debate

debate v2

Get a second (and third, and fourth) opinion on your implementation plan before you write a line of code. debate sends your plan to multiple AI reviewers in parallel, synthesizes their feedback, has them argue out contradictions, and produces a consensus verdict.

v2 is a ground-up rewrite. Everything now runs through acpx — a single unified CLI that talks to any coding agent. No more managing individual CLIs, session files, or API keys per provider. One config, any combination of models.

Quick Start

# 1. Install the plugin
/plugin marketplace add STRML/cc-debate
/plugin install debate@cc-debate

# 2. Install acpx
npm install -g acpx@latest

# 3. Configure your review panel (interactive)
/debate:acpx-setup

# 4. Run a review
/debate:run

Restart Claude Code after installing the plugin.

---

How it works

You: /debate:run

Claude: Running parallel review via acpx...

  codex        → agent: codex        (120s)
  antigravity  → agent: antigravity  (240s)
  mercury      → agent: mercury      (120s)

  ## Codex Review — Round 1
  The retry logic in Step 4 doesn't handle the case where...
  VERDICT: REVISE

  ## Antigravity Review — Round 1
  Missing error handling when the API is unavailable...
  VERDICT: REVISE

  ## Mercury Review — Round 1
  Unstated assumption: this plan assumes the temp directory is writable...
  VERDICT: REVISE

  ## Synthesis
  Unanimous: all reviewers flagged missing error handling
  Unique to Codex: retry logic gap in Step 4
  Unique to Mercury: temp directory writability assumption

  ## Final Report
  VERDICT: REVISE — 3 issues to address

Claude: Revising plan...
Claude: Re-submitting to all reviewers...

  ## Codex Review — Round 2   →  VERDICT: APPROVED ✅
  ## Antigravity Review — Round 2  →  VERDICT: APPROVED ✅
  ## Mercury Review — Round 2 →  VERDICT: APPROVED ✅

  VERDICT: APPROVED — unanimous after 2 rounds

---

What you need

Required:

• acpx — npm install -g acpx@latest
• jq — brew install jq / apt install jq
• The agent CLIs for whatever reviewers you want (see Supported Agents below)

Optional:

• opencode — only needed for OpenRouter model access (DeepSeek, Mercury, Kimi, etc.) or LiteLLM proxy access (local models, self-hosted, etc.)

---

Supported Agents

These are the reviewer backends you can use. Mix and match — pick 2-4 for a useful review panel.

Built-in acpx agents

These have native Agent Client Protocol support. Install the CLI, and acpx handles the rest.

Agent name	Model	Install
codex	OpenAI Codex	npm install -g @openai/codex + OPENAI_API_KEY
antigravity	Google Gemini 3.x via Antigravity CLI	Install the Antigravity CLI (agy) + run agy once to sign in ¹
claude	Claude (Opus/Sonnet)	Already installed — you're running it now
kimi	Kimi (Moonshot AI)	See Kimi CLI docs
kiro	Kiro (AWS)	See Kiro docs
qwen	Qwen Code	See Qwen Code docs
cursor	Cursor	Install Cursor IDE
copilot	GitHub Copilot	gh extension install github/gh-copilot
opencode	OpenCode (default model)	npm install -g opencode-ai
kilocode	Kilocode	npx @kilocode/cli
droid	Factory Droid	See acpx docs
iflow	iFlow	See acpx docs
pi	Pi Coding Agent	See acpx docs
openclaw	OpenClaw	See acpx docs

¹ Antigravity note: acpx has no native ACP support for the Antigravity CLI yet, so invoke-acpx.sh calls agy directly. Stored OAuth from running agy once works fine for this; alternatively set ANTIGRAVITY_API_KEY (or GEMINI_API_KEY) in ~/.claude/settings.json for fully headless environments:

"env": { "ANTIGRAVITY_API_KEY": "..." }

Pick the review model with the optional model config field — any display name from agy models (e.g. "Gemini 3.1 Pro (High)"). Two agy quirks the script handles for you: the prompt is passed as a positional argument (stdin is ignored in print mode), and agy -p is run under a PTY (via Python) because it drops its output when stdout is not a TTY. agy has no hard read-only flag, so the reviewer is run from a throwaway workspace with the plan supplied in-prompt — it never needs repo access.

Migrated from the Gemini CLI (June 2026): Google is transitioning the Gemini CLI to the Antigravity CLI. This plugin's Google reviewer now uses agy directly — the old gemini agent has been replaced by antigravity.