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(appearance): setting to stop the board card's RUNNING chip pulsing

Benjamin Gelbf199bdfd72bb
diff --git a/src/renderer/App.tsx b/src/renderer/App.tsx
index 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 backdrop
diff --git a/src/renderer/components/settings/sections/AppearanceSection.tsx b/src/renderer/components/settings/sections/AppearanceSection.tsx
index 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.JS
const 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}>
<FieldRow
label="Resume card"
diff --git a/src/renderer/lib/boardRunningPulse.test.ts b/src/renderer/lib/boardRunningPulse.test.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
index 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.css
index 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.ts
index 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',