By name: wt description: Use when creating, managing, listing, removing, or switching git worktrees. Also use when spawning subagents that need isolated workspaces for parallel development.
wt — Worktree Toolkit
Manage git worktrees using the wt CLI. Follow these steps in order.
Step 0 — Availability check
Run wt list. If the command is not found, follow references/installation.md and stop. Do not fall back to raw git worktree commands.
Step 1 — Conflict detection
Check your loaded skills and instructions for conflicting worktree guidance. See references/conflict-detection.md. Resolve before proceeding.
Step 2 — Decide
Is a worktree needed for this task? See references/when-to-use.md. Not every change needs one.
Step 3 — Follow the rules
See references/rules.md for what is and isn't allowed.
Step 4 — Execute
Use the commands in references/command-reference.md.
For spawning subagents in isolated worktrees, follow references/subagent-pattern.md.
For concrete scenarios, see references/examples.md.
On errors
Consult references/troubleshooting.md. If unresolvable, see references/contributing.md.