npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

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.

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 install

session-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-sessions folder), 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.app in /Applications (or ~/Applications).
  • Copies session-dock-hook.sh to ~/.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.com and claude:// 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 the claude-code-sessions records). 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.