CODEX / USAGE / RESET

Codex usage & reset

Paste your /status and see whether you make it to the reset.

Open your dashboard
codex /status

Your usage reset

Run /status in the Codex CLI and paste the whole thing.

Your weekly reset

weekly window % left

Paste your /status above, or enter the weekly percentage by hand.

burn pace
daily budget
runs out

The reset time and % here are the same ones the home tracker shows — one record, this browser only.

A reset refills this window and restarts it. See what a reset is worth to you

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

Fetching the current reset…

Choose one window

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.

Track record: No scored polls yet.

Open /api/reset-poll raw data

codex-usage --analyze-cycle

Analyze this reset cycle

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 --where

two places, two different answers

two places, two different answers
/status in the CLIthe analytics dashboard
answershow much is left right nowwhere it went over the last days
5-hour windowwhen returned — live percentage and reset timeobserved: Spark-specific 5-hour meter shown; the general 5-hour row may still be absent
weekly windowyes — live percentage and reset timeyes — percentage and reset time
historynoyes — 7 days, 1 month, or a custom range
by model / surface / skillnoyes
freshnessread at the moment you run itaggregated, 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?