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›Earlier verification records
한국어English

Earlier verification records

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

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.

Return to the current guide

September 22, 2026 second audit

The audit covers 239 pages across both books and languages: full command declarations, official URL destinations and anchors, internal links, and MDX compilation. Redirected documentation links now use the current destinations.

Replaced unsupported /help guidance with the / menu. /goal is stable and enabled by default; /sandbox-add-read-dir is native-Windows-only; /memories changes affect future sessions. Fast service tier is no longer described as a reduction in reasoning depth.

Checked 131 real external URLs (124 without fragments), with no 404s among source links. The OpenAI announcement was readable through a separate web fetch. The npm website and Claude routines console returned 403 here and remain unverified, rather than being counted as valid or broken. Reference checks do not establish account-specific runtime availability.

Running verification

Local checks validate complete declarations, CLI tables, locale coverage, and navigation against the reviewed snapshot. Live comparison fails when official names, arguments, types, descriptions, or latest releases change; source failures also fail. Behavior and availability still require editorial review.

pnpm --filter handbook check:codex-command-master
pnpm --filter handbook test:command-sources
pnpm --filter handbook check:command-sources

Official command audit — September 22, 2026

Reconciled 50 CLI slash-table entries, 27 terminal command-table entries, and the global and command-specific option tables in Developer Commands. The release baseline is 0.155.1 (September 18, 2026). Older npm channel values below are historical observations.

  • 0.155.0 /voice: experimental voice conversations on supported builds, enabled through /experimental, with live transcripts and microphone controls. It remains release-tracked because the slash reference table has not added it yet.
  • Daemon: added codex app-server daemon update and configurable update schedules, with recovery of saved threads and active goals after daemon restarts.
  • Sessions and MCP: agents-view hide/archive/delete, managed-worktree ownership and deletion confirmation, and MCP Touch ID verification on supported Macs.
  • 0.155.1: reasoning summaries default to disabled for new local TUI sessions. Explicit settings remain respected; distinguish the 0.155.0 live-summary UI from this default.

All slash commands · Terminal CLI reference · Voice conversations

Sources: Developer Commands, official changelog.

The sections below retain earlier update records.

Release-tracked command checks

CommandBasis
/voice0.155.0, /experimental
/worktree0.154.0
/recap0.153.0, tui.auto_recap

September 12, 2026 release refresh

Updated for Codex CLI 0.154.0 (September 9). npm latest=0.154.0 and alpha=0.155.0-alpha.3.10 were checked on September 12, 2026 KST.

  • Sessions: experimental --worktree and /worktree create isolated checkouts for new or forked sessions, with browse/resume support. Inline questions accept choices or free text while work continues.
  • Extensions and approvals: existing sessions refresh installed plugin tools, skills, and hooks. Failed MCP OAuth refreshes surface sign-in without replaying rejected calls. Resume/fork preserve permissions, and new user instructions invalidate stale automatic approvals.
  • Compatibility: codex mcp-server and the standalone codex-mcp-server were removed. External MCP connections through codex mcp remain supported. Evaluate migration to experimental codex app-server; the official documentation does not support production workloads on that command.
  • Editing: /copy preserves formatting and supports status output; Vim gains R replace mode. Windows gains a shared background server and daemon management.

Sources: official changelog, npm dist-tags.

This refresh compares official release text with npm channels. It does not claim local CLI execution or live feature testing. Tables below retain prior dated checks; the channel values above supersede them.

Verification Criteria

  1. Each advanced command page includes the original command declaration.
  2. Each command has practical examples and a similar-command comparison.
  3. Official source links are listed.
  4. Version-sensitive commands are tied to the changelog or release notes.
  5. English routing is registered under the English locale.
  6. Korean and English command file inventories stay in parity.

Source Baseline (2026-09-05 KST)

  • Command reference: https://learn.chatgpt.com/docs/codex/cli (308 redirect from developers.openai.com/codex/cli/slash-commands)
  • Models reference: https://learn.chatgpt.com/docs/models
  • GPT-6 Astra API specification: https://developers.openai.com/api/docs/models/gpt-6-astra
  • GPT-6 Astra announcement: https://openai.com/index/gpt-6-astra/
  • Previous command reference path: https://learn.chatgpt.com/docs/developer-commands?surface=cli
  • Figma implementation use case: https://learn.chatgpt.com/use-cases/figma-designs-to-code
  • UI mock use case: https://learn.chatgpt.com/use-cases/user-stories-to-ui-mocks
  • MCP customization: https://learn.chatgpt.com/docs/customization/overview#mcp
  • Hooks reference: https://learn.chatgpt.com/docs/hooks
  • Changelog: https://learn.chatgpt.com/docs/changelog
  • Models reference: https://learn.chatgpt.com/docs/models
  • Supplemental releases: https://github.com/openai/codex/releases
  • Official stable/latest CLI baseline: codex-cli 0.153.4
  • Latest user-facing command feature baseline: codex-cli 0.153.4
  • npm dist-tags checked: latest=0.153.4, alpha=0.154.0-alpha.3; local CLI also 0.153.4

