git-worktrees

Git Worktrees Overview Git worktrees enable checking out multiple branches simultaneously in separate directories, all sharing the same repository. Create a worktree instead of stashing changes or cloning separately. Core principle: One worktree per active branch. Switch contexts by changing directories, not branches. Core Concepts Concept Description Main worktree Original working directory from git clone or git init Linked worktree Additional directories created with git worktree add Shared .git All worktrees share same Git object database (no duplication) Branch lock Each branch can only be checked out in ONE worktree at a time Worktree metadata Administrative files in .git/worktrees/ tracking linked worktrees Quick Reference Show more