Cmd. /usage
View Codex account token usage and apply available rate-limit resets.
Key takeaways
/usageopens account token activity and available rate-limit reset actions from inside the TUI.- Use
daily,weekly, orcumulativeto jump directly to a specific token-activity view. - If the session lacks Codex service account authentication, Codex shows a sign-in requirement.
- Pair
/usagewith rollout token budgets before long autonomous or multi-agent runs.
Original Command Declaration
/usageOfficial Summary
/usage is an official slash command for viewing account token usage or applying an available
rate-limit reset.
Usage
/usageDirect views:
/usage daily
/usage weekly
/usage cumulativeGood Examples
- Run
/usage weeklybefore a long/goaltask. - Check
/usage dailybefore experimental multi-agent delegation. - Decide whether to redeem an earned reset only after prioritizing the work that needs it.
Similar Commands
| Command | Difference | Choose It When |
|---|---|---|
/usage | Shows account token activity and reset actions | You need account-level usage information |
/status | Shows current session model, policy, and context | You need session state |
/model | Changes model and reasoning | You need to adjust cost or latency after checking usage |
Use Cases
- Budget checks before long autonomous tasks.
- Comparing rollout token budgets with real account activity.
- Coordinating earned reset use with team priorities.
v0.142.0 Changes
/usageexposes token activity and rate-limit reset actions.daily,weekly, andcumulativeviews are supported.- Together with rollout token budgets, it becomes the primary TUI entry point for usage checks.
Cautions
/usageis account-level; use/statusfor current-thread context and policy.- Do not redeem earned resets automatically; tie them to explicit task priority.
- Sessions without Codex service account auth show a sign-in requirement first.
Release Basis
- Judgment: confirmed addition
- First evidence version:
Codex CLI 0.142.0 - Date (UTC): 2026-06-22
- Release link: https://developers.openai.com/codex/changelog
Sources
- Codex slash commands: https://developers.openai.com/codex/cli/slash-commands
- Codex changelog: https://developers.openai.com/codex/changelog