@iowarp/clio-coder 0.4.5 → 0.4.6

package/docs/architecture/tui-design.md

@@ -9,6 +9,32 @@ The governing principle: **the user reads state from color, structure from frame
 
 ---
 
+## Output styles
+
+**Alt+O** cycles **Compact → Standard → Detailed → Compact**. Standard is the default, so the first press reveals Detailed. The current style appears in the footer. Cycling applies immediately to the current session, including streaming output and history. Save a preferred startup style through **/settings interface → Output style → Apply and save globally**, or `clio-coder configure --section panes`.
+
+| Content | Compact | Standard | Detailed |
+| --- | --- | --- | --- |
+| Answers and user messages | Complete | Complete | Complete |
+| Supplied reasoning | Marker | 3 rows | 12 rows |
+| Reads and searches | Consecutive successful observations grouped | Action and outcome | 8 result rows |
+| File changes | Paths and change facts | 8 diff rows | 20 diff rows |
+| Agent shell commands | Command and outcome | Command and outcome | 12 output rows |
+| Your `!` / `!!` shell commands | 3 output rows | 6 output rows | 12 output rows |
+| Workers | Identity, execution and validation outcome | 3 summary rows | 8 summary rows and bounded tool activity |
+| Failures and refusals | Actionable reason, up to 4 rows | Actionable reason, up to 4 rows | Up to 12 rows |
+| Turn receipt | None | Completion and available duration | Usage and model-call facts |
+
+Preview budgets count terminal rows **after wrapping**, including the `/view` overflow hint, and shrink on short terminals. Reasoning previews retain the newest text when streaming stops. Detailed remains bounded: a successful `cat` or file read cannot fill the transcript with the entire file.
+
+Use **/view transcript** to select full available reasoning, tool arguments/results, local shell output, or worker details. Search the list, press Enter to inspect, and Escape to return. Offloaded tool and dispatch output remains available in the other `/view` categories; missing or truncated captured content is identified. Inspection applies secret redaction, and `!!` output remains excluded from model context.
+
+Output style changes presentation only. **Shift+Tab** still changes the model's thinking effort. It does not reveal unavailable reasoning; Clio shows only reasoning supplied by the provider. The previous Alt+R, Alt+P, and expand-all rendering shortcuts are retired. `/output` now explains how to reach Alt+O and Settings. Existing `minimal`, `default`, and `verbose` preferences map to `compact`, `standard`, and `detailed` without rewriting other preferences.
+
+The footer owns live activity. Transcript actions have static running or outcome markers and update in place. Background workers add a count without replacing the main agent's current phase; a completed worker cannot clear a sibling's active state. Approval and user-input waits do not spin. Failed and cancelled turns retain their actual outcome, and an elapsed wait is described as silence rather than proof that a process is stuck. A worker's successful execution remains separate from its validation result.
+
+---
+
 ## 1. Color System
 
 All color styling is defined in [src/interactive/theme/tokens.ts](../../src/interactive/theme/tokens.ts). No raw SGR sequences, `38;2;`/`38;5;` ANSI escape fragments, or hardcoded hex colors are allowed outside this theme module.
