YoRHa Review Division

Humans review.
Agents revise.

A review tool where human feedback meets AI action. Anchored comments on plans, designs, and prototypes — structured JSON exports that agents consume, act on, and resolve.

Try the Demo Read the Guide View Source

Everything for the review loop

Three content types, six anchor types, one clean API. Revi keeps humans and agents in sync.

I

Plan Review

Markdown documents with heading anchors, text selection comments, inline search, and collapsible document index.

II

Design Review

Images on a dark canvas with numbered annotation pins. Click a pin to comment; hover a card to highlight it.

III

Prototype Review

Step-through interactive HTML prototypes with per-step commenting, zoom, and pan support.

IV

Agent Export API

A single endpoint returns only open comments as structured JSON — purpose-built for LLM agent consumption.

V

Anchored Comments

Six reference types — section, quote, line, annotation, step, general — so every comment knows where it points.

VI

Zero-Dependency Binary

Single static Rust binary. No runtime, no containers, no config files needed. Download and run.

The review-revise loop

A continuous cycle: humans flag issues, agents fix them, humans verify.

01

Drop files

Place markdown, images, or HTML prototypes into the workspace folder.

02

Review & comment

Reviewers browse in the split-pane UI and leave anchored comments.

03

Agent reads export

Agents poll /api/export/{id} for open comments.

04

Act & resolve

Agents process feedback, make changes, and mark comments resolved.

One endpoint, structured feedback

The export API returns only what agents need — open comments with anchors and metadata.

agent-export.json
{
  "schemaVersion": "1.0",
  "item": {
    "id": "plans/sprint-1",
    "type": "plan",
    "title": "Sprint 1 Design"
  },
  "openComments": [{
    "author": "Alice",
    "content": "Add error handling",
    "reference": {
      "type": "section",
      "value": "## API Layer"
    }
  }]
}

Built for automation

Every comment carries a typed reference so agents know exactly where to look and what to fix.

  • section — markdown heading anchor
  • quote — inline text selection
  • line — line number
  • annotation — image pin number
  • step — prototype step index
  • general — whole-item comment

Six ways to point at things

Comments are never lost in context — every anchor type maps precisely to a location.

§

section

Heading anchor

quote

Text selection

#

line

Line number

annotation

Image pin

step

Prototype step

general

Whole item

Running in 30 seconds

terminal
# Download and run — zero dependencies
./dist/revi-linux-x86_64

# Start the frontend
cd frontend && npm install && npm run dev

# Open http://localhost:5173

# Or with custom paths:
./revi --workspace /my/docs --data /my/data --port 9000

Rust + Vue, one supported path

A production-ready Rust binary for the review API, a Vue frontend for the review UI, and a vendored `common/` base for shared docs/demo/release entry points.

  • Rust binary auto-creates workspace and data directories
  • Configure via CLI flags, TOML file, or defaults
  • `common` front door aligns dev, docs, demo, and release commands
  • Vue 3 SPA with Vite hot-reload

Ready to close the loop?

Start reviewing with humans and agents today. No accounts, no cloud — just drop files and go.

Try the Demo Get Started