Audit and clean up many GitHub repositories from the terminal: dead branches, unresolved review threads, branch-protection drift, and slow workflows. Every view works across an org or an explicit list of repos, so you never open one repo at a time.
# GitHub CLI extension
gh extension install kyleking/gh-sweep
# Go
go install github.com/KyleKing/gh-sweep/cmd/gh-sweep@latest
# from source
go build -o gh-sweep ./cmd/gh-sweepFind every branch whose PR merged or closed, across a whole org, and preview the cleanup before deleting anything:
gh sweep orphans --org my-org --cleanup --dry-runRun gh sweep with no arguments for the home menu, which reaches all thirteen
views. Each view prints its keys along the bottom of the screen.
- Update dependencies. Use Renovate or Dependabot
- Touch issues. The orphan sweep covers branches only
- Automate releases. The releases view reads release state and nothing more
- Follow a CI run live.
gha-perfreports history, so use watchgha to tail a run - Write anything in the webhooks, collaborators, secrets, or releases views,
which are read-only. Repo settings, security & analysis, release
immutability, branch protection, rulesets, and leftover-branch pruning are
the exception:
gh sweep policydiffs and applies those against a file you declare (see docs/alternatives.md)
Full docs: ./docs
MIT