What problem does it solve?
Provides a reliable, safe way to create isolated git workspaces so developers can work on feature branches concurrently without contaminating the main repository or accidentally committing workspace artifacts.
Core Features & Use Cases
- Deterministic directory selection: Prioritizes existing project-local directories (.worktrees, worktrees), respects CLAUDE.md preferences, and prompts the user when ambiguous.
- Safety verification and remediation: Verifies project-local worktree directories are git-ignored, automatically adds and commits ignore entries if needed to prevent accidental tracking.
- Automated creation and environment setup: Creates the worktree, checks out a new branch, auto-runs dependency installation/build for common platforms, and runs baseline tests to confirm a clean starting point.
- Use Case: Start a feature branch in an isolated workspace, run the project's setup and tests, and report a ready-to-implement status without touching the primary working directory.
Quick Start
Create an isolated git worktree for branch feature/auth in the project-local .worktrees directory, run the project's setup, and execute baseline tests.