> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fabriqa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces and sessions

> Choose the right workspace and session type before you start a task in fabriqa.

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](/learn/run-parallel-workflows) for the closest matching video walkthrough, then continue with [Worktree sessions](/use/worktree-sessions) for the practical details.