By name: parallel-development description: Run multiple Claude Code sessions simultaneously using git worktrees. Use when discussing parallel work, worktrees, concurrent development, or multiple sessions.
Parallel Development
Run 5+ Claude Code sessions simultaneously to maximize productivity.
Why Parallel Sessions?
Don't wait for Claude to finish one thing before starting another.
Benefits:
- Work on multiple features simultaneously
- Don't block on long-running tasks
- Experiment without affecting main work
Git Worktrees
Worktrees allow multiple working directories from a single repository.
Creating a Worktree
# Create worktree with new branch
git worktree add -b feature/auth ../project-auth main
# Create worktree with existing branch
git worktree add ../project-fix-123 fix/issue-123
Listing Worktrees
git worktree list
Removing Worktrees
git worktree remove ../project-auth
git worktree prune
Parallel Session Workflow
1. Identify Independent Tasks
Choose tasks that don't overlap in files.
2. Create Worktrees
git worktree add -b feature/auth ../project-auth main
git worktree add -b feature/ui ../project-ui main
3. Start Claude Sessions
Open separate terminals for each worktree:
cd ../project-auth && claude
cd ../project-ui && claude
4. Work Independently
Each session works on its task.
5. Merge Results
git checkout main
git merge feature/auth
git merge feature/ui
6. Clean Up
git worktree remove ../project-auth
git worktree remove ../project-ui
Best Practices
- Independent tasks: Choose work with different file footprints
- Focused sessions: One task per worktree
- Regular syncs: Pull main into feature branches
- Clean up: Remove worktrees when done
Example Layout
~/projects/
├── my-app/ # Main - coordination
├── my-app-auth/ # Session 2 - auth feature
├── my-app-dashboard/ # Session 3 - dashboard
└── my-app-perf/ # Session 4 - performance