What problem does it solve?
Creates isolated, reproducible working directories for branch-specific development to prevent workspace contamination, accidental commits of ephemeral files, and environment drift.
Core Features & Use Cases
- Safe directory selection and policy: Prioritizes existing worktrees directories, project preferences, or explicit user choice.
- Safety validation: Verifies git ignore status and updates .gitignore when necessary to avoid accidental commits.
- Worktree creation and setup: Creates named branches in dedicated worktrees, runs project setup commands, and verifies baseline tests for feature development, bugfixes, or experiments.
- Use Case: Spin up a feature branch worktree, run dependency installation, and confirm tests before starting implementation.
Quick Start
Create an isolated worktree at worktrees/feature-auth on a new branch feature/auth, ensure the directory is git-ignored, run the project setup commands for the repository, and execute baseline tests to confirm the environment is ready.