Documentation URLs moved

The official Codex docs moved from developers.openai.com/codex/* to learn.chatgpt.com/docs/*. Old links still resolve through 308 permanent redirects, but the path structure did not change uniformly, so a blanket replacement would break URLs. This round used the new domain only in newly written passages; remaining old links move path by path in the next round.

Command Coverage

CommandStatusSource Note
/permissionsCoveredStandard permissions command; /approvals remains an alias.
/approveCoveredRetries one recent auto-review denial.
/setup-default-sandboxCoveredWindows-only elevated sandbox setup in degraded restricted-token mode.
/sandbox-add-read-dirCoveredWindows-only sandbox read access helper.
/agentCoveredSwitches active agent threads; /subagents is an alias.
/appCoveredOfficially documented handoff of the current CLI thread into Codex Desktop, release-tracked from 0.138.0.
/appsCoveredBrowses app/connectors and inserts app mentions.
/archiveCoveredOfficial slash command for archiving the current session and exiting Codex.
/cd·/pwd·/cwdRelease-tracked0.149.0 confirms the working-directory group; current Developer Commands reference entries are pending, so exact syntax/output stays build-verified.
/deleteCoveredOfficial slash command for permanently deleting the current session transcript and spawned descendants.
/ideCoveredIncludes IDE open-file and selection context.
/pluginsCoveredBrowses installed and discoverable plugins.
/hooksCoveredOfficial slash command plus 2026-05-14 Hooks GA.
/importCoveredImports supported Cursor and Claude Code settings, MCP, plugins, sessions, commands, and project memories.
/experimentalCoveredToggles optional Codex feature gates.
/memoriesCoveredConfigures memory use and generation.
/clearCovered in a dedicated page and core groupClears the terminal and starts a new chat; unlike /new [name], it has no name argument.
/copyCoveredOpens a picker for the whole response, code blocks, or blockquotes; Ctrl+O remains a shortcut.
/exportCoveredExports the complete TUI conversation as Markdown to the clipboard or a new file.
/compact, /diff, /reviewCoveredReview and context-maintenance commands.
/model, /fast, /plan, /goal, /personalityCoveredExecution, model, speed, style, and long-running goal controls.
/ps, /stopCoveredBackground terminal inspection and cleanup.
/rawCoveredToggles raw scrollback mode.
/fork, /side, /resume, /new, /rename, /quit, /exitCoveredThread, naming, session continuity, and exit commands; /btw aliases /side.
/status, /statusline, /title, /keymap, /debug-configCoveredSession visibility, diagnostics, and TUI customization.
/usageCoveredShows account token activity and available rate-limit reset actions.
/skills, /theme, /pets, /vimCoveredSkill selection, syntax theme, terminal pet, and Vim composer mode; /pet aliases /pets.
/mcp, /mention, /init, /logout, /feedbackCoveredIntegration, context, setup, auth, and support commands.

Automated Validation

The project script apps/handbook/scripts/check-codex-command-master.mjs now checks both locales:

  • every non-section meta.json page has a matching MDX file;
  • every commands/*.mdx file appears in the shared command syntax map;
  • Korean and English command directories contain the same command files;
  • Korean and English meta.json command order stays aligned;
  • command declaration and usage code blocks match the expected syntax for each locale;
  • each locale's verification.mdx references every command page;
  • the Korean verification page still carries the deeper release-link table.
  • the 2026-06-25 source refresh covers Codex CLI 0.140.0~0.142.0, /delete, /import, /usage, indexed web search, plugin organization, rollout token budgets, scheduled UTC reminders/current-time handling, multi-agent delegation modes, and TUI disconnect recovery.
  • the 2026-07-01 source refresh covers Codex CLI 0.142.5 as the current stable/latest patch release, confirms npm latest=0.142.5, records alpha=0.143.0-alpha.31 as an experiment channel, and separates the trace-log payload fix from the command feature baseline.
  • the 2026-07-10 source refresh covers Codex CLI 0.143.0~0.144.0 remote plugins, system proxy and remote-control pairing, MCP auth/tool search, app approval writes, reset-credit selection, review improvements, and runtime reliability fixes.
  • the 2026-07-12 source refresh covers the official Figma-to-code and UI-mock workflows, including ImageGen, Playwright interactive, Build Web Apps, and the Figma MCP tool sequence.
  • the 2026-08-01 source refresh covers Codex CLI 0.145.0~0.146.0 paginated history/forks, named and pinned threads, side switching, expanded import, Agent Plugins/marketplaces, proxy/MCP refresh, and replay preservation.
  • the 2026-08-03 source refresh keeps 0.146.0 as stable/latest and adds official-reference coverage for /copy, /rename, /pets, /setup-default-sandbox, /app, plus /subagents, /btw, and /pet aliases.
  • the 2026-08-20 source refresh covers 0.147.0~0.148.0, /export, exec fork, archive/restore, portable plugins, MCP protocol, Bedrock, hooks, security fixes, and GPT-5.6 model policy.
  • the 2026-08-28 source refresh covers 0.149.0~0.150.1, agents/queue, task messaging, cwd commands, the copy picker, Interrupt hooks, trust/deny-read hardening, app-server migration, and remote compaction.
  • the 2026-08-30 source refresh covers 0.151.0 MCP discovery/result processing, repository-aware plugin catalogs, permission/Guardian/remote sandbox fixes, model fallback consistency, nested goal budgets, and standalone /clear parity.
  • the 2026-09-05 source refresh covers GPT-6 Astra, 0.152.0~0.153.4, the disabled-by-default planning tool, tui.auto_recap, relaxed MCP naming with per-tool output limits, and the documentation move to learn.chatgpt.com.

September 5, 2026 Check

#ItemResultSource
1npm latest v0.153.4, alpha 0.154.0-alpha.3, local CLI 0.153.4Confirmednpm dist-tags + codex --version
2GPT-6 Astra released 2026-09-03 as gpt-6-astraConfirmedAnnouncement + API models page
3Astra 1.05M context, 128K output, $10 / $1 cached / $50 per 1M, April 30 2026 cutoffConfirmedAPI models page
4Astra needs CLI 0.153.0 and is the bundled default from 0.153.4ConfirmedCodex CLI 0.153.x release notes
5Astra added to Bedrock Mantle and Runtime pickers in 0.153.3ConfirmedOfficial changelog
6Astra reaches Critical cybersecurity capabilityConfirmedGPT-6 Astra announcement
7Planning tool disabled by default from 0.152.0ConfirmedCodex CLI 0.152.0
8tui.auto_recap, tui.disable_paste_burst, context-management experimentConfirmedCodex CLI 0.153.0
9MCP naming characters and per-tool output_token_limitConfirmedCodex CLI 0.152.0
10GPT-5.4 and GPT-5.4 mini retirement completed 2026-08-31ConfirmedOfficial models page

August 30, 2026 Check

#ItemResultSource
1npm latest v0.151.0, alpha 0.152.0-alpha.4Confirmednpm dist-tags + Codex changelog
2Optional MCP grace, result interception, structured errorsConfirmedCodex CLI 0.151.0
3Repository-aware catalogs and invalid-marketplace reportingConfirmedCodex CLI 0.151.0
4Permission profiles, Guardian invalidation, remote sandbox semanticsConfirmedCodex CLI 0.151.0
5Model fallback consistency and nested goal budgetsConfirmedCodex CLI 0.151.0
6Dedicated /clear page and syntax correctionConfirmedDeveloper Commands + locale checker

August 28, 2026 Check

#ItemResultSource
1npm latest v0.150.1, alpha 0.151.0-alpha.6Confirmednpm dist-tags + Codex changelog
2codex agents, codex queue, task mentionsConfirmedCodex CLI 0.149.0~0.150.0
3/cd, /pwd, /cwd, /copy pickerConfirmedCodex CLI 0.149.0~0.150.0
4Interrupt hooks and trust/deny-read boundariesConfirmedCodex CLI 0.150.0
5image-aware remote compactionConfirmedCodex CLI 0.150.1

August 20, 2026 Check

#ItemResultSource
1npm latest v0.148.0, alpha 0.149.0-alpha.4Confirmednpm dist-tags + Codex changelog
2/export, codex exec fork, archive/restoreConfirmedCodex CLI 0.148.0
3Portable Agent Plugins, --approve-for-me, MCP 2026-07-28ConfirmedCodex CLI 0.147.0
4Built-in Bedrock provider and async/MCP hooksConfirmedCodex CLI 0.148.0 + config reference
5GPT-5.6 Sol/Terra/Luna and GPT-5.4/mini retirementConfirmedCodex Models

July 12, 2026 Design Workflow Check

#ItemResultOfficial source
1Commands plus Skills, Plugins, and MCP instead of a standalone /design commandConfirmedSlash commands + customization docs
2Figma get_design_context, get_metadata, and get_screenshot sequenceConfirmedFigma designs to code
3Reuse existing design-system components and tokensConfirmedFigma designs to code
4Playwright interactive comparison in a real browserConfirmedFigma designs to code
5$imagegen UI mocks with a screenshot or Figma referenceConfirmedUser stories to UI mocks
6Reattach the selected mock to a new Codex taskConfirmedUser stories to UI mocks
7Build Web Apps plugin for a working web prototypeConfirmedUser stories to UI mocks

August 3, 2026 Check

#ItemResultSource
1Stable/latest CLI remains v0.146.0ConfirmedGitHub release + local CLI + npm latest
2/copy, /rename, /pets, /setup-default-sandbox official coverageConfirmedCodex slash commands reference
3/app official-reference coverageConfirmedCodex slash commands reference
4/subagents, /btw, and /pet aliasesConfirmedSlash reference + 0.146.0 source
5No newer stable release; alpha remains 0.147.0-alpha.4ConfirmedGitHub Releases + npm dist-tags

August 1, 2026 Check

#ItemResultSource
1Latest stable/latest CLI baseline v0.146.0ConfirmedGitHub release rust-v0.146.0 + npm latest + local CLI
2Named /new and /clear, pins, side switchingConfirmedRelease rust-v0.146.0
3Paginated history/forks and hidden ephemeral forksConfirmedReleases rust-v0.145.0~0.146.0
4Expanded Cursor/Claude Code /importConfirmedRelease rust-v0.145.0
5Agent Plugins, workspace publishing, marketplacesConfirmedRelease rust-v0.146.0
6Proxy, MCP/App refresh, replay preservationConfirmedRelease rust-v0.146.0

July 10, 2026 Check

#ItemResultSource
1Latest stable/latest CLI baseline v0.144.0ConfirmedGitHub release rust-v0.144.0 + npm latest
2Default remote plugins, npm sources, local/remote versionsConfirmedRelease rust-v0.143.0
3MCP tool search, session auth, interactive authConfirmedReleases rust-v0.143.0~0.144.0
4App approval writes and reset-credit selectionConfirmedRelease rust-v0.144.0
5Review picker and automatic review improvementsConfirmedRelease rust-v0.144.0

July 1, 2026 Check

#ItemResultSource
1Latest stable/latest CLI baseline v0.142.5ConfirmedGitHub release rust-v0.142.5 (2026-07-01) + npm latest dist-tag
2Trace-log payload protection in v0.142.5ConfirmedFull Responses WebSocket request payloads are no longer written to trace logs
3npm alpha 0.143.0-alpha.31Confirmednpm alpha dist-tag
4Command feature baseline remains v0.142.0Confirmed/delete, /import, and /usage were introduced or documented in the v0.140.0~v0.142.0 window

June 25, 2026 Check

#ItemResultSource
1Latest stable/latest CLI baseline v0.142.0ConfirmedCodex changelog Codex CLI 0.142.0 (2026-06-22) + npm latest dist-tag
2/delete official slash commandConfirmedSlash commands page + Codex changelog Codex CLI 0.140.0
3/import official slash commandConfirmedSlash commands page + Codex changelog Codex CLI 0.140.0
4/usage official slash commandConfirmedSlash commands page + Codex changelog Codex CLI 0.142.0
5codex delete <SESSION> and app-server thread/deleteConfirmedCodex changelog Codex CLI 0.140.0
6Plugin organization improvementsConfirmedCodex changelog Codex CLI 0.140.0
7Rollout token budgetsConfirmedCodex changelog Codex CLI 0.142.0
8Indexed web-search modeConfirmedCodex changelog Codex CLI 0.142.0
9Scheduled UTC reminders and current-time handlingConfirmedCodex changelog Codex CLI 0.142.0
10Multi-agent delegation modesConfirmedCodex changelog Codex CLI 0.142.0
11App-server, exec, and MCP disconnect recoveryConfirmedCodex changelog Codex CLI 0.142.0

June 12, 2026 Check

#ItemResultSource
1Latest CLI baseline v0.139.0ConfirmedCodex changelog Codex CLI 0.139.0 (2026-06-09)
2/app release-tracked commandConfirmedCodex changelog Codex CLI 0.138.0: current CLI thread handoff to Codex Desktop
3/archive listed in the official slash tableConfirmedSlash commands page, checked 2026-06-12
4Plugin add/remove/marketplace --json, list --available --json, and marketplaceSourceConfirmedCLI reference codex plugin, codex plugin marketplace
5Code-mode standalone web searchConfirmedCodex changelog Codex CLI 0.139.0
6MCP schema oneOf/allOf preservation and large-schema compactionConfirmedCodex changelog Codex CLI 0.139.0
7codex doctor editor/pager environment diagnosticsConfirmedCodex changelog Codex CLI 0.139.0
8App-server account token usage and ChatGPT v2 personal access tokensConfirmedCodex changelog Codex CLI 0.138.0
9codex debug app-server send-message-v2 restoredConfirmedCodex changelog Codex CLI 0.139.0
10Reasoning effort fallback shortcuts and model-defined effort orderingConfirmedCodex changelog Codex CLI 0.138.0
11Local image path exposure and image edits through referenced file pathsConfirmedCodex changelog Codex CLI 0.138.0~0.139.0
12resume/fork --last, scoped MCP startup warnings, and cloud-managed requirement preservationConfirmedCodex changelog Codex CLI 0.139.0
13codex sandbox -P, effective sandbox modes, and network proxy enforcementConfirmedCLI reference + Codex changelog Codex CLI 0.139.0

June 8, 2026 Check

#ItemResultSource
1Latest CLI baseline v0.137.0ConfirmedGitHub release rust-v0.137.0 (2026-06-04)
2/archive addedConfirmedGitHub release rust-v0.136.0: TUI /archive, codex archive, codex unarchive
3/archive not yet listed in the official slash tableConfirmedSlash commands page, checked 2026-06-08
4/permissions named permission profilesConfirmedGitHub release rust-v0.135.0 and Permissions docs
5Remote /status connection/server versionConfirmedGitHub release rust-v0.135.0
6File-based --profile migrationConfirmedAdvanced Configuration docs and GitHub release rust-v0.134.0
7codex app-server --stdio and archive eventsConfirmedApp Server docs and GitHub release rust-v0.136.0
8codex plugin list --jsonConfirmedGitHub release rust-v0.137.0

Run it with:

pnpm --filter handbook run check:codex-command-master

Translation Parity

This English edition is not a loose summary. It intentionally mirrors the Korean command inventory and navigation order while using English section names:

  • Korean ## 명령어 원본 선언 maps to English ## Original Command Declaration.
  • Korean ## 사용법 maps to English ## Usage.
  • Korean ## 도입 시점 (릴리즈 기준) maps to English ## Release Basis.
  • Korean ## 출처 maps to English ## Sources.

The first full-parity pass prioritized /model, /plugins, /resume, verification, and updates, because those pages carry the most version-sensitive operational detail.

English Locale Checks

  • /en/books/codex-command-master renders English content only.
  • The English root meta registers codex-command-master.
  • The English book uses /en/books/codex-command-master/... links in cards.

Related docs

Command change history

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

Updates

Advanced Codex Usage · Change log for the Advanced Codex Usage handbook.

Advanced Codex Usage

An advanced operations and extension guide for teams standardizing Codex usage.

Release coverage history

Codex CLI: Dated release coverage and handbook update decisions, preserved separately from current instructions.

Verification

Advanced Codex Usage · A checklist for validating advanced Codex team operations.

Release coverage history

Codex CLI: Dated release coverage and handbook update decisions, preserved separately from current instructions.

Command change history

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

On this page

September 22, 2026 second auditRunning verificationOfficial command audit — September 22, 2026Release-tracked command checksSeptember 12, 2026 release refreshVerification CriteriaSource Baseline (2026-09-05 KST)Command CoverageAutomated ValidationSeptember 5, 2026 CheckAugust 30, 2026 CheckAugust 28, 2026 CheckAugust 20, 2026 CheckJuly 12, 2026 Design Workflow CheckAugust 3, 2026 CheckAugust 1, 2026 CheckJuly 10, 2026 CheckJuly 1, 2026 CheckJune 25, 2026 CheckJune 12, 2026 CheckJune 8, 2026 CheckTranslation ParityEnglish Locale Checks