Pro-workflow parallel-worktrees
Create and manage git worktrees for parallel coding sessions with zero dead time. Use when blocked on tests, builds, wanting to work on multiple branches, context switching, or exploring multiple approaches simultaneously.
install
source · Clone the upstream repo
git clone https://github.com/rohitg00/pro-workflow
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/rohitg00/pro-workflow "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/parallel-worktrees" ~/.claude/skills/rohitg00-pro-workflow-parallel-worktrees && rm -rf "$T"
manifest:
skills/parallel-worktrees/SKILL.mdsource content
Parallel Worktrees
Zero dead time. While one session runs tests, work on something else.
Trigger
Use when waiting on tests, long builds, exploring approaches, or needing to review and develop simultaneously.
Quick Start
Claude Code:
claude --worktree # or claude -w (auto-creates isolated worktree)
Cursor / Any editor:
git worktree add ../project-feat feature-branch # Open the new worktree folder in a second editor window
Both approaches create an isolated working copy where changes don't interfere with your main session.
Claude Code Extras
These features are Claude Code-specific (skip if using Cursor):
auto-creates and cleans up worktreesclaude -w- Subagents support
in agent frontmatterisolation: worktree
kills all background agents (two-press confirmation)Ctrl+F
sends a task to backgroundCtrl+B
Workflow
- Show current worktrees:
git worktree list - Create a worktree for the parallel task.
- Open a new editor/terminal session in the worktree.
- 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
Each worktree runs its own AI session independently.
When to Parallelize
| Scenario | Action |
|---|---|
| Tests running (2+ min) | Start new feature in worktree |
| Long build | Debug issue in parallel |
| Exploring approaches | Compare 2-3 simultaneously |
| Review + new work | Reviewer in one, dev in other |
| Waiting on CI | Start next task in worktree |
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