fleet-managing-worktrees

Create, fan out, and prune git worktrees for parallel sessions.

125|42|Updated May 19, 2025
One-click install
npx skills add https://github.com/SocketDev/socket-mcp --skill fleet-managing-worktrees
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fleet-managing-worktrees
Source: https://github.com/SocketDev/socket-mcp/tree/main/.agents/skills/fleet-managing-worktrees
Command: npx skills add https://github.com/SocketDev/socket-mcp --skill fleet-managing-worktrees

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manages git worktrees per the fleet's parallel-Claude-sessions rule. Creates new task-worktrees, fans out one worktree per open PR for parallel review, and prunes spent worktrees that have nothing left to land — clean trees whose branch was deleted upstream OR is fully merged into the remote default branch. Use when starting a task that needs an isolated working tree, when reviewing every open PR locally without disturbing the primary checkout, or when cleaning up after merges.

Core Features & Use Cases

  • Creates new task worktrees based on a remote default branch.
  • Fans out one worktree per open PR for parallel reviews.
  • Prunes spent worktrees that have nothing left to land, honoring safety constraints on deleted or merged branches.

Quick Start

Start a new task by specifying a task name to create a dedicated worktree beside your main checkout.

Frequently Asked Questions about fleet-managing-worktrees

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

FAQPage Schema
How do I manage git worktrees for parallel Claude sessions?

Git worktrees for parallel Claude sessions are managed by automating the creation, fan-out, and cleanup of isolated working trees. This ensures each session operates independently without disturbing the primary checkout.

Can I review multiple open PRs locally using git worktrees?

Reviewing multiple open PRs locally is supported by fanning out one worktree per open pull request. This allows parallel PR reviews across isolated working trees without affecting your main repository checkout.

What is the best way to clean up spent git worktrees after a merge?

Cleaning up spent git worktrees after merges involves pruning trees with nothing left to land. This targets clean trees whose branches were deleted upstream or are fully merged into the remote default branch.

How do I create a new isolated worktree for a development task?

Creating a new task worktree requires specifying a task name to generate a dedicated working tree beside your main checkout. This tree is based on the remote default branch to ensure a clean starting point.

What safeguards exist when pruning stale git worktrees?

Pruning stale git worktrees includes safeguards to avoid deleting unpushed or in-use trees. The cleanup process only removes spent worktrees that have nothing left to land, preventing accidental data loss.

Do I need a specific repository setup to use parallel worktrees for PR review?

Using parallel worktrees for PR review requires a git repository with a defined remote default branch. The automation depends on identifying open PRs and establishing isolated working trees based on that upstream branch.