Skip to content

Settings YAML reference

Default location: ~/.anthrogo/settings.yaml (override via ANTHROGO_HOME).

See Configuration for layered config rules, environment variable expansion, and system prompt overlays.

Top-level keys

Key Type Default Description
mode string default default / acceptEdits / bypassPermissions / plan
model string provider default Model ID override
provider string anthropic Active profile name
apiKey string — Anthropic API key (or env:VAR)
auto_compact_threshold int 0 Auto-compact at N tokens since last compact; 0 = disabled
cost_limit_usd float 0 Budget cap in USD; 0 = disabled
providers_failover []string — Ordered list of profile names to try if the active provider fails before any event is committed (typically API auth, rate-limit, or network errors during the initial Stream call)

alwaysAllow / alwaysDeny / alwaysAsk

alwaysAllow:
  - tool: Read
  - tool: Bash
    match: "git *"        # glob against full tool input; omit to match all calls

alwaysDeny:
  - tool: Bash
    match: "rm -rf*"

alwaysAsk:
  - tool: HTTPRequest

profiles

profiles:
  <name>:
    type: openai | bedrock | vertex | ollama    # default: openai
    base_url: https://...                        # openai / ollama only
    model: <model-id>
    api_key: env:MY_KEY                          # openai / ollama
    region: us-west-2                            # bedrock / vertex
    project_id: my-gcp-project                  # vertex only

mcpServers

mcpServers:
  <name>:
    command: npx                          # stdio only
    args: ["-y", "@mcp/server", "/tmp"]  # stdio only
    type: stdio | sse | streamable | websocket
    endpoint: https://...                 # sse / streamable / websocket
    headers:
      X-Key: env:MY_API_KEY
    subprotocols: ["mcp"]                # websocket only
    max_retries: 3                        # streamable only
    elicitation_mode: disabled            # suppress elicitation capability
    oauth:
      authorization_url: https://...
      token_url: https://...
      client_id: my-app
      scopes: [mcp.read]
      redirect_port: 8765

hooks

hooks:
  PreToolUse:
    - matcher: "Bash"           # Go regexp; omit to match all tools
      command: /path/to/hook.sh
      timeout: 30s
  PostToolUse:
    - matcher: "Write|Edit"
      command: /path/to/hook.sh
  UserPromptSubmit:
    - command: /path/to/hook.sh
  Stop:
    - command: /path/to/hook.sh
  SubagentStop:
    - command: /path/to/hook.sh
  PreCompact:
    - command: /path/to/hook.sh

pricing

pricing:
  claude-sonnet-4-6:
    input_per_m: 3.0
    output_per_m: 15.0
  "anthropic.claude-sonnet-4-6-v1:0":    # Bedrock / quoted for colon
    input_per_m: 3.0
    output_per_m: 15.0

Keys are exact model names or filepath.Match glob patterns. Rates are USD per million tokens.

theme

theme:
  name: dark   # dark | light | custom
  # custom palette (only when name: custom):
  user_prompt:  "#ff79c6"
  assistant:    "#f8f8f2"
  tool_header:  "#50fa7b"
  tool_body:    "#8be9fd"
  error:        "#ff5555"
  status_line:  "#6272a4"
  border:       "#44475a"
  modal_border: "#bd93f9"

auth (OAuth /login)

auth:
  authorization_url: https://your-idp/oauth2/authorize
  token_url:         https://your-idp/oauth2/token
  client_id:         your-client-id
  # client_secret:   optional for confidential clients
  scopes: [openid, profile]
  redirect_port: 8765

telemetry

telemetry:
  enabled: false
  endpoint: https://your-collector.example.com/events

webSearch

webSearch:
  backend: brave   # brave | google | bing | tavily | disabled
  apiKey: env:BRAVE_API_KEY
  # endpoint: optional override for default API URL