harness-multitool

TUI design concept

Reference mockups for the terminal UI. The implementation matches them pixel for pixel on the terminal cell grid, with colours from themes/*.toml. All screens are 1672×941 unless noted. Each screen comes in -dark and -light.

ScreenFilesWhat it fixes
Splashsplash-*shown first on launch: big logo, name, version, slogan, welcome text, OK (the logo itself comes from ../logo/multitool.svg, not from the picture)
Startupstartup-*after the splash: recent sessions, quick actions, status, tip line; its logo is THE logo
Welcomewelcome-*in-session welcome and quick tips
Main sessionmain-session-* (1586×992; nord / monokai / cyan 1560×936)turns, tool rows, diff, status line, composer, [ Settings ]
Themesthemes-nord-monokai-cyan.png (2172×724)the three extra themes side by side
Settings overlaysettings-overlay-*sidebar sections, provider choice incl. local-build plugins
Permissionpermission-*shell command approval: allow once / always / deny
Attachmentsattachments-*dropped files as thumbnail chips + preview overlay
Inbound messagesinbound-messages-*Telegram, Telegram voice, agent-to-agent, callback, reminder; toast mid-generation
Tool callstool-calls-*expanded cards: cat output with fold, telegram reply, agent_send, journal_add, failure, running
Journal & mind mapsjournal-mindmap-events-*JOURNAL card, MINDMAP created (empty), inline map after the first nodes
Session tabssession-tabs-*several sessions in one window, + for new, a2a hint
Onboarding tourtour-*coach mark over [ Settings ], step 3 of 7

Logo: ../logo/multitool.svg, traced from startup-light.png (the operator's pick). Flow on launch: splash -> startup -> session.

reasoning-*: a model's reasoning inside its turn, live, folded and unfolded. The build leaves out the mockup's token count: providers report a turn's whole output, not its reasoning apart.

Designed in code, without a mockup

Settled with the project owner on the live TUI and recorded in the journal; ../../tui.md lists the rules and the named states that show them.

Known differences to settle before implementation

This page's source