Cmd. /status
Inspect session configuration, token usage, model, and policy.
Key takeaways
/statusdisplays session configuration and token usage: active model, approval policy, writable roots, and remaining context capacity.- Run it at the start of a task and again after
/permissions,/model,/resume, or/goal. - In 0.135.0 remote TUI sessions show connection details and server version; 0.138.0 lets app-server integrations read account token usage.
/statusonly reports state; it does not change policy or fix configuration, so re-check before editing in remote or resumed sessions.
Original Command Declaration
/statusOfficial Summary
/status displays session configuration and token usage, including the active model, approval
policy, writable roots, and remaining context capacity.
Usage
/statusGood Examples
- Run
/statusat the start of a task to verify model, directory, and permissions. - Run
/statusafter/permissions,/model,/resume, or/goal.
Similar Commands
| Command | Difference | Choose It When |
|---|---|---|
/status | Inspects runtime state | You need to know how Codex is configured |
/model | Changes model | You need to switch after checking state |
/debug-config | Explains config layers | You need deeper config diagnostics |
Use Cases
- Starting a session safely.
- Checking quota or token context.
- Confirming writable roots and approval policy.
Recent Changes
- Rate-limit information refreshes more actively, reducing stale quota display.
- In 0.135.0, remote TUI sessions show remote connection details and the server version.
- In 0.137.0, enterprise/admin flows can show monthly credit limits, and status/title surfaces can use a compact reasoning-only item.
- In 0.138.0, app-server integrations can read account token usage, so remote/app-based usage checks should be part of the same operating routine.
- ChatGPT v2 personal access token support affects CLI and app-server auth runbooks.
- Forked thread title preservation, faster
resume --last, and safer goal auto-continuation make resumed-session state checks more predictable.
Cautions
/statustells you state; it does not change policy or fix configuration by itself.- In remote or resumed sessions, re-check state before editing.
Release Basis
- Judgment: first observed mention
- First evidence version:
rust-v0.23.0 - Date (UTC): 2025-08-20
- Release link: https://github.com/openai/codex/releases/tag/rust-v0.23.0
Sources
- Codex slash commands: https://developers.openai.com/codex/cli/slash-commands
- Codex CLI features: https://developers.openai.com/codex/cli/features