What is react-doctor?

React Doctor is a command-line tool that scans React codebases for common mistakes and problems. It was built with AI coding agents in mind, since agents that write React code often introduce subtle errors related to state management, side effects, performance, application structure, security, and accessibility. The tool checks for these issues deterministically, meaning it applies consistent rules rather than making judgment calls. The most basic use is a one-time audit. Running a single command in your project folder scans the codebase and produces a report of issues found. No installation is required for this quick start because it runs through npx. Once you have seen the results, you can install a companion skill that teaches your coding agent, such as Claude Code or Cursor, about the patterns to avoid so it makes fewer of those mistakes going forward. React Doctor also integrates into automated pull request workflows. A setup command adds a configuration file to your repository that runs the tool on every pull request and posts a summary comment with only the new issues introduced by that specific change, not every pre-existing problem in the codebase. This keeps the feedback focused and avoids noise. GitHub Actions is fully supported, and there is a gate-only configuration for GitLab CI. The tool works across common React environments including Next.js, Vite, TanStack, React Native, and Expo. Rules can be customized through a configuration file. By default, the CLI sends anonymous usage data such as your framework version and which rules triggered to help the developers prioritize work, but this can be turned off with a flag. The project is MIT licensed.