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. /clearCmd. /renameCmd. /archiveCmd. /deleteCmd. /compactCmd. /copyCmd. /memoriesCmd. /importCmd. /initCmd. /mentionCmd. /forkCmd. /sideCmd. /resumeCmd. /newCmd. /cdCmd. /exportCmd. /recap

Planning and execution

Cmd. /planCmd. /goalCmd. /psCmd. /stopCmd. /app

Review and verification

Cmd. /review

Models and settings

Cmd. /modelCmd. /fast

Permissions and integrations

Cmd. /permissionsCmd. /ideCmd. /setup-default-sandboxCmd. /sandbox-add-read-dirCmd. /pluginsCmd. /hooksCmd. /approveCmd. /skillsCmd. /mcp

Status and diagnostics

Cmd. /agentCmd. /appsCmd. /diffCmd. /feedbackCmd. /personalityCmd. /rawCmd. /statusCmd. /debug-configCmd. /title

Display and input

Cmd. /keymapCmd. /vimCmd. /experimentalCmd. /statuslineCmd. /themeCmd. /petsCmd. /voiceCmd. /worktree

Account and usage

Cmd. /exitCmd. /logoutCmd. /quitCmd. /usage

Legacy

Cmd. /approvals

Verification and history

Current verification scopeHandbook updatesRelease coverage historyEarlier verification recordsCommand change history
Handbook›Codex Command Master›Command change history
한국어English

Command change history

Codex CLI: Earlier command-version evidence and behavior changes, with links back to current detail guides.

Key takeaways

  • This page preserves earlier review records. Use the detail guides and complete list for current behavior. Earlier minimum-version notes do not establish a newly verified introduction version.

/permissions

Current guide

Recent Changes

  • The older "reject" policy language was replaced by "granular" in newer configuration flows.
  • /approvals still works as an alias, but the official slash popup uses /permissions.
  • Permission state is now more consistent across TUI turns, MCP sandbox metadata, shell escalation, and app-server APIs.
  • In 0.133.0, permission profiles gained list APIs, inheritance, managed requirements.toml support, and runtime refresh behavior.
  • In 0.134.0, --profile moved to separate ~/.codex/<profile>.config.toml profile files instead of legacy [profiles.<name>] tables.
  • In 0.135.0, the /permissions picker shows named permission profiles and configured custom profiles.
  • In 0.138.0~0.139.0, codex sandbox --permissions-profile gained the shorter -P alias, /debug-config can show effective sandbox modes, and configured network proxy enforcement also applies to the sandbox path.
  • In 0.151.0, restored profiles persist across turns, Guardian must reclassify after permission state changes, and remote path policy follows the executor rather than local path assumptions.

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.89.0
  • Date (UTC): 2026-01-22
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.89.0

Earlier change notes

  • Since 0.133.0, permission profiles gained list APIs, inheritance, and managed requirements.toml support; 0.134.0 moved --profile to separate ~/.codex/<profile>.config.toml files.
  • In 0.133.0, permission profiles gained list APIs, inheritance, managed requirements.toml support, and runtime refresh behavior.
  • In 0.134.0, --profile moved to separate ~/.codex/<profile>.config.toml profile files instead of legacy [profiles.<name>] tables.
  • In 0.138.0~0.139.0, codex sandbox --permissions-profile gained the shorter -P alias, /debug-config can show effective sandbox modes, and configured network proxy enforcement also applies to the sandbox path.

/ide

Current guide

Release Basis

  • Judgment: official docs listing
  • First evidence version: official slash commands documentation
  • Date (UTC): verified 2026-05-21
  • Release link: https://learn.chatgpt.com/docs/developer-commands?surface=cli

/keymap

Current guide

Recent Changes

  • Configurable TUI keymaps were added around the 0.128.0 line.
  • The 0.129.0 changelog mentions modal Vim composer contexts and /keymap debug.
  • /keymap is listed in the official slash command table.

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.128.0
  • Date (UTC): 2026-04-30
  • Release link: https://learn.chatgpt.com/docs/changelog

/vim

Current guide

Release Basis

  • Judgment: official docs listing
  • First evidence version: rust-v0.129.0 changelog plus official slash commands documentation
  • Date (UTC): verified 2026-05-21
  • Release link: https://learn.chatgpt.com/docs/changelog

/setup-default-sandbox

Current guide

Release Basis

  • Judgment: rename confirmed plus official listing
  • First evidence under the current name: rust-v0.105.0
  • Date (UTC): 2026-02-25
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.105.0
  • Note: elevated sandbox onboarding first appeared in 0.80.0 as /setup-elevated-sandbox.

