repoclean-cli 0.6.0

Repo hygiene scanner and fixer (junk files, secrets, gitignore).

Repoclean (CLI) v0.6.0

A repo hygiene CLI tool to scan repositories for common junk artifacts, detect secret/token patterns, and optionally install a Git pre-commit hook to prevent leaks.

Why repoclean exists

repoclean is a small CLI tool meant to be run before pushing to GitHub. It helps you quickly:

• spot repo hygiene issues
• detect secret/token patterns
• block accidental leaks via an optional Git pre-commit hook

Demo

Install

pip install repoclean-cli

Quick Start

repoclean scan
repoclean secrets

CI usage

repoclean ci
repoclean scan --fail-on sensitive,large
repoclean secrets --fail

Typical workflow

repoclean scan
repoclean secrets --fail
repoclean fix --yes
repoclean install-hook --mode strict

Secrets severity + CI

repoclean secrets --min-severity high
repoclean secrets --fail-on critical
repoclean ci --json

Command

Scan repo hygiene issues

repoclean scan

Create a default .gitignore

repoclean init

Config

Create a .repoclean.toml config file:

repoclean config init

Safely clean junk files/folders

Preview:

repoclean fix --dry-run --verbose

Apply cleanup:

repoclean fix --yes

Scan for secrets/tokens

repoclean secrets

Fail mode (useful for CI and hooks):

repoclean secrets --fail

Install git pre-commit hook

Install (strict mode blocks commit on issues):

repoclean install-hook --mode strict

Install (warn mode prints warnings but allows commit):

repoclean install-hook --mode warn

Uninstall:

repoclean uninstall-hook

Hook utilities:

repoclean hook status
repoclean hook print --mode warn
repoclean hook print --mode strict

Notes

• repoclean is the command name.
• The PyPI package name is repoclean-cli.