Will I accidentally delete my main working directory?

No, the skill includes specific error handling and safety checks to ensure you do not remove your primary repository worktree.

What does the worktree-cleanup skill do?

It provides a guided, safe process for removing Git worktrees that are no longer needed, such as those used for branches that have already been merged into the main codebase.

Why should I use worktrees instead of standard branches?

Worktrees allow you to have multiple branches checked out in separate directories at the same time; this skill helps manage the cleanup once those parallel tasks are complete.

Can I use this to clean up multiple worktrees at once?

The skill can facilitate the removal of individual worktrees by path or trigger automated scripts to clean all merged worktrees in bulk.

Does it check for uncommitted changes before deletion?

Yes, the skill enforces a safety check that verifies no uncommitted work exists in the target worktree, prompting the user to commit or stash changes first.

Git Worktree Cleanup

Name: Git Worktree Cleanup
Author: mvillmow

bymvillmow

•

Developer Tools

Removes merged or stale Git worktrees safely to reclaim disk space and maintain an organized development environment.

The worktree-cleanup skill provides a standardized workflow for managing the lifecycle of Git worktrees. It automates the identification and removal of directories associated with merged Pull Requests or completed tasks, ensuring that developers can keep their local repositories clean without the risk of deleting uncommitted code. By incorporating safety checks—such as verifying PR status on GitHub and ensuring no local changes are pending—it streamlines post-development maintenance while preventing accidental data loss.

Key Features

01Safety verification for uncommitted changes and PR status

0212 GitHub stars

03Integration with automated cleanup scripts like scripts/cleanup_merged_worktrees.sh

04Automated identification of merged or stale worktrees

05Safeguards to prevent accidental deletion of the primary worktree

06Workflow guidance for switching out of active worktrees

Use Cases

01Organizing complex local environments when working on multiple PRs simultaneously

02Automating the post-merge cleanup process as part of a developer's daily workflow

03Reclaiming disk space after merging several high-volume feature branches

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mvillmow/projectodyssey worktree-cleanup

For use in Claude.ai and ChatGPT

Download Skill