/sandbox-add-read-dir

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.102.0
  • Date (UTC): 2026-02-17
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.102.0
  • Supporting PR: https://github.com/openai/codex/pull/11512

/agent

Current guide

Recent Changes

  • Agent role file metadata can be loaded for clearer agent identities.
  • TUI displays for spawned agents include model and reasoning effort.
  • Remote multi-agent sessions now show agent names and paths more clearly than raw IDs.
  • /subagents is an official alias for the same thread picker.

Release Basis

  • Judgment: first observed mention
  • First evidence version: rust-v0.95.0
  • Date (UTC): 2026-02-04
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.95.0

/apps

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.93.0
  • Date (UTC): 2026-01-31
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.93.0

/plugins

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.117.0
  • Date (UTC): 2026-03-26
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.117.0

Earlier change notes

  • Since 0.117.0 plugins became first-class with startup sync; later versions added marketplace sources (GitHub, git URLs, local dirs), workspace sharing, and source filtering.
  • 0.124.0 added remote plugin marketplace list/read support, making source inspection clearer.
  • 0.131.0 added plugin marketplace CLI commands, version-aware sharing, share checkout, and clearer shared-workspace buckets.
  • 0.137.0 added codex plugin list --json and cached remote catalog suggestions, making plugin inventory easier to audit automatically.
  • 0.138.0 added --json output for plugin add/remove and marketplace commands, and plugin detail data can expose default prompts, remote MCP servers, and unavailable app templates.

/hooks

Current guide

2026-05-14 Update

  • The Codex changelog announced Hooks general availability.
  • The official slash command table now includes /hooks.
  • features.hooks is the canonical feature key; codex_hooks remains a deprecated alias.
  • Plugin-bundled hooks are opt-in in this release.

Release Basis

  • Judgment: official command plus GA
  • First evidence version: rust-v0.129.0
  • Date (UTC): 2026-05-07; GA announcement 2026-05-14
  • Release link: https://learn.chatgpt.com/docs/changelog

/clear

Current guide

Release Basis

  • Judgment: current official slash command
  • Confirmed as an independent /clear entry in Developer Commands on 2026-08-30.
  • The optional name remains on /new [name], not /clear.

/rename

Current guide

Release Basis

  • Judgment: first source evidence plus official listing
  • First evidence version: rust-v0.93.0
  • Date (UTC): 2026-01-31
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.93.0

/archive

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.136.0
  • Date (UTC): 2026-06-01
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.136.0

/delete

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: Codex CLI 0.140.0
  • Date (UTC): 2026-06-16
  • Release link: https://learn.chatgpt.com/docs/changelog

/compact

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.11.0
  • Date (UTC): 2025-08-02
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.11.0

/copy

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.105.0
  • Date (UTC): 2026-02-25
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.105.0

/diff

Current guide

Recent Changes

  • The TUI diff flow is now more workspace-aware in multi-workspace sessions.

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

/exit

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.53.0
  • Date (UTC): 2025-10-31
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.53.0

/experimental

Current guide

Recent Changes

  • Code Mode and hook-related experimental surfaces appeared in earlier release notes.
  • Check current feature maturity in Configuration Reference; the presence of a features.* key alone does not mean a feature is experimental.

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.74.0
  • Date (UTC): 2025-12-18
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.74.0

/approve

Current guide

Release Basis

  • Judgment: official docs listing
  • First evidence version: official slash commands documentation
  • Date (UTC): verified 2026-05-21
  • Release link: https://learn.chatgpt.com/docs/developer-commands?surface=cli

/memories

Current guide

Release Basis

  • Judgment: official docs listing
  • First evidence version: official slash commands documentation
  • Date (UTC): verified 2026-05-21
  • Release link: https://learn.chatgpt.com/docs/developer-commands?surface=cli

/skills

Current guide

Release Basis

  • Judgment: official docs listing
  • First evidence version: official slash commands documentation
  • Date (UTC): verified 2026-05-21
  • Release link: https://learn.chatgpt.com/docs/developer-commands?surface=cli

/import

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: Codex CLI 0.140.0
  • Date (UTC): 2026-06-16
  • Release link: https://learn.chatgpt.com/docs/changelog

/feedback

Current guide

Release Basis

  • Judgment: first observed mention
  • First evidence version: rust-v0.50.0
  • Date (UTC): 2025-10-25
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.50.0

/init

Current guide

Release Basis

  • Judgment: first observed mention
  • First evidence version: rust-v0.28.0
  • Date (UTC): 2025-09-02
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.28.0

/logout

Current guide

Release Basis

  • Judgment: first observed mention
  • First evidence version: rust-v0.54.0
  • Date (UTC): 2025-11-04
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.54.0

/mcp

Current guide

