Using Git Worktrees

The using-git-worktrees skill enables AI agents to manage parallel development branches within a single repository without cluttering the main directory structure. It automates the creation, switching, and cleanup of worktrees, allowing seamless context isolation for distinct tasks or experiments.

When to use it

• Isolate experimental feature development from stable production code in the same project.
• Run multiple concurrent workflows on different versions of a codebase simultaneously.
• Maintain clean primary branches while testing hotfixes or alternative implementations.
• Streamline CI/CD pipelines by managing temporary build environments via worktrees.

Key capabilities

• Automatically creates new git worktrees based on specified branch names.
• Switches between existing worktrees to change the active working directory.
• Cleans up and removes unused or completed worktrees to free up space.
• Manages the lifecycle of parallel development contexts within a single repository.

Example prompts

• "Create a new worktree named feature-auth based on the current branch for testing login logic."
• "Switch to the hotfix-security worktree to apply emergency patches without affecting other tasks."
• "List all active worktrees and remove any that haven't been modified in over 24 hours."

Tips & gotchas

Ensure you have write permissions to the target repository before attempting to create or modify worktrees. Be mindful of disk space usage, as each worktree maintains a full copy of the working directory files alongside the shared object database.