v1.0.0 — open source

Your codebase
has a heartbeat.

One command reveals everything wrong with your project. Dependencies, git health, security, tests — scored, graded, and fixed.

Star—
bash — ~/my-project
❯ check-project-health  🏥 PROJECT HEALTH REPORT ──────────────────────────────────── Analyzing 6 health indicators...  ✅ Dependencies 92/100 1 package outdated (patch) ✅ Git 88/100 Branch: main, 2 days since commit ⚠️ Code Quality 64/100 14 TODOs, 3 FIXMEs found ✅ Environment 100/100 .env matches .env.example ❌ Tests 30/100 No test configuration found ✅ Security 95/100 1 low vulnerability  ──────────────────────────────────── Overall Score: 78/100 Grade: B (Good)  💡 Top fix: Add jest.config.js to boost Tests score by +50❯

The Problem

Stop juggling 5 tools
for one answer.

Every developer checks the same things daily — spread across different CLIs, dashboards, and tabs. check-project-health bundles it all.

📦npm outdated — for dependencies✕
🔀git status / git log — for repo state✕
🔍grep -r "TODO" — for code smell✕
🛡️npm audit — for vulnerabilities✕
🧪npm test — for test coverage✕
🏥

check-project-health

One command.
One score.
All the context you need.

Features

Six health indicators.
One score.

Each checker runs in parallel. Results are weighted, aggregated, and graded A–F so you know exactly where to focus.

📦
Dependencies
Detects outdated packages, classifies them by severity (major/minor/patch), and gives you the exact update command.
⬥ Weight: 25%
🔀
Git Health
Checks untracked files, days since last commit, unpushed changes, and current branch status in one glance.
⬥ Weight: 20%
🔍
Code Quality
Scans every source file for TODO, FIXME, HACK, and BUG comments. Groups by file so you know where the debt lives.
⬥ Weight: 15%
🔐
Environment
Compares your .env against .env.example. Flags missing keys or undocumented secrets before they break production.
⬥ Weight: 20%
🧪
Tests
Verifies test setup, finds test files, and checks for a test framework config. Optionally runs tests and reports results.
⬥ Weight: 10%
🛡️
Security
Runs npm audit, parses vulnerabilities by severity, and surfaces actionable fix commands from the audit output.
⬥ Weight: 10%

How it works

Three steps.
Total clarity.

1
Run the command

Type check-project-health in any project directory. No config file needed. It auto-detects your stack.

2
Parallel analysis

All 6 checkers run simultaneously using Promise.allSettled — results in seconds, not minutes. No checker can crash the rest.

3
Scored report

Get a weighted score, letter grade, per-checker breakdown, and the most impactful fixes ranked by score improvement.

Get started

Ready in 10 seconds.

Install globally, run anywhere.

1npm install -g check-project-health
2cd your-project && check-project-health

Requires Node.js 18+. Works on macOS, Linux, and Windows.