Skip to content
Projects

Genie-sa/genie-react has 34 GitHub stars and 2 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 19:40 UTC. Last push 2026-11-15.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

Live DevTools for your running React + TanStack app — driven from the terminal by your AI agent, through one CLI

Developer Tools

README.md

Original

Genie React

npm version npm downloads CLI CI license

Give your coding agent a view inside your running React app.

Find out why a component rendered, whether a Query update reached the UI, or where an interaction spent its time. Then run the same flow after a fix and compare the evidence.

Works with React web and React Native. Query and routing tools support TanStack Query and TanStack Router. Use Genie in development.

Docs · Setup guides · Tool reference

Get started

For Vite or Next.js, run these from your app folder. The CLI requires Node.js 22.12 or newer.

pnpm add -D genie-react @genie-react/cli
pnpm exec genie-react init

Follow the setup result, then run pnpm dev and open the app. In Vite, render <Genie /> near the app root to add Query, Router, memory, and timeline tools:

import { Genie } from 'genie-react'

// Inside your root component:
{import.meta.env.DEV && <Genie />}

Check that your app is connected:

pnpm exec genie-react status --sessions-only
pnpm exec genie-react call react_get_tree '{"depth":3,"maxNodes":50}'

Continue when the intended session has ready: true and the tree shows your components. The tree starts at your own components: framework and library wrappers are folded away, and filteredNote says how many. If setup needs attention, run pnpm exec genie-react doctor --live.

Using React Native or Expo, Next.js, or another web bundler? Follow its setup guide.

Give your agent a useful task

init installs the Genie skill in .agents/skills/genie for Codex, Cursor, and other Agent Skills clients, and links it into .claude/skills/genie for Claude Code. Its commands call the installed node_modules/.bin/genie-react directly, since a wrapper such as pnpm exec or npx adds 75–350 ms to every call an agent makes. Without the CLI, npx skills add Genie-sa/genie-react installs the same skill. Pair your agent with agent-browser or agent-device so it can use the UI and check what changed.

Try a prompt like:

Use Genie to find why Checkout renders when I type in search. Fix it, then repeat the interaction and check that checkout still works.

Record the interaction timeline when I open the product page. Check whether the delay comes from a request or React rendering.

Put the cart into loading and error states, check both screens, then restore it.

Genie can read runtime state and call tools your app registers. The UI driver clicks, types, and checks the screen. See the agent workflow.

Try it from the terminal

Find a render cause. Replace Checkout with a component in your app:

pnpm exec genie-react call react_clear_renders '{}'
# Perform one action in the app.
pnpm exec genie-react call react_render_causes '{"component":"Checkout","limit":10}'

Read a Query:

pnpm exec genie-react call query_list '{"limit":10}'
# Use a key returned above.
pnpm exec genie-react call query_get '{"queryKey":["cart"]}'

Discover tools and their exact inputs:

pnpm exec genie-react tools
pnpm exec genie-react tools timeline_start

Results print as compact text that keeps every field, written for a model to read. Scripts add --json to parse a result, or set GENIE_OUTPUT=json to keep the JSON-by-default output of CLI 0.14–0.19. Check the result's coverage before claiming a fix worked. See CLI output for the format, limits, and migration details.

Go further

Develop Genie

pnpm check runs lint, type checks, the build, release checks, tests, and the docs checks.

pnpm typecheck type-checks the packages and evals with tsrs, a Rust port of the TypeScript 7 compiler, at the exact version pinned in the root package.json. The docs and the Expo example use it too: pnpm --filter @genie-react/docs typecheck, and pnpm --filter @genie-react/expo-demo typecheck after pnpm build, since Expo reads the built types. TypeScript itself still generates the published .d.ts files, and pnpm check:compatibility type-checks an installed consumer with TypeScript 6 and 7.

Your editor keeps using the workspace TypeScript. To try the tsrs language server in VS Code, install the TypeScript 7 extension (TypeScriptTeam.native-preview) and add this to .vscode/settings.json, which git ignores:

{
  "js/ts.experimental.useTsgo": true,
  "js/ts.tsdk.path": "./node_modules/tsrs/tsdk"
}

MIT © Genie React Agent contributors