Atlas · building
Worktrees
Several checkouts of one repository side by side, so several agents can work on different branches at once.
In plain words
Normally a repository has one folder and one branch checked out at a time. A worktree adds another folder, on another branch, from the same repository.
How it works
Git’s manual says one repository can support several working trees, so more than one branch can be checked out at a time. A new worktree shares everything with the main one except its own files such as HEAD and the index. git worktree add ../fix fix-branch makes one; git worktree list shows them.
Going deeper
This is how several agents can work on one project without stepping on each other: each gets its own folder and branch, and one integrator merges. The three agents that build this site work that way.
Sources
- git-worktree Git
A git repository can support multiple working trees, allowing you to check out more than one branch at a time.
The new worktree is linked to the current repository, sharing everything except per-worktree files such as HEAD, index, etc.
Quotes were checked against the live pages on 2026-11-12.