The TUI draws in any of the four themes, generated from every theme's tokens and chosen by ui.theme without a restart, and each window's corner carries the mark — ◐ ◓ ◑ ◒ turning while its agent works, ◑ in the reserved colour while it needs a person, ⏺ done and unread¶
TUI decision 149 · accepted · 2026-10-07 · issue #228 · supersedes 136
Issue #228's rest, on what Decision 126 built: Afterglow's palette by role, at the
depth the terminal can show, with its pink kept for a person being needed. 126 left out
the theme picker, the other three themes, the ◐ family and a blink setting; this is
those. Root Decision 807 is the shared setting. This is the part of 136 it supersedes:
the settings page now shows two of the ui keys.
- Four themes, one module.
mix troupe.palettereads everyclients/gui/docs/design/themes/*.tokens.jsonand writes them intoTroupe.UI.TUI.Palette, in the order the desktop app offers them (theme.ts), Afterglow first as the default:themes/0(id, name, description, the reserved colour's word),roles/1per theme,mask/1once. One module rather than one per theme, because a role's lookup is then one map and a theme file added there is a theme here at the next run;--checkfails CI on drift, as before. The mark is one in every theme file, so the task refuses a theme whose mark differs instead of drawing it four times. - The reserved colour stays reserved in every theme, at every depth. The roles are
the same in all four and each theme keeps its own reserved colour for them (Signal's
magenta, Footlight's amber, Limelight's lime). Two things in the tokens would have
broken that, and the generator now steers round both. Limelight's focus ring is its lime,
and the TUI's accent (126's "focus cyan") is on every heading, so a role may name a
second token for where its first is the reserved colour: the accent there is
text.link, the link blue, which is what Limelight's ownaccenttoken is. And two near colours can share their nearest of 256 — Limelight light'sokand its reserved colour did — so a role that is not reserved never takes the reserved colour's index and takes its next nearest instead. With sixteen colours the stand-ins are the same in every theme, magenta for the reserved three: the terminal's own theme decides what the sixteen look like, so a stand-in names the role, not a theme's hue. Not chosen: Footlight's amber as yellow at sixteen, which takes the plane-offline yellow and gains nothing the terminal's palette does not override. - Chosen by
ui.theme, live. The server readsconfig.getas it mounts and again on everyconfig.changedthat names auikey, so a theme picked in the desktop app is drawn here with nothing pressed, and one picked on the settings page at once. A value it does not know is drawn as Afterglow and said once, in the status line, per value. A session on a plane has no settings door (Client.settings/1answers it with an error), so it draws in Afterglow for now. Light or dark stays the terminal's (807). - The mark, per #228's table: fill is what the agent did alone, hollow is what waits on
you. In the top right corner of every window's border, a right-aligned title three
cells wide that the left title is fitted around (
View.mark/2). ◐ ◓ ◑ ◒ in:workingwhile its agent works, a quarter turn every 250 ms off the clock rather than the frame rate (Model.spinner/1), and the activity line turns the same glyph in place of the braille spinner, so the two turn together. ◑ — the lit right half, the mark itself — in:needs_youwhile it needs a person, blinking with its border,:railin the dark half of the beat. ⏺ in:ok, written with the text-presentation selector (U+FE0E) so it keeps one cell, when done and not yet read; ○ muted once read; ✗ in:error, muted once read.combining?/1counts U+FE0E as no cell. A narrow title no longer carries a glyph of its own (the old ▶ ✓ ✗ and spinner): the corner is that glyph, and the word stays in the title wherever it fits, so status is never the colour alone. - Blinking is drawn, not asked of the terminal. The SGR blink attribute is ignored or
drawn differently by many terminals, so the TUI draws the mark and the border lit and
unlit off its clock, which works in any of them;
ui.blink: falseholds them lit. Terminals do not report reduced motion, so the setting is the switch.
Governs: clients/tui/lib/mix/tasks/troupe.palette.ex, clients/tui/lib/troupe/settings.ex, clients/tui/lib/troupe/ui/tui/model.ex, clients/tui/lib/troupe/ui/tui/palette.ex, clients/tui/lib/troupe/ui/tui/server.ex, clients/tui/lib/troupe/ui/tui/theme.ex, clients/tui/lib/troupe/ui/tui/view.ex