open-code-review

Open Code Review

AI 生成コードに特化した、初のオープンソース CI/CD 品質ゲートです。 ハルシネーションによるインポート、古い API、過剰な設計、セキュリティのアンチパターンを検出します。ローカル LLM と OpenAI 互換プロバイダーを利用します。 無料。セルフホスト可能。6 言語に対応。

対応ツール

コードを生成する AI ツールなら何でも使えます。コードを書けば、OCR がレビューします。

AI リンターが見逃すもの

AI コーディングアシスタント（Copilot、Cursor、Claude）は、従来のツールではまったく検出できない欠陥を含むコードを生成します。

欠陥	例	ESLint / SonarQube
ハルシネーションによるインポート	import { x } from 'non-existent-pkg'	❌ 見逃す
古い API	学習データに含まれる非推奨 API の使用	❌ 見逃す
コンテキストウィンドウ由来の問題	ファイル間のロジックの矛盾	❌ 見逃す
過剰な設計パターン	不要な抽象化、デッドコード	❌ 見逃す
セキュリティのアンチパターン	ハードコードされたサンプル用シークレット、eval()	❌ 一部のみ

Open Code Review は、6 言語にわたるこれらすべてを無料で検出します。

デモ

📄 インタラクティブな HTML レポート全体を見る

クイックプレビュー

$ ocr scan src/ --sla L3

╔══════════════════════════════════════════════════════════════╗
║           Open Code Review — Deep Scan Report               ║
╚══════════════════════════════════════════════════════════════╝

  Project: packages/core/src
  SLA: L3 Deep — Structural + Embedding + LLM Analysis

  112 issues found in 110 files

  Overall Score: 67/100  D
  Threshold: 70  |  Status: FAILED
  Files Scanned: 110  |  Languages: typescript  |  Duration: 12.3s

ディープスキャン（L3）— 仕組み

L3 は 3 つの分析レイヤーを組み合わせ、幅広く検出します。

Layer 1: Structural Detection         Layer 2: Semantic Analysis        Layer 3: LLM Deep Scan
├── Hallucinated imports (npm/PyPI)   ├── Embedding similarity recall   ├── Cross-file coherence check
├── Stale API detection               ├── Risk scoring                  ├── Logic bug detection
├── Security patterns                 ├── Context window artifacts      ├── Confidence scoring
├── Over-engineering metrics          └── Enhanced severity ranking     └── AI-powered fix suggestions
└── A+ → F quality scoring

ローカル LLM または任意の OpenAI 互換 API を利用できます。 Ollama を実行すれば分析を 100％ローカルで行えます。または、任意のリモート LLM プロバイダーに接続できます。インターフェースは同じです。

# Local analysis (Ollama)
ocr scan src/ --sla L3 --provider ollama --model qwen3-coder

# Any OpenAI-compatible provider
ocr scan src/ --sla L3 --provider openai-compatible \
  --api-base https://your-llm-endpoint/v1 --model your-model --api-key YOUR_KEY

AI による自動修正 — ocr heal

AI に検出した問題を自動修正させます。適用する前に変更内容を確認できます。

# Preview fixes without changing files
ocr heal src/ --dry-run

# Apply fixes + generate IDE rules
ocr heal src/ --provider ollama --model qwen3-coder --setup-ide

# Only generate IDE rules (Cursor, Copilot, Augment)
ocr setup src/

多言語検出

6 言語に対応した言語固有の検出機能に加え、存在しないパッケージを検出するデータベース（npm、PyPI、Maven、Go modules）を備えています。

言語	固有の検出機能
TypeScript / JavaScript	存在しないインポート（npm）、古いAPI、過剰な設計
Python	例外指定のない except、eval()、ミュータブルなデフォルト引数、存在しないインポート（PyPI）
Java	System.out.println の漏出、非推奨の Date/Calendar、存在しないインポート（Maven）
Go	未処理のエラー、非推奨の ioutil、ライブラリコード内の panic
Kotlin	!! の乱用、println の漏出、null 安全性に関するアンチパターン

比較

	Open Code Review	Claude Code Review	CodeRabbit	GitHub Copilot
