worktree-manager

Create, configure, and clean up isolated development worktrees.

124|7|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/carere/zaidan --skill worktree-manager-carere
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-manager
Source: https://github.com/carere/zaidan/tree/main/.claude/skills/worktree-manager
Command: npx skills add https://github.com/carere/zaidan --skill worktree-manager-carere

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires commander, and includes scripts (resource) components.

What problem does it solve?

Developers often need multiple parallel development environments that are isolated from each other. This skill automates the full lifecycle of creating, configuring, and cleaning up worktrees so teams can work on multiple features without dependency conflicts.

Core Features & Use Cases

  • Create isolated worktrees with dedicated .env files and separate dependencies
  • List all existing worktrees with ports, branches, and status
  • Update a worktree by pulling changes and reinstalling dependencies
  • Remove a worktree and prune references to keep the repository clean

Quick Start

Create a new worktree for a feature branch to start a parallel development environment.

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 git worktrees for concurrent feature development?

Managing parallel git worktrees involves automating the creation, setup, and cleanup of isolated directories. This skill handles the full lifecycle, ensuring concurrent features are developed in separate environments with dedicated configurations without dependency conflicts.

What is the best way to set up isolated dev environments with separate dependencies?

Setting up isolated dev environments requires copying the main .env file, allocating unique ports, and running bun install. This skill automates these setup steps to ensure each worktree is ready-to-run and dependencies are kept completely separate.

How do I list all existing git worktrees with their branches and port allocations?

Listing existing git worktrees displays their allocated ports, active branches, and current status. This skill provides a command to output a complete overview of all parallel development environments currently active in your repository.

Does worktree-manager require bun install to set up parallel development environments?

Yes, running bun install is enforced during worktree setup to guarantee ready-to-run environments. This skill uses bun install to ensure dependencies are properly installed and isolated within each parallel development worktree.

How do I clean up and remove a git worktree while keeping the repository clean?

Cleaning up a git worktree involves removing the directory and pruning references. This skill automates worktree removal and prunes stale references to ensure the repository remains clean after parallel development is finished.

Why does parallel development require allocated ports and copied .env files?

Parallel development requires allocated ports and copied .env files to prevent runtime conflicts between isolated environments. This skill enforces these requirements during worktree creation so concurrent features can be tested independently without port or configuration collisions.