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@rc
agora init
git diff | agora review

Current release: 0.1.0-rc.6.

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/CodeAgora@v0.1.0-rc.6
        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@rc"]
    }
  }
}

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.

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
Troubleshooting	Common errors and fixes

Development and benchmarks

See Development and Benchmarks.

License

MIT