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

@intent
  purpose:    Install Roundtable, authenticate at least one provider key, and run your first council
  audience:   developer, ai-agent
  capability: install, authenticate, verify, run

@state
  install_methods[4]{id,command}:
    installer,curl -fsSL https://roundtable.sh/install.sh | bash
    uv,uv tool install roundtable
    pip,pip install roundtable
    homebrew,brew install frontier-infra/tap/roundtable
  install_target: ~/.local/share/roundtable (symlinked into ~/.local/bin)
  config_file: ~/.config/roundtable/config.env (dotenv, chmod 600)
  provider_keys[6]{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
    Google,GEMINI_API_KEY or GOOGLE_API_KEY,Gemini
  min_keys_required: 1
  first_run: roundtable ask "your question"

@actions
  - id: install
    method: GET
    href: https://roundtable.sh/install.sh
    command: curl -fsSL https://roundtable.sh/install.sh | bash
  - id: authenticate
    method: GET
    href: https://roundtable.sh/docs/get-started
    command: roundtable auth
  - id: verify
    method: GET
    href: https://roundtable.sh/docs/get-started
    command: roundtable doctor
  - id: ask
    method: GET
    href: https://roundtable.sh/docs/cli-reference
    command: roundtable ask "your question"

@context
  > The fastest path: run the installer, run `roundtable auth` to add at least one provider key,
  > run `roundtable doctor` to confirm which heads are live, then `roundtable ask "..."`. Heads
  > with no key skip gracefully, so the council runs with whatever subset you've configured.

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