React Doctor v1
We built React Doctor to answer one question about a React codebase: is it getting better or worse?
Point it at a React project and get a single 0-100 health score, plus the diagnostics behind it.
npx react-doctor@latestOne number, deterministic
The score is the headline. React Doctor runs on top of oxlint, so a full scan takes seconds, and the same commit always produces the same number. That determinism is the whole point. It makes the score worth tracking instead of a vibe that shifts between runs.
The terminal puts the score front and center, with a little doctor that reacts to how healthy the code is, then lists each diagnostic underneath with the file, line, rule, and a plain recommendation. Counts are colored and iconed by severity so the serious stuff stands out.
It already knows your project
Before it scans, React Doctor detects your framework, React version, and language, then quietly enables the rules that fit. Monorepos work too: it finds the projects and scans the one you point it at, even in CI.
Fixing, not just flagging
A linter that only complains is half a tool. --fix hands the diagnostics to a
coding agent to work through, and --prompt copies a clean, agent-ready summary
to your clipboard so you can paste it anywhere.
From the very first run, React Doctor also offers to install a skill so your agent learns to run it on its own, without you pasting instructions every time.
In CI
There's a GitHub Action from day one, so the score shows up on every push and you can watch the trend instead of guessing.
It's a small tool with a big claim: that codebase health can be one number you actually trust.