Handbook updates

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.

2026-10-22

The command review baseline stays at 2026-10-10 · Codex CLI 0.162.1; this update changes the book structure.

• Folded 43 command pages that were mostly template text into Command guides in the complete command list. Old addresses redirect permanently (308) to the matching command in the list.
• Kept 15 commands with more material (such as /model, /mcp, /hooks, and /statusline) on their own pages and replaced the repeated summary line and generic cautions with command-specific text.
• Added hook locations, a minimal configuration, the 12 hook events, and input and output rules to /hooks, and item selection plus the tui.status_line and tui.terminal_title keys to /statusline, checked against the official Hooks docs and config reference.

2026-10-10

Official-command review baseline: Codex CLI 0.162.1.

• Re-checked CLI releases 0.161.0–0.162.1 against the Developer Commands tables. The 50 official slash rows and the CLI command and option sets match the October 7 review. The official changelog page was restructured into a combined changelog, so CLI versions are now tracked through GitHub releases and npm.
• Added /mcp login <name> for signing in to an MCP server from an active session (0.161.0) to /mcp, and microphone, speaker, and microphone input channel selection (0.161.0) to /voice.
• Added transcript block navigation and Ctrl+Insert (0.162.0) to /copy, and tui.mouse_scroll_speed (0.162.0) to /tui.
• Covered the managed worktree creation and listing tools (0.162.0) in /worktree and the p pin key in the agent Command Center (0.162.0) in /agent.
• Added codex exec --cyber-access-program and the Daybreak opt-in (--enable cli_daybreak, 0.161.0) to the release additions in the terminal CLI reference.
• Corrected the GPT-6.1 Sol speed note in /model to the Ultrafast plans listed on the official models page. Per-release changes are recorded in the dated release coverage.

2026-10-07

Official-command review baseline: Codex CLI 0.160.1.

• Re-checked CLI releases 0.158.0–0.160.1 against the Developer Commands tables. The 50 official slash rows and the CLI command and option sets are unchanged; the /model description and the --model example now use gpt-6.1-sol.
• Added GPT-6.1 Sol (gpt-6.1-sol) to /model. From 0.159.1, the bundled default for sessions without a configured model moved from GPT-6 Astra to GPT-6.1 Sol.
• Added tui.copy_on_select and tui.right_click_paste (0.158.0) and X11 middle-click paste (0.160.0) to /tui, and codex mcp add --oauth-client-secret (0.158.0) to /mcp.
• Covered the 0.160.0 changes in /permissions, /resume, and /cd: default permissions for projectless sessions, restoring saved permissions on resume, and the folder-trust prompt.
• Recorded per-release changes, including the tui.prompt_suggestions setting and the bundled plugin-creator skill removed in 0.159.0, in the dated release coverage.

2026-09-26

Official-command review baseline: Codex CLI 0.157.1.

• Re-checked CLI releases 0.156.0–0.157.1 against the Developer Commands tables. The 50 official slash rows and the CLI command and option sets are unchanged; the /model, /diff, /app, and /import descriptions and the --model example changed.
• Added GPT-6 Sol (gpt-6-sol) and GPT-6 Luna (gpt-6-luna) to /model, with the October 14, 2026 GPT-5.5 retirement for ChatGPT sign-in.
• Added detail pages for /tui (fullscreen UI choice) and /daemon (local background-server updates), both added in 0.156.0.
• /voice and /worktree are enabled by default from 0.156.0, so they are now release-tracked instead of experimental. Also covered the /usage analytics dashboard and the deprecated friendly and pragmatic personalities.

2026-09-22

Official-command review baseline: Codex CLI 0.155.1.

• Reorganized the start page by task and labeled command type and availability in the complete list.
• Aligned detail guides as purpose, availability, examples, effects and persistence, cautions, and official sources.
• Made syntax, aliases, availability, and sources shared so both editions and their lists stay aligned.
• Separated dated records from current guidance while preserving existing command URLs.

Earlier records

Dated release coverage · Earlier verification records · Command change history

See current verification scope for coverage and review limits.