What problem does it solve?
Streamlines the creation, listing, switching, and cleanup of Git worktrees to enable isolated parallel development, with automatic env-file provisioning and safety checks for dev tools.
Core Features & Use Cases
- Create worktrees from a base branch with clear naming and automatic environment file copying.
- List all worktrees with status and current location.
- Switch between worktrees to enable parallel feature development.
- Cleanup inactive worktrees with interactive confirmation and safety safeguards.
- Automatically update .gitignore to include the .worktrees directory.
- Copy environment files from the main repository into new worktrees.
- Perform basic trust checks for dev tooling (mise/direnv) to minimize friction.
Quick Start
Run the worktree-manager.sh script to create a new worktree, list available worktrees, switch between them, copy environment files, or cleanup completed worktrees.