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

Release coverage history

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

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

2026-10-23 · Codex CLI 0.163.0

Compared stable 0.163.0 (2026-10-15) with Developer Commands. npm latest=0.163.0 and alpha=0.164.0-alpha.12. Alpha changes are excluded from stable usage guidance.

  • Settings and input: search /config, apply supported settings immediately, and check which need a restart. Follow-ups sent during a response now steer it immediately by default. Interrupting a turn also stops active Code Mode cells and nested tool calls.
  • Shortcuts and server: /keymap defaults to a Ctrl+X leader with hints retained until selection or cancellation. Voice mute moved to F9. /daemon can restart a managed background server, warns about interrupted work, and reconnects automatically.
  • Permissions and Daybreak: resume restores saved permissions and network approvals while respecting explicit overrides and current managed policy. Daybreak is enabled by default for eligible accounts, superseding the 0.161.0 opt-in guidance. API-key authenticated codex exec can select a program when the server provides access.
  • Execution and recovery: independent read-only tools, including skill, memory, and conversation-history lookups, can run in parallel. /side returns to an existing side chat after navigation; pending answers return to the originating thread. Windows text paste, WSL clipboard timeouts, lingering output pipes, and collection of final remote output were fixed.
  • Compatibility: patched zsh is no longer bundled; retired shell flags produce migration guidance. Linux sandbox documentation now describes bubblewrap filesystem isolation and seccomp filtering. The proxy checks authorization before DNS and blocks duplicate Host headers and credential-alias inspection bypasses.
  • Reference audit: the slash table grows from 50 to 57 rows. /agents (server command center) is separate from /subagents (child thread). /tui, /export, /recap, /cd, /pwd (/cwd), /worktree, /daemon, and /warnings are listed. /agent, /personality, and /sandbox-add-read-dir are absent; their old anchors remain with explicit status. CLI overview grows from 27 to 29 rows, adding codex agents and codex queue. Global/exec option changes and the Linux sandbox table were updated. /config and /voice remain release-tracked.
  • GPT-5.5 retirement completed: it left ChatGPT-authenticated Codex at 19:00 UTC on 2026-10-14. Update saved configuration, custom agents, scheduled tasks, and scripts to an available replacement such as GPT-6.1 Sol (gpt-6.1-sol). The OpenAI API and API-key authenticated Codex are unaffected.

Sources: 0.163.0 release, Developer Commands, Official changelog, Models, npm dist-tags.

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

CLI 0.161.0–0.162.1 refresh — October 10, 2026

Re-checked the 50 CLI slash-table entries and 27 terminal command-table entries in Developer Commands; there are no key or value changes since the October 7 review. The release baseline is 0.162.1 (October 9, 2026), with npm latest=0.162.1 and alpha=0.163.0-alpha.5. The official changelog page was restructured into a combined ChatGPT and Codex changelog that no longer lists Codex CLI version numbers, so from this review CLI releases are tracked through GitHub releases and npm. The additions below come from release notes and are not in the official tables yet.

  • 0.161.0 (October 7): /mcp login <name> signs in to an MCP server from an active terminal session. Voice conversations let you choose the microphone, speaker, and microphone input channels, with preferences saved locally. Daybreak becomes opt-in: unless --enable cli_daybreak or features.cli_daybreak = true is set, its controls and indicators are hidden, /daybreak is unavailable, and automatic Cyber routing is omitted. codex exec --cyber-access-program and the TypeScript SDK's cyberAccessProgram option select a Cyber access program per turn. The release notes restate GPT-6.1 Sol as the default model in the bundled and Amazon Bedrock catalogs and add multi-agent V2 and Ultra reasoning on Bedrock plus AWS GovCloud regions for Bedrock Mantle. Fixes cover the write scope of approved filesystem escalation, background tasks keeping their originating turn's permissions, and explicit launch permissions surviving reconnects. Authentication guidance now accounts for keyring storage instead of implying credentials always live in auth.json.
  • 0.162.0 (October 8): /copy navigates and copies transcript blocks, Ctrl+Insert copies selections, and tui.mouse_scroll_speed tunes mouse-wheel scrolling. p pins tasks in the agent Command Center, and pinned tasks stay in a shared Pinned group when the server supports it. Adds tools for creating and listing managed Git worktrees from trusted local projects when the worktrees feature is enabled. URLs are clickable in approval headers, questions, MCP prompts, warnings, banners, and verification prompts, including links that wrap across lines. Custom Responses-compatible model providers can configure live web access and remote compaction capabilities, and Windows releases publish a signed PowerShell installer.
  • 0.162.1 (October 9): fixes a TUI crash on multi-line asynchronous questions and startup failures caused by differences between a running background server's feature settings and CLI defaults. No command changes.
  • Model schedule: the October 14, 2026 GPT-5.5 retirement is unchanged. The official Models page lists Ultrafast for GPT-6.1 Sol on Pro $500 and eligible Enterprise and Edu plans.

/mcp · /copy · /voice · /worktree · /agent

