# agent.txt — Agent View Layer (AVL) manifest for roundtable.sh
# Spec: https://github.com/frontier-infra/avl · "eat our own cooking" — a Frontier Infra convention.

version: 1
content-type: text/agent-view; version=1
producer: Frontier Infra (https://frontierinfra.org)
platform: Docusaurus (static site)
discovery: [accept-header, suffix, html-alternate, link-header, manifest]
conformance: L3

# Every human route ships a parallel agent view (text/agent-view; version=1).
routes:
  - GET /.agent
  - GET /docs/get-started.agent
  - GET /docs/how-it-works.agent
  - GET /docs/the-heads.agent
  - GET /docs/cli-reference.agent
  - GET /docs/mcp-and-harness.agent
  - GET /docs/agents.agent

agent_views:
  - GET /.agent
  - GET /docs/get-started.agent
  - GET /docs/how-it-works.agent
  - GET /docs/the-heads.agent
  - GET /docs/cli-reference.agent
  - GET /docs/mcp-and-harness.agent
  - GET /docs/agents.agent

# Companion discovery resources.
companions:
  llms: https://roundtable.sh/llms.txt
  llms-full: https://roundtable.sh/llms-full.txt
  sitemap: https://roundtable.sh/sitemap.xml
  robots: https://roundtable.sh/robots.txt

# ---------------------------------------------------------------------------
# Descriptor (human + agent readable)
# ---------------------------------------------------------------------------
name: Roundtable
tagline: A council of frontier models — for the decisions that matter.
site: https://roundtable.sh
category: developer-tool, cli, mcp-server, ai-agents
license: MIT
source: https://github.com/frontier-infra/roundtable
agent-guide: https://github.com/frontier-infra/roundtable/blob/main/AGENTS.md

description: >
  Roundtable is a command-line tool and MCP server that convenes up to six frontier
  model heads (Grok, Codex/OpenAI, GLM, MiniMax, Claude, Gemini) in parallel on a
  question, optionally runs a chaired deliberation to consensus, and returns one
  decided answer. It runs on plain provider API keys — no hosted account or SSO.

# What an agent can do here:
actions:
  - id: install
    intent: Install the Roundtable CLI
    command: curl -fsSL https://roundtable.sh/install.sh | bash
    alternatives:
      - uv tool install roundtable
      - pip install roundtable
      - brew install frontier-infra/tap/roundtable
  - id: configure
    intent: Add provider API keys
    command: roundtable auth
    config-file: ~/.config/roundtable/config.env  # dotenv, chmod 600
  - id: verify
    intent: Check which model heads are configured and reachable
    command: roundtable doctor
  - id: use
    intent: Convene the council on a question
    command: roundtable ask "your question"
    flags: [-q, --rounds N, --heads a,b,c, --research, -c, --out FILE, --timeout S]
  - id: mcp-serve
    intent: Run as an MCP stdio server for a coding harness
    command: roundtable mcp serve
    mcp-config: {"command": "roundtable", "args": ["mcp", "serve"]}
  - id: wire-harness
    intent: Auto-detect and wire Roundtable into installed coding harnesses
    command: roundtable install
    supports: [claude-code, cursor, codex-cli, generic]

docs:
  - https://roundtable.sh/docs/get-started
  - https://roundtable.sh/docs/how-it-works
  - https://roundtable.sh/docs/the-heads
  - https://roundtable.sh/docs/cli-reference
  - https://roundtable.sh/docs/mcp-and-harness
  - https://roundtable.sh/docs/agents

contact: https://github.com/frontier-infra/roundtable/issues