getross
v0.1.0
Published
Point-and-draw visual-intent layer for coding agents — select real components in your running Next.js app, grounded to their true source file:line, and hand a ready-to-paste instruction to your AI agent.
Maintainers
Readme
getross
Point-and-draw visual-intent layer for coding agents.
Open an overlay over your own running Next.js app, select / draw / measure /
capture real components — each grounded to its true source file:line — compose
one intent, and Send copies a ready-to-paste instruction for your coding agent
(e.g. Claude Code). You paste, review, and run it. Selection identifies; the agent
edits.
The package is published as getross; the CLI command it installs is ross.
Requirements
- Next.js 16+ / React 19 / Turbopack, App Router,
.tsxfiles - Node.js 18+
Quick start
npx getross init /path/to/your-next-app # wire loader + overlay + design.md + .mcp.json
npx getross dev /path/to/your-next-app # daemon (serves overlay.js) + your `npm run dev`Or install globally and use the ross command:
npm i -g getross
ross init /path/to/your-next-app
ross dev /path/to/your-next-appThen in the browser: ⌥R → select / draw / measure / capture → Send → ⌘V
into Claude Code → review → Enter. Nothing is auto-applied — you are the gate.
init is idempotent: it builds the self-contained loader (Babel is bundled, so your
app needs no extra deps), adds it to your next.config Turbopack rules, injects the
dev-only overlay <script> into your root layout, seeds design.md, and registers
the optional Ross MCP server in the app's .mcp.json. It prints manual steps for
anything it can't patch confidently. Clear .next if Turbopack reports a stale
module after wiring.
How it works
- A build-time loader injects
data-src="file:line:col"+data-componentonto host elements (covers Server Components). - The overlay reads those attributes as you point/draw and builds a single composite intent (subjects + an optional measured vector + optional marks).
- Send composes the intent into one plain-language instruction (with real
file:lines) and copies it to your clipboard. - You paste into Claude Code, review/edit, and run it.
- For design-relevant changes, the agent can reconcile the decision into an
evolving
design.mdvia the optional MCP tools (ross_get_design_context+ross_update_design).
The daemon (:5179) serves overlay.js. The MCP server is optional (the
design.md tools).
Documentation
Full design, architecture, and known constraints live in the repository:
https://github.com/Renzoviale/ross — see SPEC.md.
License
MIT © Renzo Viale
