This connects Claude to a running React or React Native app via the DevTools protocol and exposes the component tree, props, state, hooks, and profiling data in a parseable format. You'd reach for it when debugging why something re-renders too often, profiling slow interactions, or inspecting component state without littering your code with console.logs. The CLI gives you stable component labels like @c1, @c2 that persist across commands, so you can get the tree, find the culprit, then drill into its props and render history. One catch: if you're using it with agent-browser, you must run in headed mode because headless Chromium won't execute the connection script properly. The profiling workflow is solid for isolating expensive commits and tracking down what props or state triggered each render.

skills.sh installs
2.7K
GitHub stars
252
last updated
Aug 21, 2026

Install

$ npx -y skills add callstackincubator/agent-react-devtools --skill react-devtools --agent claude-code

Installs into .claude/skills of the current project.

Files

agent-react-devtools

CLI that connects to a running React or React Native app via the React DevTools protocol and exposes the component tree, props, state, hooks, and profiling data in a token-efficient format.

Core Workflow

  1. Ensure connection — check agent-react-devtools status. If the daemon is not running, start it with agent-react-devtools start. Use agent-react-devtools wait --connected to block until a React app connects.
  2. Inspect — get the component tree, search for components, inspect props/state/hooks.
  3. Profile — start profiling, trigger the interaction (or ask the user to), stop profiling, analyze results.
  4. Act — use the data to fix the bug, optimize performance, or explain what's happening.

Essential Commands

Daemon

agent-react-devtools start              # Start daemon (auto-starts on first command)
agent-react-devtools stop               # Stop daemon
agent-react-devtools status             # Check connection, component count, last event
agent-react-devtools wait --connected   # Block until a React app connects
agent-react-devtools wait --component App # Block until a component appears

Sponsors

Details

Repository
github.com/callstackincubator/agent-react-devtools
Categories
Frontend Development, AI & Agent Building, Debugging, CLI & Terminal
First seen
May 16, 2026
1customware-ai avatarcustomware-support-widgetcustomware-ai/skillsUse this skill when adding, placing, configuring, or fixing the Customware support chat widget in the Customware React Router client-only SPA template. It cover2.6Kskills.sh installs
2vercel-labs avatarshadcnvercel-labs/json-renderPre-built shadcn/ui components for json-render. Use when working with @json-render/shadcn, adding standard UI components to a catalog, or building web UIs with 2.5Kskills.sh installs
3jwynia avatarfrontend-designjwynia/agent-skillsCreate distinctive, production-grade frontend interfaces with high design quality. Provides analysis tools for auditing existing designs and generation tools fo2.3Kskills.sh installs
4vercel-labs avatarfrontend-designvercel-labs/agent-evalCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, 2.2Kskills.sh installs
5delineas avatarastro-frameworkdelineas/astro-framework-agentsAstro framework specialist for building fast, content-driven websites with islands architecture. Use when creating Astro components, configuring hydration (clie2.2Kskills.sh installs
6wsimmonds avatarnextjs-app-router-fundamentalswsimmonds/claude-nextjs-skillsGuide for working with Next.js App Router (Next.js 13+). Use when migrating from Pages Router to App Router, creating layouts, implementing routing, handling me2.2Kskills.sh installs