# Parallel Worktrees

> Parallel git worktrees for concurrent Claude Code sessions. Use when working on multiple features or writer/reviewer workflows. Use when this capability is needed.

- Skill: `tomevault-io/parallel-worktrees` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/parallel-worktrees`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/parallel-worktrees/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/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
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/thebeardedbearsas) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->