# react-doctor

> CLI and agent skill that audits React code for common anti-patterns

react-doctor is an open-source static analysis and performance auditing tool built specifically for React applications. It scans codebases for state, effect, architecture, accessibility, and performance issues, highlighting common pitfalls often introduced by AI coding assistants. It works locally via the CLI, integrates as a skill in tools like Claude Code and Cursor, and runs in CI pipelines.

Website: https://github.com/millionco/react-doctor

## What it is for

- Audit React codebases for anti-patterns and performance bottlenecks
- Install as an AI agent skill in Claude Code or Cursor to catch bad React patterns
- Run automated code health checks on pull requests in GitHub Actions or GitLab CI
- Record Chrome DevTools performance traces against local React dev servers

## Features

- Deterministic static scanning across Next.js, Vite, Astro, Expo, and React Native
- Agent skill installation for Claude Code, Cursor, Codex, and OpenCode
- CI PR reviews reporting only newly introduced issues rather than backlogs
- Runtime performance tracing with visual re-render outlines in Chrome
- Custom rule configuration via doctor.config.ts
- Detection of state/effect bugs, duplicated JSX trees, and complex functions

## Pricing

Open source. Free and open source (MIT license)

## Details

- Type: Web app
- Category: [Development](https://xiry.app/topics/development.md)
- Open source: yes
- Platforms: Command line, Linux, macOS, Windows
- For: React and Next.js developers, especially those using AI coding agents
- Alternative to: ESLint, Biome
- Tags: react, nextjs, cli, ai agents, linter, code quality, performance

## Why it was saved

- [@aidenybai, 26 May 2026](https://x.com/aidenybai/status/2059303624266977296): Automated React code health checking and fixing for AI-written code; runs as one command and integrates as an agent skill.

## Compare

- [Alternatives to ESLint](https://xiry.app/alternatives/eslint.md)

## Related

- [react-best-practices](https://xiry.app/resources/react-best-practices): Curated React performance rules and coding-agent skills by Vercel (GitHub repo, Open source)
- [agent-skills](https://xiry.app/resources/agent-skills): Curated skills and performance rules for AI coding agents by Vercel. (GitHub repo, Open source)
- [Above-the-Fold Deferred Rendering Pattern](https://xiry.app/resources/above-the-fold-deferred-rendering-pattern): Performance pattern for deferring below-the-fold components to accelerate perceived page load. (Tip, Free)
- [shadcn Registry Directory](https://xiry.app/resources/shadcn-registry-directory): Discover and pull third-party component registries directly via the shadcn CLI (Website, Free)
- [shadcn/ui](https://xiry.app/resources/shadcn-ui-1902): Copy-paste React UI components built with Tailwind CSS and Radix primitives. (Website, Open source)
- [agent-browser](https://xiry.app/resources/agent-browser): Browser automation CLI and engine purpose-built for AI agents (GitHub repo, Open source)

Updated 10 October 2026. Page: https://xiry.app/resources/react-doctor

Make your own library: Xiry takes your saved reels, tweets, Reddit bookmarks and Watch Later videos, makes them searchable and pulls the useful stuff out, like this library. It's invite-only for now; join the waitlist at https://xiry.app/#waitlist.