wt-new
Create a new git worktree and branch for feature development. Use when starting a new feature or story that needs isolated development. Creates worktree in tree/ directory with proper branch setup.
When & Why to Use This Skill
The wt-new Claude skill automates the creation of Git worktrees and branches, enabling developers to manage multiple feature developments in isolated environments. By streamlining the setup process—including branch creation, pulling latest changes, and directory organization—it significantly reduces context-switching overhead and improves repository management efficiency.
Use Cases
- Parallel Feature Development: Quickly spin up a new isolated environment to work on a new feature or story without disturbing your current workspace or needing to stash uncommitted changes.
- Urgent Hotfix Handling: Create a temporary worktree to address critical production bugs immediately while keeping your long-running feature branch active and intact.
- Streamlined Code Reviews: Set up a dedicated directory to pull and test a colleague's pull request, providing a clean environment for verification without affecting your local development state.
| name | wt-new |
|---|---|
| description | Create a new git worktree and branch for feature development. Use when starting a new feature or story that needs isolated development. Creates worktree in tree/ directory with proper branch setup. |
/wt:new - Create New Worktree and Branch
Description
Quick command to activate the Git Worktree Manager skill and start a new feature worktree.
Usage
/wt:new
What It Does
This slash command:
- Activates the Git Worktree Manager skill (
@git-worktree) - Automatically runs the
*start-featurecommand - Guides you through creating a new worktree with a new branch
Workflow
The command will:
- Verify git repository - Ensure you're in a valid git repo
- Ask for base branch - Which branch to start from (e.g.,
main,develop) - Ask for feature branch name - Name for your new branch (e.g.,
feature/gallery-123) - Checkout base branch - Switch to the base branch
- Pull latest changes - Ensure base is up-to-date
- Create worktree directory - Create
tree/if it doesn't exist - Create worktree - Create the new worktree at
tree/{branch-name} - Confirm success - Show you the path to your new worktree
Benefits
✅ Quick Start - One command to create a new worktree
✅ Guided Process - Interactive prompts for all inputs
✅ Safe - Verifies git state before making changes
✅ Organized - Keeps all worktrees in tree/ directory