worktree-manager-skill

Manage git worktrees for parallel branch development with isolated environments.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/qdhenry/Foundry-OSS --skill worktree-manager-skill-qdhenry
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-manager-skill
Source: https://github.com/qdhenry/Foundry-OSS/tree/main/.agents/skills/worktree-manager-skill
Command: npx skills add https://github.com/qdhenry/Foundry-OSS --skill worktree-manager-skill-qdhenry

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides centralized and automated management of git worktrees, enabling teams to create, list, remove, and monitor isolated development environments across multiple branches without manual git worktree commands.

Core Features & Use Cases

  • Create isolated worktrees for different branches to develop in parallel without switching branches.
  • List all existing worktrees with their port mappings, statuses, and access URLs to quickly triage environments.
  • Remove a worktree, stopping services, cleaning up directories, and freeing ports to prevent conflicts.
  • Use cases include feature development, PR isolation, hotfix experimentation, and automated testing across parallel branches.

Quick Start

Ask me to create a worktree for a branch, for example: /create_worktree feature-xyz.

Frequently Asked Questions about worktree-manager-skill

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

FAQPage Schema
How do I manage git worktrees for parallel development across multiple branches?

You can manage git worktrees for parallel development by applying automated commands to create, list, and remove isolated environments across multiple branches without manual git worktree commands. This handles port isolation, configuration, and safe cleanup.

What is the best way to isolate feature development environments without switching git branches?

Isolating feature development environments is best achieved by creating separate git worktrees for each branch. This allows you to develop features in parallel directories, maintaining isolated configurations and port mappings without constantly switching branches.

How do I list all active git worktrees and their port mappings?

To list all active git worktrees, you apply a command that returns existing worktrees alongside their port mappings, statuses, and access URLs. This provides a quick overview to triage parallel environments and identify potential conflicts.

Can I automate worktree cleanup to stop services and free ports after removing a branch?

Yes, you can automate worktree cleanup by applying a remove command that safely deletes the worktree. This process stops active services, cleans up directories, and frees allocated ports to prevent conflicts across your parallel development workflow.

Do I need manual git commands to set up isolated dev environments for PR testing?

No, you do not need manual git commands to set up isolated dev environments for PR testing. The orchestration skill automates the end-to-end lifecycle, including environment creation, port isolation, configuration, and safe removal for automated testing.

When should I use git worktrees for parallel branch workflows?

You should use git worktrees for parallel branch workflows when you need isolated environments for feature development, PR isolation, hotfix experimentation, or automated testing across multiple branches simultaneously without stashing or switching contexts.