Git Worktree Manager
Manage git worktrees with all worktrees stored in a sibling directory.
Directory Convention
Given a repository at /path/to/repo, worktrees are stored at:
/path/to/repo.worktrees/<branch-name>/
Modes
| Mode |
Triggers |
Description |
| Add |
/worktree add <branch>, /worktree <branch>, /worktree #<issue> |
Create worktree |
| Status |
/worktree status |
Show PR/CI status table |
| List |
/worktree, /worktree list |
List and select worktrees |
| Remove |
/worktree remove <branch>, /worktree rm <branch> |
Remove worktree |
| Prune |
/worktree prune |
Clean stale references |
Mode Detection
When this skill is invoked, arguments follow the skill name (e.g., /worktree status passes "status" as arguments).
IMPORTANT: Before doing anything else, identify the mode from the invocation arguments:
| Arguments |
Mode |
Instructions |
(none) or list |
List |
Read list.md |
status |
Status |
Read status.md |
#<number> or just a number |
Add (from issue) |
Read add.md |
add <branch> or just <branch> |
Add (branch) |
Read add.md |
remove <branch> or rm <branch> |
Remove |
Read remove.md |
prune |
Prune |
Read prune.md |
First action: Read the appropriate .md file for your detected mode, then follow those instructions exactly.
Important Notes
- Always use the sibling directory convention (
repo.worktrees/)
- Branch names can contain slashes (e.g.,
feat/new-feature)
- Run commands separately - Don't use compound commands with
&& or variable assignment
