| name | git-worktree |
| description | Manage git worktrees with smart automation. Create worktrees with auto-setup (dependencies, env files), list worktrees with merge status, clean up stale worktrees, and switch between worktrees. Use when working on multiple branches simultaneously, doing quick bug fixes, or reviewing PRs without stashing. |
Git Worktree Skill
Enhanced git worktree management with automation beyond raw CLI commands.
Available Commands
| Command | Description |
|---|
/worktree-add <branch> | Create worktree with auto-setup |
/worktree-list | List worktrees with merge status |
/worktree-clean | Remove merged worktrees |
Quick Examples
/worktree-add feature/auth
/worktree-list
/worktree-clean --dry-run
/worktree-clean
When to Use
- Working on multiple branches simultaneously
- Quick bug fixes without stashing
- Reviewing PRs in isolation
- Testing different versions in parallel
Key Features
- Auto-setup: Installs dependencies and copies env files
- Smart listing: Shows merge status and staleness indicators
- Safe cleanup: Only removes merged branches, with confirmation
Path Convention
Worktrees are created as sibling directories:
/project/ → main worktree
/project-feature-auth/ → feature/auth branch
/project-bugfix-42/ → bugfix/42 branch
Package Manager Detection
Automatically detects and runs:
uv sync for Python (uv.lock/pyproject.toml)npm install for Node (package-lock.json)yarn install for Yarn (yarn.lock)pnpm install for pnpm (pnpm-lock.yaml)
See individual command files in commands/ for detailed documentation.
