[teamleaderleo]

Leo, 2026-11-03: "oh you guys completely misinterpreted the "animated" thing... don't bounce the circle. i mean like if you ask codex, codex (idk if you wanna ask sol 6.1 xhigh or astra high) their dot thing has a few different animations for different scenarios."

His first ask (2026-11-01: "i also want them animated like how chatgpt animates their dots") became #30534, which bobs the whole avatar up and down (Float, the default), faster while the Chief works. That is the bounce he turned down. The reference he points at is the Codex app's pet: one distinct animation per scenario, not one motion at two speeds.

What changes

A Chief's avatar in the Home list and pinned grid shows what its Chief is doing, one look per state. The avatar never leaves its place: no bob, bounce or slide. The only transforms are a small scale or turn about its centre.

State	When	Ring (default)
idle	nothing running	at rest; a soft glint sweeps across the face once every 7 s (a pet's blink), clipped to the avatar picture's own shape
working	its turn is running (InboxRow.isTyping)	a quarter arc in the accent runs round the avatar's edge, 1.6 s a turn, linear
waiting	a reply is unread	a still thin ring in the accent
failed	a send failed (InboxRow.hasFailedSend)	a still thin red ring

A state change plays one cue of at most 240 ms (design/motion-and-polish.md). When a turn ends (working to idle or waiting), the avatar pops 4%. A failure gives it a quick shake of a few degrees. A reply that arrives with no turn seen fades its ring in. A reload of the same state replays nothing.

Versions (gallery)

The list ships with four styles, and ChiefAvatarMotionGalleryTests draws each one in every state plus the two cues, 8 frames each. It writes them to Packages/Shared/CmuxMessagesLab/.build/chief-avatar-motion-gallery.png:

• Ring (default): the table above.
• Glow: a soft glow behind the avatar's shape. None at idle; accent while working, with a glint sweeping every 1.8 s; accent while waiting; red when failed. Same cues.
• Tilt: the avatar turns its head. A 3° glance every 6 s at idle and a ±4° rock (1.4 s) while working. Ring's still rings and cues.
• Still: no motion and no ring.

I picked Ring. Each state reads differently at row size, even at a glance and in a dense list. Working also matches the rest of the app's "running" language (an arc going round), so it reads as working without a second mark. Switch styles in Debug Settings > Home > Chief avatar motion (home.avatarMotion). A saved Float, Breathe or Sway value no longer matches a choice and falls back to Ring.

What it does not touch

• The shared working Spinner (the thin 3/4 arc, One spinner: every working and loading mark draws the shared arc #32754) is unchanged. This is the Chief's avatar, not the agent working-state mark.
• The Chief pet's sprite rows (ChiefPetSprite) are unchanged. A follow-up could also step the animated characters' state rows (Mochi, Captain, Sprout, Bolt) in the list.
• fix(home): keep chief avatars still by default #32861 (lucasr1b, open) sets home.avatarMotion to Still so avatars stop bouncing. This PR removes the bounce itself and changes the same default line, so the two conflict on that line. A comment on fix(home): keep chief avatars still by default #32861 says so.

Stop conditions and cleanup

Every loop and cue is removed by each of the following. The still waiting and failed rings stay, as static indicators:

• Reduce Motion (system or the cmux pin), calm mode, ui.animationSpeed off, and Home's motion switch, through the existing avatarLoopGate and reduceMotionDidChange path. Working's arc stands still as a quarter ring, so the state still reads.
• App inactive, or the window not key, hidden or minimized: the list's existing setWindowActive tracking. No new observers.
• Row back in the pool: SidebarAvatarMotion.stop removes everything, rings included.
• Style Still: nothing is drawn.

Performance

• No main-thread work per frame. Each look is Core Animation on the avatar layer and at most two named sublayers of it (a ring CAShapeLayer and a masked glint band), run by the render server. There is no timer or display link.
• A reload that keeps the state keeps the running loop (asserted by test), so a list update adds no animation work. Per configure, the cost is one look comparison and a frame fit, O(1) per visible row.
• No vendored file changes, so Patches/ is untouched.
• No same-harness before/after frame numbers. The previous loop was also render-server only.

Tests

ChiefAvatarMotionTests (MessagesLab), rewritten for the states:

• each state has its own look, and no style in any state animates the avatar's position;
• a state change plays a short cue (pop ≤ 1.04 scale, shake), and a reload or Reduce Motion plays none;
• Reduce Motion and the host's gate stop every loop and keep the still rings;
• an inactive app or hidden window stops every loop;
• a pooled row clears, and Still draws nothing;
• a style change restyles every avatar at once;
• loops close and are phase-seeded per conversation.

Observed / Not run

• Observed: python3 scripts/cmux-next/prepush-gate.py: no new violations. Fleet compile and the MessagesLab suites: results in a comment below.
• Not run: a DEV build watching the list live. Leo tries the build.

Spec: design/motion-and-polish.md (240 ms cue cap, every loop stops). Prior art: #30534 (replaced here), #32861 (open, same default line).

No capture: the looks are in the gallery sheet; Leo tries the build.

Changelog

Changed: A Chief's avatar in Home shows what the Chief is doing (a glint at rest, an arc while it works, a ring when a reply waits or a send failed) instead of bobbing.

Agent session: agent session

🤖 Generated with Claude Code

---

^{Open in [code]smith · Need help on this PR? Tag @codesmith-bot with what you need.}

---

Summary by cubic

Changes the Chief avatar in the Home list and pinned grid to show what its Chief is doing—one look per state, like the Codex pet—instead of bobbing. The avatar never leaves its place; the only transforms are a small scale or turn about its centre.

• Idle glints across the face occasionally; working runs a quarter arc round the edge; an unread reply draws a still accent ring; a failed send a still red ring.
• A state change plays one cue of at most 240 ms: a 4% pop when a turn ends, a quick shake on failure, and a ring fade-in when a reply arrives with no turn seen.
• Under Reduce Motion no loops run, but the working arc stands still as a quarter ring and the still rings stay, so the state still reads.
• Replaces Float, Breathe and Sway with Ring (new default), Glow, Tilt and Still; saved old setting values fall back to Ring.
• A state change cues per conversation id, not per row layer, so a row redrawn on another layer still plays its cue.

^{Written for commit fe426d3. Summary will update on new commits.}

[github-actions]

cmux status _{(one comment, edited in place; each line is updated by the job that owns it)}

Review e6fd0c4: HQ feed card · gallery before/after runs · checks

App of this head (app.zip, kept 1 day)

gh workflow run reload-build.yml -R manaflow-ai/cmux --ref feat-cmux-next -f tag=pr33395 -f ref=lane/chief-avatar-state-motion -f platform=macos -f backend_mode=local

Default changes

This pull request changes 2 defaults at e6fd0c418a26 (what everyone gets without configuring anything):

• tunable-source.CmuxNextHome/HomeTunables.swift:avatarMotion: "5b5e921725a2994a774c213cd7f0c62bbd3a99e843c6c23bf6e31dab54dc27d2" -> "04cd6fdc88208ffeb8962eaabbaa0396b84c5a470c04ac39be11f3c76f9b6189"
• tunable.home.avatarMotion: "float" -> "ring"

Signed off on this commit by review (codex, router-review).

Merge receipt: merged as eb1c8c05ef24 with these defaults changed, signed off by review (codex, router-review).

Regenerate the snapshot with python3 scripts/ci/defaults_guard.py snapshot.

Shipped in:

• cmux NEXT nightly 1.0.0-nightly.4161217392901 (1a7e2c1865)
• cmux NEXT nightly 1.0.0-nightly.4162023985101 (c8f5046a98)

[teamleaderleo]

Review (codex gpt-6.1-sol high, sweep, via the review router; full diff from merge base af0ae5b to this head): SHIP at fe426d3

No P1/P2 findings.

[teamleaderleo]

Review (codex, router-review): SHIP at e6fd0c4

Reviewer: codex gpt-6.1-sol xhigh, fast tier.

Follow-ups: 3. Each lands as an issue in this repo that links this receipt; the lane that opened the PR fixes it forward.

SHIP at e6fd0c4
Visual verdict: no images; Leo tries the build

1. [P2] [follow-up] SidebarAvatarMotion.swift:101: keepCue: true preserves an active pop/shake when Reduce Motion activates, the window deactivates, or Still is selected. Clear the cue when motion becomes disabled.

2. [P2] [follow-up] SidebarAvatarLooks.swift:81: Resizing updates the glint band’s bounds but retains animation coordinates calculated for the old size. Enlarging a pinned avatar from 40 to 76 points leaves the band resting inside its face for 90% of the idle loop. Recompute the sweep when bounds change.

3. [P2] [follow-up] ChiefAvatarMotionGalleryTests.swift:152: Supply gallery or native captures for this head; none were available.

AppKit tests were unavailable on this Linux box without Swift.

Follow-ups:

• Cancel cues when motion becomes disabled.
• Update glint trajectories after resizing.
• Attach visual captures.

[teamleaderleo]

Fleet at e6fd0c4 (step d7ec8ee73e705a21ac145000): ChiefAvatarMotionTests (7 tests) and ChiefAvatarMotionGalleryTests pass. The gallery sheet is the step's artifact: cmux-ci artifact d7ec8ee73e705a21ac145000 OUTPUT. Its rows are Ring, Glow, Tilt and Still. Its strips are idle, working, waiting, failed, the turn-ending pop and the failure shake.

Red then green: at b2874ee, aStateChangePlaysOneShortCue failed (step d12bc717be8725d3b5e03e7c). A changed row is drawn on another layer, so its cue lost the previous state. fe426d3 keys the last state by conversation instead.

Compile check at e6fd0c4 (job 4398ca4252516670ba116cf2): one error, in CmuxNextAppTests/RowBadgeSpinnerDensityTests.swift:32 (main-actor cases in @Test). That file comes from #33120, is untouched here and is the same on base, so it is a base red. The sources compile.