What problem does it solve?
Prevents workspace contamination and accidental commits when working on multiple branches by creating isolated, project-aware git worktrees with safety checks and automated setup.
Core Features & Use Cases
- Priority-based directory selection: prefer .worktrees, then worktrees, then CLAUDE.md preference, otherwise ask the user.
- Safety verification for project-local directories using git check-ignore and automatic .gitignore updates and commits when needed.
- Automated creation workflow that detects project name, creates a new branch worktree, auto-runs dependency setup based on project files (package.json, Cargo.toml, pyproject.toml, go.mod), and verifies a clean test baseline before proceeding.
- Typical use cases: starting feature branches that need isolation, preparing environments before executing implementation plans or subagent-driven development, and reproducing CI-local test baselines.
Quick Start
Create a project-local .worktrees/<branch> worktree, ensure the directory is git-ignored, run the appropriate dependency install for the project, and execute the test suite to confirm a clean baseline before implementing the feature.