Skip to main content
reopt Handbook
reopt Handbook
Codex Command MasterLabels and command selectionHow to read a detail guideComplete command listTerminal CLI Commands and Options

Task guides

Core Command GroupSession Command GroupCustom Command GuideMCP Command and Integration GuideDesign Workflows

Conversation and context

Cmd. /archiveCmd. /copyCmd. /importCmd. /cd

Planning and execution

Cmd. /goalCmd. /app

Models and settings

Cmd. /model

Permissions and integrations

Cmd. /pluginsCmd. /hooksCmd. /mcp

Display and input

Cmd. /statuslineCmd. /tuiCmd. /worktreeCmd. /voice

Account and usage

Cmd. /usage

Verification and history

Current verification scopeHandbook updatesRelease coverage historyEarlier verification recordsCommand change history
Handbook›Codex Command Master›Cmd. /usage
한국어KOEnglishEN

Cmd. /usage

Open the account usage analytics dashboard or apply an available rate-limit reset.

Written and reviewed by Eric Han · Co-founder & CTO, reopt

Key takeaways

  • Open the account usage analytics dashboard or apply an available rate-limit reset.
  • Open period views directly with /usage daily, weekly, or cumulative; check the current conversation's context in /status instead.

Purpose

Open the account usage analytics dashboard or apply an available rate-limit reset.

/usage

Availability

FieldValue
Input surfaceRunning CLI prompt
KindBuilt-in
StatusCurrent reference
Aliases—
Documented minimumNot specified
Reviewed against2026-10-23 · Codex CLI 0.163.0

The installed command menu and account or organization settings determine availability.

Examples

/usage
/usage weekly

From 0.156.0, /usage opens an account usage analytics dashboard with token totals, plugin and skill activity, and top chats; plan usage history appears where the plan allows it.

Direct views:

/usage daily
/usage weekly
/usage cumulative

When to use it

  1. Run /usage weekly before a long /goal task.
  2. Check /usage daily before experimental multi-agent delegation.
  3. Decide whether to redeem an earned reset only after prioritizing the work that needs it.

Choosing related commands

CommandDifferenceChoose It When
/usageShows account token activity and reset actionsYou need account-level usage information
/statusShows current session model, policy, and contextYou need session state
/modelChanges model and reasoningYou need to adjust cost or latency after checking usage

Effects and persistence

Displays usage, cost, or activity information; viewing it does not authorize a purchase or additional usage.

/usage is an official slash command for viewing account token usage or applying an available rate-limit reset.

Changes

  • /usage exposes token activity and rate-limit reset actions.
  • daily, weekly, and cumulative views are supported.
  • Together with rollout token budgets, it becomes the primary TUI entry point for usage checks.

Cautions

  • /usage is account-level; use /status for 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.

Official sources

  • Developer Commands
  • Changelog
  • Rust V0.156.0

Complete command list · Verification scope · History for this command

Related docs

Cmd. /usage

Claude Code Command Master · Show session cost, plan limits, and activity.

Cmd. /cost

Claude Code Command Master · Open the /usage cost and limit view through its /cost alias; understand which usage measure applies.

Cmd. /team-onboarding

Claude Code Command Master · Generate a team guide from 30 days of usage.

Cmd. /stats

Claude Code Command Master · Open the Stats tab of /usage through its /stats alias to inspect activity alongside other usage views.

Cmd. /context

Claude Code Command Master · Visualize context usage and heavy contributors.

Cmd. /voice

Voice conversations, enabled by default from 0.156.0, with the F8 toggle and /voice settings

Current verification scope

Codex CLI: Current coverage, checks, and limits of the official-source comparison and automated validation.

On this page

PurposeAvailabilityExamplesWhen to use itChoosing related commandsEffects and persistenceChangesCautionsOfficial sources