nimbus health

Run a codebase health scan with 6 metrics. Tracks quality trends over time.

Usage

nimbus health
nimbus health ./path/to/repo

Output

  ◆ codebase health scan  acme-api

  test coverage     ████████░░  82%
  tech debt         ███████░░░  74%
  security          █████████░  93%
  doc coverage      ██████░░░░  61%
  dep freshness     █████████░  94%

  overall  B+  81/100

Metrics

Metric	How it's measured
Test coverage	Test file count ratio, or pytest --cov if available
Tech debt	Claude Haiku analysis of code complexity, naming, error handling
Security	Heuristic scan for hardcoded secrets and SQL injection patterns
Doc coverage	% of public functions with docstrings
Dep freshness	% of dependencies that are up to date (pip list --outdated)
CI pass rate	Estimated from recent build history

Grading

Score	Grade
95+	A+
90-94	A
85-89	B+
80-84	B
75-79	C+
70-74	C
60-69	D
<60	F

API

Health snapshots are stored and available via the REST API:

# Trigger a hosted scan
POST /health-reports/{repo_id}/scan

# Get latest snapshot
GET /health-reports/{repo_id}

# Get historical trend
GET /health-reports/{repo_id}/history

Dashboard

View health trends over time at get-nimbus.com/dashboard/health.