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.

fix(kanban): bound the RUNNING chip pulse and pause the sidebar under the board

enes7b74846c661d
diff --git a/src/renderer/components/settings/sections/AppearanceSection.tsx b/src/renderer/components/settings/sections/AppearanceSection.tsx
index 28405c302..b7b7fad69 100644
--- a/src/renderer/components/settings/sections/AppearanceSection.tsx
+++ b/src/renderer/components/settings/sections/AppearanceSection.tsx
@@ -679,7 +679,7 @@ export function AppearanceSection({ isActive }: { isActive: boolean }): React.JS
<SearchableRow {...ROWS.boardRunningPulse}>
<FieldRow
label="Pulse RUNNING on board cards"
- description="Fade the RUNNING chip on a board card in and out while its agent works. Off keeps the chip, held still. The node header is unchanged."
+ description="Fade the RUNNING chip on a board card in and out a few times when its agent starts working. Off keeps the chip, held still. The node header is unchanged."
control={
<Switch
checked={pulseBoardRunning(boardRunningPulse)}
diff --git a/src/renderer/lib/canvasCovered.test.ts b/src/renderer/lib/canvasCovered.test.ts
index f7e29df20..b8290186d 100644
--- a/src/renderer/lib/canvasCovered.test.ts
+++ b/src/renderer/lib/canvasCovered.test.ts
@@ -103,6 +103,20 @@ describe('the covered attribute is wired to the stylesheet', () => {
)
})
+ it('pauses the sessions sidebar too: pinned, it sits UNDER the board and kept animating', () => {
+ // MEASURED (Server Edition, headless Chrome, pinned sidebar fully covered by the board, 20
+ // working agents): its spinners alone held GPU 4.5 % + renderer 5.7 %, ~0 % with them paused.
+ expect(css).toMatch(
+ /:root\[data-nt-canvas='covered'\]\s+\.sessions-sidebar\s*\{\s*--nt-anim-state:\s*paused/
+ )
+ // Every animation in it reads the variable, so the inherited override is the whole gate.
+ for (const sel of ['.ss-dot--working', '.ss-group__sig-spin', '.ss-check--unread', '.ss-bell']) {
+ const i = css.indexOf(sel + ' {')
+ expect(i, sel).toBeGreaterThanOrEqual(0)
+ expect(css.slice(i, css.indexOf('}', i)), sel).toContain('animation-play-state: var(--nt-anim-state)')
+ }
+ })
+
it.each(['unread', 'working', 'attention'])(
'pauses the %s glow, which is not in the variable scheme',
(state) => {
diff --git a/src/renderer/styles.animation-gate.test.ts b/src/renderer/styles.animation-gate.test.ts
index 955e3302d..cf51e42d1 100644
--- a/src/renderer/styles.animation-gate.test.ts
+++ b/src/renderer/styles.animation-gate.test.ts
@@ -190,6 +190,18 @@ describe('idle-window animation gate', () => {
}
})
+ it('the board card RUNNING chip is bounded and rests at full opacity', () => {
+ // Infinite, one chip held the compositor at display rate for as long as its agent worked,
+ // and under Liquid Glass every column's backdrop-filter ran again each frame. MEASURED (Server
+ // Edition, headless Chrome, 20 RUNNING cards, glass on, 15 s): GPU 50 % -> 17.5 % with the
+ // chips still. The covered-canvas gate cannot reach it: the board is what covers the canvas.
+ const rule = ruleBody(css, '.kanban-badge--running')
+ expect(rule).toMatch(/animation:\s*nt-pulse\s+1\.1s\s+ease-in-out\s+4\b/)
+ expect(rule).not.toMatch(/infinite/)
+ // Ends where it started, at the chip's own (unanimated) look: no snap when the fourth cycle ends.
+ expect(keyframesBody(css, 'nt-pulse')).toMatch(/0%,\s*100%\s*\{\s*opacity:\s*1;\s*transform:\s*scale\(1\)/)
+ })
+
it('never pauses the notch HUD, whose window is never focused', () => {
// hud.css belongs to a separate always-on-top panel window that by design never takes focus,
// so the shared gate would freeze it permanently rather than while nobody is looking.
diff --git a/src/renderer/styles.css b/src/renderer/styles.css
index 2856e5158..f60953cdc 100644
--- a/src/renderer/styles.css
+++ b/src/renderer/styles.css
@@ -1856,12 +1856,20 @@ body,
A SEPARATE attribute from `data-nt-window` on purpose: the two facts are independent (a board on
a focused window, an unfocused window with no board), and one attribute with two writers is a
- race over who clears it. Scoped to the canvas and nothing else — the controls cluster and the
- pills sit ABOVE the board (z 26) and are genuinely on screen, so they keep animating. */
+ race over who clears it. Scoped to what the board hides and nothing else — the controls cluster
+ and the pills sit ABOVE the board (z 26) and are genuinely on screen, so they keep animating.
+ The sessions sidebar (z 12) is BELOW it: pinned, it stays mounted and laid out under the opaque
+ board, and its working spinners and unread pulses kept the frame loop open there (measured:
+ GPU 4.5 % + renderer 5.7 % with 20 working agents, ~0 % paused). Nothing raises it over a board,
+ so whenever the attribute is set it is out of sight. */
:root[data-nt-canvas='covered'] .react-flow {
--nt-anim-state: paused;
}
+:root[data-nt-canvas='covered'] .sessions-sidebar {
+ --nt-anim-state: paused;
+}
+
:root[data-nt-canvas='covered'] .react-flow__node:has(.term-node.unread)::after,
:root[data-nt-canvas='covered'] .react-flow__node:has(.term-node.working)::after,
:root[data-nt-canvas='covered'] .react-flow__node:has(.term-node.attention)::after {
@@ -13222,8 +13230,13 @@ button.pull-checks__name {
.kanban-badge--running {
color: var(--success);
background: color-mix(in srgb, var(--state-success) 12%, transparent);
- /* reuse the terminal-header badge pulse (nt-pulse) rather than a bespoke keyframe */
- animation: nt-pulse 1.1s ease-in-out infinite;
+ /* reuse the terminal-header badge pulse (nt-pulse) rather than a bespoke keyframe. BOUNDED, like
+ the node glows (CLAUDE.md → Idle energy): looping forever, one chip kept the compositor at display rate
+ for as long as its agent worked, and under Liquid Glass every column's backdrop-filter ran again
+ each frame (20 RUNNING cards, glass on: GPU 50 % -> 17.5 % with the chips still). Four pulses
+ say "this one just started"; nt-pulse ends at opacity 1 / scale(1), the chip's own look. The
+ chip mounts when the agent starts working, so each new turn pulses again. */
+ animation: nt-pulse 1.1s ease-in-out 4;
animation-play-state: var(--nt-anim-state);
}
/* Settings → Appearance → Pulse RUNNING on board cards off (`settings.boardRunningPulse`; App.tsx