{
  "title": "Thinking Levels (/think directives)",
  "content": "* Inline directive in any inbound body: `/t <level>`, `/think:<level>`, or `/thinking <level>`.\n* Levels (aliases): `off | minimal | low | medium | high | xhigh` (GPT-5.2 + Codex models only)\n  * minimal → “think”\n  * low → “think hard”\n  * medium → “think harder”\n  * high → “ultrathink” (max budget)\n  * xhigh → “ultrathink+” (GPT-5.2 + Codex models only)\n  * `highest`, `max` map to `high`.\n* Provider notes:\n  * Z.AI (`zai/*`) only supports binary thinking (`on`/`off`). Any non-`off` level is treated as `on` (mapped to `low`).\n\n1. Inline directive on the message (applies only to that message).\n2. Session override (set by sending a directive-only message).\n3. Global default (`agents.defaults.thinkingDefault` in config).\n4. Fallback: low for reasoning-capable models; off otherwise.\n\n## Setting a session default\n\n* Send a message that is **only** the directive (whitespace allowed), e.g. `/think:medium` or `/t high`.\n* That sticks for the current session (per-sender by default); cleared by `/think:off` or session idle reset.\n* Confirmation reply is sent (`Thinking level set to high.` / `Thinking disabled.`). If the level is invalid (e.g. `/thinking big`), the command is rejected with a hint and the session state is left unchanged.\n* Send `/think` (or `/think:`) with no argument to see the current thinking level.\n\n## Application by agent\n\n* **Embedded Pi**: the resolved level is passed to the in-process Pi agent runtime.\n\n## Verbose directives (/verbose or /v)\n\n* Levels: `on` (minimal) | `full` | `off` (default).\n* Directive-only message toggles session verbose and replies `Verbose logging enabled.` / `Verbose logging disabled.`; invalid levels return a hint without changing state.\n* `/verbose off` stores an explicit session override; clear it via the Sessions UI by choosing `inherit`.\n* Inline directive affects only that message; session/global defaults apply otherwise.\n* Send `/verbose` (or `/verbose:`) with no argument to see the current verbose level.\n* When verbose is on, agents that emit structured tool results (Pi, other JSON agents) send each tool call back as its own metadata-only message, prefixed with `<emoji> <tool-name>: <arg>` when available (path/command). These tool summaries are sent as soon as each tool starts (separate bubbles), not as streaming deltas.\n* When verbose is `full`, tool outputs are also forwarded after completion (separate bubble, truncated to a safe length). If you toggle `/verbose on|full|off` while a run is in-flight, subsequent tool bubbles honor the new setting.\n\n## Reasoning visibility (/reasoning)\n\n* Levels: `on|off|stream`.\n* Directive-only message toggles whether thinking blocks are shown in replies.\n* When enabled, reasoning is sent as a **separate message** prefixed with `Reasoning:`.\n* `stream` (Telegram only): streams reasoning into the Telegram draft bubble while the reply is generating, then sends the final answer without reasoning.\n* Alias: `/reason`.\n* Send `/reasoning` (or `/reasoning:`) with no argument to see the current reasoning level.\n\n* Elevated mode docs live in [Elevated mode](/tools/elevated).\n\n* Heartbeat probe body is the configured heartbeat prompt (default: `Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`). Inline directives in a heartbeat message apply as usual (but avoid changing session defaults from heartbeats).\n* Heartbeat delivery defaults to the final payload only. To also send the separate `Reasoning:` message (when available), set `agents.defaults.heartbeat.includeReasoning: true` or per-agent `agents.list[].heartbeat.includeReasoning: true`.\n\n* The web chat thinking selector mirrors the session's stored level from the inbound session store/config when the page loads.\n* Picking another level applies only to the next message (`thinkingOnce`); after sending, the selector snaps back to the stored session level.\n* To change the session default, send a `/think:<level>` directive (as before); the selector will reflect it after the next reload.",
  "code_samples": [],
  "headings": [
    {
      "level": "h2",
      "text": "What it does",
      "id": "what-it-does"
    },
    {
      "level": "h2",
      "text": "Resolution order",
      "id": "resolution-order"
    },
    {
      "level": "h2",
      "text": "Setting a session default",
      "id": "setting-a-session-default"
    },
    {
      "level": "h2",
      "text": "Application by agent",
      "id": "application-by-agent"
    },
    {
      "level": "h2",
      "text": "Verbose directives (/verbose or /v)",
      "id": "verbose-directives-(/verbose-or-/v)"
    },
    {
      "level": "h2",
      "text": "Reasoning visibility (/reasoning)",
      "id": "reasoning-visibility-(/reasoning)"
    },
    {
      "level": "h2",
      "text": "Related",
      "id": "related"
    },
    {
      "level": "h2",
      "text": "Heartbeats",
      "id": "heartbeats"
    },
    {
      "level": "h2",
      "text": "Web chat UI",
      "id": "web-chat-ui"
    }
  ],
  "url": "llms-txt#thinking-levels-(/think-directives)",
  "links": []
}