Repository navigation
AgentPulse v0.0.1
Pre-release
Pre-release
First vertical slice of AgentPulse: a native macOS window that shows what the Claude Code sessions on your Mac are doing right now.
What's in it
- Discovers Claude Code sessions, including subagents, and tails their transcripts.
- Counts tokens once per API response and estimates cost from an editable price table.
- Maps each running session to its process by PID and start time, and measures the CPU and resident memory of its whole process tree.
- Shows status from the agent's own state: active, waiting, idle, completed, failed.
- Keeps history in a local SQLite database.
- One animated pixel cat per live agent, with a cartoon-style sprint under heavy output.
- Two screens (Overview, Sessions), light and dark themes, plus headless
--dumpand--benchmodes.
Everything stays on your machine: no network calls, and no prompt, response or file content is read or stored.
Verified on the development machine (macOS 27, Apple Silicon)
- 99 automated tests pass.
- Token totals match an independent count exactly on all sessions from the last 24 hours.
- Estimated cost is within $0.0002 of Claude Code's own recorded figure on the two sessions compared.
- Collector overhead: about 1% of one core and 13 MB with three live agents.
Not in this release
- Codex and OpenCode adapters.
- Menu-bar companion, GPU telemetry, settings screen, usage analytics.
- A packaged
.app: this release is source only. Build withcargo run --release -p agentpulse-app. - Cat animation has been reviewed as still frames and tested for timing, but not yet watched running in the window.
See docs/roadmap.md for status and known limits.