Skip to content
react-global-state-hooks
Agentic DevTools

Give your agent
state. Not guesses.

Inspect the live store. Call a real action. Read back what changed.
A direct view of your application, from the terminal your agent already uses.

Development only · Open source · Runs through the browser panel

The evidence loopIllustrative session
Your applicationTodos

A plan, made visible.

Follow the task from action to state.

Create the store
Compose a selector
Selected storetodos
Task count2
Agent terminalrgsh · localhost
$ npx rgsh state todos
[todos] state:
{
  "todos": [
    { "text": "Create the store", "done": true },
    { "text": "Compose a selector", "done": false }
  ]
}
 
# The current state is the starting point.
01 / Inspect the current state

This is a scripted design demonstration, not a connected coding agent. The recordings below are the real thing.

A more useful conversation

From “what happened?”
to a trace you can inspect.

The interface and the state answer different questions. Give your tools access to both.

Inspect the real model

Read stores, selected values and action history—not just a screenshot of the result.

Use the same actions

Invoke exposed store actions from a terminal. Keep domain behavior in the application.

Verify the outcome

Read back the state after a change. A completed command is not proof that the intended state was reached.

The connection

One application. A shared view.

App + debug entry
DevTools panel
Local WebSocket
CLI / coding agent

The panel stays open on your app’s tab. The CLI connects on the same port.

Start with the development entry.

Load debug instrumentation before creating stores. Open the extension panel, reload the app, and connect its terminal port.

terminal
npm i -D ws
npx rgsh --list
npx rgsh state todos
npx rgsh action todos add "Write the docs"
Small commands. Specific answers.

Start with a question about state.

Discover stores

Identify what the running application exposes.

terminal
npx rgsh --list

Read a store

Inspect the current value before changing it.

terminal
npx rgsh state todos

Call an action

Use the application’s own state transition.

terminal
npx rgsh action todos add "Write the docs"

Read a path

Verify the exact part of the result that matters.

terminal
npx rgsh state todos todos[0].done
See the real thing

See it work. In a real application.

Recordings of the extension, the state model and the workflow, captured against this repository’s playground.

react-global-state-hooks · Runtime Debugging

Give the agent the trace, not a screenshot. Recorded against this repository's playground; loads only when opened. Open the video ↗

A library walkthrough
Video tutorial

Start with the fundamentals

Open the original video tutorial on YouTube.

A clearer view of your next bug.

Connect a development build and inspect your first store.

↑↓ Navigate ↵ Open Esc CloseRGSH docs
Get started

Shared state. Precise subscriptions.
Built-in DevTools.