git-worktree

Manage Git worktrees for isolated parallel development via a central manager script.

23|2|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/marcusrbrown/systematic --skill git-worktree-marcusrbrown
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-worktree
Source: https://github.com/marcusrbrown/systematic/tree/main/skills/git-worktree
Command: npx skills add https://github.com/marcusrbrown/systematic --skill git-worktree-marcusrbrown

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires bash, git, and includes scripts (resource) components.

What problem does it solve?

This skill provides a unified interface to manage Git worktrees for isolated parallel development, simplifying creation, listing, switching, and cleanup across multiple branches.

Core Features & Use Cases

  • Create and manage worktrees from a central manager script
  • List active worktrees and current status
  • Switch between worktrees and safely clean up completed ones
  • Automatically copy environment files (.env, .env.local, etc.) from the main repo to new worktrees
  • Integrates with workflows to support parallel development without cluttering the main repo

Quick Start

Use the worktree manager to create a new worktree: bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh create feature-login Then list or switch as needed: bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh list bash ${CLAUDE_PLUGIN_ROOT}/skills/git-worktree/scripts/worktree-manager.sh switch feature-login

Frequently Asked Questions about git-worktree

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Git worktrees for parallel development without cluttering my main repository?

Git worktrees allow isolated parallel development by creating separate working directories for different branches. This skill provides a unified bash script to create, list, switch, and clean up worktrees, keeping your main repository organized.

Can I automatically copy environment files when creating a new Git worktree?

Yes, when creating a new Git worktree, the skill automatically copies environment files like .env and .env.local from the main repository to the new worktree directory. This ensures your parallel development branches have the necessary configuration.

What is the best way to switch between multiple Git worktrees from the command line?

The best way to switch between Git worktrees is using a centralized bash manager script. This skill provides a worktree-manager.sh script that handles switching between active worktrees safely without needing to manually change directories.

Does this Git worktree automation skill require any specific dependencies?

Yes, the skill requires both bash and git to be installed in your environment. It leverages a dedicated worktree-manager.sh script to enforce consistent worktree management and automatically update your .gitignore file.

How do I safely clean up completed Git worktrees after merging a feature branch?

To safely clean up completed Git worktrees, use the provided worktree-manager.sh script's cleanup command. This ensures the isolated working directories and their associated branches are removed properly without affecting your main repository.

Why use a dedicated bash script for Git worktree automation instead of standard Git commands?

Using a dedicated bash script for Git worktree automation enforces a unified interface for creation, listing, switching, and cleanup. It automatically handles .gitignore updates and environment file copying, reducing manual errors during parallel development.