twig-guide
This skill should be used when the user:- Wants to work on multiple branches simultaneously or in parallel- Needs to start a new feature/task while preserving current work- Asks about git worktree operations (create, remove, list, clean)- Mentions "twig" commands (add, remove, clean, list, init)- Wants to carry or move uncommitted changes to a new branch- Wants to copy/sync changes between branches- Needs to isolate work in a separate directory- Asks about switching context without stashing- Wants to clean up old/merged branches and their worktrees- Says phrases like "new worktree", "create worktree", "branch off", "work on something else", "start new work", "parallel work", "separate workspace", "another branch"Use this skill for ANY worktree-related operation, not just whenexplicitly asking about twig.
When & Why to Use This Skill
This Claude skill provides a comprehensive interface for managing Git worktrees via the twig CLI, enabling developers to handle multiple feature branches simultaneously. It optimizes software engineering workflows by facilitating seamless context switching, uncommitted change migration, and automated workspace cleanup without the need for stashing.
Use Cases
- Parallel Feature Development: Create separate physical workspaces for different branches to work on multiple tasks or features at the same time without cross-contamination.
- Efficient Context Switching: Switch to urgent bug fixes or high-priority tasks instantly without stashing or committing unfinished work, preserving the exact state of your current environment.
- Advanced Change Management: Use 'carry' or 'sync' commands to move or duplicate specific uncommitted files and changes between different branches and worktrees.
- Automated Workspace Maintenance: Quickly identify and remove worktrees associated with merged branches to keep the local development environment clean and save disk space.
| name | twig-guide |
|---|---|
| description | | |
| allowed-tools | Read |
twig CLI Guide
twig is a CLI tool that simplifies git worktree workflows by automating branch creation, symlinks, and change management in a single command.
Commands Overview
| Command | Purpose |
|---|---|
twig init |
Initialize twig configuration |
twig add <name> |
Create a new worktree with symlinks |
twig remove <branch>... |
Remove worktrees and their branches |
twig list |
List all worktrees |
twig clean |
Remove unneeded worktrees |
Typical Workflows
Start new feature work
Create a new worktree for a feature branch:
twig add feat/new-feature
This creates a worktree at the configured destination directory, creates a new branch if it doesn't exist, and sets up symlinks.
Move current changes to a new branch
When you realize current work should be on a different branch:
twig add feat/correct-branch --carry
The --carry flag moves uncommitted changes to the new worktree.
The source worktree becomes clean.
Copy changes to a new branch
When you want changes in both the current and new worktree:
twig add feat/experiment --sync
The --sync flag copies uncommitted changes to both worktrees.
Carry only specific files
When you want to carry only certain files:
twig add feat/new --carry --file "*.go" --file "cmd/**"
Clean up after merging
Remove worktrees for branches that have been merged:
twig clean
This shows candidates and prompts for confirmation. Use --yes to skip
the prompt.
Force remove a worktree
Remove a worktree even with uncommitted changes:
twig remove feat/abandoned -f
Use -ff to also remove locked worktrees.
Configuration
see ./references/configuration.md
Command Details
For detailed information on each command, refer to:
- ./references/commands/add.md - Create worktrees with sync/carry options
- ./references/commands/remove.md - Remove worktrees and branches
- ./references/commands/list.md - List worktrees
- ./references/commands/clean.md - Clean merged worktrees
- ./references/commands/init.md - Initialize configuration
- ./references/configuration.md - Configuration file details