worktree-manager

Manage Git worktree creation, listing, status, and removal with branch options.

Updated Jan 2, 2026
One-click install
npx skills add https://github.com/SpiceLabsHQ/Reaper --skill worktree-manager-spicelabshq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: worktree-manager
Source: https://github.com/SpiceLabsHQ/Reaper/tree/main/skills/worktree-manager
Command: npx skills add https://github.com/SpiceLabsHQ/Reaper --skill worktree-manager-spicelabshq

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a robust and safe way to manage Git worktrees, preventing common errors like shell breakage due to incorrect CWD handling during removal.

Core Features & Use Cases

  • Safe Worktree Creation: Creates new worktrees with proper naming conventions and optional dependency installation.
  • Comprehensive Listing: Lists all worktrees with detailed status, including changes and unmerged commits.
  • Safe Removal: Ensures worktrees are removed without breaking the shell, with options to keep or delete branches, and includes AI remediation guides for complex scenarios.
  • Use Case: When developing a new feature, create a dedicated worktree for it, and when done, safely remove it along with its branch, ensuring no data is lost and the shell remains functional.

Quick Start

Safely remove the worktree located at './trees/PROJ-123-auth' and delete its associated branch.

Frequently Asked Questions about worktree-manager

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

FAQPage Schema
How do I safely remove a git worktree without breaking my shell?

To safely remove a git worktree without breaking your shell, change to the project root directory before executing cleanup commands. This Skill handles CWD errors automatically during worktree removal, preventing shell breakage while offering explicit branch disposition options.

What is the best way to manage multiple git worktrees during feature development?

Managing multiple git worktrees during feature development is best handled through a full lifecycle approach. This includes safe creation with proper naming conventions, comprehensive listing with status checks, and safe removal with options to either keep or delete associated branches.

How do I delete a git worktree and its branch at the same time?

You can delete a git worktree and its branch simultaneously by using the --delete-branch flag during removal. This Skill provides explicit branch disposition options, allowing you to choose between --keep-branch or --delete-branch for safe and complete cleanup.

Why does my shell break when removing a git worktree?

Your shell breaks when removing a git worktree if your current working directory is inside the worktree being deleted. This Skill prevents CWD errors by automatically changing to the project root before cleanup, ensuring your shell remains fully functional.

How do I fix git worktree lock errors and timeouts during cleanup?

To fix git worktree lock errors and timeouts during cleanup, follow AI remediation guides that address these specific complex scenarios. This Skill includes built-in troubleshooting guides for timeouts and lock errors to ensure successful worktree removal.

Can I list all git worktrees and check their unmerged commit status?

Yes, you can list all git worktrees and check their unmerged commit status using comprehensive listing features. This provides detailed status for each worktree, including pending changes and unmerged commits, to help you track development workflow progress.