How does the skill handle development server ports?

It manages a global port pool (default 8100-8199) and automatically allocates unique ports to each worktree to prevent conflicts during parallel development.

What is a Git worktree and why use it with Claude?

A Git worktree allows you to have multiple branches of the same repository checked out in different directories simultaneously. Using it with Claude allows you to run separate AI agents on different tasks in parallel without switching branches in your main directory.

What happens during the cleanup process?

The cleanup script removes the worktree directory, unregisters it from Git, releases the allocated ports back to the pool, and can optionally delete the local Git branch.

Can I use this for projects across different directories?

Yes, the skill uses a global registry located at ~/.claude/worktree-registry.json to track all managed worktrees regardless of the original project path.

Which terminals are supported by the worktree manager?

The skill supports popular terminals including iTerm2 (macOS), Ghostty, tmux, WezTerm, Kitty, and Alacritty.

Git Worktree Manager

Name: Git Worktree Manager
Author: zircote

byzircote

•

Herramientas para Desarrolladores

Manages isolated Git worktrees and Claude Code agents for seamless parallel development across multiple feature branches.

The Git Worktree Manager skill empowers developers to scale their productivity by automating the creation, configuration, and cleanup of Git worktrees. It eliminates the friction of context-switching by maintaining isolated environments for each feature branch, complete with automated port allocation, dependency installation, and the launching of dedicated Claude Code agents. By maintaining a global registry of worktrees across all your projects, it provides a centralized command center for complex multi-tasking, implementation lifecycles, and Socratic planning.

Características Principales

01Automated Git worktree creation and branch isolation

02Global worktree registry to track status across multiple projects

03One-click agent launching in preferred terminals like iTerm2, Ghostty, or tmux

04Smart port allocation for running parallel development servers

05Comprehensive cleanup utility for directories, ports, and git branches

061 GitHub stars

Casos de Uso

01Running multiple Claude Code agents simultaneously on different features without context switching

02Automating the setup of temporary environments for PR reviews and hotfix validation

03Managing complex project refactors in isolated environments while keeping the main branch clean

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zircote/claude-spec worktree-manager

For use in Claude.ai and ChatGPT

Download Skill