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_
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