Skip to content

Node-based terminal manager for AI coding agents — tmux-backed terminals and parallel agent sessions as draggable nodes on an infinite pan/zoom canvas. macOS, Linux, and a browser Server Edition.

feat(glass): Liquid Glass colour palette, one HIG colour per meaning

iceclatterWTeb9155480fe5
diff --git a/CLAUDE.md b/CLAUDE.md
index 6ec868a06..4da1068af 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -3872,9 +3872,17 @@ glass never sits over plain black; a wallpaper the user chose is never replaced.
styles (`borderTopColor`, the colour dot's background), so the overrides carry `!important`: a
neutral `--glass-edge` border, the dot as a neutral ring (it is still the colour-picker button),
neutral resize handles. State survives without the colour: selection is an ink (`--text`) outline,
- unread keeps its accent border + glow, working/attention keep their `::after` glows and header
- badges. The sessions list and the kanban board keep node colours. `styles.liquid-glass.test.ts`
+ unread keeps its `--state-unread` border + glow, working/attention keep their `::after` glows and
+ header badges. The sessions list and the kanban board keep node colours. `styles.liquid-glass.test.ts`
pins the gate and every neutralising override.
+- **Glass palette** (HIG color.md › Liquid Glass color). The block at the end of styles.css
+ redefines only ROLES (see **Semantic colours**): working = the accent (no longer Claude clay),
+ needs-you = orange, finished-unseen = green, warning = yellow, error = red — one hue per meaning,
+ and orange means only "needs you" (`--warn` becomes `--caution`, the text-safe yellow). The glows,
+ minimap strokes, sidebar signals and badges follow with no rule of their own. Status labels on a
+ glass header are ink over a tinted chip (`-webkit-text-fill-color: var(--text)` with the chip
+ mixed from `currentColor`), not coloured text. `styles.palette.test.ts` pins the mapping and that
+ no two meanings resolve to the same colour, in both themes.
- **Surfaces.** Desktop: full. Server Edition: gradients + glass; the stills list is empty (not
macOS) and "Choose image…" is hidden (a picker there browses the SERVER's disk). Relay tabs keep
a stub (no stills, import refused). Mobile: N/A (no canvas). Kanban: N/A (the board is opaque).
diff --git a/src/renderer/styles.css b/src/renderer/styles.css
index a1f589427..4b19401b4 100644
--- a/src/renderer/styles.css
+++ b/src/renderer/styles.css
@@ -78,6 +78,10 @@
--state-warning: var(--sys-orange); /* non-blocking warning, caution */
--state-queued: var(--sys-gray); /* queued, idle, disarmed */
--state-automation: var(--sys-purple); /* loop / schedule / trigger status */
+ /* Text-safe hues for the "needs you" LABEL, which an appearance re-maps with its role, and the
+ readable orange Liquid Glass labels it with (dark: the system orange; light: darkened). */
+ --attention-text: var(--danger);
+ --orange-text: #ff9f0a;
/* Git file status, read by `lib/gitStatusColors.ts` (the ONE table both git panels draw). */
--git-modified: var(--caution);
--git-added: var(--success);
@@ -276,6 +280,7 @@
--sys-pink: #ff2d55;
--sys-brown: #a2845e;
--sys-gray: #8e8e93;
+ --orange-text: #a85c00;
/* The glows always drew the dark clay, in both themes. */
--state-working: #d97757;
@@ -1566,7 +1571,7 @@ body,
pseudo lives on the React Flow wrapper (via :has) because .term-node is overflow:hidden
and would clip its own ::after. */
.term-node.unread {
- border-color: var(--accent);
+ border-color: var(--state-unread);
box-shadow:
0 0 0 1px color-mix(in srgb, var(--state-unread) 50%, transparent),
0 0 16px 1px color-mix(in srgb, var(--state-unread) 35%, transparent),
@@ -2092,7 +2097,7 @@ body,
/* NEEDS YOU is red everywhere (same as the sidebar attention dot). */
.term-node__status--attention {
- color: var(--danger);
+ color: var(--attention-text);
}
/* TURN FAILED: the last turn ended on an API/model error (issue #521). Red like NEEDS YOU —
@@ -2182,7 +2187,7 @@ body,
}
.term-node__status--unread {
- color: var(--accent);
+ color: var(--state-unread);
}
/* QUEUED: a node armed with canvas-control `--after`, holding its launch until the stations it
@@ -8027,7 +8032,7 @@ button.group-node__setup:disabled {
.ss-dot--done { background: var(--success); }
.ss-check { color: var(--success); margin-top: 2px; flex: 0 0 auto; line-height: 0; }
/* Unread: the same check, accent-blue and pulsing until the user visits the node. */
-.ss-check--unread { color: var(--accent); animation: nt-pulse 1.1s ease-in-out infinite; animation-play-state: var(--nt-anim-state); }
+.ss-check--unread { color: var(--state-unread); animation: nt-pulse 1.1s ease-in-out infinite; animation-play-state: var(--nt-anim-state); }
.ss-check svg { width: 13px; height: 13px; }
/* attention renders as a red bell (ss-bell) — "it's ringing for you". Gentle pulse,
same cadence as the header badge dot. */
@@ -8368,8 +8373,8 @@ button.group-node__setup:disabled {
while the group is collapsed — that's their main job. */
.ss-group__sig { display: inline-flex; align-items: center; gap: 3px; font-size: 10px; font-weight: 700; flex: 0 0 auto; line-height: 0; }
.ss-group__sig svg { width: 11px; height: 11px; }
-.ss-group__sig--attention { color: var(--danger); }
-.ss-group__sig--unread { color: var(--accent); }
+.ss-group__sig--attention { color: var(--attention-text); }
+.ss-group__sig--unread { color: var(--state-unread); }
.ss-group__sig--working { color: var(--agent-working); }
.ss-group__sig-spin {
display: inline-block;
@@ -8463,12 +8468,12 @@ button.group-node__setup:disabled {
.ss-status__label { font-size: 12px; font-weight: 600; color: var(--text); }
.ss-status__count { font-size: 10px; color: var(--muted); }
.ss-status__icon { width: 9px; height: 9px; border-radius: 50%; flex: 0 0 auto; }
-.ss-status__icon--attention { width: auto; height: auto; border-radius: 0; color: var(--danger); display: inline-flex; }
+.ss-status__icon--attention { width: auto; height: auto; border-radius: 0; color: var(--attention-text); display: inline-flex; }
.ss-status__icon--attention svg { width: 11px; height: 11px; }
.ss-status__icon--working { background: var(--accent); }
/* Unread: the same accent-blue as the row's "new for you" check, ringed so the section header
reads as "these are the unlooked-at ones". */
-.ss-status__icon--unread { background: var(--accent); box-shadow: 0 0 0 2px rgba(var(--tint-rgb), 0.18); }
+.ss-status__icon--unread { background: var(--state-unread); box-shadow: 0 0 0 2px rgba(var(--tint-rgb), 0.18); }
/* Idle: a settled, already-seen turn — a quiet filled success dot. */
.ss-status__icon--idle { background: var(--success); opacity: 0.7; }
.ss-status__icon--unknown { background: rgba(var(--tint-rgb), 0.25); }
@@ -8911,7 +8916,7 @@ button.group-node__setup:disabled {
}
/* NEEDS YOU is red everywhere (same as the terminal attention badge). */
.chat-node__badge--needs {
- color: var(--danger);
+ color: var(--attention-text);
background: color-mix(in srgb, var(--state-error) 15%, transparent);
animation: nt-pulse 1.1s ease-in-out infinite;
animation-play-state: var(--nt-anim-state);
@@ -10353,7 +10358,7 @@ button.group-node__setup:disabled {
width: 7px;
height: 7px;
border-radius: 50%;
- background: var(--accent);
+ background: var(--state-unread);
flex: 0 0 auto;
}
.kanban-col__dot--ungrouped {
@@ -13625,8 +13630,8 @@ body.focus-mode .dock:hover {
0 12px 40px rgba(0, 0, 0, calc(0.35 * var(--shadow-k)));
}
:root[data-nt-glass='on'] .term-node.unread {
- border-color: var(--accent);
- border-top-color: var(--accent) !important;
+ border-color: var(--state-unread);
+ border-top-color: var(--state-unread) !important;
}
/* Minimap: node rectangles are painted in the node's own colour (an inline style, hence
@@ -13649,3 +13654,34 @@ body.focus-mode .dock:hover {
.react-flow__minimap-node:not(.mm-working):not(.mm-attention):not(.mm-unread) {
stroke: rgba(var(--tint-rgb), 0.45) !important;
}
+
+/* ---- Liquid Glass palette (HIG color.md › Liquid Glass color) ---------------------------------
+ Glass has no colour of its own: labels stay monochrome, and colour is reserved for status and
+ the one primary action per surface. So under Liquid Glass each MEANING takes its HIG colour,
+ one hue per meaning and never shared: the accent means working and selection, orange means only
+ "needs you", green means finished-unseen and success, yellow means warning, red means error.
+ Only roles are redefined here; every rule already reads them (the semantic-role block at the
+ top). The fills are the vibrant system values, which hold on translucent surfaces; the text-safe
+ tokens keep their per-theme darkening (--caution is the light theme's readable yellow,
+ --orange-text its readable orange). */
+:root[data-nt-glass='on'] {
+ --state-working: var(--accent);
+ --agent-working: var(--accent-text);
+ --state-attention: var(--sys-orange);
+ --attention-text: var(--orange-text);
+ --state-unread: var(--sys-green);
+ --state-warning: var(--sys-yellow);
+ --warn: var(--caution);
+ --git-renamed: var(--accent-text);
+ --git-conflict: var(--danger);
+}
+
+/* Status labels on a glass header are ink, not coloured text: the hue tints the chip BEHIND the
+ label (stained glass) and fills the dot. `-webkit-text-fill-color` paints the glyphs while
+ `color`, and so `currentColor`, keeps the status hue for the chip and the dot. */
+:root[data-nt-glass='on'] .term-node__status {
+ -webkit-text-fill-color: var(--text);
+ background: color-mix(in srgb, currentColor 24%, transparent);
+ padding: 1px 6px;
+ border-radius: 999px;
+}
diff --git a/src/renderer/styles.liquid-glass.test.ts b/src/renderer/styles.liquid-glass.test.ts
index e1a7b3674..7cb26819f 100644
--- a/src/renderer/styles.liquid-glass.test.ts
+++ b/src/renderer/styles.liquid-glass.test.ts
@@ -46,7 +46,7 @@ describe('Liquid Glass stylesheet', () => {
it('keeps the unread state perceivable (its own border survives the neutral top edge)', () => {
const unread = gated('.term-node.unread')[0]
- expect(unread?.body).toMatch(/border-top-color:\s*var\(--accent\)\s*!important/)
+ expect(unread?.body).toMatch(/border-top-color:\s*var\(--state-unread\)\s*!important/)
})
it('never blurs a container nested in a blurred one', () => {
diff --git a/src/renderer/styles.palette.test.ts b/src/renderer/styles.palette.test.ts
index 5439729bd..f20a8495c 100644
--- a/src/renderer/styles.palette.test.ts
+++ b/src/renderer/styles.palette.test.ts
@@ -20,9 +20,32 @@ function block(selector: string): Map<string, string> {
return new Map(Array.from(body.matchAll(/^\s*(--[a-z0-9-]+)\s*:\s*([^;]+);/gm), (m) => [m[1], m[2].trim()]))
}
+/** Every rule with exactly this selector, merged in source order (later declarations win). */
+function blocks(selector: string): Map<string, string> {
+ const out = new Map<string, string>()
+ let from = 0
+ for (;;) {
+ const start = CSS.indexOf(`\n${selector} {\n`, from)
+ if (start < 0) return out
+ const end = CSS.indexOf('\n}\n', start)
+ const body = CSS.slice(start, end).replace(/\/\*[\s\S]*?\*\//g, '')
+ for (const m of body.matchAll(/^\s*(--[a-z0-9-]+)\s*:\s*([^;]+);/gm)) out.set(m[1], m[2].trim())
+ from = end
+ }
+}
+
+/** The literal a token finally paints (var() chains substituted), for comparing meanings. */
+function literal(name: string, tokens: Map<string, string>, depth = 0): string {
+ const v = tokens.get(name) ?? ''
+ if (depth > 10) return v
+ return v.replace(/var\(\s*(--[a-z0-9-]+)\s*\)/g, (_, r: string) => literal(r, tokens, depth + 1)).toLowerCase()
+}
+
const DARK = block(':root')
const LIGHT = new Map([...DARK, ...block(":root[data-theme='light']")])
+const GLASS = blocks(":root[data-nt-glass='on']")
const THEMES = { dark: DARK, light: LIGHT }
+const GLASS_THEMES = { dark: new Map([...DARK, ...GLASS]), light: new Map([...LIGHT, ...GLASS]) }
/** Follow var() chains; true when every reference bottoms out in a literal colour. */
function resolves(value: string, tokens: Map<string, string>, depth = 0): boolean {
@@ -73,6 +96,35 @@ describe('palette tokens', () => {
})
})
+describe('Liquid Glass palette', () => {
+ for (const [theme, tokens] of Object.entries(GLASS_THEMES)) {
+ it(`every role still resolves under glass (${theme})`, () => {
+ for (const role of ROLES) expect(resolves(tokens.get(role) ?? '', tokens), `${role} in ${theme}`).toBe(true)
+ })
+
+ it(`maps each meaning to its HIG colour (${theme})`, () => {
+ expect(literal('--state-working', tokens)).toBe(literal('--accent', tokens))
+ expect(literal('--state-attention', tokens)).toBe(literal('--sys-orange', tokens))
+ expect(literal('--state-unread', tokens)).toBe(literal('--sys-green', tokens))
+ expect(literal('--state-warning', tokens)).toBe(literal('--sys-yellow', tokens))
+ expect(literal('--state-error', tokens)).toBe(literal('--sys-red', tokens))
+ })
+
+ it(`never uses one colour for two meanings (${theme})`, () => {
+ const meanings = ['--state-working', '--state-attention', '--state-unread', '--state-warning', '--state-error']
+ const hues = meanings.map((m) => literal(m, tokens))
+ expect(new Set(hues).size).toBe(meanings.length)
+ })
+ }
+
+ it('status labels on glass are ink over a tinted chip', () => {
+ const rule = CSS.slice(CSS.indexOf(":root[data-nt-glass='on'] .term-node__status {"))
+ const body = rule.slice(0, rule.indexOf('}'))
+ expect(body).toContain('-webkit-text-fill-color: var(--text)')
+ expect(body).toContain('color-mix(in srgb, currentColor')
+ })
+})
+
describe('git status colours have one source', () => {
it('both git panels draw from lib/gitStatusColors', () => {
for (const f of ['components/SourceControlPanel.tsx', 'components/git-history/GitHistoryCommitFiles.tsx']) {