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: skip empty Codex mascot frames on every loop

reviewce7bf44e5c6d
diff --git a/docs/mascot-sprites.md b/docs/mascot-sprites.md
index 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 over
JS timers (a canvas can hold dozens of terminals — zero per-node intervals). Render the two
pixel-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.css
index 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.ts
index 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.tsx
index 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 to
diff --git a/src/renderer/styles.css b/src/renderer/styles.css
index 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);
}
}