repoclean-cli 0.5.0

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

repoclean

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

Most developers (especially students) accidentally commit junk and sensitive files at least once:

• __pycache__/, *.pyc, venv/, node_modules/
• .env files
• API keys/tokens and private keys

These mistakes are common, embarrassing, and sometimes expensive.

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

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

Commands

Scan repo hygiene issues

repoclean scan

Create a default .gitignore

repoclean 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

repoclean install-hook

Uninstall:

repoclean uninstall-hook

Notes

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