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
fix: skip empty Codex mascot frames on every loop
reviewce7bf44e5c6d
diff --git a/docs/mascot-sprites.md b/docs/mascot-sprites.mdindex ef5278850..06ad262c8 100644--- a/docs/mascot-sprites.md+++ b/docs/mascot-sprites.md@@ -66,7 +66,8 @@ happening" but not *who*.## Codex pet (spritesheet asset)`pet-codex.webp` (checked into `resources/mascot/` here, `NodeTerm/Resources/Mascot/` on iOS):-8 columns × 9 rows of 192×208 frames. Walk cycle = the first row's frames at ~8 fps+8 columns × 9 rows of 192×208 frames. The first-row cycle has **six populated frames followed by two empty cells**; play only+those six frames at ~8 fps(agent-notch uses a 0.12 s timer). Render small (~16–20 px tall), pixelated scaling(`image-rendering: pixelated` / `.interpolation(.none)`).@@ -88,4 +89,6 @@ shimmer is noisy at small sizes — match agent-notch's panel behavior.- **Desktop canvas** (TerminalNode header, working state): prefer CSS `steps()` animation overJS timers (a canvas can hold dozens of terminals — zero per-node intervals). Render the twopixel-map frames once into a data-URI spritesheet at module load; the badge is a `<span>`- with `background-position` stepping. Codex: `steps(8)` over the webp's first row.+ with `background-position` stepping. Codex: `steps(6)` over the first row's six populated cells (0.72 s cycle, 0.12 s per frame).+ Keep the sheet eight columns wide; including its two empty cells makes the mascot disappear+ for 0.24 s on every loop. This applies to the notch HUD too.diff --git a/src/renderer/hud/hud.css b/src/renderer/hud/hud.cssindex 5474883a5..780a498fe 100644--- a/src/renderer/hud/hud.css+++ b/src/renderer/hud/hud.css@@ -240,11 +240,11 @@ body {height: var(--cmascot-h);background-position: 0 0;background-size: var(--cmascot-sheet-w) var(--cmascot-sheet-h);- animation: mascot-walk-codex 0.96s steps(8) infinite;+ animation: mascot-walk-codex 0.72s steps(6) infinite;}@keyframes mascot-walk-codex {to {- background-position-x: calc(var(--cmascot-w) * -8);+ background-position-x: calc(var(--cmascot-w) * -6);}}diff --git a/src/renderer/lib/mascot.ts b/src/renderer/lib/mascot.tsindex 97f2c8622..816228d46 100644--- a/src/renderer/lib/mascot.ts+++ b/src/renderer/lib/mascot.ts@@ -182,7 +182,7 @@ export const DONE_BLOB = {// --- Codex pet spritesheet geometry (asset imported by the component) -----------------------/** pet-codex.webp layout: 8 cols × 9 rows of 192×208 frames; walk = the first row. */+/** pet-codex.webp layout: 8 cols × 9 rows of 192×208 frames; first-row cycle = six populated frames, then two empty cells. */export const CODEX_MASCOT = {cols: 8,rows: 9,diff --git a/src/renderer/nodes/AgentMascot.tsx b/src/renderer/nodes/AgentMascot.tsxindex ec830fa7f..a0b989325 100644--- a/src/renderer/nodes/AgentMascot.tsx+++ b/src/renderer/nodes/AgentMascot.tsx@@ -11,7 +11,7 @@ const BRAND_BADGE_SIZE = 16* The walking mascot shown inside the RUNNING badge (docs/mascot-sprites.md):* - claude → the runtime-drawn coral pixel critter (data-URI spritesheet; the walk is CSS* `steps(1)` over three keyframes, NOT `steps(2)` — see .term-node__mascot--claude).- * - codex → pet-codex.webp, first-row walk cycle (CSS `steps(8)`).+ * - codex → pet-codex.webp, six-frame first-row cycle (CSS `steps(6)`).* - grok / gemini / opencode / copilot → their own BRAND MARK, pulsing and blooming rather than walking. Grok* had a quadrant critter first; a hand-drawn creature next to two real mascots read as neither, so* the glyph the agent actually has is what animates. gemini and opencode used to fall through todiff --git a/src/renderer/styles.css b/src/renderer/styles.cssindex d9131490e..c0d2b9bc0 100644--- a/src/renderer/styles.css+++ b/src/renderer/styles.css@@ -1976,20 +1976,20 @@ body,}}-/* Codex: pet-codex.webp first row, 8-frame walk at ~8fps ⇒ 0.96s/cycle. Only the first row is- shown (background-position-y stays 0); steps(8) walks left one frame at a time. */+/* Codex: the first row has six populated frames and two empty cells. Keep 120ms per frame+ and loop before the empty cells; the sheet itself remains eight columns wide. */.term-node__mascot--codex {width: var(--cmascot-w);height: var(--cmascot-h);background-position: 0 0;background-size: var(--cmascot-sheet-w) var(--cmascot-sheet-h);- animation: mascot-walk-codex 0.96s steps(8) infinite;+ animation: mascot-walk-codex 0.72s steps(6) infinite;animation-play-state: var(--nt-anim-state);}@keyframes mascot-walk-codex {to {- background-position-x: calc(var(--cmascot-w) * -8);+ background-position-x: calc(var(--cmascot-w) * -6);}}