@open-code-review/cli

Command-line interface for Open Code Review — multi-tool setup, real-time progress tracking, environment health checks, and a web dashboard for managing reviews.

Quick Start

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

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

# 3. Launch the dashboard
ocr dashboard

ocr init detects your installed AI tools and configures each one automatically. Then use your AI assistant to run a review:

/ocr:review                                          # Claude Code / Cursor
/ocr-review                                          # Windsurf / other tools
/ocr-review against spec.md                          # With requirements context
/ocr-review --team principal:2,martin-fowler:1       # Custom team composition
/ocr-review --reviewer "Focus on error handling"     # Add an ephemeral reviewer
/ocr-map                                             # Code Review Map for large changesets

Run ocr doctor to verify your setup at any time.

Reviewer Library

OCR ships with 20+ reviewer personas across four tiers — holistic generalists (Principal, Staff Engineer, Architect), domain specialists (Security, Testing, Frontend, Performance, and more), and famous engineer personas (Martin Fowler, Kent Beck, Sandi Metz, and others) who review through the lens of their published work.

Add ephemeral one-off reviewers with --reviewer, or create persistent custom reviewers with /ocr:create-reviewer.

Commands

ocr init

Initialize Open Code Review in your project. Creates .ocr/ with skills, commands, and config, then configures your detected AI tools.

ocr init                              # Interactive — select tools
ocr init --tools claude,windsurf      # Non-interactive
ocr init --tools all                  # Configure all detected tools

ocr dashboard

Start the web dashboard for running reviews, browsing results, triaging findings, and posting to GitHub. Bundled with the CLI — no separate install.

ocr dashboard                         # Default port (4173)
ocr dashboard --port 8080             # Custom port
ocr dashboard --no-open               # Don't auto-open browser

ocr progress

Watch a review or map session in real-time. Shows current phase, elapsed time, reviewer status, finding counts, and completion percentage.

ocr progress                           # Auto-detect current session
ocr progress --session 2026-01-26-main # Specific session

ocr doctor

Verify your OCR installation and all dependencies.

ocr doctor

Checks: git, AI CLI tools (Claude Code, OpenCode), gh (GitHub CLI), .ocr/ setup, and capabilities.

ocr update

Update OCR skills and commands after upgrading the package. Preserves your .ocr/config.yaml and all reviewer personas.

ocr update                    # Update everything
ocr update --dry-run          # Preview changes
ocr update --commands         # Commands only
ocr update --skills           # Skills and references only
ocr update --inject           # AGENTS.md/CLAUDE.md only

ocr reviewers

Manage reviewer personas. Sync metadata from reviewer markdown files to reviewers-meta.json for the dashboard.

ocr reviewers sync --stdin      # Pipe JSON from AI-generated metadata

ocr state

Internal command used by the review workflow to manage session state. Subcommands: init, transition, close, show, sync, round-complete, map-complete.

ocr state show                # Show current session state
ocr state show --json         # Output as JSON
ocr state sync                # Rebuild state from filesystem

Supported AI Tools

ocr init detects and configures all of these automatically:

| Tool | Config Directory | |------|------------------| | Amazon Q Developer | .aws/amazonq/ | | Augment (Auggie) | .augment/ | | Claude Code | .claude/ | | Cline | .cline/ | | Codex | .codex/ | | Continue | .continue/ | | Cursor | .cursor/ | | Gemini CLI | .gemini/ | | GitHub Copilot | .github/ | | Kilo Code | .kilocode/ | | OpenCode | .opencode/ | | Qoder | .qoder/ | | RooCode | .roo/ | | Windsurf | .windsurf/ |

Updating

After upgrading the package:

npm i -g @open-code-review/cli@latest
ocr update

The CLI notifies you when a new version is available.

Links

• Full documentation: github.com/spencermarx/open-code-review
• npm: @open-code-review/cli

License

Apache-2.0