What problem does it solve?
Git worktrees let you work on multiple branches in parallel without switching your current workspace, enabling isolated experimentation while keeping the main repository intact.
Core Features & Use Cases
- Directory priority and safety: prefer existing directories (.worktrees, then worktrees), optionally honor CLAUDE.md, and prompt the user if needed to choose a location.
- Safety verification: ensure a worktree directory is ignored by gitignore before creation; if not ignored, automatically update .gitignore, commit, and proceed.
- Flexible placement: supports project-local worktrees and a global location for organization-wide use, with automatic project-name inference.
- Auto-setup and validation: auto-detect project tooling (Node.js, Rust, Python, Go) and install/build as appropriate; run tests to ensure a clean baseline.
- Clear reporting: provide a final status with the location of the worktree, test results, and next-step readiness.
Quick Start
Create an isolated git worktree for the current project, branch naming it after your feature, verify the ignore rules, run auto-setup if a tool is detected, and confirm a clean test baseline.