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:
/keymapdefaults to aCtrl+Xleader with hints retained until selection or cancellation. Voice mute moved toF9./daemoncan 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 execcan 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.
/sidereturns 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
Hostheaders 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/warningsare listed./agent,/personality, and/sandbox-add-read-dirare absent; their old anchors remain with explicit status. CLI overview grows from 27 to 29 rows, addingcodex agentsandcodex queue. Global/exec option changes and the Linux sandbox table were updated./configand/voiceremain 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.
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_daybreakorfeatures.cli_daybreak = trueis set, its controls and indicators are hidden,/daybreakis unavailable, and automatic Cyber routing is omitted.codex exec --cyber-access-programand the TypeScript SDK'scyberAccessProgramoption 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 inauth.json. - 0.162.0 (October 8):
/copynavigates and copies transcript blocks,Ctrl+Insertcopies selections, andtui.mouse_scroll_speedtunes mouse-wheel scrolling.ppins 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) andtui.right_click_paste(auto,on,off) settings, and copied transcript selections keep their Markdown formatting.codex mcp add --oauth-client-secretconnects 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/psshows 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_interruptfeature 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, andkkeeps one for later. You can scroll the transcript while deciding whether to implement a plan..awsdirectories under writable roots are protected by default. Automatic follow-up prompt suggestions, thetui.prompt_suggestionssetting, and the bundledplugin-creatorskill 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.
/cdasks 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, andTMPwhen 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):
/tuichooses 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./usagebecomes an analytics dashboard, and worktree support is enabled by default. Adds six terminal themes, Mermaid and equation rendering, the/daemonmenu, 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
fshortcut to fork conversations open in another app, and/importin 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 updateand 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
--worktreeand/worktreecreate 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-serverand the standalonecodex-mcp-serverwere removed. External MCP connections throughcodex mcpremain supported. Evaluate migration to experimentalcodex app-server; the official documentation does not support production workloads on that command. - Editing:
/copypreserves formatting and supports status output; Vim gainsRreplace 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.4andalpha=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
/modelpages: 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/planslash 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/mcpand/usagebaselines. - Recorded the documentation move from
developers.openai.com/codex/*tolearn.chatgpt.com/docs/*; existing links still resolve through 308 redirects.
2026-08-30
- Updated npm to
latest=0.151.0andalpha=0.152.0-alpha.4after 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
/clearpages and corrected/clear [name]to/clearversus/new [name].
2026-08-28
- Updated npm to
latest=0.150.1andalpha=0.151.0-alpha.6after reviewing 0.149.0 through 0.150.1. - Added
codex agents,codex queue, task mentions,/cd//pwd//cwd, matching/cdpages, and checker parity. - Updated
/copy,/rename, Markdown links, permission/Vim behavior, andInterrupthooks. - Added trust/deny-read, redaction, MCP, Windows, shutdown, Bedrock, remote-compaction fixes, and the
mcp-serverdeprecation.
2026-08-20
- Updated npm to
latest=0.148.0andalpha=0.149.0-alpha.4, and reviewed the official 0.147.0 and 0.148.0 changelogs. - Added matching
/exportpages 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/statuscredits/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-autofrom 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-sandboxcommands. - Promoted
/appfrom release-tracked-only to official-reference coverage and added/subagentsand/btwaliases. - 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.0from GitHub Releases, the local CLI, and npm (latest=0.146.0,alpha=0.147.0-alpha.4). - Added named
/newand/clear, thread pins, side switching, paginated history/forks, and hidden ephemeral forks. - Expanded
/importacross 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-workflowspages based on the official Figma-to-code and user-story-to-UI-mock use cases. - Connected
/plugins,/skills,/mcp,/apps,/ide,/permissions,/diff, and/reviewto Figma, ImageGen, Playwright, and Build Web Apps. - Added checks for Figma MCP
get_design_context,get_metadata, andget_screenshot, with/mcp verboseas the diagnostic fallback. - Added the
$imagegenmock → new Codex task with reattached image → Build Web Apps implementation →$playwrightbrowser verification loop. - Clarified that design is a Skill, Plugin, and MCP workflow rather than a standalone
/designslash command.
2026-07-10
- Updated the stable/latest CLI baseline to
v0.144.0and cross-checked npm dist-tags (latest=0.144.0,alpha=0.145.0-alpha.1). - Updated
/pluginsfor default-enabled remote plugins, npm marketplace sources, and visible local/remote versions. - Updated
/mcpfor default tool search, ChatGPT-hosted session auth, and interactive authentication without an experimental opt-in. - Updated
/permissionsfor app approvalwrites,/usagefor reset-credit type/expiration/selection, and/reviewfor 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.5from GitHub Releases and npm dist-tags (latest=0.142.5,alpha=0.143.0-alpha.31). - Classified
v0.142.5as 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 thev0.140.0~v0.142.0feature 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.0from 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 matchingmeta.jsonand command inventory validation updates. - Documented
/deleteseparately from/archive: it permanently deletes the current transcript and spawned descendant sessions and is unavailable during running tasks or side conversations. - Added
/importguidance for Claude Code setup, project files, and recent chats, including local TUI constraints and mandatory/diff//debug-configreview after migration. - Added
/usage daily|weekly|cumulativeand earned rate-limit reset guidance before long/goalor 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.0from the 2026-06-09 Codex changelog. - Added an individual
/apppage from the 0.138.0 changelog for handing the current CLI thread into Codex Desktop. - Re-checked official slash commands and updated
/archivefrom release-tracked-only to official-table coverage;/appremains release-tracked. - Added 0.139.0 notes for code-mode standalone web search, MCP schema
oneOf/allOfpreservation, and large-schema compaction. - Added diagnostics notes for
codex doctoreditor/pager environment reporting and JSON raw-value redaction. - Updated
/pluginsforcodex 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-v2command. - Reflected reasoning-effort fallback shortcuts, model-advertised effort ordering, image file-path exposure,
resume/fork --lastprompt handling, scoped MCP startup warnings, cloud-managed requirement preservation, sandbox-Ppermissions profile alias, and effective sandbox diagnostics. - Added
/appto the shared command inventory parity checks.
2026-06-08
- Refreshed the official CLI baseline to
v0.137.0from the 2026-06-04 GitHub release. - Added an individual
/archivepage based on the 0.136.0 release and documentedcodex archive/codex unarchive. - Added notes for named permission profiles, the file-based
--profilemigration, richercodex 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
/archiveto the shared command inventory parity checks.
2026-05-21
- Refreshed the official CLI baseline to
v0.132.0from the 2026-05-20 Codex changelog. - Added individual command pages for
/approve,/ide,/memories,/raw,/skills,/theme, and/vim. - Promoted
/vimfrom 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.5is 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.jsonpage coverage, and command order. - Expanded
/model,/plugins,/resume,verification, andupdatesfrom compact English summaries into fuller translations of the Korean operational detail. - Added the English
codex-command-masterhandbook with the same structure as the Korean source. - Re-checked official Codex slash commands, hooks, config, and changelog sources.
- Promoted
/hooksfrom 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/stopas individual command pages in the Korean source. - Promoted
/sidefrom changelog-only tracking to standard slash command coverage. - Preferred
/stopover the older/cleanalias in team documentation. - Kept
/vimas preview-only because it is visible in the changelog but not yet in the official slash command table.