<div align="center">

🪑 Roundtable

A council of frontier models — for the decisions that matter.

One question → many minds → one decision.

Fan a question out to Grok, Codex/OpenAI, GLM, MiniMax, Claude, and Gemini in parallel, optionally deliberate to consensus with a chaired vote, and get back one decided answer — from the command line or any MCP-capable coding harness.

</div>

curl -fsSL https://roundtable.sh/install.sh | bash

---

Why Roundtable?

Every model has a blind spot it can't see. Right before an irreversible call — an architecture, a migration, a rewrite — is exactly when one model's confident answer deserves a second (and third, and fourth) opinion.

Roundtable convenes a panel of frontier models. Each answers independently; then, for high-stakes calls, a multi-round deliberation lets every head read the whole table and revise until a Claude chair declares CONSENSUS or names the remaining disagreement. Disagreement is signal, not noise.

• 🗳️ Advisory (default) — every head answers once, blind to the others. Raw, independent reads.
• ⚖️ Deliberation (--rounds N) — heads see each other and revise; a neutral chair rules CONSENSUS / CONTINUE and stops early on agreement.
• 🔑 API keys are enough — no local CLIs required. Missing heads are skipped; the council runs on whatever subset you've configured.
• 📦 One binary, everywhere — a CLI, an MCP server, and a one-command installer that wires itself into your coding harness.

Example

$ roundtable "Reply with exactly: OK three words" --heads claude,gemini

# 🪑 Round Table — 2 heads — advisory
## 🔵 Claude (claude-opus-4-8, Anthropic)      → OK three words
## ✨ Gemini (gemini-3.1-pro-preview, Google)  → OK three words

Add --rounds 3 and the heads deliberate; a chair prints VERDICT: CONSENSUS (or CONTINUE) with the points they agreed on and any dissent named.

Install

curl -fsSL https://roundtable.sh/install.sh | bash

Or pick your package manager — all four deliver the same engine:

pip install roundtable
uv tool install roundtable
brew install frontier-infra/tap/roundtable

The installer places the engine under ${XDG_DATA_HOME:-~/.local/share}/roundtable, symlinks roundtable into ~/.local/bin, and prints a PATH hint if needed.

Quickstart

# 1. Configure keys (masked prompts; shows which heads are ✓/✗). Stored chmod-600
#    in ~/.config/roundtable/config.env. Any subset works — missing heads are skipped.
roundtable auth

# 2. Ask the council
roundtable "Postgres or SQLite for a single-tenant internal tool?"

# 3. Deliberate to consensus on a high-stakes call
roundtable ask -q "Should we rewrite the billing service in Go?" --rounds 3

roundtable doctor shows which heads are configured and pings each for reachability.

Flags

-q/--question · -c/--context <file> (shared background for every head) · --heads grok,codex,openai,glm,minimax,claude,gemini · --rounds N (deliberation) · --research (web on, multi-step) · --timeout <secs> · --out <file>.

Exit 0 if at least one head answered.

The heads

Head	Provider	Key / auth
🤖 Grok	xAI	XAI_API_KEY (or local grok CLI / Hermes OAuth)
🧠 Codex	OpenAI	local codex CLI (read-only)
🧠 OpenAI	OpenAI	OPENAI_API_KEY (direct API — no local CLI needed)
🟣 GLM	Z.AI	ZAI_API_KEY
🟠 MiniMax	MiniMax	MINIMAX_API_KEY
🔵 Claude	Anthropic	ANTHROPIC_API_KEY (also the deliberation chair)
✨ Gemini	Google	GEMINI_API_KEY / GOOGLE_API_KEY

Heads with no key/CLI are skipped inline — the council runs on whatever subset you've configured, so API keys alone are enough (no local CLIs required).

MCP + wire into your harness

Roundtable ships an MCP server as a subcommand of the one binary:

roundtable mcp serve     # stdio JSON-RPC; one tool: roundtable(question, heads?, rounds?, research?)
roundtable mcp config    # prints the server JSON block to paste manually

Auto-wire detected harnesses (idempotent — backs up first, never clobbers):

roundtable install                  # detect + wire everything present
roundtable install --harness cursor,codex
roundtable install --all            # non-interactive

Wires Claude Code (skill + MCP), Cursor (~/.cursor/mcp.json), Codex CLI (~/.codex/config.toml), and prints a generic JSON block for anything else:

{ "command": "roundtable", "args": ["mcp", "serve"] }

Use in Claude Code

Roundtable ships as a Claude Code plugin — a roundtable skill that drives the CLI. Two ways to add it:

A — Plugin marketplace (inside Claude Code):

/plugin marketplace add frontier-infra/roundtable
/plugin install roundtable@roundtable

The skill calls the globally-installed roundtable CLI, so install that first: curl -fsSL https://roundtable.sh/install.sh | bash.

B — roundtable install — auto-wires the skill and the MCP server into Claude Code (plus Cursor / Codex) in one step:

roundtable install

Commands

roundtable "question"          shorthand for `ask`
roundtable ask                 run the council (all engine flags)
roundtable auth [provider]     configure API keys (masked, chmod-600)
roundtable models              per-head model picker
roundtable heads               enable/disable heads
roundtable doctor              which heads are configured + reachability ping
roundtable config              show / edit config.env
roundtable mcp serve|config    MCP stdio server / print config
roundtable install             auto-wire detected harnesses
roundtable version | update    show version / upgrade in place

For agents

Building on top of Roundtable? See AGENTS.md — a concise guide for an AI agent to install, configure, run, and wire Roundtable into its own harness.

Links

• Website & docs — https://roundtable.sh
• Source — https://github.com/frontier-infra/roundtable
• Frontier Infra — https://frontierinfra.org

License

MIT © Frontier Infra