Repo Audit
"Is this thing maintained?" in one deterministic pass.
Commands
python3 scripts/repo_audit.py . # this repo
python3 scripts/repo_audit.py ~/src --json # any repo
python3 scripts/repo_audit.py . --stale-days 60
python3 scripts/repo_audit.py . --fail-on license,tests
for d in ~/src/*/; do python3 scripts/repo_audit.py "$d" --json; done
Checks
| Check | Fail when |
|---|---|
license |
no LICENSE file |
readme |
no README |
tests |
no test files detected |
ci |
no CI config (GitHub Actions, GitLab CI, CircleCI) |
gitignore |
missing (untracked junk risk) |
large_files |
tracked files over 5MB (warn) |
stale_branches |
merged branches idle > --stale-days (warn) |
--fail-on a,b requires specific checks — the rest become advisory.
Pairs with
git-master (act on the stale branches this finds),
skill-audit (the same structural-hygiene idea, for agent skills),
diff-review (the per-change gate; this is the per-repo gate).