git-worktree

Git Worktree

Workflow

Run from the consumer repository. Resolve one sub-command and preserve [add|list|remove|prune] [--branch <name>] [--base <ref>]. Inspect git worktree list --porcelain and the current branch first. Resolve every target path and branch explicitly; a missing branch/path or dirty relevant worktree stops the operation.

Use native Git operations only. add uses the repository parent and the wt-{repo-shortname}-{purpose} naming convention, then reports the exact git worktree add command and next steps. list reports each worktree and status. remove and prune preview their exact targets and require explicit confirmation before mutation; never use a force option to bypass a dirty check. The detailed command sequence is in references/workflow.md.

When NOT to Use

• A merge, rebase, branch deletion, or remote operation is requested.
• The target worktree is missing, ambiguous, or dirty.
• Removal or pruning has not received explicit confirmation.

Output

• add: exact command, created path, branch, and next steps.
• list: a formatted table derived from native worktree records.
• remove/prune: confirmation state, exact target/command, and resulting status; no confirmation means NOT_RUN.
• Missing or dirty targets and native Git failures are terminal failures.

Verification

• Every target path and branch was resolved before a write.
• Relevant worktrees were checked with git status --porcelain.
• Remove/prune has explicit confirmation, or no mutation was attempted.
• Final git worktree list --porcelain evidence matches the report.

References

• references/workflow.md — native commands, naming, dirty checks, confirmation, and output details.