# Parallel Worktrees

> Parallel Worktrees

- Skill: `thebeardedbearsas/parallel-worktrees` (Agent Skill)
- Install (CLI): `npx get-skill add thebeardedbearsas/parallel-worktrees`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thebeardedbearsas/parallel-worktrees/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: TheBeardedBearSAS (https://skillmd.com/u/thebeardedbearsas)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/thebeardedbearsas/parallel-worktrees

---


# Parallel 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

```bash
# 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

```bash
# List all worktrees
git worktree list

# Remove a worktree
git worktree remove ../feature-name

# Prune stale worktree entries
git worktree prune
```