Sources: Developer Commands, Models, rust-v0.161.0, rust-v0.162.0, rust-v0.162.1.

CLI 0.158.0–0.160.1 refresh — October 7, 2026

Re-checked the 50 CLI slash-table entries and 27 terminal command-table entries in Developer Commands. Commands and options are unchanged; only the /model description and the --model example (gpt-6.1-sol) changed. The release baseline is 0.160.1 (October 5, 2026), with npm latest=0.160.1 and alpha=0.162.0-alpha.18.

  • 0.158.0 (September 28): the fullscreen TUI gains the tui.copy_on_select (auto, always, never) and tui.right_click_paste (auto, on, off) settings, and copied transcript selections keep their Markdown formatting. codex mcp add --oauth-client-secret connects MCP servers that require a pre-registered OAuth client secret. Terminal input approval (write_stdin_approval) is on by default for commands running with elevated permissions, and /ps shows multiline commands in its preview. Direct exec-server WebSocket connections can be protected with bearer tokens. GPT-5.4 leaves the bundled catalogs.
  • 0.159.0 (September 29): the opt-in instant_interrupt feature flag lets new input reach Codex during a model response or a long code-mode call. New sessions get a compact welcome screen; the warnings viewer dismisses reviewed warnings on close, and k keeps one for later. You can scroll the transcript while deciding whether to implement a plan. .aws directories under writable roots are protected by default. Automatic follow-up prompt suggestions, the tui.prompt_suggestions setting, and the bundled plugin-creator skill are removed.
  • 0.159.1 (September 29): GPT-6.1 Sol (gpt-6.1-sol) becomes the default model in the bundled catalog and in the Amazon Bedrock Mantle and Runtime catalogs.
  • 0.159.2–0.159.3 (September 29–30): fixes console windows opened on Windows by background processes and sandboxed commands; eligible local sessions signed in with ChatGPT can show reminders to complete account security setup.
  • 0.160.0 (October 1): the agent command center loads older tasks with "Show more". Fullscreen mode supports middle-click paste on local Linux X11 terminals. Sessions outside a project start with workspace default permissions when policy permits, and resuming restores saved permissions. /cd asks for folder trust and offers "Keep current directory". Adds opt-in Guardian review capabilities that retrieve earlier user instructions and use agent-handoff context.
  • 0.160.1 (October 5): a Windows fix that preserves SYSTEMROOT, TEMP, and TMP when launching remote stdio MCP servers. No command changes.
  • Model schedule: the October 14, 2026 GPT-5.5 retirement is unchanged. The official Models page now recommends GPT-6.1 Sol, but its GPT-5.5 replacement guidance still names GPT-6 Sol.

GPT-6.1 Sol · /tui · /mcp · /permissions

Sources: Developer Commands, official changelog, Models, GPT-6.1 Sol, rust-v0.158.0, rust-v0.159.0, rust-v0.159.1, rust-v0.160.0.

CLI 0.156.0–0.157.1 refresh — September 26, 2026

Re-checked the 50 CLI slash-table entries and 27 terminal command-table entries in Developer Commands. Commands and options are unchanged; only the /model, /diff, /app, and /import descriptions and the --model example (gpt-6-sol) changed. The release baseline is 0.157.1 (September 26, 2026), with npm latest=0.157.1 and alpha=0.159.0-alpha.4.

  • 0.156.0 (September 22): /tui chooses the fullscreen UI for the next launch. Voice conversations are enabled by default, with an F8 toggle, /voice settings, and bundled Linux and Windows audio runtimes. /usage becomes an analytics dashboard, and worktree support is enabled by default. Adds six terminal themes, Mermaid and equation rendering, the /daemon menu, and --no-daemon. The friendly and pragmatic personality settings no longer select response styles.
  • 0.156.1 (September 23): GPT-6 Sol and GPT-6 Luna appear in the model picker; the rate-limit switch prompt recommends GPT-6 Luna.
  • 0.157.0 (September 25): adds Amazon Bedrock support for GPT-6 Sol and Luna with migration prompts for older models, the fullscreen transcript by default with Shift-click selection, automatic background-server startup for eligible interactive sessions, the f shortcut to fork conversations open in another app, and /import in remote and background-server sessions.
  • 0.157.1 (September 26): the release notes carry no change summary, so no command impact could be confirmed.
  • Model schedule: GPT-5.5 retires from ChatGPT, ChatGPT Work, and Codex with ChatGPT sign-in on October 14, 2026. The OpenAI API is not affected.

GPT-6 Sol and Luna · /tui · /daemon · Voice conversations

Sources: Developer Commands, official changelog, Models, rust-v0.156.0, rust-v0.157.0.

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.

Handbook updates

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

Update Log

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

Verification

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

Release coverage history

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

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

2026-10-23 · Codex CLI 0.163.0CLI 0.161.0–0.162.1 refresh — October 10, 2026CLI 0.158.0–0.160.1 refresh — October 7, 2026CLI 0.156.0–0.157.1 refresh — September 26, 2026Official 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