Skip to main content
A workspace is the project-level home for your work in fabriqa.

​
What a workspace gives you

Workspaces keep the whole working surface together:
  • chats
  • sessions
  • files
  • Git state
  • workspace settings
  • permissions and audit history

​
Choose the right session type

Every chat runs inside a session. In day-to-day use, the choice that matters most is whether you stay in the main workspace or start isolated work in a linked worktree.

​
Use the main session when

  • you want to stay in the primary workspace folder
  • you are exploring, reviewing, or making smaller changes
  • speed matters more than branch isolation

​
Use a worktree session when

  • you want a clean branch for a feature or experiment
  • you are running multiple efforts in parallel
  • you do not want one task to disturb another task’s local state

​
What stays scoped to the workspace

  • the sidebar chat list
  • dockable workspace panels
  • workspace task configuration
  • workspace-level permission rules
  • audit and usage summaries

​
What changes in a worktree session

  • the chat is linked to a separate folder and branch state
  • Git quick actions can reflect the worktree workflow
  • fabriqa can warn you if the linked worktree folder disappears
  • the rest of the workspace still feels familiar, which keeps context switching low

​
Practical rule

If you switch to another repository or project, you are switching workspaces, not just chats. If you keep the same repository but start isolated work for a separate task, you usually want a worktree session instead of a brand new workspace.

​
See it in action

Go to Run parallel workflows for the closest matching video walkthrough, then continue with Worktree sessions for the practical details.