git-cleanup 🧹

A CLI tool to clean up your git repositories. Delete merged branches, find stale branches, remove branches with deleted remotes, and identify large files in your git history.

Installation

# Install globally
npm install -g git-cleanup-cli

# Or run directly with npx
npx git-cleanup-cli <command>

Usage

git-cleanup <command> [options]

Commands

| Command | Description | |---------|-------------| | merged | List and delete branches already merged into main/master | | stale | Find branches with no commits in the last N days | | gone | Delete local branches whose remote tracking branch was deleted | | large | Find large files in git history | | all | Run all cleanup checks at once | | prune | Prune remote tracking branches |

Options

| Option | Description | |--------|-------------| | --days <n> | Days threshold for stale branches (default: 30) | | --dry-run | Preview what would be deleted without deleting | | --force | Delete without confirmation prompts | | --top <n> | Number of large files to show (default: 10) |

Examples

Delete merged branches

git-cleanup merged

🧹 git-cleanup

📋 Merged Branches
   Found 3 merged branch(es):

   • feature/old-login
   • fix/typo
   • chore/deps-update

   Delete 3 merged branch(es)? [y/N] y
   ✓ Deleted feature/old-login
   ✓ Deleted fix/typo
   ✓ Deleted chore/deps-update

   Deleted 3/3 branches

Find stale branches (60+ days inactive)

git-cleanup stale --days 60

📅 Stale Branches (>60 days)
   Found 2 stale branch(es):

   • experiment/ai-feature (120 days ago)
   • wip/refactor (85 days ago)

Find large files in history

git-cleanup large --top 5

📦 Large Files in History (top 5)

    15.2 MB  assets/video.mp4
     8.4 MB  data/dump.sql
     2.1 MB  node_modules.zip
   512.0 KB  images/hero.png
   256.0 KB  docs/guide.pdf

   Tip: Use 'git filter-repo' or BFG to remove large files from history

Preview all cleanup (dry run)

git-cleanup all --dry-run

Clean everything without prompts

git-cleanup all --force

Why?

Over time, git repos accumulate:

• Merged branches that were never deleted
• Stale branches from abandoned experiments
• Gone branches where the remote was deleted but local remains
• Large files accidentally committed to history

This tool helps you identify and clean up all of these in seconds.

License

MIT © Han Kim