Do Codex Desktop and the Codex CLI have separate limits?

No. On one Codex home they sign in to the same account and share one set of windows. Separate homes stay separate.

What are reset credits?

The number of resets the service reports as still available. Agent HUD shows that number as given rather than working it out from the expiry list beside it.

My context is nearly full but my usage limit is not. Which one matters?

They are different. Context is how full this conversation is and compacting clears it; the usage limit is your plan's allowance and only a reset clears that.

Can I see this away from the Mac?

With Agent HUD Remote, which syncs one Mac's usage to the free iPhone, widget and Apple Watch apps.

Agent HUD · Guides

How to check your Codex usage

Codex meters a primary and a secondary usage limit, and shows a context percentage that is not either of them.

The limits

Codex reports its rate limits as windows with their own durations — a seven-day window reads as weekly, the others in hours or minutes. A plan usually has a primary window and a secondary one, and either can be the one that stops you.

Alongside them the service reports how many resets are still available, which is a count rather than a percentage.

Where to see them

/status inside a session. Codex's own breakdown of the current session and its limits; when you are close to one, Codex says as much and points you there.
The status line. Codex can show remaining usage on the primary and secondary limits permanently at the bottom of the session, if you add those items to it.
A monitor on screen. Keeps the windows and the reset countdown visible outside any one session, and across the other agents at the same time.

The context percentage is not your usage limit

Codex also shows how much of the context window a conversation has used. That is how full this conversation is, and compacting or starting a new thread resets it. Your usage limit is unaffected by either.

Two numbers that both count up to 100% are easy to confuse. The one that stops you working is the usage limit.

What Agent HUD shows

Each window Codex returns, labelled by its own duration, with the percentage used and the reset time, plus the number of resets the service says are available.

Codex Desktop and the Codex CLI sign in to the same account, so they share one set of windows rather than appearing twice. Usage from one is never copied into the other.

It reads the rollout logs and the engine's existing sign-in. The stored credentials file is never read.

When a window runs out

Wait for the reset, or spend one of the available resets if your plan has them.
Lower the reasoning effort. Codex warns that a higher effort consumes usage limits faster.
Move the work to another agent. Their allowances are separate.

Common questions

Do Codex Desktop and the Codex CLI have separate limits?: No. On one Codex home they sign in to the same account and share one set of windows. Separate homes stay separate.
What are reset credits?: The number of resets the service reports as still available. Agent HUD shows that number as given rather than working it out from the expiry list beside it.
My context is nearly full but my usage limit is not. Which one matters?: They are different. Context is how full this conversation is and compacting clears it; the usage limit is your plan's allowance and only a reset clears that.
Can I see this away from the Mac?: With Agent HUD Remote, which syncs one Mac's usage to the free iPhone, widget and Apple Watch apps.

Guides

Last updated: 2026-09-20 · The behaviour described here is documented in full, with the code it comes from, in Agent HUD Open. github.com/jazzenchen/agent-hud-open