Claudometer: your Claude usage in the menu bar

16% Sun 28 Jun 11:24 PM

It lives where you already look. No window to manage, no dock icon. Just a glance away, all day.

What it does

A gauge for your Claude limits.

Server-side truth, fetched live from Anthropic. Not an estimate from local logs, the real numbers Claude uses to decide your limits.

Session & weekly meters

Your 5-hour session and 7-day window, side by side, with exact reset times so nothing sneaks up on you.

SES16%

WK 7%

A sparkle with moods

The mascot breathes when you're idle, plays while a window is open, and goes frantic as you near a limit. You feel your usage before you read it.

Start a window in one tap

No open session? Tap Start Window and Claudometer fires a tiny ping to begin your 5-hour clock, no terminal required.

Private by design

Your token never leaves your Mac. Claudometer reads your local Claude login and talks only to Anthropic. Nothing is sent to us, ever.

Connect your Claude

Up and running in three steps.

Claudometer shows your data by reading the same Claude Code login you already use. If you have Claude Code, you're basically done.

STEP 01

Install Claude Code

The free CLI from Anthropic. Skip this if you already use it.

$ npm i -g @anthropic-ai/claude-code

STEP 02

Sign in once

Run Claude Code and log in with your Claude account. That stores the login Claudometer reads.

$ claude

STEP 03

Open Claudometer

Launch the app. Your sparkle appears in the menu bar with live usage. First launch only, macOS asks you to confirm: open System Settings → Privacy & Security and click Open Anyway.

Trust

Your data stays yours.

Claudometer is a read-only window onto your own usage. There is no account, no server of ours, and no telemetry.

Token never leaves your MacIt reads your local Claude Code credential and uses it only to call Anthropic's usage API.

No telemetry, no accountWe never see your usage, your token, or that you installed it. There's nothing to sign up for.

Open sourceEvery line is on GitHub. Read exactly what it does before you trust it with anything.

What's new

Changelog

Every release, straight from GitHub. The app tells you when a new one lands.

v1.0First release

The first public Claudometer.

Live session + weekly meters in the menu bar.
A coral sparkle mascot with moods.
One-tap Start Window and an opt-in notch HUD.
Built-in update checking.

Questions

Good to know.

Is it free?

Yes. Claudometer is free and open source. You only need an active Claude Max plan to have usage worth watching.

Does it use up my Claude tokens?

No. Reading your usage costs nothing. The optional Start Window button sends one tiny haiku ping to open a session, and that's the only time it touches your quota, only when you ask.

Why does it need macOS 26?

The interface is built on Tahoe's Liquid Glass. That material only exists on macOS 26 and newer, on Apple Silicon.

Is my Claude data safe?

Your token stays on your Mac and is used only to call Anthropic's own usage API. Claudometer has no server and collects nothing. The source is public so you can verify it.

How do updates work?

The app checks for a newer version on launch and from its menu. When one is out, it shows "Update available" and links you here to download it.

The first launch shows a warning?

During early access the build isn't notarized yet, so macOS blocks the first launch. The old right-click → Open shortcut no longer works on macOS Tahoe, so instead: double-click Claudometer, click Done, then open System Settings → Privacy & Security and click Open Anyway next to Claudometer. Confirm once and it launches every time after. Signed builds are coming.

Know exactly how much Claude you have left.