open-code-review-alibaba

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