Keep Working
Your Claude sessions, on your Mac desktop. A little character walks the steps while Claude works, snaps a
photo when a new image arrives, waves when Claude needs you, and celebrates when it's done. One click opens
that chat.
Download for macOS ·
see it move · macOS 14 or later
Install
- Open
KeepWorking.dmg and drag Keep Working into Applications.
- Open it. The first time, macOS stops it (it isn't notarized): click Done.
- System Settings → Privacy & Security → scroll down → Open Anyway, then Touch ID or your password.
- Right-click the desktop → Edit Widgets → Keep Working → drag a size onto the desktop.
Keep the menu-bar app (the head icon) running: it passes clicks to Claude and keeps the widget fresh.
Turn on Open at login in its menu so it's there after a restart.
Works with Claude Code in the terminal and in the Claude desktop app. Chats on claude.ai in a browser
don't show up: they leave nothing on your Mac.
Privacy
Read-only and local. It reads Claude's own session files (~/.claude/ and
~/Library/Application Support/Claude/), writes nothing there, and makes no network requests.
License
MIT. See LICENSE.
How it works
A macOS desktop widget showing your 10 most recent Claude sessions and how far along each one is.
What it shows
| Mark | Meaning |
|---|
| filled clay dot with halo | running: a turn is in progress right now |
| clay ring | waiting: the last turn ended on a question for you |
| green check | done: the session wrapped up its task list |
| grey dot | idle |
3/5 is the session's task list (steps done / total), read from its transcript.
Sources, all read-only and all local:
- Claude Code sessions in the desktop app:
~/Library/Application Support/Claude/claude-code-sessions/…/local_*.json
- Cowork tasks:
~/Library/Application Support/Claude/local-agent-mode-sessions/…/local_*.json
- Terminal sessions (
claude in a shell): ~/.claude/projects/*/*.jsonl with entrypoint: cli
- Live running / idle status:
~/.claude/sessions/<pid>.json
- Progress: the
update_plan / wrap_up (desktop) and TodoWrite (terminal) tool calls in each transcript
Regular claude.ai chats are not included: the desktop app doesn't keep them on disk, and reaching them
would mean reading your login cookie.
Links it opens
- desktop Code session:
claude://code/continue?session=local_…
- Cowork task:
claude://cowork/local_…
- terminal session:
claude://resume?session=<uuid> (imports it into the desktop app)
Pieces
Widget/: the WidgetKit extension (sandboxed, with read-only exceptions for ~/.claude/ and
~/Library/Application Support/Claude/). Sizes: small, medium, large (10 rows), extra large (2 × 5 rows with detail).App/: a menu-bar agent. It watches the session folders with FSEvents and tells the widget to reload,
so progress moves within seconds rather than on WidgetKit's own schedule. It also lists the same sessions
in its menu, and has an "Open at login" toggle.Shared/SessionStore.swift: reading and progress replay. Transcripts are read incrementally (the first read
starts at most 24 MB from the end; later reads only take appended bytes), with offsets cached in Caches.Tools/render.swift: renders the widget with live data to PNGs, for checking layout without placing it.
Build and install
brew install xcodegen
./install.sh # generates, builds, installs to /Applications, keeps one registered copy
Then right-click the desktop → Edit Widgets → search "Claude sessions" → drag the large size out.
Signed with the free Personal Team (MQ663L65WN): Xcode → Settings → Accounts must have the Apple ID.
Keep exactly one registered copy of the app: a second copy (e.g. in the build folder) makes the system
widget service flip between them. The file formats above may break if the Claude
desktop app changes how it stores sessions; SessionStore.swift is the one place to fix.
Preview every state
Tools/preview.sh builds Keep Working Preview, a small app that draws the widget's own views in a window:
all four sizes at once, with arrows (or ← →) to step through every state (needs you, working with and
without a list, finished, paused, idle, terminal, no sessions, can't read, and your live sessions).
The animation tick runs live; space pauses it, D switches light/dark.
Tools/preview.sh --capture <dir> saves every state at two ticks, light and dark, as PNGs of the window;
Tools/preview.sh --frames <state number> <dir> saves 64 frames about 0.4 s apart (a full walk turn), to check motion.
It opens on the Character screen (C toggles back to the widget): every mood looping, the walk along a
bar, a mood change, at 12/24/60 fps (F). Tools/preview.sh --sheets <dir> renders every loop frame by frame.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
