React Doctor scans the bad React your agent just shipped
Million.co's React Doctor is on a tear — 7,985 stars total, +340 today, latest push May 11. The pitch in the README is unusually honest: your agent writes bad React, this catches it. Anyone who has shipped Claude Code or Cursor output to a production React app knows the exact failure modes — missing dependency arrays, render-time state mutations, unnecessary state updates, accessibility holes. ESLint catches some of this. React Doctor is built to catch the rest.
The tool scans a codebase and produces a single 0-100 health score: Great at 75 and up, Needs work 50 to 74, Critical under 50. It runs as CLI, GitHub Action, ESLint plugin, oxlint plugin, or Node API. The framework-aware part matters — it auto-adjusts rules for Next.js, Vite, React Native, and whichever React version it detects, instead of demanding configuration files.
The structurally interesting move is the second install command: npx -y react-doctor@latest install. That installs the rules into the agent's context — Claude Code, Cursor, Codex — so the agent stops shipping the broken patterns in the first place. This is the pattern that AGENTS.md and SKILL files have been formalizing: feed the linter back upstream into the agent's prompt, not just into CI.
The category around this is filling out fast. ECC (everything-claude-code) carries the harness layer, KodHau handles tribal knowledge, AgentTrust constrains, PrefixGuard predicts failure, and now React Doctor catches the framework-specific anti-patterns. Vibe-coded React from large-context agents needs domain-aware guardrails, or it ships subtle perf and a11y bugs. Open source, MIT, free.
Repo: https://github.com/millionco/react-doctor
Site: https://react.doctor
← Back to all articles
The tool scans a codebase and produces a single 0-100 health score: Great at 75 and up, Needs work 50 to 74, Critical under 50. It runs as CLI, GitHub Action, ESLint plugin, oxlint plugin, or Node API. The framework-aware part matters — it auto-adjusts rules for Next.js, Vite, React Native, and whichever React version it detects, instead of demanding configuration files.
The structurally interesting move is the second install command: npx -y react-doctor@latest install. That installs the rules into the agent's context — Claude Code, Cursor, Codex — so the agent stops shipping the broken patterns in the first place. This is the pattern that AGENTS.md and SKILL files have been formalizing: feed the linter back upstream into the agent's prompt, not just into CI.
The category around this is filling out fast. ECC (everything-claude-code) carries the harness layer, KodHau handles tribal knowledge, AgentTrust constrains, PrefixGuard predicts failure, and now React Doctor catches the framework-specific anti-patterns. Vibe-coded React from large-context agents needs domain-aware guardrails, or it ships subtle perf and a11y bugs. Open source, MIT, free.
Repo: https://github.com/millionco/react-doctor
Site: https://react.doctor
Comments