v0.5.2 — 33 checks, 8 categories

Score any Git repository's health in seconds

Name: RepoHealth
Author: spbuilds

33 checks across docs, tests, CI, security, dependencies, and activity. Offline, deterministic, CI-ready.

RepoHealth is a repository health scoring tool that analyzes any Git repository and generates a health score based on documentation quality, test coverage, CI/CD configuration, dependency management, security signals, and project activity — all from a single command.

terminal

$ go install github.com/spbuilds/repohealth/cmd/repohealth@latest$ repohealth --versionrepohealth version v0.5.2

View on GitHub ⭐ Star on GitHub

repohealth

$ repohealth .

RepoHealth v0.5.2

Overall Score:77 / 100Grade: B

✓Documentation14 / 15

✓Testing17 / 20

✓CI/CD15 / 15

✓Dependencies8 / 9

✓Security8 / 10

✓Code Statistics5 / 5

✓Activity13 / 15

◐TODO / Debt4 / 7

Analyzed popular repositories including

PrometheusKubernetesGinTerraformReactDjango

See it in action

One command. Full report in under 100ms.

demo

We scored 17 well-known repos

Measures repository hygiene and conventions, not code quality. Even excellent projects can score lower if they don't follow standard GitHub conventions.

#	Repository	Score	Grade
1	prometheus	85	A-
2	gin	85	A-
3	terraform	83	B+
4	docker/compose	82	B+
5	grafana	81	B+
6	react	77	B
7	next.js	73	B-
8	rails	68	C+
9	fastapi	68	C+
10	cpython	68	C+
11	flask	67	C+
12	django	66	C+
13	kubernetes	64	C
14	vue	63	C
15	express	54	D
16	laravel	53	D
17	golang/go	51	D

How does your repo score?

Run it on any local Git repository. One command, instant results.

$ repohealth .$ repohealth /path/to/any/repo

33 checks across 8 categories

Every check is deterministic — same repo always gets the same score.

📄

Documentation

README, LICENSE, CONTRIBUTING, SECURITY, CHANGELOG, CODE_OF_CONDUCT

🧪

Testing

Test files, framework, coverage config, test-to-source ratio

⚙️

CI/CD

Config exists, runs tests, runs linter, runs build

📦

Dependencies

Lockfile, package manager, freshness, dependency count

🔒

Security

No secrets, .gitignore coverage, dep pinning, branch protection

📊

Code Statistics

Source files, language diversity, comment ratio, vendor bloat

📈

Activity

Recent commit, frequency, contributors, releases, bus factor

🔧

TODO / Debt

TODO/FIXME count, density per KLOC, critical markers

Three commands to repo health

Install

go install github.com/spbuilds/repohealth/cmd/repohealth@latest

Single binary, zero runtime dependencies

Run

repohealth .

Point it at any local Git repository

Get Score

Score: 77/100 (B)

0-100 score with letter grade + improvement plan

CI quality gate in 3 lines

Add a health threshold to your pipeline. Exit 0 if score meets threshold, exit 2 if below. Works with GitHub Actions, GitLab CI, CircleCI, and any CI system.

exit 0 → score ≥ threshold

exit 2 → score < threshold

.github/workflows/health.yml

name: Repo Health Check
on: [push, pull_request]

jobs:
  health:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-go@v5
      - run: |
          go install github.com/spbuilds/repohealth/cmd/repohealth@latest
          repohealth . --ci --threshold 70

Four output formats

Terminal

default

JSON

--format json

Markdown

--format markdown

HTML

--format html