git-worktrees

name	git-worktrees
description	Create, locate, inspect, and safely remove linked Git worktrees. Use when the user wants an isolated branch checkout under a repository's .worktrees directory or needs to inspect or tear down an existing worktree.

Git Worktrees

Keep linked worktrees at <primary-checkout>/.worktrees/<name>. This skill covers only their Git lifecycle; the caller decides what runs inside them.

Inspect

Run git status --short --branch and git worktree list --porcelain. The first worktree entry is the primary checkout. Reuse a suitable registered worktree, and inspect its branch and status before changing it. Never create a worktree inside another worktree.

Create

Choose the name, branch, and base ref deliberately. Fetch first when the base is remote; use HEAD when local commits must be included. From the primary checkout, create .worktrees, add /.worktrees/ to the repository's info/exclude, and run git worktree add -b <branch> .worktrees/<name> <base>. Omit -b to check out an existing branch.

Never use -B or --force to bypass a collision. Stop and inspect it. Report the new worktree's absolute path.

Remove

Check the worktree for uncommitted files, unpushed commits, and unfinished Git operations. When it is safe, run git worktree remove <path>. Do not use rm -rf; use --force only when the user explicitly chooses to discard the reported state. Delete its branch separately only when requested and safe, then report the final state.