Skip to main content
Every chat runs inside a session. In Fabriqa, the two session types that matter most to users are the main session and the worktree session.

Main session

Use the main session when:
  • you want to stay in the primary workspace folder
  • you are exploring, reviewing, or making smaller changes
  • you do not need branch isolation yet

Worktree session

Use a worktree session when:
  • you want isolation for a feature or experiment
  • you are running parallel work in the same repository
  • you want linked-worktree Git actions and clearer task separation

Quick decision rule

  • Start in the main session when speed matters more than isolation.
  • Start in a worktree session when isolation matters more than convenience.

What changes for you

In a worktree session, Fabriqa can give you:
  • linked-worktree chat context
  • Git quick actions aimed at branch completion
  • worktree-specific warnings if the linked folder disappears
  • automatic worktree setup behavior when your project is configured for it