git-worktree

name	git-worktree
description	Manage git worktrees for parallel development. Use when the user wants to work on multiple branches simultaneously, create isolated environments for features/fixes, or clean up completed worktrees.

Git Worktree Manager

Overview

This skill provides a unified interface for managing git worktrees, enabling isolated parallel development. Worktrees allow you to have multiple branches checked out simultaneously in separate directories.

Key features:

• Automatic .env file copying from main repo to new worktrees
• Unified storage in .worktrees/ directory
• Cleanup of merged and stale worktrees

When to Use This Skill

• Creating isolated environments for feature development
• Working on multiple branches simultaneously
• Reviewing PRs without stashing current work
• Cleaning up completed feature branches

Critical: Always Use the Manager Script

Always use the worktree-manager.sh script rather than raw git worktree commands. The script handles:

• Automatic .env file copying to new worktrees
• Consistent storage in .worktrees/ directory
• Proper .gitignore management

Core Commands

All operations use the unified worktree-manager.sh script:

bash scripts/worktree-manager.sh <command> [options]

Create Worktree

worktree-manager.sh create <branch-name> [source-branch]

Creates a new worktree in .worktrees/<branch-name>. If the branch exists, it checks it out. If not, creates a new branch from the source (defaults to main/master).