codex - 💡(How to fix) Fix Codex Desktop shows “You're out of Codex messages” despite 99% usage remaining

What version of the Codex App are you using (From “About Codex” dialog)?

26.519.41501

What subscription do you have?

Business / self_serve_business_usage_based

What platform is your computer?

macOS 26.5.0 arm64

What issue are you seeing?

Codex Desktop shows a persistent banner:

You're out of Codex messages You've reached your Codex usage limit.

However, the Codex Analytics page at chatgpt.com/codex/cloud/settings/analytics shows available usage:

• 5 hour usage limit: 99% remaining
• Weekly usage limit: 99% remaining
• Credits remaining: 0

This appears in front of Codex sessions and is misleading because the user is not usage-limited according to the web usage page.

Local debugging evidence

The local app-server method account/rateLimits/read returns an empty rate-limit snapshot:

{
  "rateLimits": {
    "limitId": "codex",
    "limitName": null,
    "primary": null,
    "secondary": null,
    "credits": null,
    "planType": "self_serve_business_usage_based",
    "rateLimitReachedType": null
  },
  "rateLimitsByLimitId": {
    "codex": {
      "limitId": "codex",
      "limitName": null,
      "primary": null,
      "secondary": null,
      "credits": null,
      "planType": "self_serve_business_usage_based",
      "rateLimitReachedType": null
    }
  }
}

The desktop logs show the UI recording:

eventType=codex_usage_limit_banner_shown
bannerType=legacy_rate_limit_reached
limitReason=usage_limit

The same empty snapshot was reproduced via:

• Bundled Codex CLI: 0.133.0-alpha.1
• Homebrew Codex CLI: 0.130.0

codex doctor showed ChatGPT auth configured and WebSocket reachability working.

What steps can reproduce the bug?

Feedback ID: 019e5f34-6937-7ce1-9731-7067fa3b1211

Observed flow:

1. Open Codex Desktop with a Business / self_serve_business_usage_based account.
2. Observe the “You're out of Codex messages” banner.
3. Open Codex Analytics in the browser.
4. Observe both shared agentic usage limits show 99% remaining.
5. Call local app-server account/rateLimits/read and observe primary, secondary, credits, and rateLimitReachedType are all null.

What is the expected behavior?

If the web usage page shows 99% remaining and rateLimitReachedType is null, Codex Desktop should not show an out-of-messages / usage-limit banner.

Additional information

Likely issue: for self_serve_business_usage_based accounts, the local app-server is not hydrating the real shared agentic usage buckets into account/rateLimits/read. The desktop UI then falls back to the legacy rate-limit banner classification.

Related open issues that may be the same class of bug:

• #23258
• #23827
• #22450