What problem does it solve?
Create isolated git worktrees so developers can work on parallel features without impacting the main repository, avoiding branch conflicts, preserving uncommitted work, and keeping monorepo projects organized.
Core Features & Use Cases
- Smart repo detection: auto-detects monorepo vs standalone, submodules, and topmost superproject to choose the correct worktree root.
- Branch name handling: automatic prefix detection, slug sanitization, optional --no-prefix mode that preserves slashes and case for Jira or multi-segment branches.
- Safe worktree creation & removal: dry-run previews, branch existence checks, fetch handling for remote branches, path validation, and clear warnings for dirty state.
- Environment template support: auto-copy .env*.example templates and optional explicit env file copying with traversal safety checks.
- Use Case: create a feature worktree for a monorepo project, install dependencies in that isolated folder, and later remove the worktree without touching the main repo.
Quick Start
Create or preview an isolated worktree by running the worktree script to create a feature branch and directory, for example use the create command with --dry-run to preview the branch name and target path.