Skip to content

zgx: an agent's presence is its light sweep - #1291

Draft
gaelcado wants to merge 4 commits into
zeronsh:zeron/zgxfrom
gaelcado:gael/zgx-day-presence
Draft

gaelcado wants to merge 4 commits into
zeronsh:zeron/zgxfrom
gaelcado:gael/zgx-day-presence

Conversation

@gaelcado

@gaelcado gaelcado commented Nov 8, 2026 •

Copy link
Copy Markdown
Contributor

What changes

  • An agent at work is the mark's light sweep, not the dashed ring, and it sweeps only where you look: the open chat's "Noodling…" foot and up to two running sub-agents (3 × 3 glyph).
  • Every other working agent (sidebar rows, tabs, palette, lanes, the dock's plan step) sweeps for 3 s as it starts or comes back, then holds a still mark in its hue. A session that newly needs you flashes its icon once.
  • Small sizes have their own forms: the mark at 16/14, a 4 × 2 cut at 12, and a 2 × 2 micro mark under 10 pt (group badges, the sub-agents chip, the new-reply pill). Connecting sweeps at half pace, waiting holds the mark at rest, reduced motion and an inactive window freeze everything.
  • Loading that isn't an agent (palette search, updates, reconnecting, busy buttons) keeps Wing's ring. Plain tool-call rows keep their tool icon; the group summary loses its ring.

Before / After

Before After
The GIF: "Write the docs" starts and sweeps, then holds still; the two sessions already working stay still. Light GIF: one-sweep-sidebar-light.gif. The glyphs at every size and state: proposal sheet.

Why

Gaël: an agent's presence is the brand's light sweep, and there were too many moving elements. One sweep where attention is, still marks in the periphery, motion spent on change and on "needs you" (Apple HIG, NN/g, calm-technology pattern; see the presence proposal).

For review

  • Perf (CPU vs zeron/zgx, headless on the RX 6800): presence −15…19%, idle −11%.
  • Defaults picked pending Gaël's look: the 3 s start sweep on rows (vs strictly one sweep per screen), and the 2 × 2 micro mark under 10 pt (vs Wing's dot).
  • Wing's ring is kept for plain loading: tiles mean an agent, the ring means loading. A Cloud chat's machine waking or repo cloning (Wing's new rows) is loading: the ring.
  • The "needs you" flash plays wherever the icon is drawn, the open chat's own row included.
  • A side-chat test used to wait on frames the ring's loop brought; it steps its own frames now.

Tests

Rebased on zeron/zgx (c153906): lint, the Luau suite (1361/1361) and Zeron v2 in step. New: tests/presence_sweep (the band, and the rule: what sweeps, what holds still).

gaelcado and others added 4 commits November 14, 2026 15:32
The working ring becomes the mark's light sweep wherever an agent is at
work (session rows and tabs, the rail, the palette's sessions, the
transcript's foot and running rows, the dock, the lanes); a sub-agent
sweeps its 3 × 3 dot glyph. Connecting sweeps at half the pace, waiting
stands still at rest, reduced motion holds it mid-way, and its resting
tiles are lighter than the brand's renders. The group summary drops its
ring. Loading that isn't an agent keeps the ring (Spinner).

One timer on the step's boundaries sets every sweep's step and every
dot's pulse (dots stay under 10 pt), six times a second, from ui.now():
no animation plays for them, so nothing else waits on a capped frame.

Co-authored-by: zeronsh[bot] <346184242+zeronsh[bot]@users.noreply.github.com>
The band moves twelve times a second instead of stepping six, a tile half
lit as its edge passes, so the light carries between places: the mark
crosses in 1 s (was 1.33), a sub-agent's dot in 0.83 s, then rests. The
dots keep their two-second pulse on every other beat.
Only the open chat's foot and two of its running sub-agents keep sweeping.
Every other agent at work (rows, tabs, the palette, lanes, badges) sweeps
for three seconds as it's drawn, as it starts or comes back, then holds the
mark still in its hue; a session that newly needs you flashes once. Under
10 pt the dot becomes the mark's 2 × 2 micro form, at 12 the mark a 4 × 2
cut; ordinary tool calls keep their glyph. Nothing moves while the window
isn't active. The values live in ds/motion (presence).
@gaelcado
gaelcado force-pushed the gael/zgx-day-presence branch from 8429f05 to 80483fb Compare November 14, 2026 14:55

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant