Template v1.0 2026-09-12 — As of Codex CLI v0.154.0
Content / Codex CLI Releases
November 2026 v0.170.0 6 releases
Codex CLI v0.169.1–v0.170.0 2026-11-18
- CHG
codex cloud (card-cli) — improves automatic reconnection and preserves active recovery turns when clients reconnect
- FIX
default_permissions (card-settings) — permission updates and child threads no longer lose existing sandbox restrictions
- CHGTUI — realtime voice calls now negotiate over WebRTC
- CHGMCP — adds experimental support for identically named servers across different environments
- FIXMCP — fixes OAuth credential races during cancellation, login and logout
- FIXWindows — fixes file replacement, sandbox permission preservation and runtime registration recovery
- FIXTUI — removes duplicate file search results and fixes thread search snippets for queries containing whitespace
Codex CLI v0.168.0–v0.169.0 2026-11-13
- ADD
features.tui_workspace (card-settings) — opt-in resizable side-chat pane beside the main conversation, with multiple tabs and session restore
- ADD
features.image_generation_animation (card-settings) — opt-in animated GIF generation and editing with image-capable models
- ADD
--trust (card-cli, codex exec) — save project trust for this and future chats, including MCP commands outside the sandbox
- CHG
agents.enabled (card-settings) — Codex now warns when features.multi_agent is explicitly configured and points here instead
- CHG
tui.notifications (card-settings) — adds an osc777 value and lengthens approval previews
- CHG
model_provider (card-settings) — adds browsing model providers under Sessions and choosing a default for new chats
- CHG
codex resume (card-cli) — local history and resume pickers now filter to threads under the signed-in ChatGPT account
- CHG
@ (card-keys) — fuzzy file search now weighs filename matches more heavily
- CHG
/pets (card-slash-tools) — adds image previews and pet rendering in tmux on Ghostty and Kitty
- CHG
codex login (card-cli) — custom model providers can now be added or edited from the terminal, including during sign-in with device-code authorization
- CHG
codex cloud (card-cli) — the opt-in macOS/Linux Cloud connection can send images, choose a model and reasoning effort, and archive or restore conversations
- CHG
codex agents (card-cli) — adds searching older tasks by name, prompt preview or working directory
- CHG
/tui (card-keys) — adds a Collapse turn details option that folds completed activity under each prompt
- CHG
/feedback (card-slash-tools) — adds pressing Ctrl+S in the report editor to save a diagnostic ZIP locally
Codex CLI v0.167.2 2026-11-11
- CHG
model_provider (card-settings) — tool updates to the gcp provider now stream incrementally by default; opt out with features.incremental_tools_legacy_gcp, unverified
Codex CLI v0.167.0 2026-11-06
- ADD
Ctrl L / Ctrl T (card-keys) — clear the terminal display, then bring back messages hidden by it
- CHG
codex agents (card-cli) — the command center and session picker now mark unread results
- CHG
/experimental (card-slash-tools) — adds opting into the OS-level (macOS or Windows) system proxy
- CHG
model_provider (card-settings) — adds a gcp_setup_wizard flag that configures Vertex AI credentials interactively
- FIX
model_auto_compact_token_limit (card-settings) — now counts retained output from failed responses and responses missing token-usage data
- FIX
! (card-keys) — deleting back past a leading ! now keeps the draft in chat mode instead of switching to shell mode
October 2026 v0.160.0 – v0.166.0 8 releases
Codex CLI v0.166.0 2026-10-29
- CHG
/tui (card-keys) — adds keyboard-driven transcript selection with word, line and page movement, an integrated search, and configurable shortcuts
- CHG
codex queue (card-cli) — adds --resume to resume an unloaded thread after queueing a message
- CHG
codex doctor (card-cli) — adds --network-only for focused configuration, connectivity and WebSocket diagnostics
- FIX
approval_policy (card-settings) — acknowledged approval and permission settings are now kept when resuming or forking threads
- FIX
/archive (card-slash-core) — spawned descendant threads are now restored when their parent is unarchived
- FIX
codex app-server (card-cli) — fixes thread startup and shutdown races, releasing completed runtimes promptly
- FIX
model_auto_compact_token_limit (card-settings) — reasoning-token accounting is now preserved across resume and fork, avoiding premature compaction
- CHGTUI — Markdown now renders consistently in async questions, choices, answers and transcript replies
- CHGTUI — adds clearer safety-block explanations and selectable safer follow-up prompts
- FIXTUI — improved reconnection recovery, including offline
/quit and /exit handling
Codex CLI v0.165.0 2026-10-27
- CHG
model_provider (card-settings) — adds a built-in gcp provider for Google Cloud Vertex AI
- CHG
--worktree (card-cli) — adds a repository filter to the session picker and directory grouping in the agent command center for linked worktrees
- CHG
codex app-server (card-cli) — adds experimental attached thread forks to the app-server API
- CHG
/model (card-slash-core) — reasoning effort can now be changed mid-conversation by default for supported models
- CHG
memories.use_memories (card-settings) — memory v2 is now the default for fresh profiles
- CHG
/memories (card-slash-tools) — adds support for importing memories generated by other coding agents
- FIX
approvals_reviewer (card-settings) — fresh TUI sessions now use the server’s default approval reviewer when no override is given
- FIX
Tab (card-keys) — queued messages no longer restart work after an interrupt or a switch to Plan mode
- FIX
marketplaces.<name>.source_type (card-skills) — closes a marketplace URL validation gap that could let Git connect to a host other than the one checked
Codex CLI v0.164.0 2026-10-23
- ADD
/presets (card-slash-core) — save reusable prompts and slash commands in ten numbered slots, with a keyboard menu for quick access
- CHG
/model (card-slash-core) — inline arguments now set the model, reasoning effort and speed directly
- CHG
/permissions (card-slash-core) — an inline argument now sets a permission profile directly
- FIX
/tui (card-keys) — promoted from unverified, now confirmed in developer-commands.md
Codex CLI v0.163.0 2026-10-15
- ADD
/config (card-slash-core) — searchable preferences panel; supported settings change immediately, and changes needing a restart are flagged
- CHG
/keymap (card-keys) — adds a configurable leader key (default Ctrl+X) and moves voice mute to F9
- FIX
/side (card-slash-core) — fixes returning to an existing side chat after switching threads, and routes answers to pending prompts back to the thread that asked
- FIX
/daemon (card-slash-tools) — promoted from unverified, now confirmed in developer-commands.md; also adds restarting the managed server, per the release notes
Codex CLI v0.162.1 2026-10-09
- FIX
codex app-server (card-cli) — startup compatibility checks now apply only to explicit command-line feature overrides, fixing false-positive failures from drift between a running background server's feature settings and CLI defaults
- FIXTUI — fixed a crash when asynchronous questions contain multiple lines; line breaks and full hyperlink destinations are now preserved
Codex CLI v0.162.0 2026-10-08
- CHG
/tui (card-keys) — release notes add transcript-block navigation and copying via /copy, a Ctrl+Insert selection-copy shortcut, and adjustable mouse-wheel scroll speed; still unverified
- CHG
codex agents (card-cli) — release notes add task pinning in the Command Center with p, kept in a shared Pinned group when the server supports it
- CHG
--worktree (card-cli) — adds tools to create and list managed worktrees for trusted local projects when the worktrees feature is enabled
Codex CLI v0.161.0 2026-10-07
- CHG
/mcp (card-slash-tools) — adds a login <name> subcommand to sign in to a streamable HTTP MCP server’s OAuth flow from the terminal
Codex CLI v0.160.0 2026-10-01
- ADD
auto_review.extra_policy (card-settings) — additional Markdown policy appended alongside the main auto-review policy, part of this release’s opt-in Guardian review capabilities
September 2026 v0.154.0 – v0.159.0 8 releases
Codex CLI v0.159.0 2026-09-29
- ADD
instant_interrupt (card-settings) — opt-in setting to steer Codex mid-response or during extended code-mode runs; unverified
- CHG
/tui (card-keys) — release notes add Markdown table and whitespace preservation on copy, plus automatic copy-on-select in more terminals; still unverified
- CHG
codex app-server (card-hooks) — adds pagination for thread-history queries from a specific item
Codex CLI v0.158.0 2026-09-28
- ADD
codex mcp add --oauth-client-secret (card-hooks) — connects to MCP servers that require a pre-registered OAuth client secret
- ADD
codex exec-server --ws-auth (card-cli) — secures direct WebSocket connections with bearer tokens, matching what codex app-server already supported
- CHG
/tui (card-keys) — release notes add configurable copy-on-select and right-click paste, preserving Markdown formatting in copied selections; still unverified
- FIX
--no-daemon (card-cli) — promoted from unverified, now confirmed in codex --help
Codex CLI v0.157.0 2026-09-25
- CHG
/import (card-slash-tools) — now works in remote and local background-server sessions, not just plain interactive ones
- CHG
codex app-server (card-cli) — can now start automatically for qualifying interactive sessions, with a recovery prompt when existing settings are incompatible
Codex CLI v0.156.0 2026-09-22
- ADD
/tui (card-keys) — fullscreen terminal transcript interface with transcript search, mouse selection and right-click copying; unverified
- ADD
/daemon (card-slash-tools) — updates the local background-server daemon from the TUI; unverified
- ADD
--no-daemon (card-cli) — opts a run out of the shared background-server daemon; unverified
- CHG
--worktree (card-cli) — worktree sessions are now enabled by default, with browsing and status filtering added to the agent command center
- CHG
/usage (card-slash-tools) — the usage view now also surfaces plugin and skill activity alongside token totals
Codex CLI v0.155.0–v0.155.1 2026-09-18
- ADD
codex app-server (card-cli) — noted the daemon subcommand tree, including the new daemon update for restarting a standalone install’s managed daemon on a configurable schedule
- FIX
model_reasoning_summary (card-settings) — noted that new local TUI sessions now default to summaries disabled, so providers that reject the field no longer fail requests; an explicit value is still respected
Codex CLI v0.154.0 2026-09-09
- ADD
card-keys — initial reference: composer shortcuts, working-turn keys, /keymap and TUI appearance (19 rows)
- ADD
card-slash-core — initial reference: model, permissions, session lifecycle, context and background terminals (26 rows)
- ADD
card-slash-tools — initial reference: extensibility commands, Windows sandbox helpers, account and diagnostics (17 rows)
- ADD
card-cli — initial reference: global flags plus every documented subcommand (47 rows)
- ADD
card-settings — initial reference: 63 curated config.toml keys across model, approvals, sandbox, MCP, providers, TUI and features
- ADD
card-env — initial reference: the complete stable public environment-variable set, including CODEX_HOME (12 rows)
- ADD
card-skills — initial reference: skill scopes, plugins and marketplaces, AGENTS.md merge order, subagents (19 rows)
- ADD
card-hooks — initial reference: 12 lifecycle events, hook trust, MCP client config, sandbox modes and execpolicy (17 rows)
Template / Structure
- ADDv1.0 — template derived from
claude-code-placemat v1.2
- CHGStylesheet and page script moved to
shared/; each placemat sets its own accent via a small :root override and declares itself with <html data-agent>
- CHGPer-agent
localStorage keys (pm-codex-seen-version, pm-codex-collapsed); theme and density stay shared across every placemat on this origin
- DELCommand builder — it generated
claude invocations and did not carry over
- FIX
sources.json gained a vendor-extracted inventory (54 slash commands, 224 settings keys, 12 hook events, sourced from developer-commands.md, config-reference.md, config-basic.md and hooks.md); codex is now under the inventory gate in tests/placemat.test.js
- FIXMarked
mcp_oauth_callback_port and mcp_optional_startup_grace_ms (card-hooks) unverified — both are confirmed config.toml keys, but the inventory gate reads every bare-word chip in card-hooks as a hook-event candidate, and neither is a hook event
- FIXMarked the v0.156.0 additions
/tui, /daemon and --no-daemon unverified — learn.chatgpt.com (developer-commands, config-reference, hooks) was unreachable from the sync sandbox this run, so sources.json → inventory was not re-extracted; promote them once a future sync confirms against the docs
- FIXBackfilled
auto_review.policy (card-settings) — already a confirmed config.toml key in sources.json → inventory since the original extraction, but had never been given a placemat row