@@ -22,7 +48,7 @@ All color styling is defined in [src/interactive/theme/tokens.ts](../../src/inte
 | `action` | `rgb(255, 126, 41)` (Orange) | Active autonomous operations: dispatching phase pills, active fleet badges, running fleet indicators, running connect/probe indicators, and user-steering queues. |
 | `success` | `rgb(87, 227, 137)` (Green) | Positive outcomes: success indicators (`✓`), ok health status, clean git trees, and output-token count updates. |
 | `warning` | `rgb(255, 180, 84)` (Amber) | Real warnings only: stale data, dirty trees, retry status, blocked tools, and truncation. |
-| `error` | `rgb(255, 92, 102)` (Red) | Failures: error indicators (`✗`), error rails, stuck states, and error message text. |
+| `error` | `rgb(255, 92, 102)` (Red) | Failures: error indicators (`✗`), error rails, failed outcomes, and error message text. |
 | `info` | `rgb(91, 168, 255)` (Blue) | Informational messages, notices, and system-prompt meters. |
 | `reason` | `rgb(157, 140, 255)` (Purple) | Reasoning-related status: thinking phases, thinking rails, reasoning-token metrics, and context compacting. |
 | `dim` | `rgb(106, 122, 133)` | Scaffolding elements: separators, key names, keyboard shortcut hints, durations, and timestamps. |
@@ -191,9 +217,9 @@ Interactive startup uses one terminal lease across both boot stages. Stage 0 own
 
 ### 5.3 Progressively Disclosed Footer
 
-- **Compact Mode (Quiet Idle)**: Two always-on lines that eliminate idle telemetry noise (suppresses `tools none`, `◌ idle`, and default-output tags):
+- **Compact Mode (Quiet Idle)**: Two always-on lines that eliminate idle telemetry noise (suppresses `tools none`, `◌ idle`, and duplicate turn receipts):
   - **Line 1 (Workspace & Readiness)**: CWD path, git branch/dirty state, and active phase pill only when meaningful.
-  - **Line 2 (Context & Receipt)**: Context window meter and the best current/last-turn receipt.
+  - **Line 2 (Context & Style)**: Context window meter, Output style, and session cost.
 - **Expanded Mode (`Alt+U`)**: Four responsive sections ordered by operational urgency rather than a static telemetry grid:
   1. `Activity`: Live agent phase, active workers, running tool calls.
   2. `Context`: Context window gauge, breakdown, token headroom.
@@ -210,15 +236,15 @@ State is signaled through the status pill in the footer and matches the followin
 |---|---|---|---|
 | idle | Quiet (phase omitted; line 1 shows workspace, line 2 shows context/receipt) | None; last-turn telemetry on line 2 | No |
 | preparing / waiting | spinner + `waiting` (info) | None | No |
-| thinking | spinner + `thinking` (reason) | Dim `Thinking (N tokens)…` marker | No |
+| thinking | spinner + `thinking` (reason) | Bounded supplied reasoning | No |
 | writing | spinner + `writing` (accent) | Streaming markdown text | No |
-| tool running | spinner + `tool <name>` (accent) | `▸` tool execution ledger line | No |
+| tool running | spinner + `Running <name>` (accent) | `▸` tool execution ledger line | No |
 | blocked | `⏸ blocked` (warning) | Permission prompt surface | No |
 | retrying | `↻ retry 2/5` (warning) | Dim retry details line | No |
 | compacting | spinner + `compacting` (reason) | None | No |
-| dispatching / fleet live | spinner + `dispatch` (action) | Task island status updates | Yes |
-| stuck | `⚠ stuck 12s` (error) | Inline watchdog warning | No |
-| done | `✓ done` (success), then quiet telemetry | Settled transcript blocks | No |
+| dispatching / fleet live | Main phase plus worker count | Task island status updates | Yes |
+| prolonged silence | `⚠ No output · 12s` (warning) | No duplicate status | No |
+| ended | Ready, Failed, Cancelled, or Output limit | Settled transcript blocks | No |
 
 ---
 
@@ -230,27 +256,18 @@ State is signaled through the status pill in the footer and matches the followin
 - **Two-Cell Hanging Indent**: User and assistant prose are rendered with a fixed two-cell gutter. The first line begins with the turn prefix (`› ` or `✦ `), while all wrapped continuation lines indent by two spaces (`PROSE_GUTTER = "  "`), keeping multiline text visibly attached to its voice glyph.
 
 ### 6.2 Thinking Blocks
-Drawn as a folded dim marker (`Thinking (N tokens)…` or `Thinking…`), which expands into a body using the `reason` color vertical `│` rail. Cap of 12 lines.
+
+Supplied reasoning stays in stream order on the `reason` color rail. Compact shows a historical marker; Standard and Detailed show the bounded tail defined in [Output styles](#output-styles). The footer alone reports current activity.
 
 ### 6.3 Tool Ledger
-Every tool call owns one stable transcript block for its complete lifecycle. Streamed
-`toolcall_*` message updates first expose the call as `forming call`, the completed argument block
-becomes `ready`, `tool_execution_start` changes the same row to `running`, and cumulative
-`tool_execution_update` results replace the live body until `tool_execution_end` settles it. Rapid
-tool updates are coalesced to terminal frame rate; settlement always renders immediately.
 
-The collapsed form is one composed ledger line:
-```
-▸ verb(object) · resource · facts · size ✓ · 230ms · full: path (Alt+O)
+Each call owns one stable action row. Argument fragments stay hidden until the call is formed. A formed call becomes ready, then running, then settles with its actual outcome. Cumulative output replaces the live preview; late partials cannot overwrite a settled result. The same policy applies during replay.
+
+```text
+▸ bash(cat README.md) · exit 0 ✓ · 230ms
 ```
-- Verb is bold `accent`, tail details are `dim`, status glyph is semantic (`✓`/`✗`), and the keyboard shortcut hint is appended at the end. Tool ledgers maintain full terminal width and bypass the prose hanging indent.
-- Expanded calls show the primary argument in the signature and every secondary argument as a typed field list. Multiline argument bodies become line and byte facts, nested objects retain structured rendering, and safety-sensitive values remain redacted.
-- Running calls label `live output` and replace the cumulative partial result in place. Settled calls label `output` and show available exit status, result or observation counts, line count, displayed and total byte sizes, truncation, timeout, tool-token usage, dynamically added tools, context exclusion, and the full-output path. A blocked or aborted admission instead labels its `decision` and does not claim that the tool ran.
-- A call parked for one-shot approval replaces its running timer with `awaiting approval` and shows the already-sanitized action class, asking safety axis, and target below the row. These facts are transient UI state: approval, denial, abort, or settlement clears them, and they are never reconstructed from the session ledger.
-- The live permission frame derives its consequence tier from those typed facts and the authenticated origin. It anchors at bottom center with five rows reserved for the composer and footer, and it recomputes that anchor on resize. Each queued frame retains its own tier and requester.
-- Text and image tool results keep their text while rendering images as MIME and byte-size placeholders; base64 image data is never written to the terminal.
-- Successful `edit` and `write` calls render the bounded diff produced by the tool result. Live regular-screen and fullscreen rows color removed and added lines with the `error` and `success` tokens and emphasize changed words; `/resume` replay and `/export` keep the same numbered diff as plain text.
-- Operator `!` and `!!` bash commands use the same running and settled block as model-initiated bash. The block appears before the process starts, streams the throttled cumulative stdout/stderr tail, and settles in place while the existing `bashExecution` session entry remains the durable record. `!!` continues to exclude that record from model context and says so in the block.
+
+Successful reads and shell commands keep raw content out of Standard. Mutations show bounded diffs, and failures keep actionable context in every preset. `/view transcript` exposes full available arguments and results. Approval rows show the sanitized action and target, with no running spinner. Truncation, context exclusion, offload paths, refusal, cancellation, and missing results remain visible.
 
 ### 6.4 Editor Rail
 The right-hand label shows `model · thinking`. Thinking level colors map as: `off` (dim), `minimal`/`low` (muted), `medium`/`high` (`reason` purple), and `xhigh`/`max`/`on` (bold `reason` purple).
@@ -258,11 +275,9 @@ The right-hand label shows `model · thinking`. Thinking level colors map as: `o
 ### 6.5 Transcript Notices
 Replay and system tags (e.g. `[retry]`, `[model]`) are wrapped in `dim` brackets with a `muted` message. Retry tags use `warning` amber.
 
-### 6.6 Output Verbosity Receipts
-Turn usage receipts rendered at the bottom of completed turns respect the output verbosity configuration:
-- `minimal`: Omits the turn usage receipt entirely.
-- `default`: Renders one compact dim receipt: `turn · in <N> · out <M>`.
-- `verbose`: Renders the full receipt with model call counts (`over N calls`), cache reads/writes (`cache R/W`), reasoning tokens with provenance (`reasoning N provider` or `reasoning ≈N estimated`), and the verification caveat (`· reasoning text is a UI excerpt, not a verification`).
+### 6.6 Output Style Receipts
+
+Compact omits the separate turn receipt. Standard shows a small completion line with available duration. Detailed includes model calls, input/output tokens, cache usage, and supplied reasoning usage with provenance. Reasoning text is an excerpt, not verification. The quiet footer keeps the style and session cost visible; detailed telemetry is available through Detailed or the expanded dashboard.
 
 ### 6.7 Code Ink (Syntax Highlighting)
 

package/docs/guide/commands-and-modes.md

@@ -189,7 +189,6 @@ The registry table below lists the available interactive slash commands. On a ba
 | `/panes` | `/panes show <run-or-agent> \| /panes open <preset-or-argv> \| /panes zoom [target] \| /panes close [target]` | Inspect the pane layer, watch a live run in a pane, or open a utility pane (`files`, `logs`, `shell`, `files --once`, or a command); a second open focuses the pane already there |
 | `/files` | `/files [open\|close\|pick]` | Toggle the files pane docked below the session; picks land in the composer as `@` mentions. See [Panes and the Files Pane](panes-and-files.md) |
 | `/thinking` | `/thinking [level]` | Set the chat thinking level, or open Settings → Orchestrator |
-| `/output` | `/output [verbosity]` | Set transcript detail (minimal, default, verbose), or open Settings → Terminal |
 | `/model` | `/model [pattern]` | Open model selector or set a model |
 | `/settings` | `/settings [chat\|fleet\|targets\|context\|safety\|interface\|integrations] [group]` | Open interactive settings, optionally at a durable area and UI group |
 | `/resume` | `/resume` | Resume a past session |
@@ -344,7 +343,7 @@ text is still there to correct, rather than having to be retyped. Retired spelli
 
 The accepted spelling of every command is the table under [Interactive Slash Commands](#interactive-slash-commands); there is exactly one per operation, and nothing else is parsed as a command.
 
-Configuration lives in one place: the `/settings` overlay. `/settings <section>` reaches every section directly. `/thinking <level>`, `/output <verbosity>`, and `/model <pattern>` stay as quick setters that apply without opening anything.
+Configuration lives in one place: the `/settings` overlay. `/settings <section>` reaches every section directly. `/thinking <level>` and `/model <pattern>` stay as quick setters that apply without opening anything.
 
 Settings → Targets presents an operational console table (`HEALTH`, `ID`, `ROLES`, `RUNTIME`, `LATENCY`) with an in-place action/detail drawer for URL, default model, last probe error, and reachability. `Enter` opens actions for `Use` (switches active chat target and rebases model), `Connect` (runs the API-key or OAuth flow then probes), `Probe`, and `Remove` (with preflight analysis of affected routes/profiles). Probing runs live when the overlay opens or when explicitly requested. Target creation is initiated via `clio-coder targets add`.
 
@@ -357,13 +356,7 @@ or `◇ codex (acp) · run 7hq2ab` for ACP peers), the worker's prose down a rai
 one coalesced line of tool names, and a one-line footer carrying the outcome glyph,
 token count, duration, and contract status (such as `└ ✓ ok · 8.4k tok · 18s · contract unmeasured`),
 with the failure reason printed on the rail above the footer when a run fails.
-Runs the model itself asked for through the dispatch tool render as folded `◆`
-cards under the spawning tool segment; operator-typed runs are `◇` and open.
-The footer chip in the status line splits them (such as `◇1 ◆3`). `Alt+O` toggles
-the newest foldable item (tool call or worker block), while `Ctrl+Alt+O` or
-`Alt+Shift+O` toggles every one. Memory workers on the background target never
-appear as transcript blocks. A run that fails over keeps one block and gains an
-`↻ failed over → attempt 2 on node-b/example-coder-model` line inside it.
+Model-launched workers use `◆` and operator-launched workers use `◇`; both follow the same Output style. Standard shows a short reported summary, Detailed adds bounded activity, and Compact keeps identity and outcome. The footer shows the active worker count alongside the main agent's phase. Use `/view transcript` or `/view dispatch:<runId>` for full available details. Memory workers do not appear as transcript blocks. A failover keeps one block with an attempt annotation.
 
 That block is the only place a `/run` answer goes. The main agent is not told
 about it, which is what makes a side run a side run; asked about the answer, it
@@ -483,11 +476,7 @@ editor reserves and can be rebound through `settings.yaml.keybindings`.
 | `Alt+B` | Open the composite session and operator task board (`/tasks`). Approved application-boundary override of editor word-back. |
 | `Alt+D` | Open the settled interview decision board (`/decisions`). Approved application-boundary override of editor word-delete. |
 | `Alt+S` / `Ctrl+Alt+B` | Convert an active attached dispatch to a detached background batch. |
-| `Alt+O` | Toggle the newest tool call or worker block between collapsed subline and full body. |
-| `Ctrl+Alt+O` / `Alt+Shift+O` | Toggle all tool calls and worker blocks between collapsed sublines and full bodies. |
-| `Alt+P` | Toggle streaming partial tool output in expanded tool bodies. |
-| `Alt+R` | Toggle the latest thinking block between hidden marker and full body. |
-| `Ctrl+Alt+R` / `Alt+Shift+R` | Toggle all thinking blocks between hidden markers and full bodies. |
+| `Alt+O` | Cycle Output style: Compact, Standard, Detailed. Session only; save a default in `/settings interface`. |
 | `Alt+G` | Open the current input in an external editor. |
 | `Alt+X` | Dismiss footer notifications. |
 | `Ctrl+G`, then a letter | Portable leader fallback for Alt-letter actions. |
@@ -757,17 +746,29 @@ model-free.
 `outline`, `deps`, and `dependents` resolve an exact indexed path or a unique
 substring match.
 
-## Reasoning and Live Thinking Controls
+## Output styles
 
-Clio Coder features direct, interactive controls for model reasoning and thinking streams:
+**Alt+O** cycles **Compact → Standard → Detailed → Compact**. Standard is the default, so the first press reveals Detailed. The current style appears in the footer. Cycling applies immediately to the current session, including streaming output and history. Save a preferred startup style through **/settings interface → Output style → Apply and save globally**, or `clio-coder configure --section panes`.
 
-- **Thinking Level (`Shift+Tab`):** Allows operators to cycle through available thinking configurations. This is useful for dialing model reasoning budgets up or down in real time.
-- **Thinking Blocks Toggle (`Alt+R`):** Toggles the latest assistant thinking block between a compact, single-line folded marker and an expanded, full-body view.
-- **All Thinking (`Ctrl+Alt+R` / `Alt+Shift+R`):** Toggles every thinking block in the transcript.
-- **Tool Body Toggle (`Alt+O`) / All Tools (`Ctrl+Alt+O` / `Alt+Shift+O`):** Expand the latest tool or every tool body. The single-target key takes the newest foldable thing of either kind, so a worker card that just landed opens before the tool call above it; exactly one surface advertises the chord at a time.
-- **Live Tool Output (`Alt+P`):** Pause or resume cumulative partial tool output in expanded live tool bodies; the tool still executes.
-- **Live Streaming:** During active assistant turns, thinking increments stream live into the chat panel down a rail-prefixed segment. Reasoning totals marked `≈` are approximations from visible text; provider-reported totals are shown without that marker. Neither implies complete or cryptographically verified hidden reasoning.
-- **Thinking Replay:** When continuing a conversation, prior thinking is preserved and replayed in the history according to target-specific rules.
+| Content | Compact | Standard | Detailed |
+| --- | --- | --- | --- |
+| Answers and user messages | Complete | Complete | Complete |
+| Supplied reasoning | Marker | 3 rows | 12 rows |
+| Reads and searches | Consecutive successful observations grouped | Action and outcome | 8 result rows |
+| File changes | Paths and change facts | 8 diff rows | 20 diff rows |
+| Agent shell commands | Command and outcome | Command and outcome | 12 output rows |
+| Your `!` / `!!` shell commands | 3 output rows | 6 output rows | 12 output rows |
+| Workers | Identity, execution and validation outcome | 3 summary rows | 8 summary rows and bounded tool activity |
+| Failures and refusals | Actionable reason, up to 4 rows | Actionable reason, up to 4 rows | Up to 12 rows |
+| Turn receipt | None | Completion and available duration | Usage and model-call facts |
+
+Preview budgets count terminal rows **after wrapping**, including the `/view` overflow hint, and shrink on short terminals. Reasoning previews retain the newest text when streaming stops. Detailed remains bounded: a successful `cat` or file read cannot fill the transcript with the entire file.
+
+Use **/view transcript** to select full available reasoning, tool arguments/results, local shell output, or worker details. Search the list, press Enter to inspect, and Escape to return. Offloaded tool and dispatch output remains available in the other `/view` categories; missing or truncated captured content is identified. Inspection applies secret redaction, and `!!` output remains excluded from model context.
+
+Output style changes presentation only. **Shift+Tab** still changes the model's thinking effort. It does not reveal unavailable reasoning; Clio shows only reasoning supplied by the provider. The previous Alt+R, Alt+P, and expand-all rendering shortcuts are retired. `/output` now explains how to reach Alt+O and Settings. Existing `minimal`, `default`, and `verbose` preferences map to `compact`, `standard`, and `detailed` without rewriting other preferences.
+
+The footer owns live activity. Transcript actions have static running or outcome markers and update in place. Background workers add a count without replacing the main agent's current phase; a completed worker cannot clear a sibling's active state. Approval and user-input waits do not spin. Failed and cancelled turns retain their actual outcome, and an elapsed wait is described as silence rather than proof that a process is stuck. A worker's successful execution remains separate from its validation result.
 
 ## TUI Surface Refinements
 
@@ -775,7 +776,7 @@ The Clio TUI has been enhanced to maximize readability, operational focus, and c
 
 - **Adaptive Welcome Launchpad:** Before the first prompt, renders a compact launchpad with bold CAPS section tags (`WORKSPACE`, `ROUTE`, `NEXT`), honest readiness indicators, and context-sensitive next actions. Upon first prompt submission, it deliberately collapses into a single-line session header (`>C_ Clio Coder vX.Y.Z · <workspace · git branch> · <target·model · ready> · ctx ready · type a task`) so the conversation transcript owns the viewport.
 - **Unmistakable Clio Composer:** The input editor features an explicit left section tag reflecting current prompt semantics (`MESSAGE` while idle, `FOLLOW-UP` while Clio runs, and orange `STEER` when Enter steers in-flight execution). Includes the dim placeholder `Ask Clio…  / for commands` and lower-rail hint `Enter send · Shift+Enter newline` at wider widths.
-- **Progressively Disclosed Footer:** The compact footer uses a quiet two-zone status layout that suppresses idle decoration (`tools none`, `◌ idle`, and default-output tags). Line 1 displays workspace location, git branch/dirty state, and active phase only when meaningful; Line 2 displays the context window gauge and best current/last-turn receipt. `Alt+U` toggles the expanded dashboard, which orders information by operational urgency (Activity, Context, Session, Workspace).
+- **Progressively Disclosed Footer:** The compact footer uses a quiet two-zone status layout that suppresses idle decoration (`tools none`, `◌ idle`, and duplicate turn receipts). Line 1 displays workspace location, git branch/dirty state, and active phase only when meaningful; Line 2 displays the context window gauge, current Output style, and session cost. `Alt+U` toggles the expanded dashboard, which orders information by operational urgency (Activity, Context, Session, Workspace).
 - **Footer Notification Degradation Ladder:** The footer notification badge reserves the severity head (`glyph count noun`) and `[Alt+X] dismiss` tail first, allocating remaining width to an ellipsized message body. Under narrow terminal constraints, it degrades cleanly down the ladder without clipping action keys.
 - **Grouped Slash Command Palette:** Typing `/` opens an autocomplete command palette grouped by operational category (`Run`, `Inspect`, `Configure`, `Sessions`) with compact argument hints. Every suggestion is the command's one canonical spelling.
 - **Voice-First Transcript & Receipts:** User (`› `) and assistant (`✦ `) prose are formatted with a two-cell hanging indent, ensuring wrapped continuation lines remain visually tied to their voice prefix. Tool ledgers maintain full terminal width. Completed turn receipts honor output verbosity (`minimal` none, `default` compact dim `turn · in N · out M`, `verbose` full receipt with call counts, cache reads/writes, reasoning provenance, and verification caveats).
@@ -822,7 +823,7 @@ The detail pane displays structured descriptions, usage, or state metadata using
 ### Responsive Width Adaptation
 
 All TUI overlays fluidly adapt to narrow terminals down to 40 columns:
-- Split overlays such as `/view` gracefully fall back to a single-pane presentation with `[Tab]` switching between list and content panes.
+- `/view` falls back to one pane on narrow terminals. Type to filter, use Enter to read, Escape to return to the list, and Escape again to close. Ctrl+U clears the filter; long text wraps and scrolls. Tab also switches panes.
 - Settings provides a drill-down navigation stack below 72 columns (sections → rows → details) with breadcrumbs and `Esc` backtracking.
 - Text content and detail descriptions wrap cleanly without line truncation.
 

package/docs/guide/configuration-and-targets.md

@@ -47,26 +47,120 @@ configured remote before synchronization can run. See
 
 ## First-run flow
 
-From a source checkout:
+After [installing Clio](installation-and-lifecycle.md), run `clio-coder configure`
+from the repository you want to work on. The launcher has three choices:
 
-```bash
-git clone https://github.com/iowarp/clio-coder.git
-cd clio-coder
-corepack enable pnpm
-pnpm install --frozen-lockfile
-pnpm run install:local
-hash -r
-clio-coder --version
+```text
+❯ Quick Connect    endpoint → model → ready
+  Settings         all configuration options
+  Diagnostics      check an existing installation
 ```
 
-Then start from the repository you want Clio to work on:
+Choose **Quick Connect**:
+
+1. Enter your endpoint URL. Examples: `localhost:1234` for LM Studio,
+   `localhost:11434` for Ollama, or the URL supplied by your API provider.
+2. Enter an API key if requested. Native local servers that work without a key
+   skip this step. Other APIs offer a key field even when their model list is
+   public, because chat may still require authentication; leave it blank only
+   for a keyless server.
+3. Choose a model if the endpoint offers several. Type to filter the list,
+   use arrows to move, and Enter to select. A single model is selected for you.
+4. Review the endpoint and model, then choose **Connect**. Run `clio-coder` to
+   start coding. Starting `clio-coder` itself without a target opens this same
+   launcher and continues into chat after setup succeeds.
+
+Quick Connect detects LM Studio, Ollama, and LiteLLM where their discovery APIs
+are available; other servers use the OpenAI- or Anthropic-compatible protocol.
+It checks live model discovery, without sending a generation request. An
+unreachable endpoint or empty model list stays in setup with a useful error.
+Use **Settings → Targets & Auth → Add a target** for browser sign-in,
+subscriptions, AWS credentials, explicit runtime selection, or a server that
+needs a manually entered model id.
+
+A first connection powers both chat and dispatched workers. Connecting again
+changes chat; existing fleet and background assignments, target capabilities,
+and preferences remain in place. A saved matching endpoint reuses its credential.
+New endpoints never inherit an unrelated provider key. Pasted keys are masked
+and saved locally only when you choose **Connect**.
+
+Escape goes back one step, including from the review screen. Ctrl+U clears a
+text field or model filter; Ctrl+C quits. In ordinary menus, `q` also quits;
+in the model filter it is text. Cancelling leaves the connection draft unsaved.
+Leaving first setup without a chat target exits 130. Use
+`clio-coder configure --quick` to open this path directly.
+
+## Recommended defaults
+
+Quick Connect uses the shipped defaults, with no separate preset to maintain.
+These aim to make one coding session useful on a laptop or a shared endpoint:
+
+| Area | Default and purpose |
+| --- | --- |
+| Connection | One endpoint and model for chat and the fleet default on first setup. No separate model assignments to learn. |
+| Autonomy | `auto-edit`: workspace edits are allowed; unrecognized commands need approval. The safety policy still applies. |
+| Parallel work | One worker at a time, so a single local model or shared endpoint is not flooded by default. Explicit `auto` still allows four workers. |
+| Worker permissions | Deny worker tool requests that need approval (`deny`), returning a structured denial so the worker can continue. This works across native and external runtimes. Interactive operator escalation is available for mediated runtimes in Settings. |
+| Cost | $5 tracked session budget. This depends on reported usage and known pricing; it is not a provider billing cap. |
+| Thinking | Low for chat, off for workers; actual support depends on the chosen model. |
+| Model limits | Runtime/model discovery supplies limits where available. `chat.maxOutputTokens: 0` uses the resolved model limit. Unknown models still use Clio's fallback limits; set a capability override in Settings if the server cannot advertise its actual capacity. |
+| Long sessions | Automatic compaction at 80% context pressure, with working-set management enabled. Compaction uses the chat model. |
+| Bounded work | Up to 3 chat retries, 2 worker retries, 60 chat tool calls per turn, 150 tool calls per worker run, and a 15-minute internal worker timeout. |
+| Background activity | Prompt prewarm is off. Memory stays rules-only without a separate memory route. No automatic peer setup or library sync. |
+| Terminal | Regular terminal mode, smooth streaming on automatic TTY detection, no panes or desktop notifications. |
+| Extensions and trust | No configured external peers or runtime plugins; project resource imports are untrusted by default. |
+
+Newly initialized settings contain these values. Existing explicit values are
+preserved; omitted keys inherit the current shipped defaults. For this release,
+the changed defaults are worker concurrency `1`, prewarm `false`, and smooth
+streaming `auto`. See the
+[full settings reference](configuration-reference.md) for every key.
+
+## Advanced settings
+
+Choose **Settings**, or run `clio-coder configure --settings`, to open the full
+configuration menu:
+
+- **Targets & Auth**: add, edit, rename, or remove a target; choose chat, fleet,
+  and background-memory defaults. Add and Edit share the full target wizard.
+  Adding a target preserves existing defaults. Editing preserves its other
+  capabilities, gateway settings, and role-specific model overrides. Rename
+  updates the target name and its references together.
+- **Models & Thinking**, **Chat Defaults**, **Fleet**, **Permissions & Autonomy**,
+  **Panes & Layout**, and **Skills & Extensions** cover common settings.
+- **Diagnostics** shows paths, runs the read-only doctor, and displays saved YAML.
+- **All Settings** opens a validated editor for every settings key, including
+  fleet profiles, routing, memory, compaction, plugins, hooks, and keybindings.
+
+Escape returns to the parent menu, which remembers the selected row. Each
+accepted setting is saved immediately; leaving another field does not undo
+previously accepted settings. Clear a model override or list by deleting its
+prefilled text before accepting it. The full target wizard instead saves at
+**Save target** after review. Pasted keys wait for Save; browser sign-in stores
+credentials when sign-in succeeds. Optional delegation review follows Save.
+
+Open a section directly, or open the full editor:
 
 ```bash
-cd /path/to/your/repo
-clio-coder doctor --fix
-clio-coder configure --list
+clio-coder configure --section targets
+clio-coder configure --section models
+clio-coder configure --edit
 ```
 
+The editor uses `VISUAL`, then `EDITOR`, then an available `nano` or `vi`. It edits
+a temporary draft, validates it against the same schema Clio uses at startup,
+and asks you to save, return to the editor, or discard. Invalid YAML or settings
+never replace the saved file. A save keeps the previous file at
+`settings.yaml.bak` and refuses to overwrite concurrent changes. `--edit` also
+works when malformed settings prevent the regular menu from loading.
+
+These commands edit user settings. Approved project settings and session
+choices can override them; use `clio-coder config inspect` to see the active
+sources. Without a terminal, `--section` prints its values and exits; `--json`
+and `--list` inspect settings and runtimes without initializing an installation.
+Dumb terminals retain the numbered prompt fallback; Quick Connect requires a
+regular interactive terminal. Use explicit flags for unattended target setup.
+
 Start one local runtime and register exactly one target first. Clio integrates with popular local inference engines:
 - **[LM Studio](https://lmstudio.ai):** A desktop application to run LLMs locally. Target runtime ID: `lmstudio`.
 - **[Ollama](https://ollama.com):** A lightweight, extensible framework for building and running LLMs locally. Target runtime ID: `ollama-native`.
@@ -75,8 +169,8 @@ Start one local runtime and register exactly one target first. Clio integrates w
 - **[SGLang](https://github.com/sgl-project/sglang):** A fast serving framework for large language models. Target runtime ID: `sglang`.
 - **[LiteLLM](https://docs.litellm.ai):** An OpenAI-compatible gateway that publishes routed models across multiple inference endpoints. Target runtime ID: `litellm`.
 
-First-run onboarding always completes a valid orchestrator before it offers any
-worker-only colleague. If `agy` is already on `PATH`, the final optional step is
+The full target wizard completes a valid orchestrator before it offers any
+worker-only colleague. Quick Connect skips this optional review. If `agy` is already on `PATH`, the final optional step is
 named **Antigravity CLI — experimental local delegation**. It runs only the
 non-generating model-catalog probe, explains that Clio uses the operator's
 existing local session without inspecting credentials, and can create and bind a
@@ -177,7 +271,7 @@ chat:
     favorites: []
     recentLimit: 12
   maxOutputTokens: 0
-  prewarm: true
+  prewarm: false
 
 fleet:
   default:
@@ -188,7 +282,7 @@ fleet:
   rosters: {}
   agentProfiles: {}
   nodes: []
-  concurrency: auto
+  concurrency: 1
 
 context:
   workingSet:
@@ -216,8 +310,8 @@ safety:
     enabled: false
 
 interface:
-  outputDetail: default
-  smoothStreaming: off
+  outputDetail: standard
+  smoothStreaming: auto
   mode: regular
   fullscreenScrollbar: auto
   terminalProgress: false
@@ -584,7 +678,7 @@ each as a stable deep link:
 | `targets` | Runtime connections, advertised models, auth metadata, and capability overrides |
 | `context` | Working set, compaction, and proactive memory |
 | `safety` | Autonomy, cost/tool/read limits, and the optional review watchdog |
-| `interface` | Output detail, terminal behavior, notifications, keybindings, and experimental pane settings |
+| `interface` | Output style, terminal behavior, notifications, keybindings, and experimental pane settings |
 | `integrations` | Project-resource trust, external agents, runtime plugins, resource library, and Git attribution |
 
 The Center groups rows with task-oriented labels such as Orchestrator, Targets,
@@ -617,7 +711,7 @@ This is the version-2 durable schema shipped in `DEFAULT_SETTINGS`. Validation i
 | `chat.modelPicker.favorites` | `[]` | list of target/model references | immediately |
 | `chat.modelPicker.recentLimit` | `12` | integer ≥ 1 | immediately |
 | `chat.maxOutputTokens` | `0` | integer ≥ 0; `0` uses the model cap or the 32,768-token fallback when unknown | next turn |
-| `chat.prewarm` | `true` | boolean | next turn |
+| `chat.prewarm` | `false` | boolean | next turn |
 | `chat.retry.enabled` | `true` | boolean | next turn |
 | `chat.retry.maxRetries` | `3` | integer ≥ 0 | next turn |
 | `chat.retry.baseDelayMs` | `2000` | integer ≥ 0 | next turn |
@@ -643,7 +737,7 @@ This is the version-2 durable schema shipped in `DEFAULT_SETTINGS`. Validation i
 | `fleet.permissions.mode` | `deny` | `deny`, `fail`, `escalate` | next dispatch |
 | `fleet.permissions.escalation.timeoutMs` | `120000` | integer ≥ 1 | next dispatch |
 | `fleet.permissions.escalation.fallback` | `deny` | `deny` or `fail` | next dispatch |
-| `fleet.concurrency` | `auto` | `auto` or integer ≥ 1 | restart |
+| `fleet.concurrency` | `1` | `auto` or integer ≥ 1 | restart |
 | `fleet.retry.maxRetries` | `2` | integer ≥ 0 | next dispatch |
 | `fleet.retry.routeCooldownMs` | `15000` | integer ≥ 0 | next dispatch |
 | `fleet.limits.toolCallsPerRun` | `150` | integer ≥ 1 | next dispatch |
@@ -695,10 +789,10 @@ The safety-limit leaves have no one-process `CLIO_CODER_*` overrides in the curr
 | Key | Default | Validation | When it applies |
 | --- | --- | --- | --- |
 | `interface.terminalProgress` | `false` | boolean | next turn |
-| `interface.outputDetail` | `default` | `minimal`, `default`, `verbose` | next turn |
+| `interface.outputDetail` | `standard` | `compact`, `standard`, `detailed` | immediately |
 | `interface.mode` | `regular` | `regular` or `fullscreen` | restart |
 | `interface.fullscreenScrollbar` | `auto` | `hidden`, `auto`, `always` | restart |
-| `interface.smoothStreaming` | `off` | `off`, `auto`, `on` | immediately |
+| `interface.smoothStreaming` | `auto` | `off`, `auto`, `on` | immediately |
 | `interface.desktopNotifications` | `false` | boolean | next turn |
 | `interface.panes.enabled` | `off` | `auto`, `embedded`, `off` | restart |
 | `interface.panes.notifications` | `failures` | `failures`, `all`, `off` | immediately |
@@ -779,10 +873,11 @@ Review and connect detected agents with:
 clio-coder configure --interop
 ```
 
-On a terminal this walks the pending proposals one at a time, showing the exact
-YAML entry before it asks, and writes only what you answer yes to. Without a
+On a terminal this shows one list of pending proposals with their launch
+commands. Space selects peers and Enter confirms the selection. Without a
 TTY it prints the proposals and exits 0 with `settings.yaml` byte-identical.
-The interactive `clio-coder configure` wizard ends with the same review, and
+The full target wizard in Settings offers the same review after saving
+the first primary target; Quick Connect skips it. Also,
 `/agents connect` in the TUI opens the same flow.
 
 No code path writes `integrations.externalAgents.entries` without an operator

package/docs/guide/configuration-reference.md

@@ -20,7 +20,7 @@ Precedence, where several surfaces set the same value: a one-run CLI flag beats
 | `chat.modelPicker.cycleSet` | `[]` | Exact `target` or `target/model` refs Alt+J/Alt+K cycle through (refs with an empty target part are dropped); session-owned routing state, immediate this session, saved default next session. | session routing (Alt+J/K, `/settings`) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `chat.modelPicker.favorites` | `[]` | Exact `target/model` refs pinned in the focused model picker; refs naming an unconfigured target are dropped at validation; applies immediately. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `chat.modelPicker.recentLimit` | `12` | How many recently selected `target/model` refs `recent-models.json` keeps (integer >= 1); applies immediately. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
-| `chat.prewarm` | `true` | Whether the known prompt prefix is sent to a `local-native` server at session start, after resume, and after compaction to fill its prefix cache (boolean; no effect on other tiers, workers, headless); applies next turn. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
+| `chat.prewarm` | `false` | Whether the known prompt prefix is sent to a `local-native` server at session start, after resume, and after compaction to fill its prefix cache (boolean; no effect on other tiers, workers, headless); applies next turn. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `chat.retry.baseDelayMs` | `2000` | First backoff delay in ms for chat-loop retries, doubled per attempt up to `maxDelayMs` (integer >= 0); applies next turn. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `chat.retry.enabled` | `true` | Master switch for transient-provider retries in the interactive chat loop (boolean); dispatched workers use `fleet.retry.maxRetries` instead; applies next turn. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `chat.retry.maxDelayMs` | `60000` | Ceiling in ms on the exponential backoff between chat-loop retries (integer >= 0); applies next turn. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
@@ -52,7 +52,7 @@ Precedence, where several surfaces set the same value: a one-run CLI flag beats
 | `fleet.adaptiveRouting.roles` | `[]` | Execution roles (`researcher`, `verifier`, `reviewer`, `judge`) for which measured joint routing may change execution; unlisted roles only record a shadow recommendation; applies next dispatch. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `fleet.agentProfiles` | `{}` | Map of native agent id to a `fleet.profiles` name so that agent's dispatches use that route (`auto` is reserved; ACP agents cannot be bound); applies next dispatch. | `run --target` > `run --agent-profile` > session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `fleet.agentProfiles.<key>` |  | One binding: the key is the native agent id, the value the `fleet.profiles` name used when that agent is dispatched without an explicit profile; applies next dispatch. |  |
-| `fleet.concurrency` | `auto` | Maximum concurrently running local workers: `auto` currently resolves to the compiled default of 4, or set an integer >= 1; applies at restart. |  |
+| `fleet.concurrency` | `1` | Maximum concurrently running local workers: `auto` currently resolves to the compiled default of 4, or set an integer >= 1; applies at restart. |  |
 | `fleet.default.model` | `null` | Saved default model id for workers (string or null; null rebases to the target's `defaultModel`); applies next session. | `run --model` > selected `fleet.profiles` route model > session routing (`/settings`) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `fleet.default.target` | `null` | Saved default target id for dispatched workers and `/run` (configured id or null; dangling ids become null); seeds session routing, so applies next session. | `run --target` > `run --agent-profile`/`--agent-runtime` > `fleet.agentProfiles` binding to a `fleet.profiles` route > session routing (`/settings`) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `fleet.default.thinkingLevel` | `off` | Saved default thinking level for workers (`off` through `max`); applies next session. | `run --thinking` > selected `fleet.profiles` route thinkingLevel > session routing (`/settings`) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
@@ -115,7 +115,7 @@ Precedence, where several surfaces set the same value: a one-run CLI flag beats
 | `interface.keybindings` | `{}` | Map of binding id (`clio-coder.*`; legacy `clio.*` ids are renamed) to a key string or list of key strings; invalid bindings are reported at boot; applies immediately. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `interface.keybindings.<key>` |  | One rebinding: the key is a binding id such as `clio-coder.notifications.dismiss`, the value a key string or a list of alternatives; applies immediately. |  |
 | `interface.mode` | `regular` | Renderer: `regular` keeps scrollback, `fullscreen` uses the alternate screen with a sticky layout; applies at restart. |  |
-| `interface.outputDetail` | `default` | Transcript detail level: `minimal`, `default`, `verbose`; applies next turn. | session override (`/output`, `/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
+| `interface.outputDetail` | `standard` | Output style: `compact`, `standard`, `detailed`; applies immediately. Legacy `minimal`/`default`/`verbose` values are accepted. | session override (Alt+O, `/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `interface.panes.enabled` | `off` | Pane-host rung: `auto` detects a guest pane host, `embedded` asks Clio to own a session (behaves as `auto` until implemented), `off` skips detection; applies at restart. | `--no-panes` / `--with-panes` (`--with-panes` keeps a saved `embedded`, otherwise `auto`) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `interface.panes.files.enabled` | `false` | Whether the files pane (yazi) may open (boolean); applies on the next files-pane open. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `interface.panes.files.followCwd` | `true` | Whether the files pane follows the conversation's working directory (boolean); applies on the next files-pane open. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
@@ -125,7 +125,7 @@ Precedence, where several surfaces set the same value: a one-run CLI flag beats
 | `interface.panes.layout` | `off` | Docks composed at interactive boot in guest mode: `off` opens nothing, `workers` opens the workers dock, `cockpit` opens workers and files; applies at restart. |  |
 | `interface.panes.notifications` | `failures` | Which terminal run states raise a pane-host toast: `failures`, `all`, `off`; applies immediately. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `interface.panes.workers.ratio` | `0.34` | Share of terminal width the workers dock takes (number 0.05 through 0.5); applies at restart. |  |
-| `interface.smoothStreaming` | `off` | Presentation-only pacing of streamed assistant text and thinking: `off`, `auto` (TTY heuristics), `on`; applies immediately. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
+| `interface.smoothStreaming` | `auto` | Presentation-only pacing of streamed assistant text and thinking: `off`, `auto` (TTY heuristics), `on`; applies immediately. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `interface.terminalProgress` | `false` | Whether terminal progress (OSC progress) is emitted while a turn runs (boolean); applies next turn. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `safety.autonomy` | `auto-edit` | Baseline autonomy for tool admission: `read-only`, `suggest`, `auto-edit`, `full-auto`; applies immediately (an ACP session's own autonomy wins inside that session). | `run --autonomy` (stored as the session override `safety.autonomy`) > session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
 | `safety.limits.chatToolCallsPerTurn` | `60` | Soft per-turn tool-call budget for the chat agent (integer >= 1); crossing it blocks further calls with a stop-and-summarize directive, the hard ceiling sits 15 above; applies next turn. | session override (`/settings` apply-this-session) > `.clio-coder/settings.local.yaml` > `.clio-coder/settings.yaml` > user settings.yaml > default |
@@ -359,6 +359,11 @@ Grouped by command. Global flags appear under `global`.
 | `--api-key-env` | Name of the environment variable read for the target's API key at call time, instead of storing a literal. |
 | `--background-model` | Model id to use when this target is set as the proactive task-memory (background) target. |
 | `--context-window` | Capability override: positive integer context window in tokens recorded on the target instead of the probed or catalog value. |
+| `--quick` | Open Quick Connect directly: endpoint, key if needed, model, and Connect. Requires a terminal. |
+| `--settings` | Open the full settings menu directly. |
+| `--edit` | Open all user settings in VISUAL/EDITOR as a draft; validate and confirm before saving, retain settings.yaml.bak, and allow repair of malformed YAML. Requires a terminal. |
+| `--json` | Print effective user settings as JSON without initializing the installation. |
+| `--section` | Open targets, models, chat, fleet, permissions, panes, skills, diagnostics, or advanced (All Settings); without a terminal, print the section values and exit. |
 | `--fleet-model` | Model id stored as the fleet default model when this target becomes the fleet default target (mutually exclusive with `--agent-profile`). |
 | `--force` | Save a model outside the runtime catalog, or one the target does not advertise, without refusing. |
 | `--gateway` | Mark the registered target as a gateway. |

package/docs/guide/fleet-dispatch.md

@@ -841,12 +841,7 @@ hard block.
   and a one-line receipt footer showing the outcome glyph, token count, duration,
   and contract status (such as `└ ✓ ok · 8.4k tok · 18s · contract unmeasured`),
   with the failure reason printed on the rail above the footer when a run fails.
-- Runs the model itself asked for through the dispatch tool (identified by
-  parentToolCallId) render as folded `◆` cards under the spawning tool segment;
-  operator-typed runs are `◇` and open. The fold chord uses the `clio-coder.tool.expand`
-  keybinding (`Alt+O`), which toggles the newest foldable item of either kind
-  (tool call or worker block). `Ctrl+Alt+O` or `Alt+Shift+O` toggles every tool
-  call and worker block at once.
+- Model-launched workers use `◆`; operator-launched workers use `◇`. Both follow the current Output style: Compact identity/outcome, Standard short summary, Detailed bounded activity and a larger summary. `Alt+O` cycles styles for the session. `/view transcript` and `/view dispatch:<runId>` expose full available details. Execution success and validation quality remain separate facts.
 - Sharing: nothing a worker produced enters the main model's context unless
   `--share` was passed or the operator runs `/share [runId]`. What enters is a
   bounded note of the shape `[worker result] <agent> · run <id> · <outcome> · shared by the operator`

package/docs/guide/glossary.md

@@ -90,7 +90,7 @@ This document defines the 50 core architectural concepts and terminology used th
 - **Owning Type**: `WorkerShareFacts` in `src/interactive/worker-share.ts`.
 
 ### 21. Fold
-- **Definition**: Collapsing an expanded tool call or worker block down to a single-line summary row. Toggled for the newest foldable item with `Alt+O` or for all items with `Ctrl+Alt+O` / `Alt+Shift+O`.
+- **Definition**: Presenting an action as a short summary in the current Output style. `Alt+O` cycles Compact, Standard, and Detailed. Use `/view transcript` for full available details.
 - **Owning Type**: `WorkerEntryRenderOptions` in `src/interactive/renderers/worker-entry.ts`.
 
 ### 22. Interop