worktree-manager-skill

Create, list, and remove Git worktrees with isolated ports and environment files.

Updated May 13, 2025
One-click install
npx skills add https://github.com/GolferGeek/orchestrator-ai --skill worktree-manager-skill-golfergeek
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-manager-skill
Source: https://github.com/GolferGeek/orchestrator-ai/tree/main/.claude/skills/worktree-manager-skill
Command: npx skills add https://github.com/GolferGeek/orchestrator-ai --skill worktree-manager-skill-golfergeek

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the complex and error-prone process of manually managing Git worktrees, preventing port conflicts, incomplete cleanup, and inconsistent development environments.

Core Features & Use Cases

  • Worktree Creation: Automates the setup of new Git worktrees with isolated configurations, unique ports, and environment files.
  • Status Listing: Provides a comprehensive overview of all active worktrees, their configurations, and service statuses.
  • Safe Removal: Ensures proper cleanup by stopping services, killing processes, and removing directories, preventing orphaned worktrees.
  • Use Case: When juggling multiple feature branches or reviewing a pull request while actively developing, use this skill to seamlessly create, manage, and remove isolated development environments.

Quick Start

List all my current Git worktrees and their status.

Frequently Asked Questions about worktree-manager-skill

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

FAQPage Schema
How do I manage multiple Git worktrees without port conflicts?

Git worktrees let you work on multiple branches simultaneously with isolated environments. This Skill automates worktree creation with auto-allocated ports (4000+offset*10 for servers, 5173+offset*10 for clients), per-worktree .env files, and dependency installation, eliminating manual port management and configuration errors.

Can I run parallel development environments on the same machine?

Yes. This Skill creates isolated worktrees under trees/<branch-name> with unique port assignments, separate environment configurations, and background service management. Each worktree runs independently with its own .env and .claude/settings.json, letting you develop multiple features simultaneously.

How do I set up a new Git worktree with dependencies and services running?

This Skill automates the full setup: create a worktree, generate isolated .env and settings files with allocated ports, install dependencies, and start server and client services in the background. You get access URLs and PID tracking immediately after creation.

What happens when I remove a worktree?

Safe removal stops running services, kills tracked processes, and removes the worktree directory completely. This Skill prevents orphaned processes and incomplete cleanup that can cause port conflicts and wasted resources.

Do I need prior Git or worktree knowledge to use this?

This Skill handles the automation complexity. You need Git installed and basic familiarity with branches, but the Skill manages worktree creation, port allocation, environment setup, and service lifecycle—no manual configuration required.