session-dock-for-claude
v0.10.1
Published
A floating macOS dock of pixel-art sprites, one per Claude Desktop session: click to jump to the session, with live status from Claude Code hooks. Independent project, not affiliated with Anthropic.
Maintainers
Readme
Session Dock for Claude
A small floating dock on the right edge of your Mac screen with one pixel-art sprite per Claude Desktop session. Click a sprite to jump to that session; its badge shows whether Claude is working, waiting for you, or done.
Independent project. Not made, endorsed or supported by Anthropic. "Claude" is a trademark of Anthropic.
Leer en español: README.es.md. The app's interface is currently in Spanish.
Requirements
- macOS 13 (Ventura) or later
- Node.js 18 or later
- Apple's Command Line Tools:
xcode-select --install - Claude Desktop
Install
npm install -g session-dock-for-claude
session-dock installsession-dock install builds the app from the Swift source in this package on your Mac,
signs it locally, copies it to /Applications and sets up the Claude Code hooks. The npm
package has no install scripts and ships no prebuilt binary: nothing runs until you call the
command.
After installing, quit Claude Desktop completely (Cmd+Q) and open it again.
Use
- + adds a session. Pick one from Sesión de Code en este Mac (the first time, grant
read-only access to Claude Desktop's
claude-code-sessionsfolder), or create a new Code session in Claude Desktop from there. - Click a sprite to open that exact session in Claude Desktop.
- Hover to see the session name and status. Right-click to change status, edit or remove.
- » collapses the dock to a small tab on the screen edge.
- The menu bar icon shows or hides the dock, adds sessions, toggles launch at login and quits. Configuración… opens the settings window: notification sound on/off and sound type (four to choose from), pop-up on/off, side of the screen, display (when more than one is connected) and a transparency slider.
Chats can be added by pasting their https://claude.ai/chat/… link; their status is manual.
Live status
| In the session | In the dock | |---|---| | You send a message, or Claude uses a tool | Running (blue pulse) | | Claude asks a question, shows a plan or requests a permission | Waiting for you (orange, "!") | | Claude finishes its turn | Done (green check) |
When a session starts waiting for you or finishes, the dock can play a sound and show a small pop-up next to the sprite (click it to open the session). If Claude asked a question or needs a permission, the pop-up and the hover label show it. Turn each one on or off, and pick the sound, in Configuración… from the menu bar icon. Both are on by default.
Live status works for local Code sessions of Claude Desktop that were added from the session list or created from the dock.
Commands
session-dock install [--no-hooks] [--no-open]
session-dock open
session-dock hooks install | uninstall
session-dock diagnose
session-dock uninstall [--purge]What it changes on your Mac
- Installs
Session Dock for Claude.appin/Applications(or~/Applications). - Copies
session-dock-hook.shto~/.claude/hooks/. - Adds six hook entries to
~/.claude/settings.json, after saving a backup next to it. The hooks also run for Claude Code sessions in the terminal; the dock ignores those. - The hook notifies the dock through a
sessiondock://status?…link with the session identifier and its new state. When a session is waiting for you, it also passes what Claude Code reports for that event (the question Claude asks, or the permission it requests) so the dock can show it. This stays on your Mac and is not written to the log. It keeps a short log of timestamps, states and session ids in~/.claude/hooks/session-dock.log, and the last state of each session in~/.claude/hooks/.session-dock-state/.
session-dock uninstall reverts all of it.
Privacy and security
- The app runs in the macOS App Sandbox with no network access.
- It only opens
claude.ai,claude.comandclaude://links. - It reads session titles and working folders from the folder you grant, read-only. It does not read your conversations; the only conversation text it ever shows is the question or permission request of a session that is waiting for you, kept in memory only.
- Your dock sessions are stored locally in the app's sandbox container.
Limitations
- Opening an exact Code session and reading the session list rely on Claude Desktop behaviour
that Anthropic does not document (
claude://code/continue?session=…and theclaude-code-sessionsrecords). A Claude Desktop update can break them. - Cowork sessions and cloud sessions have manual status.
- The dock does not scroll: it shows as many sessions as fit along the chosen side of the screen (about 10 on the side of a laptop screen, more along the top or bottom).
- The app is signed locally (ad hoc), not with an Apple Developer ID.
License
Proprietary, all rights reserved. You may install and use the software as published; you may not modify or redistribute it. See LICENSE.
