Worktrees
The Worktrees tab manages git worktrees — separate working directory checkouts of the same repository. Worktrees let you work on multiple branches simultaneously without stashing or switching. This tab can appear as a mode within Refs or Git Settings, or as a standalone content tab.
Worktree List
Each linked worktree (excluding the main worktree) is displayed with:
- Repo name (extracted from the worktree path)
- Branch name or “(detached)” for detached HEAD
- Status badges — Current, Locked, Stale, Prunable
- Action buttons — Open/Switch, Compare, Remove, Prune
Creating a Worktree
Click New Worktree to expand the creation form:
- New branch — create a worktree with a new branch from main or a selected branch
- Existing branch — check out an existing branch in a new directory
- Auto-prune option — automatically clean up stale worktrees on creation
Worktree Operations
| Action | Effect |
|---|---|
| Open | Open the worktree as a Worktree app tab |
| Switch | If already open, activate that app tab |
| Compare | Open a Compare tab showing the diff between this worktree and the main repo |
| Remove | Delete the worktree (disabled if open or locked) |
| Prune | Remove stale or abandoned worktrees |
| Unlock | Remove the lock file if a worktree is stuck |
Conflict State
Remove and prune operations are disabled during merge or rebase conflicts.