open-code-review

Customizable multi-agent code review for AI-assisted development

---

Quick Start

Prerequisites: Node.js >= 22.5, Git, and an AI coding assistant.

# 1. Install the CLI globally
npm install -g @open-code-review/cli

# 2. Initialize OCR in your project
cd your-project
ocr init

# 3. Launch the dashboard and run your first review
ocr dashboard

Your browser will open the OCR dashboard — you're ready to run your first review.

Any package manager works. From v2.1 OCR uses Node's built-in SQLite (node:sqlite) — there's no native module to compile, so npm i -g, pnpm add -g, and yarn global add all install cleanly (including under pnpm 10+, which blocks dependency build scripts). It just needs Node >= 22.5.

ocr init detects your installed AI tools (Claude Code, Cursor, Windsurf, and 11 more) and configures each one automatically. Then open the dashboard to run a review, browse results, and manage your workflow from the browser.

Or run reviews directly from your AI coding assistant:

/ocr:review                                    # Claude Code / Cursor
/ocr-review                                    # Windsurf / other tools
/ocr-review Review against openspec/spec.md    # With requirements

---

Why Open Code Review?

When you ask an AI to "review my code," you get a single perspective — one pass, one set of priorities. OCR changes that fundamentally:

• Multi-agent redundancy — Multiple reviewer instances examine your code independently. Different attention patterns catch different issues. What one reviewer misses, another finds.
• Discourse before synthesis — Reviewers don't just produce findings — they debate them. They challenge assumptions, validate concerns, and surface questions no single reviewer would ask.
• Fully customizable teams — Pick from 28 reviewer personas (including famous engineers like Martin Fowler, Kent Beck, and Sandi Metz), create your own persistent reviewers, or describe ephemeral one-off reviewers inline.
• Requirements-aware — Pass in a spec, proposal, or acceptance criteria. Every reviewer evaluates the code against your stated requirements, not just general best practices.
• Project context — OCR discovers your standards from CLAUDE.md, .cursorrules, OpenSpec configs, and other common patterns. Reviewers apply your conventions.

                    ┌─────────────┐
                    │  Tech Lead  │  ← Orchestrates the review
                    └──────┬──────┘
                           │
         ┌─────────────────┼─────────────────┐
         │                 │                 │
         ▼                 ▼                 ▼
┌─────────────────┐ ┌─────────────┐ ┌─────────────────┐
│   Your Team     │ │  Your Team  │ │   Your Team     │
│   Composition   │ │  Composition│ │   Composition   │
└─────────────────┘ └─────────────┘ └─────────────────┘
         │                 │                 │
         └─────────────────┼─────────────────┘
                           │
                    ┌──────▼──────┐
                    │  Discourse  │  ← Reviewers debate findings
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │  Synthesis  │  ← Unified, prioritized feedback
                    └─────────────┘

Note: OCR does not replace human code review. The goal is to reduce the burden on human reviewers by catching issues earlier — so human review is faster and more focused on things machines can't catch.

---

Table of Contents

• The Dashboard
• IDE & CLI Workflows
• Features
  • Multi-Agent Review
  • Multi-Model Teams
  • Code Review Maps
  • Requirements-Aware Review
  • Reviewer Discourse
  • GitHub PR Posting
  • Multi-Round Reviews
  • Custom Reviewers
  • Famous Engineer Personas
  • Ephemeral Reviewers
  • Real-Time Progress
  • Address Feedback
  • Session Notes & Chat
• Configuration
• Commands Reference
• Updating OCR
• Supported AI Tools
• Requirements

---

The Dashboard

The dashboard is the recommended way to run reviews, browse results, and manage your workflow. Launch it with ocr dashboard.

Run reviews and maps

The Command Center lets you launch multi-agent code reviews and Code Review Maps directly from the dashboard. Specify targets, add requirements, toggle fresh starts — then watch live terminal output as agents work.

Browse and triage reviews

View verdict banners, individual reviewer cards, findings tables, and cross-reviewer discourse for every review round. Set triage status on findings (needs review, in progress, changes made, acknowledged, dismissed) with filtering and sorting.

Explore Code Review Maps

Navigate large changesets with section-based breakdowns, rendered Mermaid dependency graphs, and file-level progress tracking.

Post to GitHub

Two posting modes from the review round page:

• Post Team Review — Posts the multi-reviewer synthesis as-is
• Generate Human Review — AI-rewrites all findings into a single, natural human voice following Google's code review guidelines. Preview, edit, and save drafts before posting.

Manage your review team

The Team page lets you browse all 28 reviewer personas grouped by tier (Generalists, Specialists, Famous Engineers, Custom). View full prompts, focus areas, and persona details. Create