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.
TypeScript adhdagent-orchestrationai-agentscanvasclaude-codecodexcoding-agentsdeveloper-toolselectrongeminilinuxmacosmultiplexeropencodeparallel-agentsterminalterminal-emulatorterminal-multiplexertmuxworkspace-manager
feat(appearance): setting to stop the board card's RUNNING chip pulsing
Benjamin Gelbf199bdfd72bb
diff --git a/src/renderer/App.tsx b/src/renderer/App.tsxindex 3e5effbc4..3289bcec8 100644--- a/src/renderer/App.tsx+++ b/src/renderer/App.tsx@@ -41,6 +41,7 @@ import {import { useGlassA11y } from './lib/useGlassA11y'import { GlassRefraction } from './components/GlassRefraction'import { isLiquidGlass } from './lib/appTheme'+import { pulseBoardRunning } from './lib/boardRunningPulse'export default function App() {// Apply the terminal-rendering setting to the two GPU coordinators, live. 'auto' is@@ -111,6 +112,15 @@ export default function App() {document.documentElement.dataset.theme = appTheme}, [appTheme])+ // Settings → Appearance → Pulse RUNNING on board cards. Off ⇒ `data-nt-board-pulse='off'`, which+ // the `.kanban-badge--running` rule in styles.css keys off; absent leaves the pulse as before.+ const boardPulse = pulseBoardRunning(useSettings((s) => s.settings.boardRunningPulse))+ useLayoutEffect(() => {+ const root = document.documentElement+ if (boardPulse) delete root.dataset.ntBoardPulse+ else root.dataset.ntBoardPulse = 'off'+ }, [boardPulse])+// Liquid Glass (Settings → Appearance). `data-nt-glass` switches the chrome rules in styles.css// on, and `--glass-chrome-bg` is the ONE fill every glass chrome surface uses: the resolved// `--panel` at the alpha that keeps the resolved `--text` at 4.5:1 over any backdropdiff --git a/src/renderer/components/settings/sections/AppearanceSection.tsx b/src/renderer/components/settings/sections/AppearanceSection.tsxindex 0784bdcdf..28405c302 100644--- a/src/renderer/components/settings/sections/AppearanceSection.tsx+++ b/src/renderer/components/settings/sections/AppearanceSection.tsx@@ -10,6 +10,7 @@ import {} from '@renderer/lib/glassContrast'import { useGlassA11y } from '@renderer/lib/useGlassA11y'import { showCanvasDots } from '@renderer/lib/canvasDots'+import { pulseBoardRunning } from '@renderer/lib/boardRunningPulse'import {defaultWallpaper,GRADIENT_WALLPAPERS,@@ -118,6 +119,10 @@ const ROWS = {title: 'Show grid dots',keywords: ['grid', 'dots', 'dot', 'canvas', 'background', 'pattern']},+ boardRunningPulse: {+ title: 'Pulse RUNNING on board cards',+ keywords: ['running', 'badge', 'chip', 'board', 'kanban', 'card', 'animation', 'motion', 'pulse', 'static']+ },resumeCard: {title: 'Resume card',keywords: ['resume', 'where you left off', 'breadcrumb', 'card', 'popup', 'trail']@@ -505,6 +510,7 @@ export function AppearanceSection({ isActive }: { isActive: boolean }): React.JSconst hiddenHeaderButtons = useSettings((s) => s.settings.hiddenHeaderButtons)const showResumeCard = useSettings((s) => s.settings.showResumeCard)const canvasDots = useSettings((s) => s.settings.canvasDots)+ const boardRunningPulse = useSettings((s) => s.settings.boardRunningPulse)const glassSlider = resolveGlassSlider(useSettings((s) => s.settings.glassTint))const glassA11y = useGlassA11y()const glassLocked = glassA11y.reduceTransparency || glassA11y.moreContrast@@ -670,6 +676,19 @@ export function AppearanceSection({ isActive }: { isActive: boolean }): React.JS}/></SearchableRow>+ <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."+ control={+ <Switch+ checked={pulseBoardRunning(boardRunningPulse)}+ onChange={(v) => update({ boardRunningPulse: v })}+ ariaLabel="Pulse RUNNING on board cards"+ />+ }+ />+ </SearchableRow><SearchableRow {...ROWS.resumeCard}><FieldRowlabel="Resume card"diff --git a/src/renderer/lib/boardRunningPulse.test.ts b/src/renderer/lib/boardRunningPulse.test.tsnew file mode 100644index 000000000..8c3ae2a9c--- /dev/null+++ b/src/renderer/lib/boardRunningPulse.test.ts@@ -0,0 +1,27 @@+import fs from 'node:fs'+import path from 'node:path'+import { describe, expect, it } from 'vitest'+import { DEFAULT_SETTINGS } from '@shared/types'+import { pulseBoardRunning } from './boardRunningPulse'++describe('pulseBoardRunning', () => {+ it('ships on', () => {+ expect(DEFAULT_SETTINGS.boardRunningPulse).toBe(true)+ expect(pulseBoardRunning(DEFAULT_SETTINGS.boardRunningPulse)).toBe(true)+ })+ it('only a literal false stops it; anything hand-edited keeps it pulsing', () => {+ expect(pulseBoardRunning(false)).toBe(false)+ for (const v of [true, undefined, null, 0, 'false', {}]) expect(pulseBoardRunning(v)).toBe(true)+ })+})++describe('the still board RUNNING chip rule', () => {+ const css = fs.readFileSync(path.join(__dirname, '..', 'styles.css'), 'utf8').replace(/\r\n/g, '\n')+ const rules = css.split('\n').filter((l) => l.includes("[data-nt-board-pulse='off']"))++ it('stops the board card chip and nothing else', () => {+ expect(rules).toEqual([":root[data-nt-board-pulse='off'] .kanban-badge--running {"])+ const i = css.indexOf(rules[0])+ expect(css.slice(i, css.indexOf('}', i))).toContain('animation: none')+ })+})diff --git a/src/renderer/lib/boardRunningPulse.ts b/src/renderer/lib/boardRunningPulse.tsnew file mode 100644index 000000000..6c4930e2a--- /dev/null+++ b/src/renderer/lib/boardRunningPulse.ts@@ -0,0 +1,9 @@+/**+ * Whether a board card's RUNNING chip pulses (Settings → Appearance → Pulse RUNNING on board+ * cards). Off holds the chip still; the node header's badge and every other chip are untouched.+ *+ * settings.json is hand-editable, so anything but a literal `false` keeps the default (pulsing).+ */+export function pulseBoardRunning(value: unknown): boolean {+ return value !== false+}diff --git a/src/renderer/lib/settingsReset.ts b/src/renderer/lib/settingsReset.tsindex 1fd1a1558..816c8b685 100644--- a/src/renderer/lib/settingsReset.ts+++ b/src/renderer/lib/settingsReset.ts@@ -45,6 +45,7 @@ export const APPEARANCE_RESET_KEYS = ['hiddenHeaderButtons','showResumeCard','canvasDots',+ 'boardRunningPulse','glassTint','glassBlurWhileMoving','windowTitleActiveSession',diff --git a/src/renderer/styles.css b/src/renderer/styles.cssindex 3f5bb6498..a0a72893b 100644--- a/src/renderer/styles.css+++ b/src/renderer/styles.css@@ -13594,6 +13594,11 @@ button.pull-checks__name {animation: nt-pulse 1.1s ease-in-out infinite;animation-play-state: var(--nt-anim-state);}+/* Settings → Appearance → Pulse RUNNING on board cards off (`settings.boardRunningPulse`; App.tsx+ sets the attribute): the same chip, held still. The node header's badge keeps its motion. */+:root[data-nt-board-pulse='off'] .kanban-badge--running {+ animation: none;+}.kanban-badge--needs {color: var(--attention-text);background: color-mix(in srgb, var(--state-attention) 12%, transparent);diff --git a/src/shared/types.ts b/src/shared/types.tsindex 913aa98cb..776853040 100644--- a/src/shared/types.ts+++ b/src/shared/types.ts@@ -2300,6 +2300,10 @@ export interface Settings {/** Draw the canvas dot grid (Settings → Appearance). Display only — snapping and align-to-grid* are unchanged. Default ON in every appearance; read through `showCanvasDots`. */canvasDots: boolean+ /** Pulse the RUNNING chip on board cards (Settings → Appearance). Off = the same chip, held still.+ * The node header's mascot is not affected. Default ON; read through `pulseBoardRunning`, so only+ * a literal false stops it. */+ boardRunningPulse: boolean/** The Liquid Glass slider (Settings → Appearance), 0 = Clear … 1 = Tinted. null = the Readable* tick, where text keeps 4.5:1 (renderer/lib/glassContrast.ts `resolveGlassSlider`). */glassTint: number | null@@ -2603,6 +2607,7 @@ export const DEFAULT_SETTINGS: Settings = {// reads as noise to users who navigate by the trail chords/Dock buttons instead.showResumeCard: false,canvasDots: true,+ boardRunningPulse: true,glassTint: null,glassBlurWhileMoving: true,usagePercentMode: 'remaining',