clawdbot/docs/refactor/tui.md

summary, read_when

summary	read_when
Refactor plan: Gateway TUI parity with pi-mono interactive UI	Building or refactoring the Gateway TUI Syncing TUI slash commands with Clawdbot behavior

Gateway TUI refactor plan

Updated: 2026-01-03

Goals

• Match pi-mono interactive TUI feel (editor, streaming, tool cards, selectors).
• Keep Clawdbot semantics: Gateway WS only, session store owns state, no branching/export.
• Work locally or remotely via Gateway URL/token.

Non-goals

• Branching, export, OAuth flows, or hook UIs.
• File-system operations on the Gateway host from the TUI.

Checklist

• Protocol + server: sessions.patch supports model overrides; agent events include tool results (text-only payloads).
• Gateway TUI client: add session/model helpers + stricter typing.
• TUI UI kit: theme + components (editor, message feed, tool cards, selectors).
• TUI controller: keybindings + Clawdbot slash commands + history/stream wiring.
• Docs + changelog updated for the new TUI behavior.
• Gate: lint, build, tests, docs list.