Recent Changes

  • /mcp verbose provides deeper server diagnostics.
  • Built-in MCPs and plugin-provided capabilities are increasingly first-class in runtime flows.
  • 0.146.0 adds live MCP/App-tool refresh and broader proxy handling across auth redirects, MCP, and remote WebSockets.
  • 0.150.0 strengthens bearer-token and startup handling; the supported host direction is codex app-server rather than deprecated codex mcp-server.
  • codex app-server is still marked experimental in the 0.150.1 CLI help. Pin the CLI, choose and test a transport (stdio, Unix socket, or WebSocket), and verify auth, shutdown, and reconnect behavior before migrating production callers.
  • In 0.151.0, configure optional-server discovery separately from required startup, define an audit boundary for extension-transformed tool results, and consume structured app-server MCP errors instead of parsing error strings.

Release Basis

  • Judgment: confirmed addition
  • 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

/mention

Current guide

Release Basis

  • Judgment: first observed mention
  • First evidence version: rust-v0.105.0
  • Date (UTC): 2026-02-25
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.105.0

/model

Current guide

Release Basis

  • Judgment: confirmed addition
  • 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

/fast

Current guide

Recent Changes

  • The persisted /fast toggle made Fast/Standard switching easier to manage during a session.
  • Fast mode can be shown in the TUI footer through /statusline.

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.110.0
  • Date (UTC): 2026-03-05
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.110.0

/plan

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.93.0
  • Date (UTC): 2026-01-31
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.93.0

/goal

Current guide

Recent Changes

  • Goals are available starting in Codex 0.128.0.
  • Newer releases made goals more discoverable and clearer around pause/resume behavior.
  • In 0.142.0-era workflows, specify UTC timing and current-time assumptions for scheduled reminders, and document parent/child handoff rules when multi-agent delegation modes are used.
  • Before a long goal run, check /usage weekly and rollout token budgets. Reserve earned resets for explicit retry or priority work.

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.128.0
  • Date (UTC): 2026-04-30
  • Release link: https://learn.chatgpt.com/docs/changelog

/personality

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.92.0
  • Date (UTC): 2026-01-27
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.92.0

/ps

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.76.0
  • Date (UTC): 2025-12-19
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.76.0

/stop

Current guide

Release Basis

  • Judgment: official slash command table
  • First evidence version: official slash command reference
  • Date (UTC): verified 2026-05-17
  • Release link: https://learn.chatgpt.com/docs/developer-commands?surface=cli

/fork

Current guide

Recent Changes

  • Remote resume/fork history restoration has been improved.
  • App-server thread handling and pagination make large thread lists easier to work with.
  • 0.146.0 supports paginated-history forks and keeps ephemeral forks out of normal listings, while replay preservation covers messages, final responses, errors, timestamps, and approval settings.

Release Basis

  • Judgment: first observed mention
  • First evidence version: rust-v0.88.0
  • Date (UTC): 2026-01-21
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.88.0

/app

Current guide

Release Basis

  • Judgment: confirmed addition plus official listing
  • First evidence version: Codex CLI 0.138.0
  • Date (UTC): 2026-06-08
  • Release link: https://learn.chatgpt.com/docs/changelog

/side

Current guide

Recent Changes

  • /side first appeared in changelog context for quick side questions.
  • It is now included in the official slash command table and treated as a standard command.
  • 0.146.0 adds switching among open side conversations.
  • /btw is an official alias for the same ephemeral side-chat flow.

Release Basis

  • Judgment: first observed mention plus official table
  • First evidence version: rust-v0.122.0
  • Date (UTC): 2026-04-20
  • Release link: https://learn.chatgpt.com/docs/changelog

/raw

Current guide

Release Basis

  • Judgment: official docs listing
  • First evidence version: official slash commands documentation
  • Date (UTC): verified 2026-05-21
  • Release link: https://learn.chatgpt.com/docs/developer-commands?surface=cli

/resume

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.65.0
  • Date (UTC): 2025-12-04
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.65.0

Earlier change notes

  • v0.123.0–v0.125.0 added cursor-based pagination so 1,000+ task histories load without freezing.

/new

Current guide

Release Basis

  • 0.146.0 added the optional name argument.

  • Judgment: first observed mention

  • First evidence version: rust-v0.59.0

  • Date (UTC): 2025-11-19

  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.59.0

Earlier change notes

  • 0.146.0 added the optional name argument.

/quit

Current guide

Release Basis

  • Judgment: first observed mention
  • First evidence version: rust-v0.53.0
  • Date (UTC): 2025-10-31
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.53.0

/review

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.39.0
  • Date (UTC): 2025-09-18
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.39.0

/status

