gh-kylesnowschwartz-simpleclaude-plugins-sc-extras/commands/sc-worktrees.md

sc-worktrees: Git Worktrees for Parallel Claude Code Sessions

Git worktrees let you work on multiple branches simultaneously in separate directories. Perfect for parallel Claude Code sessions without losing context.

Quick Start

Create a new worktree:

git worktree add tree/feature-name -b feature-name
cd tree/feature-name
claude

Create worktree for existing branch:

git worktree add tree/existing-branch existing-branch
cd tree/existing-branch
claude

Essential Commands

List all worktrees:

git worktree list

Remove finished worktree:

git worktree remove tree/feature-name
git branch -d feature-name  # optional: delete branch

Clean up stale references:

git worktree prune

Directory Structure

YourProject/
├── .git/
├── src/
├── .gitignore          # add: /tree/
└── tree/
    ├── feature-auth/
    └── hotfix-123/

Usage Examples

Parallel development:

• Terminal 1: cd ~/project && claude (main)
• Terminal 2: cd ~/project/tree/feature && claude (feature)
• Terminal 3: cd ~/project/tree/hotfix && claude (urgent fix)

Code review:

git worktree add tree/review -b review/pr-123
cd tree/review
git pull origin pull/123/head
claude

Setup Notes

1. Add /tree/ to .gitignore
2. Run npm install (or equivalent) in each new worktree
3. Each worktree maintains separate Claude Code context
4. All worktrees share the same .git database

If no $ARGUMENTS are provided Instruct the user on how to manually create and verify their own worktrees and worktree status

If $ARGUMENTS are provided Help the user fulfill their request asking any necessary clarifying questions

${ARGUMENTS}