Repository navigation
Releases
AgentPulse v0.0.10
The installer now opens on a window that shows where to drag AgentPulse. The app itself is unchanged from 0.0.9. If you're on 0.0.9, click Install Update; otherwise download the DMG below.
AgentPulse v0.0.9
AgentPulse now monitors the Grok CLI and OpenCode alongside Claude Code and Codex, showing each session's folder, model, tokens, cost and live status. Costs come from each agent's own records, and only session metadata is read, never your conversations. If you're on 0.0.8, click Install Update; otherwise download the DMG below.
AgentPulse v0.0.8
AgentPulse can now install its own updates: click Install Update and it downloads the new version, checks its signature, and relaunches. Nothing downloads until you click. Coming from 0.0.7 or earlier, download the DMG below and drag AgentPulse to Applications once; later updates install from inside the app.
AgentPulse v0.0.7
Phones now pair with no setup. AgentPulse ships with a relay at relay.snitco.com, so you no longer have to deploy your own or enter an address and key.
Download
AgentPulse-0.0.7.dmg (below) holds the app. It is signed with a Developer ID and notarized by Apple. Open the DMG and drag AgentPulse to Applications.
SHA-256: 7a5e6cd185724075b385f942d7136687f75c2a6ee97950a1c2647bbe4ce07461
New
- A built-in relay for phones. Settings → Phones → "Pair a Phone" works right away. While no relay of your own is set, Settings shows "Using the AgentPulse relay (relay.snitco.com)".
- The relay is a Cloudflare Worker run by the AgentPulse developer, built from
relay/in this repo. - Each pairing on it holds only:
- end-to-end encrypted messages;
- hashes of the pairing's tokens;
- its creation and last-use times.
- A pairing nobody answers is deleted after 10 minutes, and an unused one after 30 days.
relay/README.mdlists everything it stores. - The relay code writes no request logs. Cloudflare, which hosts it, sees connection details such as IP addresses, as any web host does.
- The relay is a Cloudflare Worker run by the AgentPulse developer, built from
- Your own relay is still an option. Enter its address in Settings → Phones.
- A relay key now goes only to the relay address it was saved with. Changing the address never sends your key to a different server.
- If you saved a relay key in 0.0.6, enter it again. Keys saved by 0.0.6 aren't tied to an address, so AgentPulse no longer sends them.
Network
Unchanged unless you pair a phone. With a phone paired, AgentPulse talks to relay.snitco.com, or to your own relay if you set one, as it did in 0.0.6:
- it sends the sealed widget summary when it changes, at most every 10 s and at least every 5 minutes;
- it polls for messages from the phone every 30 s.
The README and docs/telemetry-spec.md describe both in full.
Verified
- CI passed on the release commit (Rust, Swift
link/and relay tests, formatting and lints). - The DMG is notarized and stapled.
- The live relay at
relay.snitco.compassed two checks:- its health check answers;
- it accepts pairing requests without a key.
Known limits
- Not yet tested end to end: pairing a physical iPhone through
relay.snitco.com. Earlier pairing tests used a local relay. - The relay is new. It runs on Cloudflare's free tier with no uptime guarantee. New pairings are limited to 10 a minute from one address.
- iPhone app: it is in TestFlight internal testing only. Push notifications and the Live Activity are not built yet.
- Not yet checked by a person (unchanged from 0.0.6):
- the icon in Finder and the Dock;
- typing and IME in the text fields;
- VoiceOver on the new rows.
AgentPulse v0.0.6
AgentPulse's first packaged download: a notarized DMG. This release also brings an app icon, a richer menu bar and widgets, and early support for an iPhone companion.
Download
AgentPulse-0.0.6.dmg (below) holds the app. It is signed with a Developer ID and notarized by Apple, so macOS opens it without the "unidentified developer" warning. Open the DMG and drag AgentPulse to Applications.
SHA-256: f5f934038cc067344175803ab5d099f9acc3c8662b7716abfb3434d93143de35
New
- App icon. "Peek", a pixel cat peeking up from the bottom edge. It has light, dark and tinted versions on macOS 26, and the DMG volume uses it too.
- Menu bar
- Session rows open that session in the window. Waiting sessions come first, each with its state and how long it has run.
- An "Updated just now / N min ago" row.
- Codex plan-limit rows show a bar and a countdown to the reset.
- An output-rate sparkline. Missing samples stay blank, never zero.
- The icon fades when data is stale and shows a dot while an agent is waiting.
- Widgets. "Updated … ago" keeps counting, and the medium widget can show the Codex limit bar. The Overview header shows the same limit as a thin meter.
- Phones (early). Settings → Phones pairs the Mac with the AgentPulse iPhone app. Pairing goes through a QR code and a six-digit code that both screens show.
- The phone gets the same summary the widgets show, end-to-end encrypted. It travels over a relay, or directly when both are on the same network.
- Relay and key fields are real text fields now, with paste, selection and a secure key field.
Network
Nothing new happens unless you pair a phone. The update check from 0.0.5 is unchanged. With a phone paired, AgentPulse also:
- talks to the relay address you entered in Settings → Phones. It sends the sealed widget summary when it changes, at most every 10 s and at least every 5 minutes, and polls for messages from the phone every 30 s;
- listens on your local network (Bonjour
_agentpulse._tcp) while "Direct connection" is on.
The relay only ever sees encrypted data. The README and docs/telemetry-spec.md describe both in full.
Verified on the development machine (macOS 27, Apple Silicon)
- 266 Rust tests, 44 Swift tests (
link/) and 37 relay tests pass. Formatting and lints are clean. CI runs the same checks on every pull request. - The DMG is notarized and stapled.
spctlaccepts both the DMG and the app inside it as "Notarized Developer ID", with the hardened runtime. - The iPhone app builds, signs and has been uploaded to TestFlight.
- When the phone work was merged, pairing passed end to end against a local relay, both to a phone simulator and to the real iPhone app in the iOS Simulator. It has not been tried with a deployed relay or a physical iPhone.
Known limits
- Phones need a relay. There is no public relay yet, so you deploy
relay/(a Cloudflare Worker) yourself. The iPhone app is in TestFlight internal testing only, and push notifications and the Live Activity are not built yet. - Not yet checked by a person:
- the new icon in Finder and the Dock;
- typing and IME in the new text fields;
- clicking the real menu;
- VoiceOver on the new rows;
- widgets on a phone's home screen.
- Widgets are still snapshots that macOS refreshes on its own schedule, so a widget can be about 15 minutes behind.
AgentPulse v0.0.5
AgentPulse gets a Settings screen and tells you when a new release is out.
New
- Settings screen. A new sidebar item after Cats.
- Animation: turn the cats' animation on or off and pick its speed (0.5×, 1×, 1.5× or 2×). Saved with your coats; the
AGENTPULSE_ANIMATIONandAGENTPULSE_ANIMATION_SPEEDvariables still win, and Reduce Motion still keeps the cats still. - Updates: turn automatic checks on or off, check now, and see when the last check ran. When a newer release exists, Settings shows its version, date and release notes, with a button to download it from GitHub.
- Animation: turn the cats' animation on or off and pick its speed (0.5×, 1×, 1.5× or 2×). Saved with your coats; the
- New-updates notice. When a newer release is out, a banner at the top of the window offers What's New, Download and Dismiss, and the menu-bar menu gets an "Update Available" item that opens the release page. It is a notice only: nothing is downloaded or installed for you.
Network
This is AgentPulse's first and only network request. Every 2 hours (on by default; you can turn it off in Settings) it asks GitHub for this project's list of releases:
GET https://api.github.com/repos/chengboonrong/agentpulse/releases?per_page=10- headers:
User-Agent: AgentPulse/<version>,Accept: application/vnd.github+json,Accept-Language: en, plus theAccept-EncodingmacOS adds; - no cookies, no cache, nothing about you, your agents or your usage. GitHub sees your IP address, as with any connection.
The README and docs/telemetry-spec.md describe it in full.
Changed
settings.jsonnow also holds the animation and update settings. Each change saves only its own part on top of what is on disk, so two copies of AgentPulse sharing a data folder no longer undo each other's coats.- A
settings.jsonthat cannot be parsed is moved aside tosettings.json.bad-<time>instead of being replaced, and one bad cat entry no longer resets the others. AGENTPULSE_ANIMATIONnow acceptsonas well asoff; other values are ignored with a warning.
Verified on the development machine (macOS 27, Apple Silicon)
- 222 automated tests pass; formatting and lints are clean.
- The bundle builds, signs and verifies as 0.0.5, including the widget extension.
- One real update check against GitHub succeeded and correctly found 0.0.4 up to date.
- The "update available" banner and Settings were rendered through the app's screenshot mode from a local file.
- Two rounds of independent code review; the data-loss cases it found in
settings.jsonare fixed and tested.
Known limits
- Not yet checked by a person: clicking or keyboard use of the new Settings controls, the menu-bar update item, and VoiceOver on the new screen.
- The update check can only see releases from now on, so this is the first version that will tell you about the next one.
- Source only: no packaged download. The bundle is development-signed for the machine that builds it. A notarized DMG needs a Developer ID certificate.
- Widgets are still snapshots that macOS refreshes on its own budget, so a widget can be about 15 minutes behind.
AgentPulse v0.0.4
AgentPulse has a new look, the Cat Roster. Your agents are a cast of cats, and the one that needs you comes first.
New
- Cat Roster. The Overview is now a ranked grid of cards, one per agent:
- Each card shows the agent's cat on its own stage, a coloured ribbon (needs you, sprinting, working, idle, failed or ended) and one line of what was measured.
- The agent that needs you leads, outlined in pink. A cat hops once when its card changes rank.
- The header counts who needs you, who is working and who is resting, beside today's estimated cost.
- New visual style. Warm cream in light mode and deep plum in dark, Claude Code on a peach stage and Codex on a periwinkle one, set in SF Pro Rounded. Sessions, Usage, Cats and the widgets follow it.
- Output rate hover. Hovering the Output rate chart shows the value at that moment and how long ago it was measured.
- Dozing cats. A session idle for 10 minutes shows its cat asleep, in its own coat. Its ribbon still says idle, and any activity wakes it. Ended sessions stay grey.
Changed
- Today's token split moved from the sidebar to the top of the Usage screen.
- At the 880-wide minimum, the Sessions table drops the Model, Started and Claude Code cost columns instead of cutting them off.
- The roadmap adds a new-updates notice (on by default, checking every 2 hours, with a setting to turn it off) and pairing several devices with the planned mobile app.
Fixed
- The Output rate chart said "2 min ago" even when idle, where its samples are 5 s apart and covered 10 minutes. Samples are now placed by time over a real 2 minutes, and gaps such as a sleeping Mac are left empty rather than bridged.
Verified on the development machine (macOS 27, Apple Silicon)
- 209 automated tests pass; formatting and lints are clean.
- The bundle builds, signs and verifies as 0.0.4, including the widget extension.
- Every screen was rendered in light and dark through the app's screenshot mode.
- Chart libraries for GPUI (gpui-px, gpui-d3rs, plotters-gpui) were prototyped and not adopted. None builds unmodified on current GPUI; the findings are in
docs/repository-audit.md.
Known limits
- Not yet checked by a person: hover and keyboard focus on the new cards, and VoiceOver on the new screens.
- The Sessions table cannot be sorted yet.
- The widget's cat stage is one colour for every agent, because the widget's data does not say which agent a session belongs to.
- Source only: no packaged download. The bundle is development-signed for the machine that builds it. A notarized DMG needs a Developer ID certificate.
- Widgets are still snapshots that macOS refreshes on its own budget, so a widget can be about 15 minutes behind.
AgentPulse v0.0.3
AgentPulse now watches Codex as well as Claude Code, has a Usage screen with charts, and lets you dress each agent's cat.
New
- Codex CLI. Codex sessions appear beside Claude Code with tokens, estimated cost at API list prices, runtime, CPU and memory. Codex reports only active and idle while it runs. Subagent threads count once, under their root session, and only rollouts under your own
CODEX_HOMEcount. - Usage screen. Shows 30 days of estimated cost per day, split by agent. Also shows how efficient caching was and what it saved, today's sessions on a timeline, and Codex's plan limit with its reset time. Days with no stored data are drawn as such, never as zero.
- Session detail. Click a session to see its context size for each request and its running estimated cost.
- Cat coats. A new Cats screen dresses each agent's cat: 47 original coats (tabbies, calico, colourpoints, a galaxy…) and 7 eye colours. A choice applies at once and is saved. The desktop widget follows it; the menu-bar cat stays monochrome.
- CPU sprint. The cat also sprints when an active agent's processes are CPU-heavy, not only when it writes a lot of output.
- GPU. The status line shows how busy the Mac's GPU is overall. It is never shown per agent.
- Claude Code's own cost. Claude Code's own cost record is shown beside AgentPulse's estimate.
- Packaging.
scripts/bundle.sh --dmgbuilds a DMG.--releasebuilds a Developer ID signed, notarized DMG once a certificate is set up.
Changed
- Licensed under MIT OR Apache-2.0.
- The menu-bar cat animates at 5 frames a second. With the cat sprinting, the app uses about 2.7% of one core, down from 3.5–3.7%.
- The README has a screenshot gallery.
Verified on the development machine (macOS 27, Apple Silicon)
- 199 automated tests pass; formatting and lints are clean.
- The bundle builds, signs and verifies, including the widget extension.
- Codex token totals were cross-checked against the raw rollout files with no mismatches. Daily cost per day matches the database.
Known limits
- Not yet checked by a person: chart hover tooltips, clicking coats on the Cats screen, and VoiceOver on the new screens.
- Codex sessions older than a day appear only while their file is still open.
- A redesign of the window is in progress and is not part of this release.
- Source only: no packaged download. The bundle is development-signed for the machine that builds it. A notarized DMG needs a Developer ID certificate.
- Widgets are still snapshots that macOS refreshes on its own budget, so a widget can be about 15 minutes behind.
AgentPulse v0.0.2
AgentPulse now lives in the menu bar and on the desktop, and the window has a new layout.
New
- Redesigned window. The live agents lead the Overview as rows with larger cats. Totals moved to a one-line status row and a "Today" block in the sidebar, and the output-rate chart has real axes.
- Menu bar cat. One cat follows overall activity, next to the number of active agents. Its menu shows today's tokens and estimated cost, the output rate and the live sessions. Closing the window keeps AgentPulse running in the menu bar.
- Desktop widgets. Small and medium widgets with the cat, agent counts, today's estimated cost and (medium) the live sessions with running timers. Build the signed app with
scripts/bundle.sh, open it once, then right-click the desktop → Edit Widgets → AgentPulse. Seemacos/README.md.
Fixed
- A project running from the home folder is shown as "~" instead of the account name.
- Chart axis labels keep their precision for very small peaks.
Verified on the development machine (macOS 27, Apple Silicon)
- 118 automated tests pass.
- The bundle builds, signs and verifies; the bundled app launches, writes live widget data and quits cleanly, and macOS registers the widget extension.
- The menu-bar item and its rows were read back from the running app.
Known limits
- Not yet checked by a person: the icon's appearance in the real menu bar, closing and reopening the window, and a widget placed on a desktop.
- While the menu-bar cat sprints, the app uses about 3–4% of one core. A still cat adds nothing measurable.
- Widgets are snapshots: macOS budgets their reloads, so a widget can be about 15 minutes behind and always shows its "as of" time.
- The widget reads its data through a sandbox exception, which the Mac App Store does not accept.
- Source only: no packaged download. The bundle is development-signed for the machine that builds it.
AgentPulse v0.0.1
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.