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
This Claude skill automates the creation of Git worktrees and branches, enabling developers to start new features in isolated environments quickly. By streamlining the setup process—including base branch verification, pulling updates, and directory organization—it enhances workflow efficiency and minimizes the friction of context-switching during complex software development tasks.
Use Cases
- Feature Isolation: Starting a new feature or user story in a dedicated directory without disturbing your current work-in-progress.
- Concurrent Task Management: Managing multiple bug fixes or tasks simultaneously by maintaining separate, independent worktrees for each branch.
- Workflow Standardization: Ensuring team-wide consistency by automatically organizing all feature worktrees within a structured 'tree/' directory.
- Rapid Context Switching: Quickly jumping between different versions of a codebase for testing, debugging, or comparison without the need for frequent stashing or switching branches in a single directory.
| 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