CLI for Open Code Review - Multi-environment setup and progress tracking
npm install @open-code-review/cliThe command-line interface for Open Code Review. Handles multi-tool setup and provides real-time progress tracking.
1. Multi-tool configuration: If you use multiple AI assistants (Claude Code, Cursor, Windsurf), the CLI configures all of them with a single command.
2. Progress visibility: AI-powered reviews take time. The ocr progress command shows what's happening in real-time.
``bashGlobal install
npm install -g @open-code-review/cli
Commands
$3
Initialize Open Code Review in your project.
`bash
Interactive mode
ocr initNon-interactive
ocr init --tools claude,windsurf,cursorConfigure all detected tools
ocr init --tools all
`What it does:
1. Creates
.ocr/ directory with skills, commands, and config
2. Detects installed AI tools
3. Configures each tool appropriately
4. Optionally injects OCR instructions into AGENTS.md / CLAUDE.md$3
Watch a review session in real-time.
`bash
Auto-detect current session
ocr progressWatch a specific session
ocr progress --session 2026-01-26-feature-auth
`Shows: current phase, elapsed time, reviewer status, finding counts, completion percentage, and current round.
Multi-round support: The progress display shows which round is active and tracks completion across rounds. When a round completes, running
/ocr-review again starts a new round (round-2/, round-3/, etc.).$3
Update OCR skills and commands to the latest version after upgrading the package.
`bash
Update everything
ocr updatePreview changes first
ocr update --dry-runUpdate specific components
ocr update --commands # Commands only
ocr update --skills # Skills and references only
ocr update --inject # AGENTS.md/CLAUDE.md only
`What it does:
1. Detects which AI tools you configured during
ocr init
2. Updates .ocr/skills/ (SKILL.md, workflow, discourse rules)
3. Updates tool-specific commands (.windsurf/workflows/, etc.)
4. Updates managed blocks in AGENTS.md / CLAUDE.mdWhat is NOT modified:
-
.ocr/config.yaml — Your team composition and context are preserved
- .ocr/skills/references/reviewers/ — All reviewers preserved (default and custom)
- .ocr/sessions/ — Review history remains untouchedSession Storage
The CLI reads session state from
.ocr/sessions/{date}-{branch}/:`
.ocr/sessions/2026-01-26-feature-auth/
├── state.json # Workflow state (read by progress command)
└── rounds/
├── round-1/
│ ├── reviews/*.md # Individual reviewer outputs
│ ├── discourse.md
│ └── final.md # Completion indicator
└── round-2/ # Additional rounds if re-reviewed
`The CLI derives round information from the filesystem:
- Round count: Enumerated from
rounds/round-*/ directories
- Round completion: Determined by final.md presence
- Reviewer progress: Listed from rounds/round-{n}/reviews/*.mdSupported AI Tools
| Tool | Config Directory |
|------|------------------|
| Claude Code |
.claude/ |
| Windsurf | .windsurf/ |
| Cursor | .cursor/ |
| GitHub Copilot | .github/ |
| Cline | .cline/ |
| Continue | .continue/ |After Installation
Use OCR through your AI assistant:
`
/ocr-review # Start a code review
/ocr-review against spec.md # Review against a spec file
/ocr-doctor # Verify setup
`For Claude Code / Cursor, use
/ocr:review, /ocr:doctor`, etc.See the main README for full documentation.
Apache-2.0