worktree-manager

Manage Git worktrees with automated setup, port allocation, and sparse-checkout.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Michael0520/milo-claudekit --skill worktree-manager-michael0520
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-manager
Source: https://github.com/Michael0520/milo-claudekit/tree/main/plugins/worktree-manager/skills/worktree-manager
Command: npx skills add https://github.com/Michael0520/milo-claudekit --skill worktree-manager-michael0520

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the management of multiple Git worktrees, eliminating the friction of context switching between branches and projects, and preventing port conflicts for development servers.

Core Features & Use Cases

  • Effortless Worktree Creation: Spin up isolated development environments for different branches with a single command.
  • Automated Setup: Handles dependency installation, environment copying, and port allocation automatically.
  • Monorepo Support: Integrates with Git sparse-checkout for efficient development in large repositories.
  • Use Case: When a critical bug needs immediate attention while you're in the middle of a feature, this Skill allows you to instantly create a new worktree for the bugfix branch, complete with its own isolated environment and running servers, without disrupting your current work.

Quick Start

Use the worktree-manager skill to spin up worktrees for feature/auth and fix/payment-bug.

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 development environments with git worktrees?

Managing parallel development environments with git worktrees involves automating creation, dependency installation, and port allocation. This Skill spins up isolated environments for different branches with a single command to eliminate context switching friction.

What is the best way to handle port conflicts when running multiple git worktrees?

Handling port conflicts for multiple git worktrees is resolved through automated port allocation. The Skill assigns distinct ports to each isolated development environment, preventing conflicts when running multiple development servers simultaneously.

Does git worktree management support sparse-checkout for monorepos?

Git worktree management does support sparse-checkout for monorepos. It integrates Git sparse-checkout functionality to enable efficient development within large repositories by checking out only the necessary directories.

Do I need jq installed to automate git worktree creation?

You do need jq installed to automate git worktree creation. Both git and jq are required dependencies for core operations, as jq is used to process JSON data within the worktree registry and resource tracking systems.

Why use a global registry for tracking git worktree status?

Using a global registry for tracking git worktree status provides a centralized view of all active parallel environments. It monitors allocated ports and resource states, ensuring isolated development setups are tracked without manual oversight.