Skip to main content

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​

In Claude​

Run these two lines in Claude Code, one after the other:

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

That is all. The plugin brings the roundtable command, the Roundtable skill, and the roundtable MCP tool. Claude Code then asks for your API keys. Every key is optional, and any one key is enough to start. Run /roundtable:setup to see which models are ready.

Command line​

uv tool install roundtable-sh

Other ways, one line each:

pipx install roundtable-sh
pip install roundtable-sh

The package is roundtable-sh. The command is roundtable. The PyPI package named roundtable is an unrelated project, so do not install it.

To use the command line tool from Claude Code without the plugin, add its MCP server:

claude mcp add --scope user roundtable -- roundtable mcp serve

Or run our installer​

Works on macOS and Linux:

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

What it does:

  • Checks that bash, python3, and curl are present.
  • Downloads Roundtable from GitHub into ~/.local/share/roundtable.
  • Links the roundtable command into ~/.local/bin, and tells you if that folder is not on your PATH.
  • Offers to run roundtable auth and roundtable install. Both are optional.

It needs no sudo and changes nothing else. Read it first at roundtable.sh/install.sh. Re-running it upgrades in place.

PATH

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:

ProviderEnv varHead
AnthropicANTHROPIC_API_KEYClaude (and the chair)
OpenAIOPENAI_API_KEYCodex / OpenAI
xAIXAI_API_KEYGrok
Z.aiZAI_API_KEYGLM
MiniMaxMINIMAX_API_KEYMiniMax
GoogleGEMINI_API_KEY / GOOGLE_API_KEYGemini

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.

Support & help
Agent view of this page