P
parallel-worktrees
About parallel-worktrees
Parallel Worktrees is a productivity pattern for running multiple Claude Code sessions against one repository using separate Git worktrees. It describes setup, writer/reviewer roles, and cleanup practices for keeping parallel tasks isolated.
Key features
- 01Separate worktrees for parallel tasks
- 02Writer and reviewer session pattern
- 03Worktree listing and cleanup commands
Use cases
- 01Implement a feature while another session reviews code
- 02Keep parallel repository tasks isolated
- 03Remove completed or stale worktrees
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/parallel-worktreesin Claude Code to confirm it loaded.
Details
From the project READMEParallel Worktrees
Productivity pattern for running multiple Claude Code sessions on the same repository.
See ../../rules/12-context-management.md for detailed documentation.
Quick Reference
Setup
# Create worktree for a feature branch
git worktree add ../feature-name feature/branch-name
# Launch Claude in the worktree
cd ../feature-name && claude
Writer/Reviewer Pattern
| Terminal | Role | Command |
|---|---|---|
| Terminal 1 | Writer | cd ../feature-auth && claude "Implement feature" |
| Terminal 2 | Reviewer | cd ../review-auth && claude "Review the code" |
Best Practices
- 3-5 worktrees maximum
- One worktree = one task
- Remove completed worktrees:
git worktree remove ../feature-name - Never share sessions between worktrees
Cleanup
# List all worktrees
git worktree list
# Remove a worktree
git worktree remove ../feature-name
# Prune stale worktree entries
git worktree prune
Comments
Markdown supported