Everything here stays in this browser. No account, no upload, no cookie.
codex-usage --forecast
When does the next reset land?
Call the next verified reset. Community results unlock after enough forecasts, and every round is scored against what happened.
Community forecast
Model forecast:
Fetching the current reset…
Community unlock{count} / {min} forecasts
No reset landed in the last round — it closed at "not anytime soon" and this one reopened on the weekly refresh.
What readers expect
These percentages are reader expectations, not this site's forecast. The model number beside them is calculated from verified reset history and is never mixed with the vote.
The dashboard shows one number today. Log it a few times across the week and the shape appears: how fast you are actually burning, how much you can spend per day and still make it, and when you run out if nothing changes.
remaining now—
cycle elapsed—
readings this cycle—
sustainable pace your burn
codex-usage --reference-cycle
What a real cycle looks like
One real account, sampled every minute by this site's reset verifier and published as a daily curve. It is a single account on a single plan running one person's workload — a shape to compare against, not a population estimate.
Source: this site's own monitored account. Not OpenAI data, and not an average of users.
observed: Spark-specific 5-hour meter shown; the general 5-hour row may still be absent
weekly window
yes — live percentage and reset time
yes — percentage and reset time
history
no
yes — 7 days, 1 month, or a custom range
by model / surface / skill
no
yes
freshness
read at the moment you run it
aggregated, lags by minutes
Run /status when you are deciding whether to start another task. Open the dashboard when you want to know which model, surface or skill consumed the window.
codex-usage --explain-dashboard
What every block on the dashboard means
Observed directly on the live page rather than copied from documentation. OpenAI's own enterprise guidance warns against treating dashboard labels as a stable contract, so this section carries its own observation date.
balance
The top card. It states plainly that Codex and Work share the same usage limit, then shows your weekly usage limit as a percentage remaining with an absolute reset timestamp — the same server-sent time the CLI renders.
easy to misread: It is a percentage, not a quantity. OpenAI publishes no weekly cap for any plan, so 20% remaining cannot be converted into a number of messages.
the second meter you probably missed
Spark now has two separate cards: a GPT-5.3-Codex-Spark 5-hour limit and a Spark weekly limit, each with its own remaining percentage and reset display.
easy to misread: Do not merge the Spark 5-hour and Spark weekly cards into one allowance, or confuse either with the general weekly card. Read the label and timestamp on the exact card.
credits remaining
Credits extend usage past the plan limits and are spent only after a window is exhausted. Auto-reload appears later on the page and tops the balance up automatically when it runs low.
easy to misread: Zero credits is the normal state for someone who has never bought any — it is not an error, and it is not your weekly limit hitting zero.
Usage limit resets
The live account section is titled "Usage limit resets" and says a reset can restore the 5-hour limit, weekly limit, or both. A saved item appears as "Full reset" with its exact expiry and a "Use reset" action in both the Codex app and the web Usage tab.
easy to misread: Seeing Full reset means the reset is available, not already applied. Your current percentages change only after you choose Use reset; copy the displayed expiry rather than assuming a universal lifetime.
personal usage, by surface
A 0–100% chart across the selected range, split into Desktop App, CLI, Web and Exec. This is the block that tells you which client is actually eating the window.
easy to misread: Surfaces are clients, not budgets. All four draw on the one shared pool, so a quiet CLI does not mean you have headroom.
turns
The total number of turns in the range, toggled between By model and By surface. The model list is the live routing set — Sol, Terra and Luna alongside the older 5.5, 5.4 and 5.4-mini, plus Spark and the automatic code-review model.
easy to misread: A turn is not a unit of cost. A long Sol turn at high reasoning effort and a one-line Luna turn both count as one.
skills and plugin calls
Two counters over the same range: how many plugin calls ran, and how many skills were used, broken down per skill.
easy to misread: These count invocations, not consumption. They are useful for spotting a skill that fires far more often than you expected, not for attributing budget.
credits usage history
A paged table of Date, Service and Credits used. It stays empty until credits are actually spent.
easy to misread: It records credit spend only. Ordinary in-plan usage never appears here, so an empty table says nothing about how heavy your week was.
the controls
Range is 7D, 1M or a custom window, with a Group by selector that buckets the charts (Day by default). A second tab, Code review, covers automatic reviews separately from everything above.
The range applies to the history charts only. The balance card at the top is always live and ignores it.
Dashboard anatomy observed 2026-08-22
codex-usage --faq
Codex usage questions, answered
Where is the Codex usage dashboard?
It is inside Codex settings, not ChatGPT settings, under Analytics — the page is titled "Codex and Work Analytics" and the Usage tab is the default. The older /codex/cloud/settings/usage address is no longer the surface that carries the meters. https://chatgpt.com/codex/cloud/settings/analytics#usage
How do I check Codex usage without opening a browser?
Run /status in an active Codex CLI session. Read the live percentage remaining and reset time from the limit-window rows your client actually prints; the returned set of windows can vary.
Why does the dashboard not show my 5-hour limit?
The web Usage tab can show a GPT-5.3-Codex-Spark 5-hour card while still omitting a general 5-hour card. OpenAI can return different window sets by model and account, so read the exact labels on your page and compare them with /status.
What is the GPT-5.3-Codex-Spark meter?
A separate allowance for the Spark model with its own percentage and its own reset timestamp, shown directly beneath the weekly bar. It runs on an independent clock — spending it does not touch your weekly window, and the weekly rollover does not refill it.
Does ChatGPT Work usage count against my Codex limit?
Yes. The balance card says so outright: Codex and Work share the same usage limit. ChatGPT for Excel and Workspace Agents draw on that same agentic pool. Ordinary ChatGPT chat is metered separately and never drains it.
How many messages is 20% of my weekly limit?
Unknowable from the dashboard. OpenAI publishes per-5-hour message ranges per plan but no weekly cap for any plan, so the weekly meter is a percentage of an undisclosed total. Anyone quoting an exact weekly message count is guessing.
Why did my usage percentage jump without me running anything?
The history charts aggregate and lag by minutes, and the surfaces share one pool — a cloud task, an automatic code review or a Work session can consume budget while your terminal sits idle. Compare against /status, which reads live.
Where do I see and use a saved reset?
In the Codex app, open the profile usage summary. On the web, open Codex and Work Analytics → Usage. Look for the section named "Usage limit resets", then review the Full reset expiry and choose Use reset only when you want the listed windows restored. Read the banked reset guide
Would a reset actually help me?
Not always. A reset refills the weekly window and also restarts it from that moment, so if you were still holding most of your quota the top-up is small and your next rollover moves later — you can end up hitting the limit at a time you otherwise would not have. The reset-value calculator plays both futures forward from numbers you type. Was that reset worth it?