tui

Overview ¶

file_view.go is the drill-in view for a touched file, opened from the FILES sidebar section (files_panel.go). It reuses the subchat pattern: while active, the chat column's body swaps to this file's content — the sidebar, composer, and scroll engine keep working unchanged (transcriptBodyItems is the single source the viewport, renderer, and hit-testers all read, so swapping there keeps every consumer consistent). Two modes:

diff (default) — the file's edit cards from this session, full-depth
full           — the file as it stands on disk, syntax highlighted, with
                 gutter markers on the lines this session's diffs added

d/f switch modes (with an empty composer), Esc returns to the chat at the scroll position it was left at.

files_git_sweep.go fills the FILES sidebar's blind spot: mutations that bypass the file tools entirely — bash/exec_command scaffolding (npm create, go generate, heredoc writes) and subagents editing the shared workspace. None of those produce a changedFiles-carrying tool result, so the transcript-derived roster (files_panel.go) never sees them. The sweep asks git instead: a baseline `git status --porcelain` snapshot is taken at startup (Init), and a re-run after each command tool result / turn end reports any NEWLY dirty paths, which merge into the roster with a diffstat from `git diff --numstat`. Pre-existing dirty state stays in the baseline and never shows; a non-git workspace fails the first command and the sweep silently stays off.

files_panel.go renders the FILES section of the right context sidebar: the workspace files this session has touched, newest first, with an A/M badge and a +added/−removed diffstat per file, plus a pulsing row for the file whose write is streaming right now. Like the swarm roster (sidebar.go), the touched set is not separate model state — it is recovered on demand from the transcript's tool-result rows (their changedFiles), so it survives resume for free and can never drift from what the chat shows.

Interaction (see handleTranscriptSelectionMouse): the first click on a row SELECTS the file — its edit cards tint in the chat and the transcript scrolls to the most recent one; a second click (or a click while the drill-in is already open) opens the file view (file_view.go). Esc clears the selection.

keybinding_help.go renders the `?` keyboard-shortcut overlay. Zero has a rich set of chord bindings (Ctrl+T effort, Ctrl+P plan, drill-in subchat, Shift+Tab permission mode, …) that are otherwise invisible — only learnable by reading the source. A single-key `?` overlay (opened on an empty composer) lists them grouped, so the keymap is discoverable the way the reference TUIs do it. The list is declarative and hand-curated to match the real handlers in model.go's Update switch; keep them in sync when a binding changes.

plan_panel.go renders the sticky plan panel for the Zero TUI. The panel surfaces the in-progress task plan produced by the update_plan tool: a one-line header with a live spinner and progress count, a text progress bar, and (while running or expanded) the per-step list with status icons and timings. planPanelState tracks per-step start/completion timestamps across the tool's full-replacement updates so durations stay stable as steps transition between pending, in_progress, completed, and failed.

plan_step_detail.go makes the context-sidebar plan steps clickable: each step records the file mutations made while it was in_progress ("what was built"), and clicking a step drops a transcript card listing them. The work is captured from tool-result rows as they stream; the click maps a sidebar y-coordinate to a step, mirroring sidebarAgentSelectables' offset accounting.

ripple.go adds a slow cosine "breathing" colour wave for the working status line: each character cycles through a dim→lime ramp blended from the brand accent, and the wave travels across the text one character per phase tick. The phase is sourced from the shared spinner clock (m.spinnerPhase, advanced by the existing spinner.TickMsg handler) so the ripple and the braille spinner animate in lock-step with no extra ticker.

sidebar.go renders the right-hand context sidebar for the two-column chat layout (alt-screen managed mode only). The sidebar surfaces three sections — the spawned AGENTS and their live working detail, the live PLAN (the same data the pinned plan panel reads), and a token/context readout at the bottom — so the chat column stays focused on the conversation. It is a set of pure helpers: the layout in transcriptView renders the chat at a reduced width via the existing scroll engine, builds a sidebar block of the same height here, and joins the two columns row-by-row through joinColumns.

specialist_card.go renders specialist/subagent cards in the transcript.

A specialist card summarises one spawned sub-agent (worker, explorer, code review, ...): its name, task description, elapsed time, tool-call count, and token usage. The SpecialistTracker holds the live state that the transcript view consults each render; the session store feeds it via start/complete/ incrementToolCount/addTokens as specialist events arrive.