Yomi

Agent-facing React repair context for AI coding agents.

Yomi helps a coding agent move from a visible React UI symptom to the source owner, likely edit target, runtime trace plan, and verification loop.

visible UI bug
  -> source-linked owner
  -> action/state/effect/cache path
  -> likely edit target
  -> minimal trace plan
  -> verifier result

Yomi is not a browser automation wrapper, generic repo graph, or UI generation protocol. It is a React repair context layer for coding agents.

Quick Start

Try the demo graph:

npx @isamisushi/yomi-cli@latest index --demo --output .yomi/demo-graph.json
npx @isamisushi/yomi-cli@latest repair "Customer search" --graph .yomi/demo-graph.json
npx @isamisushi/yomi-cli@latest plan-trace "Customer search" --graph .yomi/demo-graph.json

For repeated use:

npm install -g @isamisushi/yomi-cli
yomi doctor

The CLI package downloads the matching prebuilt yomi binary for macOS, Windows, or Linux during install. Bun is not required to run the installed CLI.

What It Does

• Indexes React and TypeScript apps into a source-linked frontend graph.
• Answers repair questions from visible UI labels.
• Identifies behavior owners across state, effects, actions, forms, stores, and cache operations.
• Produces doNotStartFrom hints for display-only surfaces.
• Plans focused runtime instrumentation when ordering or history matters.
• Runs verifier scenarios that return source-linked pass/fail traces.

Documentation

Start here: yomi-docs.fly.dev

• Why Yomi
• Getting Started
• Demo Walkthrough
• CLI Reference
• Runtime Instrumentation
• Agent Skills
• Comparison
• Limitations

Local Development

mise install
npm install
npm run yomi -- index --demo --output .yomi/demo-graph.json
npm run yomi -- repair "Customer search" --graph .yomi/demo-graph.json

Useful checks:

npm run typecheck
npm test
npm run docs:build
npm run publish:npm:dry-run

Agent Skills

Install project-local guidance for coding agents:

yomi skill --all --scope project

This installs generated command guidance plus Yomi's React repair and instrumentation workflows.

Package

The npm packages are split by role:

• @isamisushi/yomi-cli exposes the yomi CLI.
• @isamisushi/yomi exposes React runtime adapters:
  • @isamisushi/yomi/react
  • @isamisushi/yomi/tanstack-query

The CLI package is small. Its postinstall step downloads the current platform binary from GitHub Releases and verifies its checksum.

License

MIT