Skip to content

AgentPulse v0.0.1

Pre-release
Pre-release

Choose a tag to compare

@chengboonrong chengboonrong released this 13 Nov 03:26
· 119 commits to main since this 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 --dump and --bench modes.

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 with cargo 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.