Skip to content

feat(sessions): a Clawd in its own outfit for every session and subagent - #7

Merged
MF-DEEV merged 6 commits into
mainfrom
feat/claude-sessions
Oct 22, 2026
Merged

MF-DEEV merged 6 commits into
mainfrom
feat/claude-sessions

Conversation

@MF-DEEV

@MF-DEEV MF-DEEV commented Oct 22, 2026 •

Copy link
Copy Markdown
Owner

Every Claude Code session and subagent in the Sessions section now shows its own pixel Clawd, the crab Claude Code greets with, in an outfit drawn at random. Sessions from one folder are told apart at a glance, and the outfit can be changed from the session's page.

Clawds

  • Outfit. Shell (10 colors, Claude Code's own clawd_body rgb(215,119,87) among them), hat (8), eyewear (5) and extra (6), each part optional. The lot is drawn from the session's id with FNV-1a and SplitMix64, so a session wears the same outfit on every launch and after claude --resume, which keeps the id.
  • Subagents draw their own outfit from session/agent ids. When the agent's definition has a color: line, the shell takes that color (red, orange, yellow, green, cyan, blue, purple, pink). A finished subagent fades.
  • Drawing. Letter-coded pixel grids, after the sprite Claude Code cooks with, composed per pose into small images and scaled by whole device pixels with no smoothing. No artwork files ship.
  • Motion by phase. Working: busy hands. Running a tool: waddling. Waiting on a permission: hops and waves under an amber "!", or "?" for a question. Done: one jump with both arms up, then smiling eyes. Idle: blinks, and dozes with rising z's after five minutes. Reduce Motion keeps one pose per phase. Every Clawd of a session counts from when the phase began, so the row and the notice move together.
  • Cost. A display link at 12 steps a second (6 in Low Power Mode) runs only while the Clawd is on a visible, uncovered window, and the layer changes only when the pose does.

Wardrobe

Clicking the Clawd on a session's page (a shirt badge shows under the pointer) opens a wardrobe in the island: the Clawd on a stage, rows of swatches and tiles for each part, Surprise me, and a button back to the drawn outfit. A choice dresses it at once and it hops. The choice is kept by session id in notchSessionsCostumes, pruned like the session names and left out of settings backups. Escape steps back from the wardrobe to the page, ⌘Y/⌘N do nothing while it covers a request, and a bar offers the way back if the session starts waiting.

Elsewhere

  • List rows, the page header, the enlarged header, subagent rows and session notices (notch and capsule) show the Clawd; the closed strip beside the camera is unchanged.
  • A session whose Clawd dozes (idle for five minutes; opening its page counts as activity) fades a little in the list and comes forward under the pointer or keyboard focus. Nothing fades with Increase Contrast or with Clawds off.
  • Settings → Dynamic Island → Content → Sessions has a switch for Clawds, on by default; off brings the old badges back.
  • Agent colors are read from the first 4 KB of plain-file definitions in the project's .claude/agents and its parents, the person's agents, installed plugins and plugins synced from the account (the folder the account's manifest.json names). Folders macOS guards (Desktop, Documents, iCloud, cloud storage, external volumes and so on) are read only with Full Disk Access, also when reached through a link, so no prompt appears.
  • PRIVACY.md, PERMISSIONS.md, README and the spike notes are updated.

Testing

  • ./build.sh --test: all 114,413 checks pass apart from the flaky one below, no warnings. New suites cover the lot (pinned costumes for known ids, distribution, Surprise me), keeping and pruning, phase to motion, every pose fitting the canvas for every part, layout on whole device pixels, the view's clock against window visibility and Low Power Mode, and agent definitions (CRLF, BOM, comments, pipes, links, guarded folders, stale synced copies).
  • The .app bundle passes --selftest.
  • End to end with the Developer build and throwaway Claude Code sessions, clicking on the island:
    • two sessions in one folder wear different outfits; a subagent with color: green is green;
    • a permission request: the Clawd hops and waves under "!" (checked frame by frame); a finished session smiles; an idle one dozes;
    • wardrobe: shell, hat, Surprise me and reset, with the choice kept after relaunching the app and gone after reset;
    • claude --resume keeps the session's Clawd; the Settings switch swaps Clawds and badges live; a notice shows the session's Clawd.
    • sleeping sessions' rows fade (title brightness 179 against 245 for a working one) and come back under the pointer.
  • Not tested end to end: Reduce Motion, Low Power Mode and capsule notices (unit tests only). Tests/NotchCompactTests.swift:337 is flaky on unchanged code.

…stume

Each session draws a pixel Clawd costume (shell, hat, eyewear, extra) by
lot from its id, the same on every launch. Subagents draw their own and
wear the color their definition gives them. The Clawd waddles, types,
hops for a permission, cheers when work ends and dozes when quiet; Reduce
Motion keeps one pose. Clicking it on a session's page opens a wardrobe
in the island, and the choice is kept for that session.
…at clawds read

The wardrobe fits the whole canvas in its card, so a cup held out or the
highest jump no longer spills over the top row. The session page leaves
room for a tall hat to hop. Privacy and permission notes say that outfits
are kept by session id and that agent colors come from the head of agent
definitions, read in guarded folders only with Full Disk Access.
…in step

Agent definitions are read after a byte order mark, with any line ending
and without a trailing comment, only from plain files, so a pipe named
*.md can no longer hold up the sessions' queue. Plugins synced from the
account are searched too, and folders macOS guards stay unread without
Full Disk Access wherever they are reached from. Every Clawd of a session
counts its motion from when the phase began, so a row and a notice hop
together and the first hop comes with the request. Legs wear the shell's
shade, turning Clawds off closes an open wardrobe, notices follow the
switch at once, Low Power Mode is picked up as it changes, and the
settings search finds the switch.
… never list guarded folders

A synced plugin is read from the folder its account's manifest names,
with its generation, rather than a stale copy left beside it; without a
manifest the copies are tried from the highest generation. An agents
folder linked into a guarded folder is not listed without Full Disk
Access. A quoted color followed by anything but a comment is taken as
written, as Claude Code does, and names no color.
@MF-DEEV
MF-DEEV marked this pull request as ready for review October 22, 2026 17:30
A session idle for five minutes, whose Clawd dozes, fades to half in the
list, so the ones at work stand out. It comes forward under the pointer
to be read.
…read

A sleeping session's row fades to 0.65 rather than half, comes forward
under the keyboard as well as the pointer, and does not fade when more
contrast is asked for or Clawds are off. Opening a session's page counts
as activity, so a result read long after it came is not shown beside a
Clawd that falls asleep at once. The row and its Clawd read one clock.
@MF-DEEV
MF-DEEV merged commit 14c530f into main Oct 22, 2026
0 of 2 checks passed
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