worktree-manager

Create and manage multiple Git worktrees with a global JSON registry.

1|3|Updated Dec 12, 2025

Search Tags:#automation #git #Claude Code #worktree #registry #parallel-development #port-management

One-click install

npx skills add https://github.com/zircote/claude-spec --skill worktree-manager-zircote

Or copy as Structured Prompt for Agent▼

Please help me install this Agent Skill.
Skill: worktree-manager
Source: https://github.com/zircote/claude-spec/tree/main/skills/worktree-manager
Command: npx skills add https://github.com/zircote/claude-spec --skill worktree-manager-zircote

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill enables you to orchestrate parallel development by creating and managing multiple Git worktrees, each with its own Claude Code agent, shared registry, and isolated environment. It reduces context-switching and merge conflicts by allowing concurrent branches.

Core Features & Use Cases

Global worktree registry: Track all worktrees across projects in a single JSON registry.
Port allocation & cleanup: Reserve and release ports for agents safely.
Agent orchestration: Launch Claude Code agents in dedicated worktrees with customizable prompts.
Lifecycle-friendly tooling: Scripted status, cleanup, and optional branch management for clean handoffs.

Quick Start

Use the worktree-manager to spin up a new worktree for feature/auth, then inspect status with the global registry.