claude-pulse

claude-pulse command [options]npx pulse-for-claude-code [command] [options]

claude-pulse is a local, dependency-free dashboard for Claude Code. It displays live token usage and context fill, recovers lost sessions, provides full-text search across past sessions, and lets you approve tool calls remotely (for example from a phone) through notification and approval hooks.Everything runs on the local machine: by default the dashboard serves on 127.0.0.1:4317 and opens in the browser. It is distributed on npm as pulse-for-claude-code and exposes the claude-pulse command once installed; it can also be run ad hoc with npx or directly from a clone via node bin/cli.js.

install-hooks

Wire notification and approval hooks into Claude's settings.

Run Pulse detached in the background.

Stop the background service.

Report whether the service is running.

Stop and restart the service.

Recover a lost session as a readable transcript.

Export all sessions to a compressed markdown file.

(macOS) Start Pulse at login with automatic restart.

Remove the system service.

Serve the dashboard on PORT instead of the default 4317.

Do not open the dashboard in a browser on startup.

Requires Node.js 18 or newer. The dashboard binds to localhost only; remote tool-call approval works by reaching that local service, so exposing it beyond the machine is the user's responsibility. Hooks modify Claude's settings file, so review the changes made by install-hooks.

claude-pulse is a community tool published on npm as pulse-for-claude-code, created to give Claude Code users visibility into token usage, context, and session history without external dependencies. It is distributed under the MIT license.

claude(1), npx(1), node(1)

Source code