worktree-kit

Create, list, switch, and clean up git worktrees under .worktrees.

674|52|Updated Dec 26, 2025
One-click install
npx skills add https://github.com/gmickel/gmickel-claude-marketplace --skill worktree-kit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-kit
Source: https://github.com/gmickel/gmickel-claude-marketplace/tree/main/plugins/flow/skills/worktree-kit
Command: npx skills add https://github.com/gmickel/gmickel-claude-marketplace --skill worktree-kit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill simplifies the management of git worktrees to enable parallel feature development, clean workspaces, and isolated reviews without manual setup.

Core Features & Use Cases

  • Create, list, switch, and cleanup worktrees under a dedicated .worktrees directory to separate features cleanly.
  • Copy non-overwriting environment files (.env*) into new worktrees to preserve per-feature configurations.
  • Real-world use: a team member creates a feature branch in its own worktree, switches between worktrees for reviews, and cleans up unused worktrees without touching main branches.

Quick Start

Use the worktree kit to spin up a new feature worktree and manage it with these commands: bash ${CLAUDE_PLUGIN_ROOT}/skills/worktree-kit/scripts/worktree.sh create feat-login main bash ${CLAUDE_PLUGIN_ROOT}/skills/worktree-kit/scripts/worktree.sh list bash ${CLAUDE_PLUGIN_ROOT}/skills/worktree-kit/scripts/worktree.sh switch feat-login bash ${CLAUDE_PLUGIN_ROOT}/skills/worktree-kit/scripts/worktree.sh copy-env feat-login bash ${CLAUDE_PLUGIN_ROOT}/skills/worktree-kit/scripts/worktree.sh cleanup

Frequently Asked Questions about worktree-kit

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

FAQPage Schema
How do I manage git worktrees for parallel feature development?

Managing git worktrees for parallel feature development involves using a script to create isolated worktrees under a dedicated .worktrees directory, allowing you to separate features cleanly without manual setup. This enables isolated reviews and clean workspaces.

How do I copy .env files to a new git worktree?

To copy .env files to a new git worktree, you can use a dedicated copy-env command that duplicates non-overwriting environment files into the target worktree. This preserves per-feature configurations without overwriting existing environment variables.

What is the best way to clean up unused git worktrees without deleting branches?

The best way to clean up unused git worktrees without deleting branches is to use a cleanup command that safely removes worktree directories while preserving the associated feature branches. This ensures your main branches remain untouched during workspace maintenance.

Can I switch between git worktrees for isolated code reviews?

Yes, you can switch between git worktrees for isolated code reviews by using a list and switch command. This allows you to quickly navigate between feature branches in separate directories without stashing changes or cloning the repository again.

Does git worktree management require manual directory setup?

No, git worktree management with this approach does not require manual directory setup. The script automatically enforces safety rules and stores all worktrees under a dedicated .worktrees directory, simplifying the creation process.