/parallel

# /parallel - Worktree Setup Guide

Set up parallel Claude Code sessions using git worktrees.

## Native Worktree Mode (Claude Code 2.1.49+)

Claude Code now has built-in worktree support:

```bash
claude --worktree
claude -w
```

This creates an isolated git worktree automatically and runs Claude inside it. No manual setup needed.

### Subagent Worktree Isolation

Subagents can also run in isolated worktrees:

```yaml
# In .claude/agents/my-agent.md frontmatter
isolation: worktree
```

This gives each subagent its own working copy, preventing file conflicts.

## Current State

```bash
git worktree list
```

## Manual Worktree Setup

For cases where you want more control:

```bash
git worktree add ../[project]-feat [branch-name]
git worktree add ../[project]-fix [branch-name]
git worktree add ../[project]-exp -b experiment
```

## Usage Pattern

```
Terminal 1: ~/project          → Main work (or `claude`)