tui

Overview ¶

Package tui — multi-pane dashboard for clawtool's runtime surface. Bubble Tea-based, deferred from the v0.19 sketch and resurrected for the operator's "I want to see what every agent is doing" directive.

v1.1 fixes (operator feedback): the tick chain was breaking after the first refresh because tickCmd only fired AFTER a successful refresh. Now the tick runs on its own cadence independent of refresh completion, so the dashboard stays live even during transient SQLite hiccups. Plus: every pane respects the terminal viewport — rows beyond the visible area are truncated with a "(…N more)" tail line, and the layout adapts to the operator's terminal height instead of overflowing the scrollback.

Package tui — orchestrator TUI (Phase 2 of ADR-028). Split-pane Bubble Tea view that auto-spawns one pane per active BIAM dispatch, fades panes 5 seconds after they hit terminal so the operator sees the final tail before the layout reflows. Feeds from the daemon's task-watch Unix socket — no SQLite poll.

Layout: lipgloss horizontal+vertical join, square-ish grid sized to the terminal viewport. With 4 active dispatches, 2x2; with 6, 3x2; with 1, the single pane spans the whole window.

Pane content per task:

┌─ task abc12345 (codex) ─────┐
│ [21:47:01] active  · 12 msg │
│                             │
│ > applying patch 3/12       │
└─────────────────────────────┘

Pane fades to dim style 5s after terminal so the operator notices the transition; pane closes 5s after fade so the layout reflows around remaining live dispatches.