Open Code Review is an AI-assisted code review CLI tool that reads diffs, uses an agent with tool-use capabilities, and generates line-level comments with deterministic review steps and multi-language rule support. It supports OpenAI and Anthropic compatibility and can run in repository-wide or per-file modes.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Open Code Review is an AI-powered code review CLI tool. It reads Git diffs, sends changed files to a configurable LLM via an agent with tool-use capabilities, and generates structured review comments with line-level precision. The agent can read full file contents, search the codebase, inspect other changed files for context, and produce deep reviews — not just surface-level diff feedback. Beyond diff review, ocr scan reviews entire files for auditing unfamiliar codebases or directories that have no meaningful diff.
How it works
- Deterministic engineering with hard constraints for review steps: precise file selection, smart file bundling, fine-grained rule matching, and external positioning/reflection modules.
- Agent component handles dynamic decisions and context retrieval, including scenario-tuned prompts and a purpose-built toolset.
- It supports a repository-wide review workflow and a full-file scan mode for auditing entire directories.
Getting started
Prerequisites
- Git >= 2.41
CLI Install
npm install -g @alibaba-group/open-code-review
After installation, the ocr command is available globally.
Quick Start
1. Configure LLM
ocr config provider # Select a built-in provider or add a custom one
ocr config model # Pick a model for the active provider
The interactive UI guides you through provider selection, API key entry, and model configuration, then automatically tests connectivity.
2. Review
cd your-project
# Workspace mode — review all staged, unstaged, and untracked changes
ocr review
# Branch range — compare two refs
ocr review --from main --to feature-branch
# Single commit
ocr review --commit abc123
# Resume an interrupted range or commit review
ocr session list
ocr review --from main --to feature-branch --resume <session-id>
# Print the review comments recorded in a saved session
ocr session comments <session-id>
ocr session comments --severity critical,high --json <session-id>
# Full-file scan — review whole files instead of a diff (no git history needed)
ocr scan # scan the entire repository
ocr scan --path internal/agent # scan a directory or specific files
ocr scan --resume <session-id> # resume an interrupted full-file scan
# Delegation mode — let your AI coding agent perform the review itself
# OCR handles file selection and rule resolution; no LLM configuration needed
ocr delegate preview
ocr delegate rule src/main.go src/handler.go
Documentation
Full docs at open-codereview.ai/docs covering quickstart, installation, CLI reference, review rules, configuration, MCP server, integrations, and more.
Traction
(Repo shows 18702 stars and 1256 forks as raw numbers in the data.)