docs: refresh tui guide

CHANGELOG.md

@@ -49,7 +49,8 @@
 - CLI: add `configure`, `doctor`, and `update` wizards for ongoing setup, health checks, and modernization.
 - CLI: add Signal CLI auto-install from GitHub releases in the wizard and persist wizard run metadata in config.
 - CLI: add remote gateway client config (gateway.remote.*) with Bonjour-assisted discovery.
-- CLI: add `clawdis tui` gateway-connected terminal UI (local or remote).
+- CLI: enhance `clawdis tui` with model/session pickers, tool cards, and slash commands (local or remote).
+- Gateway: allow `sessions.patch` to set per-session model overrides (used by the TUI `/model` flow).
 - Skills: allow `bun` as a node manager for skill installs.
 - Skills: add `things-mac` (Things 3 CLI) for read/search plus add/update via URL scheme.
 - Skills: add Apple Notes + Reminders skills via memo CLI (thanks @tylerwince).

docs/refactor/tui.md

@@ -22,5 +22,5 @@ Updated: 2026-01-03
 - [x] Gateway TUI client: add session/model helpers + stricter typing.
 - [x] TUI UI kit: theme + components (editor, message feed, tool cards, selectors).
 - [x] TUI controller: keybindings + Clawdis slash commands + history/stream wiring.
-- [ ] Docs + changelog updated for the new TUI behavior.
+- [x] Docs + changelog updated for the new TUI behavior.
 - [ ] Gate: lint, build, tests, docs list.

docs/tui.md

@@ -10,6 +10,7 @@ Updated: 2026-01-03
 
 ## What it is
 - A terminal UI that connects to the Gateway WebSocket and speaks the same chat APIs as WebChat.
+- Uses Gateway agent events for tool cards while streaming responses.
 - Works locally (loopback) or remotely (Tailscale/SSH tunnel) without running a separate agent process.
 
 ## Run
@@ -28,7 +29,7 @@ Use SSH tunneling or Tailscale to reach the Gateway WS.
 - `--token <token>`: Gateway token (if required).
 - `--password <password>`: Gateway password (if required).
 - `--session <key>`: Session key (default: `session.mainKey` or `main`).
-- `--deliver`: Deliver assistant replies to the provider.
+- `--deliver`: Deliver assistant replies to the provider (default off).
 - `--thinking <level>`: Override thinking level for sends.
 - `--timeout-ms <ms>`: Agent timeout in ms (default 30000).
 - `--history-limit <n>`: History entries to load (default 200).
@@ -36,16 +37,29 @@ Use SSH tunneling or Tailscale to reach the Gateway WS.
 ## Controls
 - Enter: send message
 - Esc: abort active run
-- Ctrl+C: exit
+- Ctrl+C: clear input (press twice to exit)
+- Ctrl+D: exit
+- Ctrl+L: model picker
+- Ctrl+P: session picker
+- Ctrl+O: toggle tool output expansion
+- Ctrl+T: toggle thinking visibility
 
 ## Slash commands
 - `/help`
-- `/session <key>`
+- `/status`
+- `/session <key>` (or `/sessions`)
+- `/model <provider/model>` (or `/models`)
+- `/think <off|minimal|low|medium|high>`
+- `/verbose <on|off>`
+- `/activation <mention|always>`
+- `/deliver <on|off>`
+- `/new` or `/reset`
 - `/abort`
+- `/settings`
 - `/exit`
 
 ## Notes
-- The TUI shows Gateway chat deltas (`event: chat`) and final responses.
+- The TUI shows Gateway chat deltas (`event: chat`) and agent tool events.
 - It registers as a Gateway client with `mode: "tui"` for presence and debugging.
 
 ## Files