OpenCodeReview CLI

AI-powered code review tool that reads Git diffs, sends changed files to a configurable LLM via OpenAI-compatible API, and generates structured review comments. It goes beyond surface-level analysis — the Agent can read project context for deep reviews.

Install

npm install -g @alibaba/open-code-review

After installation, the ocr command is available globally.

Version Control

# Install specific version
OCR_VERSION=v1.0.0 npm install -g @alibaba/open-code-review

Prerequisites

You must configure an LLM provider before using ocr. The tool requires access to an OpenAI-compatible API endpoint (OpenAI, Claude, local models, etc.).

ocr config set llm.url https://api.anthropic.com/v1/messages \
    && ocr config set llm.auth_token {{your-api-key}} \
    && ocr config set llm.model claude-opus-4-6 \
    && ocr config set llm.use_anthropic true  \
    && ocr config set language Chinese

Config is stored in ~/.open-code-review/config.json.

Or via environment variables:

export OCR_LLM_URL=https://api.anthropic.com/v1/messages
export OCR_LLM_TOKEN=your-api-key
export OCR_LLM_MODEL=claude-opus-4-6

Test Connectivity

ocr llm test

Quick Start

Navigate to any Git repository and run:

# Review all workspace changes
ocr review

# Review diff between two branches
ocr review --from main --to feature-branch

# Review a single commit
ocr review --commit abc123

Commands

| Command | Description | |---------|-------------| | ocr review / ocr r | Start code review | | ocr config set <key> <value> | Manage configuration | | ocr llm test | Test LLM connectivity | | ocr viewer | Start WebUI session viewer | | ocr version | Show version info |

Common Options

| Flag | Shorthand | Default | Description | |------|-----------|---------|-------------| | --repo | | current dir | Git repository root | | --from | | | Source ref (e.g., main) | | --to | | | Target ref (e.g., feature-branch) | | --commit | -c | | Review a single commit | | --format | -f | text | Output format: text or json | | --concurrency | | 4 | Max concurrent file reviews | | --timeout | | 10 | Per-file timeout (minutes) |

Features

• Three review modes: workspace changes, branch range, single commit
• Context-aware: Agent reads arbitrary files, searches code via git grep, inspects diffs
• Plan phase: Large changes (>50 lines) get risk analysis first
• Any LLM: Works with OpenAI, Claude-compatible endpoints, local models
• Concurrent: Files reviewed in parallel (configurable workers)

License

Apache-2.0