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›Release coverage history
한국어English

Release coverage history

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

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

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.

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.

Updated: both locales of the index, setup, verification, and relevant command/operations chapters. Entries below retain their historical verification dates.

2026-09-05

  • Updated npm to latest=0.153.4 and alpha=0.154.0-alpha.3, cross-checked against the local CLI at 0.153.4.
  • Added GPT-6 Astra (released 2026-09-03) to both /model pages: 0.153.0 minimum, bundled default from 0.153.4, 1.05M context, 128K output, $10 / $1 cached / $50 per 1M, April 30 2026 cutoff, and the Critical cybersecurity warning.
  • Recorded the 0.152.0 change that disables the planning tool by default (tools.update_plan.enabled) and noted it is distinct from the /plan slash command.
  • Added tui.auto_recap, remote marketplace management from the plugin CLI, Vim undo/redo, earlier Plus/Team allowance warnings, and Full Access skipping Guardian reviews for confirmation-only actions (0.153.0).
  • Added relaxed MCP server naming, per-tool output_token_limit, and rate-limit banner actions (0.152.0) to the /mcp and /usage baselines.
  • Recorded the documentation move from developers.openai.com/codex/* to learn.chatgpt.com/docs/*; existing links still resolve through 308 redirects.

2026-08-30

  • Updated npm to latest=0.151.0 and alpha=0.152.0-alpha.4 after reviewing the complete 0.151.0 changelog.
  • Added optional MCP discovery grace, extension result interception, and structured app-server MCP errors.
  • Added per-repository plugin catalogs and separate reporting for invalid project marketplaces.
  • Added restored-profile persistence, stale Guardian invalidation, remote executor path semantics, model/fallback consistency, and nested goal budgeting.
  • Added matching standalone /clear pages and corrected /clear [name] to /clear versus /new [name].

2026-08-28

  • Updated npm to latest=0.150.1 and alpha=0.151.0-alpha.6 after reviewing 0.149.0 through 0.150.1.
  • Added codex agents, codex queue, task mentions, /cd//pwd//cwd, matching /cd pages, and checker parity.
  • Updated /copy, /rename, Markdown links, permission/Vim behavior, and Interrupt hooks.
  • Added trust/deny-read, redaction, MCP, Windows, shutdown, Bedrock, remote-compaction fixes, and the mcp-server deprecation.

2026-08-20

  • Updated npm to latest=0.148.0 and alpha=0.149.0-alpha.4, and reviewed the official 0.147.0 and 0.148.0 changelogs.
  • Added matching /export pages and checker parity for full TUI conversation export to Markdown clipboard/file.
  • Added codex exec fork, resume-picker archive/restore, startup prompt drafting, and estimated /status credits/cost.
  • Added portable Agent Plugins, --approve-for-me, Cursor skill/conversation import, opt-in MCP 2026-07-28, the built-in Bedrock provider, and async/MCP hooks.
  • Removed codex exec --full-auto from current guidance and added redaction, OAuth/reconnect, plugin/network isolation, and fail-closed sandbox fixes.
  • Migrated the model baseline to GPT-5.6 Sol/Terra/Luna and recorded the 2026-08-31 ChatGPT-sign-in retirement of GPT-5.4/mini.

2026-08-03

  • Re-checked GitHub Releases, the local CLI, and npm; the stable/latest baseline remains 0.146.0.
  • Added individual pages for the currently documented /copy, /rename, /pets (/pet), and Windows-only /setup-default-sandbox commands.
  • Promoted /app from release-tracked-only to official-reference coverage and added /subagents and /btw aliases.
  • Expanded both locale manifests and the shared checker so the four new command pages must stay in file, order, syntax, and locale parity.

2026-08-01

  • Updated stable/latest to Codex CLI 0.146.0 from GitHub Releases, the local CLI, and npm (latest=0.146.0, alpha=0.147.0-alpha.4).
  • Added named /new and /clear, thread pins, side switching, paginated history/forks, and hidden ephemeral forks.
  • Expanded /import across Cursor and Claude Code settings, MCP, plugins, sessions, commands, and project memories.
  • Added Agent Plugin manifests, workspace publishing, Amazon Bedrock and Claude Code marketplaces, and live MCP/App refresh.
  • Added proxy, replay preservation, Multi-agent V2, remote Code Mode, custom-provider web search, and executor-skill operating notes.

2026-07-12

  • Added matching Korean and English design-workflows pages based on the official Figma-to-code and user-story-to-UI-mock use cases.
  • Connected /plugins, /skills, /mcp, /apps, /ide, /permissions, /diff, and /review to Figma, ImageGen, Playwright, and Build Web Apps.
  • Added checks for Figma MCP get_design_context, get_metadata, and get_screenshot, with /mcp verbose as the diagnostic fallback.
  • Added the $imagegen mock → new Codex task with reattached image → Build Web Apps implementation → $playwright browser verification loop.
  • Clarified that design is a Skill, Plugin, and MCP workflow rather than a standalone /design slash command.

2026-07-10

  • Updated the stable/latest CLI baseline to v0.144.0 and cross-checked npm dist-tags (latest=0.144.0, alpha=0.145.0-alpha.1).
  • Updated /plugins for default-enabled remote plugins, npm marketplace sources, and visible local/remote versions.
  • Updated /mcp for default tool search, ChatGPT-hosted session auth, and interactive authentication without an experimental opt-in.
  • Updated /permissions for app approval writes, /usage for reset-credit type/expiration/selection, and /review for branch-picker and automatic-review improvements.
  • Added overview and verification notes for system proxies, codex remote-control pair, compaction recovery, Windows sandbox fixes, terminal-control sanitization, and connector auth refresh.

2026-07-01

  • Refreshed the official stable/latest CLI baseline to v0.142.5 from GitHub Releases and npm dist-tags (latest=0.142.5, alpha=0.143.0-alpha.31).
  • Classified v0.142.5 as a trace-log payload protection patch, so /delete, /import, /usage, rollout token budgets, indexed web search, scheduled UTC reminders, and multi-agent delegation guidance remain tied to the v0.140.0~v0.142.0 feature baseline while log-protection checks move to 0.142.5.
  • Synced the English index, overview, verification, and handbook shelf metadata with the Korean July 1 update.

2026-06-25

  • Refreshed the official stable/latest CLI baseline to v0.142.0 from the 2026-06-22 Codex changelog and cross-checked npm dist-tags (latest=0.142.0, alpha=0.143.0-alpha.14).
  • Added Korean and English command pages for official slash commands /delete, /import, and /usage, plus matching meta.json and command inventory validation updates.
  • Documented /delete separately from /archive: it permanently deletes the current transcript and spawned descendant sessions and is unavailable during running tasks or side conversations.
  • Added /import guidance for Claude Code setup, project files, and recent chats, including local TUI constraints and mandatory /diff / /debug-config review after migration.
  • Added /usage daily|weekly|cumulative and earned rate-limit reset guidance before long /goal or multi-agent runs.
  • Reflected 0.140.0~0.142.0 notes for plugin organization, rollout token budgets, indexed web search mode, scheduled UTC reminders/current-time handling, multi-agent delegation modes, and TUI disconnect recovery in overview and verification pages.

2026-06-12

  • Refreshed the official CLI baseline to v0.139.0 from the 2026-06-09 Codex changelog.
  • Added an individual /app page from the 0.138.0 changelog for handing the current CLI thread into Codex Desktop.
  • Re-checked official slash commands and updated /archive from release-tracked-only to official-table coverage; /app remains release-tracked.
  • Added 0.139.0 notes for code-mode standalone web search, MCP schema oneOf/allOf preservation, and large-schema compaction.
  • Added diagnostics notes for codex doctor editor/pager environment reporting and JSON raw-value redaction.
  • Updated /plugins for codex plugin add/remove --json, codex plugin list --available --json, marketplace source JSON, and marketplace install/upgrade operations.
  • Added command-operation notes for app-server account token usage, ChatGPT v2 personal access tokens, and the restored codex debug app-server send-message-v2 command.
  • Reflected reasoning-effort fallback shortcuts, model-advertised effort ordering, image file-path exposure, resume/fork --last prompt handling, scoped MCP startup warnings, cloud-managed requirement preservation, sandbox -P permissions profile alias, and effective sandbox diagnostics.
  • Added /app to the shared command inventory parity checks.

2026-06-08

  • Refreshed the official CLI baseline to v0.137.0 from the 2026-06-04 GitHub release.
  • Added an individual /archive page based on the 0.136.0 release and documented codex archive / codex unarchive.
  • Added notes for named permission profiles, the file-based --profile migration, richer codex doctor, and remote /status.
  • Refreshed app-server and remote-control coverage for codex app-server --stdio, archive events, and controller grant RPCs.
  • Added notes for codex plugin list --json, cached remote catalog suggestions, Multi-agent v2 runtime metadata, F13-F24 keybindings, and searchable menu paste.
  • Added /archive to the shared command inventory parity checks.

2026-05-21

  • Refreshed the official CLI baseline to v0.132.0 from the 2026-05-20 Codex changelog.
  • Added individual command pages for /approve, /ide, /memories, /raw, /skills, /theme, and /vim.
  • Promoted /vim from changelog-only preview tracking to standard command coverage.
  • Added 0.131.0 notes for codex doctor, unified @ mentions across files/directories/plugins/skills, data-driven service-tier commands, remote-control daemon/API work, plugin marketplace CLI commands, and version-aware sharing.
  • Added 0.132.0 notes for codex exec resume --output-schema, Python SDK auth/turn APIs, original-resolution image fidelity, and goal-continuation guardrails.
  • Updated the model baseline so gpt-5.5 is documented as available in Codex with ChatGPT sign-in or API-key authentication.
  • Expanded the shared command inventory parity checks to cover the newly documented command pages.

2026-05-17

  • Added shared Korean/English validation to check-codex-command-master.mjs.
  • Added parity checks for command file inventory, meta.json page coverage, and command order.
  • Expanded /model, /plugins, /resume, verification, and updates from compact English summaries into fuller translations of the Korean operational detail.
  • Added the English codex-command-master handbook with the same structure as the Korean source.
  • Re-checked official Codex slash commands, hooks, config, and changelog sources.
  • Promoted /hooks from preview tracking to a standard command page after the official slash table and 2026-05-14 Hooks GA update.
  • Added hook notes for features.hooks, plugin-bundled hook opt-in, managed hooks, and project trust.
  • Updated the Korean source and verification baseline at the same time.

2026-05-10

  • Updated the baseline to Codex CLI v0.130.0.
  • Added /goal, /keymap, /side, and /stop as individual command pages in the Korean source.
  • Promoted /side from changelog-only tracking to standard slash command coverage.
  • Preferred /stop over the older /clean alias in team documentation.
  • Kept /vim as preview-only because it is visible in the changelog but not yet in the official slash command table.

Related docs

Updates

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

Release coverage history

Claude Code Command Master · Claude Code: Dated release coverage and handbook update decisions, preserved separately from current instructions.

Update Log

Claude Code Complete Guide · English edition changes for the Claude Code Complete Guide.

Updates

Enterprise Project Architecture · Change log for the enterprise project architecture handbook.

Advanced Codex Usage

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

Handbook updates

Codex CLI: Recent handbook structure improvements with links to dated release coverage and audit records.

Earlier verification records

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

On this page

Official command audit — September 22, 2026September 12, 2026 release refresh2026-09-052026-08-302026-08-282026-08-202026-08-032026-08-012026-07-122026-07-102026-07-012026-06-252026-06-122026-06-082026-05-212026-05-172026-05-10