Current guide

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.
  • In 0.142.0-era runbooks, use /usage for account-level token activity and /status for current-thread model, policy, and context state.
  • After app-server, exec, or MCP disconnect recovery, run /status before resuming edits.

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

/usage

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: Codex CLI 0.142.0
  • Date (UTC): 2026-06-22
  • Release link: https://learn.chatgpt.com/docs/changelog

/debug-config

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.97.0
  • Date (UTC): 2026-02-05
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.97.0

/statusline

Current guide

Recent Changes

  • Custom status lines can include renamed thread titles.
  • Newer releases added theme-aware colors and optional PR or branch-change summaries.
  • Active-turn status-line edits are supported in recent CLI versions.

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.99.0
  • Date (UTC): 2026-02-11
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.99.0

/title

Current guide

Recent Changes

  • Terminal-title picker support works across classic and app-server TUI flows.
  • Newer releases improved action-required title state and branch/task progress visibility.

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.117.0
  • Date (UTC): 2026-03-26
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.117.0

/theme

Current guide

Release Basis

  • Judgment: official docs listing
  • First evidence version: official slash commands documentation
  • Date (UTC): verified 2026-05-21
  • Release link: https://learn.chatgpt.com/docs/developer-commands?surface=cli

/pets

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.131.0
  • Date (UTC): 2026-05-18
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.131.0

/approvals

Current guide

Release Basis

  • Judgment: confirmed addition
  • 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

/cd

Current guide

Release Basis

  • Judgment: confirmed official changelog addition
  • First evidence version: rust-v0.149.0
  • Date (UTC): 2026-08-20
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.149.0

/export

Current guide

Release Basis

  • Judgment: confirmed addition
  • First evidence version: rust-v0.148.0
  • Date (UTC): 2026-08-18
  • Release link: https://github.com/openai/codex/releases/tag/rust-v0.148.0

/recap

Current guide

Release Basis

  • 0.153.0 — Basis for automatic recap configuration and retained manual invocation; not a first-introduction claim
  • Release-tracked: not yet in the official CLI slash table. Check the installed / menu and feature settings.

/voice

Current guide

Release Basis

  • 0.155.0 — 2026-09-17
  • Release-tracked: not yet in the official CLI slash table. Check the installed / menu and feature settings.

/worktree

Current guide

Release Basis

  • 0.154.0 — 2026-09-09
  • Release-tracked: not yet in the official CLI slash table. Check the installed / menu and feature settings.

Related docs

Updates

Harness Engineering · Change log for the Harness Engineering handbook

Earlier verification records

Codex CLI: Earlier review dates, version baselines, and findings, with a link to the current verification scope.

Updates

LLMOps and AgentOps in Production · Changelog for LLMOps and AgentOps in Production

Complete command list

Syntax, type, availability, and guide links for all 50 entries in the official Codex CLI slash table.

Verification Report

Claude Code Complete Guide · Verification checklist for the English Claude Code handbook locale.

Earlier verification records

Codex CLI: Earlier review dates, version baselines, and findings, with a link to the current verification scope.

On this page

/permissionsRecent ChangesRelease BasisEarlier change notes/ideRelease Basis/keymapRecent ChangesRelease Basis/vimRelease Basis/setup-default-sandboxRelease Basis/sandbox-add-read-dirRelease Basis/agentRecent ChangesRelease Basis/appsRelease Basis/pluginsRelease BasisEarlier change notes/hooks2026-05-14 UpdateRelease Basis/clearRelease Basis/renameRelease Basis/archiveRelease Basis/deleteRelease Basis/compactRelease Basis/copyRelease Basis/diffRecent ChangesRelease Basis/exitRelease Basis/experimentalRecent ChangesRelease Basis/approveRelease Basis/memoriesRelease Basis/skillsRelease Basis/importRelease Basis/feedbackRelease Basis/initRelease Basis/logoutRelease Basis/mcpRecent ChangesRelease Basis/mentionRelease Basis/modelRelease Basis/fastRecent ChangesRelease Basis/planRelease Basis/goalRecent ChangesRelease Basis/personalityRelease Basis/psRelease Basis/stopRelease Basis/forkRecent ChangesRelease Basis/appRelease Basis/sideRecent ChangesRelease Basis/rawRelease Basis/resumeRelease BasisEarlier change notes/newRelease BasisEarlier change notes/quitRelease Basis/reviewRelease Basis/statusRecent ChangesRelease Basis/usageRelease Basis/debug-configRelease Basis/statuslineRecent ChangesRelease Basis/titleRecent ChangesRelease Basis/themeRelease Basis/petsRelease Basis/approvalsRelease Basis/cdRelease Basis/exportRelease Basis/recapRelease Basis/voiceRelease Basis/worktreeRelease Basis