Tokenmax 0.1

A macOS menubar app that shows remaining Claude Code and Codex quota — and, if you switch it on, Cursor's included usage — counts down to reset, projects whether your current pace runs out early or leaves quota on the table, keeps a local prompt queue, and notifies you before a window resets so leftover quota gets used instead of evaporating.

What it does

• Two providers in one meter. Claude Code and Codex quota side by side — session and weekly windows, each with the time left before it resets.
• Cursor, if you use it. How much of your plan's included usage is left this billing cycle, in total and on models picked by name. Off until you switch it on; watched, never driven.
• A menu bar icon you configure. Two or three stacked bars, nested rings that fit all four quotas at once, or the plain percentage left — each position drawing a quota you choose, plus a countdown that can track a different window entirely, and optional colour levels as a window runs low.
• A Side Notch when the menu bar is not enough. An opt-in Alpha handle lives at the right screen edge, expanding into provider rings on hover without taking keyboard focus.
• Pace, not just remaining. A marker showing where an even burn would have left you, whether you are ahead or in deficit, and when the window empties if you carry on at this rate.
• Reminders before quota evaporates. Per-window lead times and thresholds, quiet hours, and nothing at all until you switch them on.
• A local prompt queue. Keep work ready so leftover quota has somewhere to go. Run it yourself, or let Tokenmax run it.
• Unattended runs, on your terms. Off by default, preview-only when first enabled, with a runtime cap, a cost cap, path-scoped file access and a separate opt-in for shell.
• A session opener. A Claude window starts on first use, so one tiny request at the right moment means the next window is already running when you sit down.
• Nothing about you leaves your Mac. No telemetry, no analytics, no server, no account. The only request not about your quota is a daily "is there a newer release?" to GitHub, which you can switch off.

The menubar shows a set of meters and the time left before a window resets ("1h 16m"). The meters carry how much is left; the countdown carries how long there is to spend it.

Settings → General → Menu bar icon decides what is drawn, in one of two shapes.

Bars are two or three stacked capsules. Length is the channel the eye compares most accurately, so this is the shape to pick when the question is "which of these is lowest". Three is the ceiling: a fourth bar does not fit the menu bar's 16pt of height.

Rings are nested arcs, two per ring — an outer arc enclosing an inner one. That buys two things bars cannot give. A session runs inside a week, and putting the week on the outer arc draws that relationship instead of flattening it into two equal-looking rows. And two rings hold all four quotas at once, where bars stop at three. The cost is width: two rings take about 35pt where two bars take 20, so on a MacBook with a notch this is the shape that competes with your other menu bar items. One ring is 16pt — narrower than the bars — so watching a single provider comes out ahead. The outer arc is drawn dimmer than the inner one, which is what makes the pair read as nested rather than as two unrelated circles; it goes to full strength the moment it has something to announce.

Numbers write the percentage left instead of drawing it: one window, or two stacked, such as 90% over 40%. Neither bars nor rings can say the exact figure — length and arc are estimates — and for someone who watches the 5h window alone that figure is the whole question. With the time remaining switched on it follows after a dot, 90% · 4:10, so the reading and the deadline do not run together. The colours, the highlight and the escalation levels apply exactly as they do to a bar, since the digits are drawn by the same renderer. A reading Tokenmax cannot trust shows -- rather than a number: a stale 90% would claim a reading nobody has. Two lines of digits have to share the height one line has, so they are set smaller; the width follows what is written: about 28pt for one 90%, 20pt for two, and a little more at 100%.

In any shape, choose which quota each position shows — Claude session, Claude week, Codex session, Codex week, and with Cursor on, Cursor API and Cursor Auto — by dragging a quota onto a slot; dragging one that is already placed swaps the two. Rings are not locked to one provider per ring: if what you actually watch is both weekly windows, put them on the two outer arcs. A preview under the picker shows the icon you have built on a light and a dark menu bar.

This is the beginning of the README. Read the rest at the original. Read the full README ↗