CodeAgora

Where LLMs debate your code.

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