価格	無料	PR あたり $15–25	$24/月/シート	$10–39/月
オープンソース	✅	❌	❌	❌
セルフホスト	✅	❌	Enterprise	❌
AI のハルシネーション検出	✅	❌	❌	❌
古い API の検出	✅	❌	❌	❌
LLM による詳細分析	✅	❌	❌	❌
AI による自動修正	✅	❌	❌	❌
多言語対応	✅ 6 言語	❌	JS/TS	JS/TS
レジストリ検証	✅ npm/PyPI/Maven	❌	❌	❌
Unicode セキュリティ検出	✅	❌	❌	❌
SARIF 出力	✅	❌	❌	❌
GitHub + GitLab	✅ 両方	GitHub のみ	両方	GitHub のみ
データのプライバシー	✅ 100% ローカル	❌ クラウド	❌ クラウド	❌ クラウド

クイックスタート

# Install
npm install -g @opencodereview/cli

# Fast scan — no AI needed
ocr scan src/

# Deep scan — with local LLM (Ollama)
ocr scan src/ --sla L3 --provider ollama --model qwen3-coder

# Deep scan — with any OpenAI-compatible provider
ocr scan src/ --sla L3 --provider openai-compatible \
  --api-base https://your-provider/v1 --model your-model --api-key YOUR_KEY

CI/CD 統合

GitHub Actions（30 秒）

name: Code Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: raye-deng/open-code-review@v1
        with:
          sla: L1
          threshold: 60
          github-token: ${{ secrets.GITHUB_TOKEN }}

GitLab CI

code-review:
  script:
    - npx @opencodereview/cli scan src/ --sla L1 --threshold 60 --format json --output ocr-report.json
  artifacts:
    reports:
      codequality: ocr-report.json

出力形式

ocr scan src/ --format terminal    # Pretty terminal output
ocr scan src/ --format json        # JSON for CI pipelines
ocr scan src/ --format sarif       # SARIF for GitHub Code Scanning
ocr scan src/ --format html        # Interactive HTML report

設定

# .ocrrc.yml
sla: L3
ai:
  embedding:
    provider: ollama
    model: nomic-embed-text
    baseUrl: http://localhost:11434
  llm:
    provider: ollama
    model: qwen3-coder
    endpoint: http://localhost:11434

  # Or use any OpenAI-compatible provider:
  # provider: openai-compatible
  # apiBase: https://your-llm-endpoint/v1
  # model: your-model

MCP サーバー — Claude Desktop、Cursor、Windsurf で利用

Model Context Protocol を介して、Open Code Review を AI IDE に直接統合できます。

npx @opencodereview/mcp-server

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "open-code-review": {
      "command": "npx",
      "args": ["-y", "@opencodereview/mcp-server"]
    }
  }
}

Cursor / Windsurf / VS Code Copilot：MCP 設定に同じ設定を追加します。

利用可能な MCP ツール：ocr_scan（品質ゲートスキャン）、ocr_heal（AI による自動修正）、ocr_explain（問題の説明）。

💡 Chrome DevTools MCP との互換性：OCR MCP Server は標準の Model Context Protocol に準拠しています。Google の Chrome DevTools MCP Server と組み合わせれば、AI ネイティブな開発ワークフローを実現できます。一方が実行中のアプリを検査し、もう一方がソースコードを検査します。

プロジェクト構成

packages/
  core/              # Detection engine + scoring (@opencodereview/core)
  cli/               # CLI tool — ocr command (@opencodereview/cli)
  mcp-server/        # MCP Server for AI IDEs (@opencodereview/mcp-server)
  github-action/     # GitHub Action wrapper

対象ユーザー

• AI コーディングアシスタントを使うチーム — Copilot、Cursor、Claude Code、Codex、または本番コードを生成するあらゆる LLM ベースのツールを使用するチーム
• オープンソースのメンテナー — マージ前に、AI が生成した PR に存在しないインポート、古い API、セキュリティ上のアンチパターンがないか確認したい方
• DevOps / プラットフォームエンジニア — コードをクラウドサービスに送信せずに、CI/CD パイプラインへ品質ゲートを追加したい方
• セキュリティを重視するチーム — すべてをローカル（Ollama）で実行し、コードを自分たちのマシン内に保持したい方
• 個人開発者 — 無料で高速、設定不要で利用できます（npx @opencodereview/cli scan src/）

掲載実績

ライセンス

BSL-1.1 — 個人利用および非商用利用は無料です。2030-03-11 に Apache 2.0 へ移行します。 商用利用には、Team または Enterprise ライセンスが必要です。

---

このリポジトリが役に立ったらスターを付けてください。想像以上に励みになります！