What problem does it solve?
Prevents branch interference and accidental commits to the current workspace by creating isolated, project-aware git worktrees with safety verification and an automated project setup and baseline test check.
Core Features & Use Cases
- Systematic directory selection that prefers .worktrees or worktrees, falls back to a global cadence location, or asks the user when ambiguous.
- Safety verification that ensures project-local worktree directories are listed in .gitignore and will add and commit the ignore entry if missing.
- Automated creation of a new worktree branch, auto-run of project setup based on manifest files (package.json, Cargo.toml, pyproject.toml, requirements.txt, go.mod), and execution of the project's test command to verify a clean baseline before work proceeds.
- Use case: Starting feature work for an authentication flow on a new branch while keeping the main workspace untouched and guaranteeing tests pass before implementation.
Quick Start
Create an isolated worktree for branch feature/auth using the preferred worktrees directory, ensure the directory is ignored in git, run the project's setup based on detected manifests, and verify tests pass before implementing the feature.