Usage Limit Status both in CLI and SDKs

Open 💬 3 comments Opened Apr 30, 2026 by alwint3r

What variant of Codex are you using?

CLI

What feature would you like to see?

I would like to see the usage/status information via the CLI. Something akin to /status in the TUI.

Proposed Behavior
codex status

prints the following information in the terminal

Account status

  5h limit: 100% left (resets 14:39)
  Weekly limit: 91% left (resets 15:28 on 5 May)

Visit https://chatgpt.com/codex/settings/usage for up-to-date rate limits and credits.
codex status --json

prints the JSON so that it can be used in the SDK as well

{"rateLimits":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1777534802},"secondary":{"usedPercent":9,"windowDurationMins":10080,"resetsAt":1777969707},"credits":{"hasCredits":false,"unlimited":false,"balance":"0"},"planType":"plus","rateLimitReachedType":null},"rateLimitsByLimitId":{"codex":{"limitId":"codex","limitName":null,"primary":{"usedPercent":0,"windowDurationMins":300,"resetsAt":1777534802},"secondary":{"usedPercent":9,"windowDurationMins":10080,"resetsAt":1777969707},"credits":{"hasCredits":false,"unlimited":false,"balance":"0"},"planType":"plus","rateLimitReachedType":null}}}

Additional information

_No response_

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