AgentPulse icon: a pixel cat's face peeking up from the bottom edge

Watch your agents work

AgentPulse is a native Mac app that shows what the AI coding agents on your Mac are doing right now: Claude Code, Codex CLI, OpenCode and Grok CLI. Status, tokens, cost, CPU and memory per session, and a pixel cat for each one that runs while its agent works.

Download for Mac

Free and open source · macOS 14 or later on Apple Silicon · signed and notarized

No account, no API key. It reads metadata only: never your prompts, code or responses.

A ginger pixel cat running along the top of the window
The Overview window: a roster of session cards, each with a cat on a pastel stage, the project name, a state ribbon such as working or idle, an estimated cost and a token count, with today's estimated total at the top right

One cat per agent. Read its mood, not a dashboard.

Each session gets its own cat, and it moves with what its agent is really doing.

The Cats screen in dark appearance: a Claude Code and Codex switch, a preview of the ginger tabby sitting and running, a row of eye colour chips and a grid of coats
Cats. Pick a coat and an eye colour for each agent, from 47 and 7. The cat sits when its session is idle, looks around while it waits for you, runs while it works, and sprints under heavy output.

Three questions it answers

Is anything stuck?

The roster. One card per session. Look at the ribbon first: blue is working, grey is idle, and a card that is waiting on you turns pink and goes to the front. The figures under it are the session's tokens and its cost, marked ≈ when it is an estimate.

The Overview roster with session cards and their state ribbons

What's it costing?

Usage. Where the money went: estimated cost per day for 30 days by agent, what caching saved, and today's sessions on a timeline. A day with no stored data is drawn as a gap, never as zero.

The Usage screen: estimated cost per day for 30 days as bars split into Claude Code and Codex, with days that have no stored data shown as dotted gaps, and below it the cache efficiency card

How hard is it working?

Session detail. Open any session to see its context size per request, its running estimated cost, CPU and memory.

A session's detail screen: its context size for each request, its running estimated cost, and its CPU and memory

These images are rendered by the app's own screenshot mode from the developer's real sessions, not mocked up.

Your prompts never leave your Mac. AgentPulse never reads them.

What it reads, and how sure each number is

AgentPulse reads the agents' own files on your Mac and the system's process table. Every figure says whether it was measured or estimated, and anything it cannot know is shown as unavailable, never as zero.

FigureHow sureFrom
Tokens, model, start and last activitymeasuredThe agent's own usage records
Working, waiting, idlemeasuredThe agent's own session state. Codex CLI and OpenCode record no waiting-on-you state, so their sessions never show as waiting.
CPU and memory per sessionmeasuredThe macOS process table
Cost, Claude Code and Codex CLIestimatedTokens × API list prices, from a price table you can edit. A subscription plan is not reflected.
Cost, OpenCode and Grok CLIrecordedThe agent's own charge for each response; list prices where it records none
Plan limitCodex and Claude CodeCodex's own records. Claude Code shares its limits only with a status line command, which you add yourself (see the README).
Active timeestimatedGaps of up to 60 seconds between records
GPU per agentunavailablemacOS has no documented way to measure it. Whole-Mac GPU use is shown instead.
Prompts, code, responsesnever readOnly the metadata fields listed above are kept; content is never stored or shown

The full method, agent by agent: telemetry specification.

Privacy

Everything AgentPulse reads stays on your Mac. It never reads or stores prompt, response or file content.

On its own it makes one kind of network request: the update check, which asks GitHub for the public list of AgentPulse releases every 2 hours. It sends no cookies, identifiers or anything about you or your agents; GitHub sees your IP address, as with any connection. You can turn the automatic check off in Settings.

Phone pairing is an opt-in setting for a companion phone app that is not released yet. Until you pair a phone, it sends nothing.

This page sets no cookies and loads nothing from anywhere else.

Works with the agents you already run

Subagents included. Nothing to install or configure in the agents.

Try it in a minute.

Download AgentPulse

Signed and notarized by Apple · macOS 14 or later on Apple Silicon · Release notes · All releases

Install

  1. Download the DMG, open it and drag AgentPulse to Applications.
  2. Open AgentPulse. A cat appears in the menu bar; closing the window keeps it running there.
  3. Updates: it checks GitHub for a new release and shows a notice. Nothing installs until you click Install Update, and an update is installed only if its signature checks out.

It is not in the App Store on purpose: the App Store sandbox would stop it reading other apps' session files and the process table.

Requirements

  • macOS 14 or later on an Apple Silicon Mac.
  • At least one of Claude Code, Codex CLI, OpenCode or Grok CLI on the same Mac.

Questions

Does it work on Intel Macs?

Not yet. It needs an Apple Silicon Mac.

Are the costs exact?

No. For Claude Code and Codex CLI they're estimates at API list prices, and the app always says so; OpenCode and Grok CLI record their own charge.

How do updates work?

It checks GitHub for a new release and shows a notice. Nothing installs until you click Install Update, and an update is installed only if its signature checks out.