Get Started
Roundtable is a command-line tool that fans a question out to up to six frontier model "heads" in parallel and hands you one decided answer. It runs on plain API keys — no hosted account, no SSO.
Install
Pick whichever fits your setup. All four deliver the same engine.
Installer (recommended)
The canonical one-liner. Works on macOS and Linux:
curl -fsSL https://roundtable.sh/install.sh | bash
It checks dependencies (bash, curl, python3), drops the CLI into
~/.local/share/roundtable, and symlinks roundtable into ~/.local/bin. Re-running
upgrades in place.
uv
uv tool install roundtable
pip
pip install roundtable
Homebrew
brew install frontier-infra/tap/roundtable
If your shell can't find roundtable after install, add ~/.local/bin to your
PATH and restart your shell.
Authenticate
Roundtable needs at least one provider key. Run the guided prompt:
roundtable auth
It lists every provider with a ✓ (configured) or ✗ (missing), takes a masked paste,
and writes the keys to ~/.config/roundtable/config.env (chmod 600). Target a
single provider with roundtable auth <provider>.
Recognized keys:
| Provider | Env var | Head |
|---|---|---|
| Anthropic | ANTHROPIC_API_KEY | Claude (and the chair) |
| OpenAI | OPENAI_API_KEY | Codex / OpenAI |
| xAI | XAI_API_KEY | Grok |
| Z.ai | ZAI_API_KEY | GLM |
| MiniMax | MINIMAX_API_KEY | MiniMax |
GEMINI_API_KEY / GOOGLE_API_KEY | Gemini |
Heads with no key (or no local CLI) skip gracefully — the council runs with whatever subset you've configured.
Verify what's live:
roundtable doctor
Ask the council
roundtable ask "Should we ship the migration today or wait for the staging soak?"
You get back a markdown transcript: each head's independent take, then a synthesized recommendation. Narrow the panel with flags:
roundtable ask "Say OK in three words" --heads claude,gemini
Next: read How it works to understand advisory vs. deliberation mode, or jump to the CLI reference.
