Is it possible for this skill to delete active work?

No. The skill performs multiple safety checks and will skip any worktree that has unpushed code, local modifications, or an open/unmerged pull request.

Does this skill require the GitHub CLI?

Yes, the skill uses the 'gh' CLI to accurately verify the merge status of pull requests before taking any destructive action.

What happens to the git metadata after a worktree is removed?

The skill automatically runs 'git worktree prune' after deletions to ensure that Git's internal tracking remains clean and synchronized.

Can I use this for automated repository housekeeping?

Yes, this skill is specifically designed to integrate with housekeeping workflows, providing detailed metrics on checked, kept, and removed worktrees.

What does this skill consider a 'dangling' worktree?

A worktree is considered dangling only if its associated branch has a confirmed merged pull request, contains no uncommitted changes, and has no unpushed commits.

Git Worktree Cleanup

Name: Git Worktree Cleanup
Author: bacchus-labs

bybacchus-labs

•

Developer Tools

Safely removes Git worktrees associated with merged pull requests to maintain a clean and organized development environment.

The cleanup-dangling-worktrees skill automates the maintenance of Git worktrees by identifying and removing directories linked to successfully merged GitHub pull requests. It prioritizes data integrity through a multi-step safety protocol, ensuring that worktrees are only deleted if they have no uncommitted changes, no unpushed commits, and a confirmed 'MERGED' status on GitHub. This tool is essential for developers who leverage worktrees for concurrent feature development and want to avoid the manual overhead of pruning stale metadata and directories.

Key Features

01Comprehensive execution reporting and metrics

02Safe removal using native git worktree commands

03Automated safety checks for uncommitted and unpushed changes

04GitHub PR status verification via GitHub CLI (gh)

053 GitHub stars

06Automatic stale metadata pruning

Use Cases

01Syncing local worktree state with remote pull request status

02Freeing up local disk space by removing obsolete feature worktrees

03Automating repository housekeeping during routine maintenance cycles

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bacchus-labs/wrangler cleanup-dangling-worktrees

For use in Claude.ai and ChatGPT

Download Skill