twig-guide

708u's avatarfrom 708u

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.

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 10, 2026

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.
nametwig-guide
description|
allowed-toolsRead

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