---

name: git-worktrees description: Manage git worktrees for parallel development. Use when user mentions worktrees, parallel branches, or working on multiple branches simultaneously.

Git Worktrees

Work on multiple branches simultaneously without stashing or switching.

Worktree Location

All worktrees live in .worktrees/ at repo root.

Copyproject/
├── .worktrees/
│   ├── feat-auth/
│   └── fix-login/
└── (main working tree)

Naming Convention

Worktree folder matches branch name pattern:

Pattern: Take the last two segments, join with hyphen.

Commands

Create Worktree

Copy# New branch
git worktree add .worktrees/<folder> -b <branch-name>

# Existing branch
git worktree add .worktrees/<folder> <existing-branch>

List Worktrees

Copygit worktree list

Remove Worktree

Copygit worktree remove .worktrees/<name>

Prune Stale

Copygit worktree prune

Workflow

• Create worktree for feature/fix work
• Each worktree is independent (own node_modules, build cache, etc.)
• Remove worktree when branch is merged
• Run git worktree prune to clean up stale references

Tips

• Worktrees share the same .git - commits are visible everywhere
• Don't forget to install dependencies in new worktree