Skip to main content
A worktree is a feature that opens several branches from one repository in separate folders at the same time. git worktree lets a single repository (sharing one .git history) hold several working trees, each folder checked out to a different branch at the same time.
The working tree you get when you first open a repository is the main worktree; additional folders you create are linked worktrees. All worktrees share the commit history and branches, but each has its own checked-out branch and its own working changes.
Two worktrees can’t check out the same branch at the same time. Branches in use & cleanup covers what happens when you try to move to a branch that’s already in use.

​
Worktrees in ParalleLane

  • Worktrees are shown directly in the sidebar, listed under each repository. The main worktree has a folder-check icon and linked worktrees have a Git folder icon; each row shows the checked-out branch and its ahead/behind count. Clicking a row switches to it.
  • Each worktree keeps independent state, meaning its own commit graph cache, repository overview, and Working copy state. Per-worktree state covers the exact rules.
  • The top bar breadcrumb shows your current location as Repository ⟩ Worktree ⟩ Branch when you are viewing a linked worktree.
Five worktrees of one repository listed in the Projects tab of the left sidebar; the top one, the main worktree, has a folder-check icon while the rest, the linked worktrees, have a Git folder icon, each row shows the name of its checked-out branch, and rows with an ahead or behind count show the number on the right