Skip to content
OpenChamber

Worktree Sessions

A worktree session runs in its own checked-out copy of your repo, on its own branch (a git worktree). That keeps parallel sessions from stepping on each other’s files — one can refactor while another fixes a bug, with no switching back and forth.

Create one

  1. Open the new-worktree dialog from the button at the top of the session sidebar.
  2. Choose a starting point:
    • new branch — name the branch and pick which branch to start from
    • existing branch — check out a branch you already have
  3. Confirm the worktree folder (OpenChamber suggests one from the branch name).
  4. Create it.

OpenChamber makes the branch, sets up the folder, and starts a session in it. You can also kick one off straight from a todo or a GitHub issue or PR.

Bring the work back

When the work is good, use Integrate in the Git view to bring the worktree’s commits onto another branch (like main). If a change conflicts, you can hand the conflict to the agent to resolve.

Clean up

Deleting or archiving the session can remove the worktree. You choose whether to also delete the branch — local, and remote if there is one. Nothing is deleted without you asking.

If something looks off

A worktree can need attention if its folder went missing, its branch is in a detached state, or a merge or rebase is half-finished. OpenChamber flags these so you can fix them — see Worktrees & Git.