git-worktree

Create, sync, and remove Git worktrees for isolated agent environments.

23|5|Updated Nov 5, 2025
One-click install
npx skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill git-worktree-jstarfilms
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: git-worktree
Source: https://github.com/JStaRFilms/VibeCode-Protocol-Suite/tree/main/assets/.agent/skills/git-worktree
Command: npx skills add https://github.com/JStaRFilms/VibeCode-Protocol-Suite --skill git-worktree-jstarfilms

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinate and manage multiple Git worktrees to isolate agent development environments, reducing path juggling and merge conflicts.

Core Features & Use Cases

  • Create Agent Environment: Create a new worktree for a specific agent or feature, with a dedicated folder and branch.
  • SYNC: Synchronize changes across worktrees with origin/main and prune stale entries.
  • KILL / Teardown: Remove a worktree and clean up branches when no longer needed.
  • Real-world use: Setting up parallel agents for different features to test integration without polluting main.

Quick Start

Create a new worktree for a feature and then verify it using git worktree list.

Frequently Asked Questions about git-worktree

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

FAQPage Schema
How do I manage parallel Git worktrees for isolated development environments?

To manage parallel Git worktrees, you can create dedicated folders and branches for specific features or agents, isolating development environments to reduce path juggling and merge conflicts.

What is the best way to set up parallel branches for agent development without polluting main?

Setting up parallel worktrees for feature branches allows multiple agents to test integration independently. Each worktree uses a dedicated folder and branch, keeping your main branch clean.

How do I synchronize changes across Git worktrees with the main branch?

You can synchronize changes across Git worktrees by running a sync operation that updates them with origin/main and prunes stale entries to maintain a clean version control state.

Can I automate Git branch naming conventions and folder layouts when creating a worktree?

Yes, when creating a new worktree, the process supports automated branch naming conventions, specific folder layouts, validation steps, and post-setup environment bootstrap configurations.

How do I remove a Git worktree and clean up its feature branch?

To remove a Git worktree, you can use a teardown or kill operation that deletes the worktree directory and cleans up the associated branch when it is no longer needed.