wt

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.