skills.rest
ScientiaCapital
ScientiaCapitalCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/ScientiaCapital/skills --skill worktree-manager-scientiacapital
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
digital-stoic-orgdigital-stoic-org
19

install-dependency

Automate monorepo-aware dependency installation across Python, JavaScript, and system packages.

Official
Intermediate
abhattacherjeeabhattacherjee
1

worktree

Create and remove Git worktrees for isolated parallel development sessions.

Community
Intermediate
wesleyegbertowesleyegberto
3

terminal-monitor

Open a named tmux or iTerm2 pane to monitor real-time subagent or team output.

Community
Intermediate
Fantasia1999Fantasia1999

git-worktree-manager

Manage Git worktrees with deterministic port allocation and safe cleanup.

Community
Advanced