pulse — guest@123cheese — zsh — 80×24 cd ..exit

pulse --about

pulse watches your mac and your ai limits, right from the menu bar.

A tiny native macOS app for CPU, memory, and how much of your Claude, Codex, Copilot, Gemini or API allowance is left. About 1% of one core. Readings stay on your Mac.

open ~/dev/pulse/gallery

Pulse open on a MacBook: CPU 44% and memory 82% charts, Claude and Codex usage tiles, and the apps using the most CPU
pulse --specs

binary        1.4 MB · arm64
memory        ~30 MB
cpu, idle     ~1% of one core
sampling      every 3 s · 2 min history
ai readings   every 5 min
source        Swift · C · Python
              ~1,900 lines
requires      macOS 14+ · Apple Silicon
dependencies  0
network       AI services only
Close-up of the Pulse hover card under the menu bar: Claude 5-hour 50% and weekly 54%, Codex weekly 96%, each with a reset time
The Mac menu bar with Pulse: Claude and Codex dials, a CPU graph at 44% and memory at 82%

pulse --features

pulse --requirements

install

Paste this into Terminal:

git clone https://github.com/123-Cheese-Online-LLC/pulse && cd pulse && ./scripts/install.sh
  1. Checks your Mac and builds Pulse on it, so macOS doesn't block it.
  2. Installs Pulse to ~/Applications and opens it.
  3. Asks to connect Claude for exact limits (optional).
  4. Asks to add Pulse to Claude Code's status line (optional, default no).

To update: run git pull in the pulse folder, then the installer again.

pulse --help

pulse --tools

Tools appear on their own once they're set up on your Mac. Nothing extra is installed.

toolshows
Claude Code5-hour and weekly %, or tokens used
Codex5-hour and weekly %
GitHub Copilotchat, completions and premium %
Gemini CLItokens, last 5 hours and 7 days
OpenAI API$ this month (admin key)
Anthropic API$ this month (admin key)

pulse status

See what Pulse can read on your Mac. It prints no keys or tokens. Add -a to also list tools that aren't set up.

/usr/bin/python3 ~/Applications/Pulse.app/Contents/Resources/usage_bridge.py status

uninstall

osascript -e 'tell application id "local.koz46.pulse" to quit'; rm -rf ~/Applications/Pulse.app ~/Library/Application\ Support/Pulse; defaults delete local.koz46.pulse

Full uninstall notes, including saved API keys and the Claude status line, are in the README.

open source

github.com/123-Cheese-Online-LLC/pulse