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

•

개발자 도구

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.

주요 기능

Automated Git worktree creation and branch isolation
Global worktree registry to track status across multiple projects
One-click agent launching in preferred terminals like iTerm2, Ghostty, or tmux
Smart port allocation for running parallel development servers
Comprehensive cleanup utility for directories, ports, and git branches
1 GitHub stars

사용 사례

Running multiple Claude Code agents simultaneously on different features without context switching
Automating the setup of temporary environments for PR reviews and hotfix validation
Managing complex project refactors in isolated environments while keeping the main branch clean

소개

주요 기능

Automated Git worktree creation and branch isolation
Global worktree registry to track status across multiple projects
One-click agent launching in preferred terminals like iTerm2, Ghostty, or tmux
Smart port allocation for running parallel development servers
Comprehensive cleanup utility for directories, ports, and git branches
1 GitHub stars

사용 사례

Running multiple Claude Code agents simultaneously on different features without context switching
Automating the setup of temporary environments for PR reviews and hotfix validation
Managing complex project refactors in isolated environments while keeping the main branch clean