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

@intent
  purpose:    Describe the six frontier-model heads, the key each seat needs, and how to configure them
  audience:   developer, ai-agent
  capability: configure-heads, choose-subset

@state
  heads[6]{name,provider,key,runs}:
    Grok,xAI,XAI_API_KEY,Direct API or an authenticated local CLI if present
    Codex / OpenAI,OpenAI,OPENAI_API_KEY,Direct API or the local codex CLI if present
    GLM,Z.ai,ZAI_API_KEY,Direct API
    MiniMax,MiniMax,MINIMAX_API_KEY,Direct API
    Claude,Anthropic,ANTHROPIC_API_KEY,Direct API — also serves as the chair
    Gemini,Google,GEMINI_API_KEY or GOOGLE_API_KEY,Direct API
  all_heads_optional: true
  missing_key_behavior: head skips gracefully; council runs with the configured subset
  clis_required: false (plain API keys are enough; a local CLI is preferred when present)

@actions
  - id: toggle_heads
    method: GET
    href: https://roundtable.sh/docs/the-heads
    command: roundtable heads
  - id: pick_models
    method: GET
    href: https://roundtable.sh/docs/the-heads
    command: roundtable models
  - id: doctor
    method: GET
    href: https://roundtable.sh/docs/get-started
    command: roundtable doctor
  - id: ask_subset
    method: GET
    href: https://roundtable.sh/docs/cli-reference
    command: roundtable ask "Review this API design" --heads claude,grok,gemini

@context
  > Six independent reasoners — different labs, different training runs, different blind spots —
  > is the whole point: a council catches what any single model misses. Claude does double duty,
  > answering as a head and acting as the chair in deliberation mode.

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