@@ -443,7 +443,7 @@ OpenTUI (`@opentui/core`) is the shipping shell; the Ink/React tree has been del
 - **Runner host** (`runner-host.ts`) — Runner-facing mount: catalog assembly from live config, chrome pushes on session change, subagent observe resolution, and session teardown (quitting is Ctrl+C twice, owned by the shell).
 - **Overlays and pickers** — Resume picker (`src/tui/pick-session.ts`) uses `runListModal` (`src/tui/list-modal.ts`). Slash-command surfaces (`/model`, `/settings`, `/permissions`, `/plugins`, etc.) route through `openCommandSurface` (`src/tui/command-surfaces.ts`).
 - **Auto mode** — Toggled by CLI flags only (`--auto` / `--no-auto`); there is currently no in-session key bound to it.
-- **Send-path ingest** — Submit, leftover send, and live steer run `ingestOperatorPrompt` (`src/tui/prompt-attachments.ts`): inline image-path mentions become attachments (`findImagePathMentions` / `imageAttachmentFromPath`); `@file` contents are inlined and `@dir` mentions become a directory summary (`resolveAtMentions` in `mention-resolution.ts`). The mention popup splices paths into the prompt (`spliceMentionCompletion`); it does not send. Ctrl+V / Ctrl+P (and `/paste-image`) attach a macOS clipboard PNG (`attachClipboardImage` in `shell.ts` → `readClipboardImage`); Cmd+V stays text (bracketed paste). Linux/Windows bitmap clipboard paste is not supported.
+- **Send-path ingest** — Submit, leftover send, and live steer run `ingestOperatorPrompt` (`src/tui/prompt-attachments.ts`): inline image-path mentions become attachments (`findImagePathMentions` / `imageAttachmentFromPath`); `@file` contents are inlined and `@dir` mentions become a directory summary (`resolveAtMentions` in `mention-resolution.ts`). The mention popup splices paths into the prompt (`spliceMentionCompletion`); it does not send. Ctrl+V / Ctrl+P (and `/paste-image`) attach an image from the system clipboard (`attachClipboardImage` in `shell.ts` → `readClipboardImage`); Cmd+V stays text (bracketed paste). Image clipboard reads go through the OpenTUI clipboard service (PNG, JPEG, GIF, WebP) on platforms whose host backend supports them.
 
 Known keybindings: `Ctrl+C` interrupts the in-flight run, and quits on a second press inside a two-second window.
 
 
@@ -235,10 +235,10 @@ a path into the prompt (`spliceMentionCompletion`). Attachments land at send
 time, not at accept time.
 
 Ctrl+V / Ctrl+P and `/paste-image` call `attachClipboardImage` (`shell.ts`) →
-`readClipboardImage` (`image-attachments.ts`), which reads a macOS clipboard
-PNG via osascript `«class PNGf»`. Cmd+V is terminal bracketed paste and stays
-text. Linux and Windows bitmap clipboard paste is a separate product gap; do
-not treat bracketed-paste path text as a paste-time image gesture.
+`readClipboardImage` (`image-attachments.ts`), which reads PNG, JPEG, GIF, or
+WebP through the OpenTUI clipboard service. Cmd+V is terminal bracketed paste
+and stays text. Do not treat bracketed-paste path text as a paste-time image
+gesture.
 
 ## Configuration
 
 
@@ -72,7 +72,7 @@ already carries the primitive:
 
 - The before-tool authz hook returns, for an `ask` effect,
   `{ type: "suspend", gate: { type: "approval", gateId, correlationId,
-timeoutAt }, pendingOp }` (`authz-extension.ts:263-267` upstream; the
+  timeoutAt }, pendingOp }` (`authz-extension.ts:263-267` upstream; the
   reactor persists `pendingOp`, minting `correlationId` at :223 and
   `gateId = pending-${correlationId}` at :226).
 - `DEFAULT_APPROVAL_TIMEOUT_MS = 3_600_000` (:36) — one hour.
 
@@ -878,11 +878,11 @@ sent messages. Once a real `paste` event has fired even once, the fallback
 heuristic is permanently skipped for the rest of the session
 (`src/tui/shell/keys.ts`, the `sawBracketedPaste` guard).
 
-Ctrl+V and Ctrl+P attach a PNG from the macOS clipboard
+Ctrl+V and Ctrl+P attach an image from the system clipboard
 (`attachClipboardImage` in `src/tui/shell/prompt.ts` → `readClipboardImage` in
-`image-attachments.ts`).
-Cmd+V stays text (bracketed paste above). Clipboard image attach is
-macOS-only; Linux/Windows bitmap clipboard paste is not supported.
+`image-attachments.ts`, which reads through the OpenTUI clipboard service).
+Cmd+V stays text (bracketed paste above). The host clipboard backend reads
+PNG, JPEG, GIF, and WebP where the platform supports image clipboard data.
 `/paste-image` is the same attach path.
 
 @-mention path completion opens a popup keyed off the `@token` under the
@@ -967,7 +967,7 @@ running its own selection. Two chords cover remaining copy needs:
     WezTerm, Kitty, and VS Code support it.
   - **Linux/Windows: Ctrl+click.** The app opens the URL through the
     platform opener (`open` on macOS as fallback, `xdg-open`, `rundll32
-url.dll,FileProtocolHandler` — argv spawns, never through a shell).
+    url.dll,FileProtocolHandler` — argv spawns, never through a shell).
   - **Right-click safety.** The open gesture requires a left (button-0)
     press with the modifier held, so Ctrl+right-click never opens a URL —
     context menus stay safe.
@@ -1042,7 +1042,12 @@ before any other Corbits code executes: the TUI holds the alternate screen
 for the rest of the process, and anything landing on the real terminal
 mid-frame corrupts the paint. Anything the operator must actually see goes
 through the transcript (`appendStreamRow`) or a chrome notice — never a log
-line.
+line. Confirmation flashes stay on the status row and are also mirrored with
+`console.info` into OpenTUI's Console overlay (`consoleMode: "console-overlay"`,
+the production renderer default). The overlay is an in-frame observation
+surface: it stays hidden unless `SHOW_CONSOLE` is set, and it is not a
+durability surface. The file sink remains mandatory, because a log line emitted
+before a renderer exists has nowhere else to go.
 
 ## Test-harness blind spots
 
@@ -1068,6 +1073,11 @@ terminal. It cannot observe:
 - **The system clipboard.** `system-clipboard.ts`'s helper-binary spawns and
   OSC 52 fallback are exercised with mocked spawn functions in tests; no
   test round-trips through a real `pbcopy`/`xclip`/terminal clipboard.
+- **A shown Console overlay.** Headless suites can enable
+  `consoleMode: "console-overlay"` and read `renderer.console.getCachedLogs()`
+  while the overlay stays hidden. That pins that a mirrored flash was captured
+  and that a hidden console adds no rows to `captureCharFrame`. It does not
+  show whether a real terminal paints the overlay when `SHOW_CONSOLE` is set.
 - **Terminal-owned text selection.** Native drag-select only exists once DEC
   mouse reporting is off and a real terminal emulator is running; there is
   no terminal emulator in the test harness to select text in. OpenTUI