~/apps/calmmeter available · macOS
CalmMeter icon

Calm is knowing
how much is left.

CalmMeter keeps your Claude Code limits in view — the same data as the /usage command, without opening a terminal. Both the 5-hour and weekly window: how much you have used and when it resets.

macOS 13+ · MIT licence · no account, no analytics

Usage
5h window 10 %
resets in 4 h 33 min
Weekly 66 %
resets in 2 d 11 h
Fable 93 %
resets in 2 d 11 h
Updated 7:06 Preferences… Quit

a dot and a percentage in the menu bar · the panel one click away · no extra window

$ cd ~/what-it-does

A limit should not surprise you mid-task.

CalmMeter does not manage or speed up anything. It quietly shows how much room you have left — and when it comes back.

01

Always in view

A coloured dot and a percentage right in the menu bar. You catch the state peripherally, without switching windows.

02

Both windows at once

The 5-hour and the weekly limit with reset countdowns. The same numbers /usage reports.

03

Calm when things fail

On errors it backs off, honours Retry-After and keeps showing the last known values. No hammering the server.

$ cd ~/look-inside

It takes exactly as much space as you give it.

Four menu-bar formats. From the full reading down to a single dot.

10 %
dot + 5h %
the default
10 %
5h % only
leanest with a number
10 % · 66 %
5h % · weekly %
both without opening the panel
dot only
for a crowded menu bar
Colour thresholds are yours to set: plenty left watch it running out

$ cd ~/preferences

Everything is configurable.

Five settings, no submenus. Set it once and forget it.

Menu-bar format dot + 5h %
Refresh interval 30 s · 60 s · 5 min
Launch at login on
Per-model breakdown optional
Colour thresholds green / orange / red

$ cd ~/privacy

Your data stays between you and Anthropic.

CalmMeter has no server, no account and no analytics. The only thing it sends out is a request for your own usage — exactly the one /usage makes.

The token from your keychain

On first launch macOS asks for access to the Claude Code-credentials item. Click Allow.

CalmMeter copies the token into its own item, com.calmbit.CalmMeter.credentials, and reads from there afterwards — so it stops asking on every launch.

One call out

GET api.anthropic.com/api/oauth/usage with your bearer token. Nothing more, nowhere else.

It does not refresh the token itself — Claude Code keeps it fresh. When it stops working, CalmMeter re-reads Claude Code’s item once.

No third parties

No analytics, no telemetry, no Calmbit account. Your settings stay on your Mac.

The whole source is on GitHub under the MIT licence — you can check it line by line.

$ cd ~/download

Give it a try.

Free on GitHub. macOS 13 Ventura or newer, with Claude Code installed and signed in.

Download the DMG macOS 13+

Open it, drag to Applications, launch. Signed and notarized.

Download .dmg
Build from source Swift

git clone …/CalmMeter.git
./scripts/build-app.sh --install

Open the repository →