worktree-manager

Manage git worktrees across repositories with a centralized registry.

1|Updated Jan 7, 2026
One-click install
npx skills add https://github.com/storypixel/react-six-pack --skill worktree-manager-storypixel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-manager
Source: https://github.com/storypixel/react-six-pack/tree/main/.claude/skills/worktree-manager
Command: npx skills add https://github.com/storypixel/react-six-pack --skill worktree-manager-storypixel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, lsof, uuidgen, and includes scripts (resource) components.

What problem does it solve?

This Claude Code skill helps developers manage parallel development environments by coordinating multiple git worktrees across projects, eliminating painful context switches and inconsistent setups.

Core Features & Use Cases

  • Create isolated worktrees for individual features or bug fixes and store them in a centralized location for quick switching.
  • Allocate and track ports globally to prevent cross-project conflicts, run Claude Code agents in dedicated terminals, and perform health checks.
  • Maintain a global registry of worktrees to simplify status, cleanup, and cross-team collaboration.

Quick Start

Say: "Spin up worktrees for feature/auth and feature/payments." The skill will create worktrees, copy shared resources, install dependencies, validate environments, register them in the global registry, and launch Claude Code agents.

Frequently Asked Questions about worktree-manager

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

FAQPage Schema
How do I manage parallel git worktrees for multiple features without port conflicts?

You can manage parallel git worktrees by using a centralized registry and automated port allocation scripts to isolate development environments and prevent cross-project conflicts. This solution tracks ports globally and handles worktree creation, configuration, and validation.

What is the best way to automate git worktree lifecycle and cleanup across projects?

Automating git worktree lifecycle involves using a suite of scripts for registration, status monitoring, and cleanup stored in a global registry. This ensures consistent environment teardown and eliminates inconsistent setups when switching features.

Do I need jq and lsof to run automated git worktree environments with Claude?

Yes, you need jq, lsof, and uuidgen installed as dependencies to run automated git worktree environments with Claude. These tools handle JSON registry parsing, port allocation validation, and unique identifier generation for isolated worktrees.

Can I launch dedicated Claude Code agents in isolated git worktrees automatically?

Yes, you can launch dedicated Claude Code agents in isolated git worktrees automatically. The solution uses a launch-agent script to open dedicated terminals for each worktree, allowing you to run parallel development sessions without manual terminal setup.

How does global port allocation work for parallel development environments?

Global port allocation works by using an allocate-ports script to track assigned ports in a centralized JSON registry. This prevents cross-project conflicts when running multiple isolated worktrees and their associated development servers simultaneously.

When should I avoid using a centralized registry for git worktree management?

You should avoid using a centralized registry for git worktree management if you are working on a single repository without parallel branches or if your environment lacks the required jq, lsof, and uuidgen dependencies needed for port allocation and validation.