Using Git Worktrees

What it does

This skill enables AI agents to manage multiple parallel versions of a codebase simultaneously using Git worktrees. It allows the agent to switch between different branches or experimental features without cluttering the main repository with numerous local branches, ensuring a clean and organized development environment.

When to use it

• Running multiple experiments on the same project in parallel to compare results quickly.
• Isolating specific feature branches from the main codebase while maintaining active development on other areas.
• Testing different configurations or dependencies against the same base code without overwriting changes.
• Collaborating on a single repository where distinct tasks require separate working directories.

Key capabilities

• Creates and manages Git worktrees for parallel development sessions.
• Switches between existing worktrees to access different branches instantly.
• Maintains a clean primary branch state while handling multiple concurrent changes.
• Integrates seamlessly with standard Git workflows within the agent's environment.

Example prompts

• "Create a new worktree for the 'feature-auth' branch so I can test authentication logic without affecting the main code."
• "Switch to the existing worktree named 'debug-build' and run the linter on that specific version."
• "List all available worktrees and show me which branches they are currently pointing to."

Tips & gotchas

Ensure your Git repository is initialized before attempting to create a worktree, as this feature requires an existing .git directory. Be mindful of file locking mechanisms when multiple agents or processes access the same working directory simultaneously.