revizorro

revizorro

Local, GitHub-PR-grade code review of the worktree diff before merge — driven by an AI agent, reviewed by you inline in VS Code. No GitHub required.

The agent generates code, opens a review form in VS Code where you leave line-anchored comments and approve/decline; the agent applies fixes and re-submits until you approve. Realtime mid-review dialogue with the agent is first-class.

Architecture

Two processes, one localhost channel:

/revizorro (agent)            VS Code extension (form host)
   │  revizorro review ──HTTP──▶  long-poll: 1 event per call
   │     [blocks]                 you review inline (Comments API)
   │  ◀─── { question | comment | decision } ── output ends = agent's turn
   │  revizorro review --push ─▶  agent reply/fix into the open form
   │     ...loop until approved

• CLI (@revizorro/cli) — stateless HTTP client. Each revizorro review blocks until one review event, prints it as JSON, exits.
• Extension (revizorro) — hosts the long-lived review session + a localhost HTTP server; renders the diff (native editor, split/inline) + line-anchored threads (Comments API) + a file list with viewed-collapse and approve/decline.
• Discovery — the extension writes its port to <repoRoot>/.claude/revizorro/port; the CLI reads it.

Install

Three pieces — the Claude Code plugin (skill), the CLI, and the VS Code extension.

1. Claude Code plugin (the /revizorro skill). Installed from this repo's marketplace — auto-updates when the marketplace is refreshed:

/plugin marketplace add artk0de/revizorro
/plugin install revizorro@revizorro

2. CLI — on PATH via npm global bin:

npm i -g @revizorro/cli

3. VS Code extension — from the Marketplace (or a local .vsix):

code --install-extension revizorro.vsix

Then, in a project open in VS Code with the extension active:

/revizorro     # in Claude Code — drives the review loop

Develop

npm workspaces — same toolchain as a single-package repo:

npm install
npm run build   # tsc + esbuild bundles (cli → dist/revizorro.cjs, extension → dist/extension.cjs)
npm test        # vitest across protocol / core / adapters / cli

# put `revizorro` on PATH (like tea-rags):
cd packages/cli && npm link

Extension runtime: open packages/extension and press F5 for the Extension Development Host.

Status

I1 (MVP core loop) — protocol, domain, adapters, CLI: implemented and tested. Extension form: implemented; runtime pending manual F5 validation. Lenses (I2) and side-by-side diff polish (I3) are future increments. See docs/superpowers/specs/2026-06-29-revizorro-design.md.