worktree-manager

Manages Git worktrees, assigns ports, and launches isolated agents per branch.

28|3|Updated Dec 10, 2025

Search Tags:#git #worktrees #claude-code #dev-ops #parallel-development #port-allocation

Ready to run

npx skills add https://github.com/ScientiaCapital/skills --skill worktree-manager-scientiacapital

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Parallel development across multiple git worktrees with centralized agent orchestration and port management.

Core Features & Use Cases

Manage parallel workspaces by cloning repos into isolated worktrees per branch
Allocate and track ports for API/frontend per worktree to avoid conflicts
Launch Claude Code agents in isolated terminals (Ghostty, iTerm2, tmux) with project context

Quick Start

Create and spin up a new worktree using the example workflow and automatically launch the agent with the configured environment.

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 with Claude Code agents?▼

To manage parallel git worktrees, this Skill clones repos into isolated worktrees per branch and launches Claude Code agents in isolated terminals with project context. It coordinates parallel development using a centralized worktree registry.

How do I avoid port allocation conflicts across multiple git worktrees?▼

You avoid port allocation conflicts by enforcing per-worktree port pools for API and frontend services. This Skill tracks ports to ensure conflict-free collaboration across isolated development workspaces.

Can I launch Claude Code agents in isolated Ghostty or iTerm2 terminals for parallel development?▼

Yes, you can launch Claude Code agents in isolated Ghostty or iTerm2 terminals. This Skill applies scripted launch workflows to open terminals with propagated project context for each worktree.

Do I need jq and uuidgen installed to coordinate parallel worktrees?▼

Yes, you need jq and uuidgen installed as dependencies. These utilities support the centralized worktree registry and unique identifier generation required to coordinate isolated workspaces.

What is a centralized worktree registry and how does it help parallel development?▼

A centralized worktree registry is a tracking mechanism for isolated git worktrees across branches. It helps parallel development by maintaining project context propagation and preventing workspace conflicts during agent orchestration.