Repository navigation
feat(sessions): a Clawd in its own outfit for every session and subagent - #7
Merged
Merged
Conversation
…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
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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
clawd_bodyrgb(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 afterclaude --resume, which keeps the id.session/agentids. When the agent's definition has acolor:line, the shell takes that color (red, orange, yellow, green, cyan, blue, purple, pink). A finished subagent fades.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
.claude/agentsand its parents, the person's agents, installed plugins and plugins synced from the account (the folder the account'smanifest.jsonnames). 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)..appbundle passes--selftest.color: greenis green;claude --resumekeeps the session's Clawd; the Settings switch swaps Clawds and badges live; a notice shows the session's Clawd.Tests/NotchCompactTests.swift:337is flaky on unchanged code.