The TUI draws in Afterglow's palette, generated from the design tokens, at the depth the terminal can show, and its pink means a person is needed¶
TUI decision 126 · accepted · 2026-09-27 · issue #228
- Roles, generated.
mix troupe.palettewritesTroupe.UI.TUI.Palettefromafterglow.tokens.json: fourteen roles, each a token with its dark and light values, the nearest of xterm's fixed 240 to each (CIELAB, never 0 to 15, which are the person's theme) and a stand-in among the sixteen. An alpha token is laid overbg.canvas.--checkis inmix check. The view names roles, never colours, andTheme.paint/2resolves them once per frame. - Depth from the terminal. Truecolor under
COLORTERM=truecolor|24bitor in Windows Terminal (WT_SESSION, which sets noCOLORTERM), 256 from aTERMthat says so, otherwise the sixteen; none underNO_COLORorTERM=dumb. The light values whenCOLORFGBGreports a light background.TROUPE_COLORS(truecolor,256,16,none, andlightordark) overrides all of it; an environment variable rather than a setting, since the setting belongs with the theme choice (#57) and this is about the terminal, not the person's taste. - The canvas is not painted. Text outside a role keeps the terminal's ink, and a background never comes from anything but a role: the code highlighter's backgrounds are dropped, and its colours become their nearest of 256 at 256 and the terminal's ink with the sixteen.
- Pink is for being needed.
:needs_yougoes on the pending line and a ticked option, "waiting for you", the border and title of a window that waits on you, the status line's count and how to answer, and the rows in the observer, the session picker and HQ that wait on you;:brandon the mask's lit half. Magenta in the sixteen goes to those three roles and nothing else, and a test reads every tagmodel.exdraws and holds all but those to other roles. Code and headings take the accent (the focus cyan), reasoning goes muted. - A window waits on you when something in it is pending. No daemon sends the
branch_statethat used to setneeds_input, so the strip, the status line's count and hint readpendinginstead; the needs-you border blinks once a second, off the clock rather than the tick. - The mask, in half-blocks. Rasterised by the task from
mark.pathand the eyes at two cuts, light from the right, the eye on the lit half cut out; drawn in the middle of a session's window until its first line, over the empty strip, and beside HQ's lists. With no colour the lit half is solid ink against the hollow one.
Governs: clients/gui/docs/design/themes/afterglow.tokens.json, clients/tui/lib/mix/tasks/troupe.palette.ex, clients/tui/lib/troupe/ui/hq.ex, clients/tui/lib/troupe/ui/tui/palette.ex, clients/tui/lib/troupe/ui/tui/theme.ex, clients/tui/lib/troupe/ui/tui/view.ex