@meta
  v: 1
  route: /docs/cli-reference
  generated: 2026-06-17T00:00:00Z
  ttl: 1d

@intent
  purpose:    Reference for every Roundtable command and every ask flag
  audience:   developer, ai-agent
  capability: run, configure, automate

@state
  default_command: ask (roundtable "question" == roundtable ask "question")
  commands[11]{command,does}:
    "ask \"q\"",Convene the council on a question (default)
    auth [provider],Configure provider API keys (masked paste to config.env)
    models,Pick the model id used for each head
    heads,Enable or disable individual heads
    doctor,Show which heads are configured and reachable
    config,Show or edit ~/.config/roundtable/config.env
    mcp serve,Run the MCP stdio server
    mcp config,Print the MCP server JSON block for a harness
    install,Detect installed coding harnesses and wire each
    update,Upgrade Roundtable in place
    version,Print the installed version
  ask_flags[7]{flag,description}:
    -q,Quiet — print only the final synthesized answer
    --rounds N,Run a chaired deliberation of up to N rounds (default 1 = advisory)
    "--heads a,b,c",Restrict the panel to a comma-separated subset
    --research,Allow tool-capable heads to gather fresh context
    -c,Continue — include the previous question/answer as context
    --out FILE,Write the full transcript to FILE
    --timeout S,Per-head timeout in seconds
  exit_codes: 0 on success; non-zero only on hard failure (no heads configured, all timed out)
  config_file: ~/.config/roundtable/config.env (dotenv, chmod 600; also reads ~/.api_keys)

@actions
  - id: ask_quiet
    method: GET
    href: https://roundtable.sh/docs/cli-reference
    command: roundtable ask -q "Name one risk in this plan"
  - id: deliberate
    method: GET
    href: https://roundtable.sh/docs/cli-reference
    command: roundtable ask "Monolith or services for v1?" --rounds 3 --heads claude,grok --out decision.md
  - id: config
    method: GET
    href: https://roundtable.sh/docs/cli-reference
    command: roundtable config

@context
  > One binary, a handful of commands. `ask` is the default; everything else configures the
  > heads, keys, models, or harness wiring. Individual heads that error or time out are reported
  > inline and never fail the run as long as one head succeeds.

@nav
  self:      /docs/cli-reference.agent
  parents:   [/]
  peers:     [/docs/get-started.agent, /docs/how-it-works.agent, /docs/the-heads.agent, /docs/mcp-and-harness.agent, /docs/agents.agent]
  drilldown: /docs/mcp-and-harness.agent