git-worktree-manager

Create and clean up isolated Git worktrees with port and environment synchronization.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/Veloxia-agency/VELOXIA-WEB --skill git-worktree-manager-veloxia-agency
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-worktree-manager
Source: https://github.com/Veloxia-agency/VELOXIA-WEB/tree/main/.claude/skills/engineering/skills/git-worktree-manager
Command: npx skills add https://github.com/Veloxia-agency/VELOXIA-WEB --skill git-worktree-manager-veloxia-agency

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill removes the friction and risk of developing multiple branches locally at the same time by keeping each worktree isolated, synchronized, and easy to clean up.

Core Features & Use Cases

  • Parallel branch setup: Create a new worktree from an existing or new branch with predictable naming and placement.
  • Isolated runtime environments: Allocate non-conflicting ports, copy environment files, and prepare each worktree to run like its own local app.
  • Safe cleanup workflows: Detect stale, dirty, and merged worktrees before removing anything, reducing the chance of accidental data loss.
  • Use Case: A team can keep one worktree for main integration, another for a feature branch, and a third for a hotfix, each with its own ports and dependencies.

Quick Start

Ask the skill to create a new worktree for your target branch and worktree name, then prepare ports, sync environment files, and install dependencies if needed.

Frequently Asked Questions about git-worktree-manager

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

FAQPage Schema
How do I run parallel Git worktrees without causing port or environment collisions?

To run parallel Git worktrees safely, you need deterministic port allocation and .env synchronization to isolate each runtime environment. This Skill coordinates safe worktree creation, copying environment files and assigning non-conflicting ports to prevent collisions during parallel feature development.

What's the best way to clean up stale or dirty Git worktrees without losing data?

The best way to clean up dirty Git worktrees safely is to detect stale, dirty, and merged branches before removal. This Skill performs dirty-tree checks and merged-branch detection to reduce the chance of accidental data loss during stale worktree maintenance.

Can I use Git worktrees for multi-agent workflows and hotfix isolation?

Yes, you can use Git worktrees for multi-agent sessions and hotfix isolation. This Skill supports parallel feature development by preparing isolated runtime environments, allowing a team to keep separate worktrees for main integration, features, and hotfixes simultaneously.

How do I sync .env files and install dependencies when creating a new Git worktree?

To sync .env files and install dependencies in a new Git worktree, request worktree creation with optional dependency installation. This Skill copies environment files, allocates predictable ports, and prepares each worktree to run like its own local application.

Does Git worktree management support JSON or text output for CLI automation?

Yes, Git worktree management supports JSON or text CLI automation. This Skill provides text and JSON output formats, enabling automated scripts to handle worktree creation, environment synchronization, and cleanup workflows programmatically.