Usage
Plan limits
Watch your Claude, Codex and Cursor plans fill up, with projections and reset times, in the menu bar, a widget and the app.
Claude, Codex and Cursor subscriptions come with limits: rolling windows that fill as you work and reset later, or an allowance for the billing cycle. Codz shows how full each one is, where it’s heading at the pace you’re going, and when it resets, so a limit doesn’t catch you halfway through a task.
Plan limits are part of the free app and need no Codz account.
What Codz reads
Claude
Claude’s 5-hour and Weekly windows, and its Extra usage when it is switched on. The readings come from Claude Code on this Mac, which Codz asks when its last reading is getting old, and from the Claude desktop app’s history while it runs, so they describe the account Claude Code is signed in to.
Codz measures the pace of the recent readings and projects each window forward:
- “Lands near 59%”: where the window lands at reset if the pace holds. Bars draw this as a hatched extension of the fill that ends in a small ring.
- “Runs out 9:00 AM, in 20m”: the window fills before it resets, and the bar turns amber, or red when that is under 30 minutes away. A window that runs out on another day names it: “Runs out Mon 3:00 PM”.
- “Lasts until reset” when nothing has been used lately, and “Forecast after 15 min of use” (“after 2 hours” for the Weekly window) until there is enough to measure a pace.
- “≥ 92%” with “As of 8:40 AM”: the newest reading is older than the window allows (45 minutes for a 5-hour window, 6 hours for the Weekly one). Usage inside a window only rises, so the window is at least that full; Codz stops projecting until a fresh reading arrives.
- “—” with “Waiting for a reading”: the window has reset since the last reading.
- “Ran out 9:00 AM · Back at 9:25 AM” once it’s spent.
Extra usage is a light, not a bar: “On, not used”, or “In use · billed beyond your plan”.
A window opens with the first message after the last one ended. Claude Code states its reset, and where it doesn’t, Codz dates the window from the readings, so that reset time is an estimate.
Codex
Codex reports each window itself, commonly a 5-hour and a Weekly one, with the exact time it resets. Codz asks each Codex login for them every couple of minutes and keeps the readings, so once it has three it projects the window the same way as Claude’s; until then it says “Forecast after 15 min of use” (“after 2 hours” for the Weekly window) beside the reset. Codex only reports on a request, so a reading stays current until its reset, and after a reset the window reads “—” until your next request.
If you use more than one ChatGPT login with Codex, each login’s windows are read separately and named after the window, such as “Codex 5-hour · Work”. A model with a limit of its own is named before the window, such as “Codex Spark 5-hour”. See Providers & logins.
Cursor
Cursor’s Included usage for the current billing cycle, as a percentage, with “$12.40 remaining” or “No included usage left” when your account reports a balance. It comes from your Cursor account, so it appears while the Cursor app is signed in on this Mac. Cursor reports no history or cycle end, so it says “Cycle percentage only” and there is no projection.
Other providers
OpenRouter shows the spend limit set on your key, such as “$3.40 of $10.00”, or No spend limit set. OpenCode says Plan limit not reported, and DeepSeek Usage not collected.
Where you see them
| Where | What it shows |
|---|---|
| Menu bar | Two rings while a window needs you; the popover’s Limits: the first window as a small chart, then every window |
| Plan Limits widget | Two rings (small), three windows (medium), or the first window as a chart and four more (large) |
| Usage | The top of the page: the window that needs you first as a large chart, its last 30 windows, and Limits with every window. Click a row to chart it |
| Overview | The window that needs you first, coloured once it warns |
| Composer | A warning above the prompt when a window will run out within 30 minutes or is 90% used, and the plan windows in the context meter’s popover |
| A chat’s Usage panel | The chat provider’s windows |
| Account menu | Plan limits under your name: the fullest provider, then one row per provider |
codz status | Each provider’s windows, Claude’s forecasts and Cursor’s cycle |
Every window is listed the same way everywhere: the ones that need you first, then the earliest to run out, then the fullest.
In the account menu, a provider with several windows opens a submenu with each one and, for Codex, when it resets. Providers with nothing to report are folded into one row, such as “2 others with no reading”, whose submenu says why for each. Clicking a row opens Usage.
The model picker shows the reading beside a provider’s logins, and each Codex login has its own. codz status asks Codex for its windows as it runs, and codz status --json puts every reading under plans. See Commands.
Colours
Every bar, ring and chart uses the same rule. A window is grey while there’s room. It turns amber from 75%, or sooner when it is on pace to run out before it resets, and red from 90%, when it will run out within 30 minutes, or once it’s spent. Providers are told apart by their logo beside the row, never by colour. A small tick on a bar shows how far through the window you are, and the words beside it say whether you’re ahead of that pace (“+2 pts over pace”) or behind it.
When a plan runs out
When a provider refuses a turn because its limit is spent, the chat says so above the composer, for example “You’re out of Claude 5-hour usage · Back at 9:25 AM, in 24m”, with a strip showing when it ran out and when it’s back, Remind me at 9:25, and the provider’s own page when it names one.
With Continue on another provider turned on in Settings ▸ Agent & composer, Codz keeps the task going on the next ready model in your loadout instead of stopping. It is on by default. See Models & loadout.
Questions
There’s no Claude meter. Claude’s readings come from Claude Code signed in with a Claude plan; an API key has no plan windows. Until there is a reading, the Plan Limits widget says “Open Claude Desktop or send a Codex request to read your limits.”
A meter shows “≥” and “As of”. The newest reading is older than its window allows, so Codz shows it as a floor and stops projecting. It picks up again with the next reading.
Codex says “Plan limit unavailable”. Codz couldn’t ask Codex, or every window it reported has since reset. Check that the Codex CLI is installed and signed in (codex login); after a reset, the next request reports the new windows.
Cursor’s cycle is missing. Sign in to the Cursor app on this Mac. Codz shows Cursor’s account usage only when that service answers.