MeterBar
Download for macOS
Latest v1.8.42833 downloadsMIT licensedLocal-firstNo account required

Know your limits before you hit them.

A tiny native utility for people who burn through AI coding quotas. It reads local provider state, shows the tightest limit in your menu bar, and keeps the source open.

Download for macOSView source

Requires macOS 26 or later · 20.0 MB · Version v1.8.42

Three providers, read locally.

MeterBar reads the auth and usage state these tools already keep on your Mac. Nothing new to sign into.

Claude Code

Session and weekly windows

Codex CLI

Session, weekly, and reset credits

Cursor

Local auth and usage state

A quota meter that stays out of the way.

MeterBar reads the provider state already on your Mac, surfaces the limit closest to running out, and stays quiet the rest of the time.

Menu bar

The tightest limit, always in view.

MeterBar keeps one number in the menu bar: the window closest to running out. Open it and every tracked limit is there with the time left before it resets.

  • The tightest limit is the one promoted to the menu bar.
  • Every provider window and reset time in one panel.
  • No dashboard, no browser tab, no provider login.
Widgets

The same state, in Notification Center.

The same provider state renders as small, medium, and large widgets, so the number you check between prompts is one swipe away instead of one click into the menu bar.

  • Three sizes reading from the same local state.
  • Small for the tightest window, large for the full breakdown.
Providers

Reads the CLIs you already signed into.

There is nothing to connect. MeterBar reads the auth and usage state the CLIs already keep on disk, and a provider you have not signed into simply sits idle until you do.

  • Claude Code, Codex CLI, and Cursor from their local surfaces.
  • Providers appear as they are detected, not as you configure them.
Privacy

Nothing leaves the Mac.

Credentials never move. MeterBar has no account, no server, and nothing to upload — which is a claim you can check yourself in a terminal rather than take on trust.

  • No account to create and no telemetry to opt out of.
  • Signed and notarized, so Gatekeeper opens it on the first try.
Privacy

It reads the sign-ins you already have.

MeterBar has no account, no server of its own, and no telemetry. Every provider it tracks is one you already logged into on this Mac, and it reads that existing session in place — it never asks you for a password and never copies a credential somewhere new. The full list is below, and all of it is checkable in the source.

Claude Code
Reads the OAuth token Claude Code already stored, and sends it only to Anthropic's own usage endpoint. If no token is readable, it falls back to parsing the output of claude /usage instead.
Keychain — Claude Code-credentials
Codex CLI
Reads the token codex login wrote, then calls ChatGPT's own usage endpoint with it. Honors CODEX_HOME when you have moved that directory.
~/.codex/auth.json
Cursor
Queries Cursor's local database for the session token the editor already holds, then reads your monthly usage from cursor.com.
~/Library/Application Support/Cursor
Grok
Checks only whether the login exists. The billing figures come back from the official Grok CLI over its own protocol — MeterBar never reads or stores that token itself.
~/.grok/auth.json
Cost scan
An optional 30-day scan that totals the token-count and model fields in local session transcripts. It never reads prompt or response text, and it makes no network calls at all.
~/.claude/projects, Codex session logs
OpenRouter
The one credential MeterBar stores itself: an API key you paste into Settings, kept in MeterBar's own Keychain item and used only against openrouter.ai.
Keychain — dev.meterbar.app

Prompts macOS will show you

Keychain access, once
On first launch macOS asks whether MeterBar may read the Claude Code-credentials item. That single read is how Claude usage arrives without a login. Deny it and MeterBar falls back to the CLI, and you can switch the OAuth read off in Settings at any time.
Notifications, optional
Requested once so quota warnings and session-wake alerts can appear. Decline it and every other part of the app keeps working.
Login Items, only if you opt in
Enabling Launch at Login or Session Wake registers a helper through SMAppService, so MeterBar shows up under System Settings → General → Login Items. Both stay off until you turn them on.
No Full Disk Access
MeterBar never requests it. Everything listed above sits in your home directory or your login Keychain, none of which is behind that permission.

Also true

  • No account, no sign-up, and no MeterBar server for anything to be sent to.
  • No analytics, no telemetry, no crash reporting.
  • Outbound requests go only to your own providers' usage endpoints.
  • The widget is sandboxed. The main app is not, because it has to read other tools' files — hardened runtime is enabled for both.
  • MIT licensed, so every path listed here can be checked against the source.
Check it in the source

Inside MeterBar

MeterBar overview window tracking Codex, Claude, and Cursor usage limits
MeterBar macOS widget showing quota usage

Download it, or install it with Homebrew.

Signed and notarized, so it opens on the first try — no Gatekeeper detour. The full source is on GitHub if you would rather build it yourself.

macOS 26+ target while the app is under active development.
Reads from CLI/provider state already on the machine.
Signed and notarized; no Gatekeeper overrides needed.
Direct download
v1.8.42
Signed and notarized. Drag to Applications, done.
Download for macOSAll releases

Requires macOS 26 or later · 20.0 MB · Version v1.8.42

Using Claude Code or Codex?
Prefer Homebrew?
brew install --cask vincentshipsit/tap/meterbar
GitHub