Track all your AI coding subscriptions in one place

See your usage at a glance from your menu bar. No digging through dashboards.

Download

Download PulseUsage from GitHub Releases.

Current macOS distribution: direct GitHub Releases downloads. Binary app auto-updates are not implemented yet. PulseUsage can auto-refresh provider usage data on a schedule, but that is separate from updating the app itself. Downloaded macOS builds may show Gatekeeper warnings until signing and notarization are configured.

What It Does

PulseUsage lives in your menu bar and shows you how much of your AI coding subscriptions you've used. Progress bars, badges, and clear labels. No mental math required.

• One glance. All your AI tools, one panel.
• Always up-to-date. Refreshes automatically on a schedule you pick.
• Global shortcut. Toggle the panel from anywhere with a customizable keyboard shortcut.
• Lightweight. Opens instantly, stays out of your way.
• Plugin-based. New providers get added without updating the whole app.
• Local HTTP API. Other apps can read your usage data from 127.0.0.1:6736.
• Proxy support. Route provider HTTP requests through a SOCKS5 or HTTP proxy.

Menu Bar

The status bar icon opens a menu with:

• Show Statistics / Settings… — open the panel to the overview or settings.
• Log Level ▸ — change log verbosity (Error / Warn / Info / Debug / Trace).
• Diagnostics ▸
  • Open Log Folder — reveal the log directory in Finder.
  • Copy Log Path — copy the log file path to the clipboard.
  • Export Diagnostics… — copy log files plus a redacted metadata snapshot (app version, platform, plugin ids/names/versions; no credentials or settings) into a timestamped folder under Downloads and reveal it.
• About PulseUsage — open the about panel.
• Download Latest Release — open the GitHub releases page. PulseUsage does not self-update; download new builds manually.
• Quit — exit the app.

Supported Providers

• Amp / free tier, bonus, credits
• Antigravity / all models
• Claude / session, weekly, extra usage, local token usage (ccusage)
• Codex / session, weekly, reviews, credits
• Copilot / premium, chat, completions
• Cursor / credits, total usage, auto usage, API usage, on-demand, CLI auth
• Factory / Droid / 5h, weekly, monthly, Droid Core, managed computers, tokens
• Grok / credits used, plan, pay-as-you-go cap
• JetBrains AI Assistant / quota, remaining
• Kiro / credits, bonus credits, overages
• Kimi Code / session, weekly
• MiniMax / coding plan session
• OpenCode Go / 5h, weekly, monthly spend limits
• Perplexity / requests, searches, research
• Devin / weekly quota, extra usage
• Synthetic / demo provider metrics
• Warp / base credits, personal credits, auto-reload, spend limit
• Z.ai / session, weekly, web searches

Community contributions welcome.

Want a provider that's not listed? Open an issue.

Independent Project

This repository is the independent development home for PulseUsage.

Useful upstream fixes can be reviewed and brought into this repo deliberately.

Plugins are currently bundled while the app stays focused on a small internal workflow.

How to Contribute

• Add a provider. Each one is just a plugin. See the Plugin API.
• Fix a bug. PRs welcome. Provide before/after screenshots.
• Request a feature. Open an issue and make your case.

Keep it simple. No feature creep, no AI-generated commit messages, test your changes.

Development Notes

PulseUsage uses AI-assisted development tools such as Cursor, Claude Code, and Codex CLI. Changes should still be reviewed, tested, and kept small.

Release and Environment Checks

src-tauri/resources/bundled_plugins/ is generated and gitignored. An empty folder in a checkout is not a release failure by itself.

Before diagnosing missing providers, verify the active checkout and production bundle:

• Update the checkout with git pull --ff-only origin main.
• Confirm source plugins exist, especially plugins/factory and plugins/warp.
• Bundle plugins with bun run bundle:plugins.
• Confirm bundled manifests with find src-tauri/resources/bundled_plugins -maxdepth 2 -name plugin.json.
• Build releases with bun run build:release; the script fails if bundled plugin manifests are missing.
• Verify installed app resources under /Applications/PulseUsage.app/Contents/Resources/resources/bundled_plugins/.

Provider manifests list supported metrics. Runtime cards show returned metrics, and provider detail pages mark supported metrics as Not returned when the provider or local data source does not expose those fields.

Sponsors

This independent repository does not currently use sponsorship links.

Credits

Same idea, very different approach.

• Based on OpenUsage, originally by Robin Ebers, under the MIT license.
• Inspired by CodexBar by @steipete.

License

MIT

---

Build from source

Warning: The main branch may not be stable. It is merged directly without staging, so users are advised to use tagged versions for stable builds. Tagged versions are fully tested while main may contain unreleased features.

Stack

...