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

  • CHGcodex cloud (card-cli) — improves automatic reconnection and preserves active recovery turns when clients reconnect
  • FIXdefault_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

  • ADDfeatures.tui_workspace (card-settings) — opt-in resizable side-chat pane beside the main conversation, with multiple tabs and session restore
  • ADDfeatures.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
  • CHGagents.enabled (card-settings) — Codex now warns when features.multi_agent is explicitly configured and points here instead
  • CHGtui.notifications (card-settings) — adds an osc777 value and lengthens approval previews
  • CHGmodel_provider (card-settings) — adds browsing model providers under Sessions and choosing a default for new chats
  • CHGcodex 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
  • CHGcodex login (card-cli) — custom model providers can now be added or edited from the terminal, including during sign-in with device-code authorization
  • CHGcodex cloud (card-cli) — the opt-in macOS/Linux Cloud connection can send images, choose a model and reasoning effort, and archive or restore conversations
  • CHGcodex 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

  • CHGmodel_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

  • ADDCtrl L / Ctrl T (card-keys) — clear the terminal display, then bring back messages hidden by it
  • CHGcodex 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
  • CHGmodel_provider (card-settings) — adds a gcp_setup_wizard flag that configures Vertex AI credentials interactively
  • FIXmodel_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
  • CHGcodex queue (card-cli) — adds --resume to resume an unloaded thread after queueing a message
  • CHGcodex doctor (card-cli) — adds --network-only for focused configuration, connectivity and WebSocket diagnostics
  • FIXapproval_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
  • FIXcodex app-server (card-cli) — fixes thread startup and shutdown races, releasing completed runtimes promptly
  • FIXmodel_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

  • CHGmodel_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
  • CHGcodex 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
  • CHGmemories.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
  • FIXapprovals_reviewer (card-settings) — fresh TUI sessions now use the server’s default approval reviewer when no override is given
  • FIXTab (card-keys) — queued messages no longer restart work after an interrupt or a switch to Plan mode
  • FIXmarketplaces.<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

  • FIXcodex 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
  • CHGcodex 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

  • ADDauto_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

  • ADDinstant_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
  • CHGcodex app-server (card-hooks) — adds pagination for thread-history queries from a specific item

Codex CLI v0.158.0 2026-09-28

  • ADDcodex mcp add --oauth-client-secret (card-hooks) — connects to MCP servers that require a pre-registered OAuth client secret
  • ADDcodex 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
  • CHGcodex 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

  • ADDcodex 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
  • FIXmodel_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

  • ADDcard-keys — initial reference: composer shortcuts, working-turn keys, /keymap and TUI appearance (19 rows)
  • ADDcard-slash-core — initial reference: model, permissions, session lifecycle, context and background terminals (26 rows)
  • ADDcard-slash-tools — initial reference: extensibility commands, Windows sandbox helpers, account and diagnostics (17 rows)
  • ADDcard-cli — initial reference: global flags plus every documented subcommand (47 rows)
  • ADDcard-settings — initial reference: 63 curated config.toml keys across model, approvals, sandbox, MCP, providers, TUI and features
  • ADDcard-env — initial reference: the complete stable public environment-variable set, including CODEX_HOME (12 rows)
  • ADDcard-skills — initial reference: skill scopes, plugins and marketplaces, AGENTS.md merge order, subagents (19 rows)
  • ADDcard-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
  • FIXsources.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