StartWorktrees
Work on multiple branches simultaneously without stashing.
Worktree mode is experimental. Enable it in Settings → Experimental.
Git worktrees let you have multiple branches checked out at the same time in separate directories. This is especially useful with Start's parallel agent sessions — you can have agents working on different branches simultaneously.
Why worktrees
- Work on a feature branch without stashing current changes
- Have an agent run tests on one branch while you edit another
- Compare code across branches side by side
Setup
- Open Settings (Cmd+,) → Experimental tab
- Enable Worktree Mode
- Create, switch, and delete worktrees from the sidebar
Worktrees are stored in a .worktrees/ directory in your repository. The file explorer and terminal automatically switch to the active worktree's directory.
If worktree mode is disabled, Start uses the repository's main working directory directly.