What it does:

Creates worktrees from main branch with clear branch names
Copies .env.local automatically (Supabase/Cloudflare keys)
Runs pnpm install to make worktrees dev-ready
Lists, switches between, and cleans up worktrees

When to use:

Code review (/review): Isolated environment for reviewing PRs
Feature work (/work): Parallel work on multiple features
Testing: Test a feature branch without switching

# Create a new worktree (copies .env.local, runs pnpm install)
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh create feature-name

# List all worktrees
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh list

# Switch to a worktree
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh switch feature-name

# Clean up inactive worktrees
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh cleanup

Creates new worktree with dependencies installed.

bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh create feature-login

What happens:

Checks if worktree already exists
Updates base branch from remote
Creates new worktree and branch
Copies .env.local
Runs pnpm install
Shows path for cd-ing to worktree

list or ls

Lists all worktrees with their branches and status.

switch <name> or go <name>

Switches to an existing worktree.

cleanup or clean

Removes inactive worktrees with confirmation.

PR Review:

# Create worktree for PR review
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh create pr-664-lightbox

# Move to worktree and start dev
cd .worktrees/pr-664-lightbox
pnpm run dev

# After review, return and cleanup
cd ../..
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh cleanup

Parallel Development:

# Start first feature
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh create feature-a

# Start second feature
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh create feature-b

# Switch between them
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh switch feature-a

/work command:

Ask: "How do you want to work?"

New branch on current worktree (live work)

Worktree (parallel work)
If worktree → call recollect-worktree skill

KISS: One manager script, simple commands, sensible defaults

Opinionated Defaults:

Worktrees from main (unless specified)
Stored in .worktrees/ directory
Branch name becomes worktree name
.env.local copied automatically
pnpm install runs automatically

Safety First:

Confirms before creating/removing
Won't remove current worktree
Clear error messages

Directory structure:

.worktrees/
├── feature-login/
│   ├── .git
│   ├── .env.local      # Copied from main
│   ├── node_modules/   # Installed via pnpm
│   └── ...
└── pr-664-lightbox/
    └── ...

How it works:

Uses git worktree add for isolated environments
Each worktree has its own branch
Share git history with main repo
Lightweight (filesystem links, no duplication)

Worktree is ready when:

.worktrees/<name>/ directory exists .env.local is present in worktree node_modules/ exists (pnpm install completed) pnpm run dev starts successfully

安装