| name | worktree |
| description | Create a git worktree for parallel development. Use when the user wants to work on a feature branch in a separate directory without switching branches. |
| disable-model-invocation | true |
| allowed-tools | Bash, Read |
Git Worktree
Create a git worktree for working on a separate branch in parallel.
Current State
- Repository: !
basename $(git rev-parse --show-toplevel)
- Current branch: !
git branch --show-current
- Existing worktrees: !
git worktree list
Instructions
Parse $ARGUMENTS to determine:
- Branch name - required (first argument)
- Base branch - optional (second argument, defaults to
main)
Workflow
-
Determine the worktree path: Use ../<repo-name>-<branch-name> as the directory (sibling to the current repo).
-
Check if the branch already exists:
git branch --list <branch-name>
git branch -r --list "origin/<branch-name>"
-
Create the worktree:
- If branch exists locally or remotely:
git worktree add <path> <branch-name>
- If new branch:
git worktree add -b <branch-name> <path> <base-branch>
-
Report the result with the full path so the user can navigate to it.
Examples
/worktree feature-auth → Creates ../<repo>-feature-auth on new branch feature-auth from main/worktree fix-bug develop → Creates ../<repo>-fix-bug on new branch fix-bug from develop/worktree existing-branch → If branch exists, checks it out in a new worktree
Cleanup Reminder
After reporting success, remind the user how to clean up when done:
git worktree remove <path>
# or to also delete the branch:
git worktree remove <path> && git branch -d <branch-name>
