What problem does it solve?
Using a single working directory for multiple branches can cause conflicts, accidental commits, and messy state when you need isolation for feature development.
Core Features & Use Cases
- Isolated workspaces per branch: Create and switch to an isolated directory using
git worktree without disturbing your current workspace.
- Project-local safety guardrails: When using a project-local
.worktrees/ or worktrees/ directory, it verifies the directory is ignored by git before creating the worktree to prevent accidental tracking.
- Baseline setup and validation: Automatically runs project setup (e.g., npm/cargo/pip) and verifies a clean test baseline so you know the new workspace starts in a good state.
- Real-world use case: Start a long-running feature branch while keeping the main working directory clean, then run tests to confirm the baseline before you begin implementing the feature.
Quick Start
Use the skill to create an isolated worktree for your feature branch, then run the project’s setup and verify the test baseline before implementation.