CodeAgora runs multiple LLM reviewers in parallel, lets them challenge each other, and returns a final review verdict with evidence.

Quick Start

Published CLI

npm i -g @codeagora/review
agora init
git diff | agora review

Current release: 0.1.2.

Source Checkout

CodeAgora is a pnpm-only workspace. Use pnpm for local setup, scripts, package filters, and release validation; do not use npm or yarn for workspace workflows.

pnpm install
pnpm build
pnpm typecheck
pnpm test
pnpm dev review path/to/diff.patch

Why CodeAgora

• parallel reviewers catch different issues
• debate and filtering reduce noisy findings
• works from the CLI, GitHub Actions, and MCP-compatible editors

How it works

1. pre-analysis enriches the diff
2. specialist reviewers inspect in parallel
3. hallucination and dedupe filters remove weak claims
4. discussion resolves disputes
5. a head agent returns ACCEPT, REJECT, or NEEDS_HUMAN

Common ways to use it

CLI

agora review path/to/diff.patch

agora init detects keys and tools, then writes a starter config.

GitHub Actions

name: CodeAgora Review
on:
  pull_request:
    types: [opened, synchronize, reopened]

permissions:
  contents: read
  pull-requests: write
  statuses: write
  checks: write

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: bssm-oss/[email protected]
        with:
          github-token: ${{ secrets.GITHUB_TOKEN }}
        env:
          OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}

Use .ca/config.json as the default config path. See GitHub Actions setup for fork handling, secrets, permissions, and tuning.

MCP

{
  "mcpServers": {
    "codeagora": {
      "command": "npx",
      "args": ["-y", "@codeagora/mcp"]
    }
  }
}

See packages/mcp/README.md for tool details.

Desktop app

The desktop app in packages/desktop is an official local UI surface for setup, session browsing, review launch, result inspection, and evidence export. It uses the same CLI/core/session/config contracts as the automation surfaces.

The v0.1.2 GitHub Release includes a macOS arm64 DMG: CodeAgora_0.1.2_aarch64.dmg. This DMG is an unsigned preview build. It is not Developer ID signed, not notarized, and does not enable a Tauri updater channel; macOS Gatekeeper warning is expected. See Desktop app for the current distribution policy.

Docs map

| Doc | Purpose | |---|---| | Docs index | Audience-based documentation map | | CLI reference | Commands and options | | Configuration | Config file guide | | Providers | Provider list and tiers | | Architecture | Pipeline and system design | | Development notes | Setup, checks, release/doc pointers | | Benchmarks | Fixture set and benchmark notes | | GitHub Actions setup | Full action guide | | Desktop app | Desktop DMG policy and evidence | | Troubleshooting | Common errors and fixes |

Development and benchmarks

See Development and Benchmarks.

License

MIT