git-clean-up 🧹

An audit-first CLI tool for cleaning local git repository hygiene. It scans for stale branches, forgotten stashes, and suspicious worktrees, then lets you selectively clean them with explicit confirmation.

Features

• Audit-First Workflow: scan inspects repository hygiene without mutating anything, and clean previews changes unless --apply is explicitly set.
• Grouped Findings: Results are organized by branches, stashes, and worktrees with per-item reasons and risk hints.
• Branch Hygiene Detection:
  • merged branches
  • branches whose upstream is gone
  • branches with no upstream
  • significantly diverged branches
  • squash-merged branches
• Stash Hygiene Detection:
  • old stashes
  • stale WIP stashes
  • duplicate-message stashes
• Worktree Hygiene Detection:
  • missing-path worktrees
  • detached-head worktrees
  • protected-branch worktrees
  • worktrees pointing at stale branches
• Safety First:
  • Protected branches (main, master, develop, dev) are not surfaced as branch cleanup candidates.
  • Branches active in other worktrees are excluded from branch deletion candidates.
  • clean is a preview by default.
  • Explicit confirmation is required before applying cleanup actions unless --all is used.

Installation

You can run it directly without installation:

pnpx @kurokeita/git-clean-up

Or install it globally to your system:

pnpm install -g @kurokeita/git-clean-up

Usage

# Start an interactive repository scan
git-clean-up

# Audit all hygiene categories and return JSON
git-clean-up scan --json

# Focus on branch and worktree findings only
git-clean-up scan --include branches,worktrees

# Preview cleanup actions without mutating the repo
git-clean-up clean --include branches --all

# Apply the selected cleanup actions
git-clean-up clean --include branches,stashes --apply

# Use a different merge target and age threshold
git-clean-up scan --target develop --age-days 14

Development

pnpm install
pnpm dev          # Run in development mode
pnpm test         # Run tests
pnpm run check    # Run linting and type checking
pnpm run build    # Build for production

License

GPL-3.0