Settings schema

{
  "default": 0.9,
  "description": "Fraction of the context window that trips the runaway guard and ends the turn."
}

{
  "default": 0.4,
  "description": "Fraction of the context window a SINGLE turn may consume before the guard trips."
}

{
  "description": "Child-process env allowlist for sandboxed tools/MCP servers — keep ONLY these names."
}

{
  "description": "Child-process env blocklist for sandboxed tools/MCP servers — drop these names."
}

{
  "default": 4,
  "description": "Global concurrent-IO cap."
}

{
  "default": 3,
  "description": "Provider-request attempts per turn: the first write plus retries of retryable failures (network/provider/auth)."
}

{
  "default": {},
  "description": "MCP servers this Agent can reach (name -> {command, args?, env?, timeout?, safe?, description?}) — package/settings scope only, never the project folder."
}

{
  "default": "all",
  "description": "Model-list exposure policy: \"local\", \"remote\", or \"all\"."
}

{
  "description": "Extra prompt roots (string or array)."
}

{
  "description": "Extra provider-class roots (string or array) — package/settings scope only."
}

{
  "default": {},
  "description": "Manually configured endpoints (name -> {provider, url, model?, timeout?, maxActive?, secret?, ...})."
}

{
  "default": 2000,
  "description": "The first request-retry delay in ms; each next attempt waits twice as long."
}

{
  "default": 30000,
  "description": "The request-retry delay ceiling in ms."
}

{
  "description": "Extra skill roots (string or array)."
}

{
  "description": "Extra tool-folder roots (string or array) — package/settings scope only."
}

{
  "default": 120000,
  "description": "Default per-tool-call timeout, in ms (a tool's own schema `timeout` overrides it)."
}

{
  "default": 1200000,
  "description": "The hard cap a tool's own `timeout` may not exceed, in ms."
}

{
  "default": {
    "cursor": {
      "blink": 450,
      "shape": "line"
    },
    "alt": false,
    "keys": {},
    "osc52": true,
    "scroll": {
      "show": true,
      "track": "│",
      "thumb": "█"
    },
    "theme": "default",
    "themes": {}
  },
  "description": "Terminal UI settings: cursor {blink, shape}, alt-screen flag, key overrides, mouse flag (true managed, false off, unset mode default), OSC 52 clipboard, scrollbar, and named themes."
}

{
  "default": {
    "autocomplete": true,
    "collapse": {
      "thinking": true,
      "tools": true
    },
    "toolLines": 6,
    "theme": "system"
  },
  "description": "Web UI settings: slash autocomplete, default collapse of thinking/tool blocks, tool-output line cap, and theme (\"system\"|\"light\"|\"dark\")."
}