Parallel Worktrees

Trigger

Quick Start

claude --worktree    # or claude -w (auto-creates isolated worktree)

git worktree add ../project-feat feature-branch
# Open the new worktree folder in a second editor window

Claude Code Extras

• claude -w

  auto-creates and cleans up worktrees
• Subagents support

  isolation: worktree

  in agent frontmatter

• Ctrl+F

  kills all background agents (two-press confirmation)

• Ctrl+B

  sends a task to background

Workflow

1. Show current worktrees:

   git worktree list

2. Create a worktree for the parallel task.
3. Open a new editor/terminal session in the worktree.
4. When done, clean up the worktree.

Commands

git worktree list

git worktree add ../project-feat feature-branch
git worktree add ../project-fix bugfix-branch
git worktree add ../project-exp -b experiment

git worktree remove ../project-feat
git worktree prune

Usage Pattern

Terminal 1: ~/project          → Main work
Terminal 2: ~/project-feat     → Feature development
Terminal 3: ~/project-fix      → Bug fixes

When to Parallelize

Guardrails

• Each worktree is a full working copy — changes are isolated.
• Before removing a worktree, verify changes are committed:

  git -C ../project-feat status

• Don't forget to clean up worktrees when done (

  git worktree prune

  ).
• Avoid editing the same files in multiple worktrees simultaneously.

Output

• Current worktree list
• Created worktree path and branch
• Instructions for opening a new session