GitHub Repo Cleaner

Tools and workflows to help you discover and manage disposable GitHub repositories.

Features

• List, suggest, delete, and archive repositories after analysing inactivity, stars, forks, and custom rules.
• Interactive deletion and archiving prompts with optional bulk modes plus double confirmation to avoid accidents.
• Configurable ruleset (config.toml) to protect templates/profile repos, blacklist (protected repos), and auto-delete pristine forks.
• Config lives under the OS config directory (e.g. ~/.config/github-repo-cleaner/config.toml) but still honours ./config.toml when present.
• Fixture support via --input for offline testing.

Getting started

# build the tool
cargo build --release

# run a suggestion sweep for your authenticated user
GITHUB_TOKEN=... target/release/repo-clean suggest

# archive stale repos, one by one
GITHUB_TOKEN=... target/release/repo-clean archive --filter archive

Configuration

Copy the generated config template, then adjust the [rules] table to tune thresholds, templates, or protected repositories. Use protected_repositories = ["org/repo"] to skip specific repos permanently.