Codex CLI v0.169.0 is a OpenAI release published 2026-11-13 with 259 listed changes, flagged for breaking changes, security fixes. Summary and full notes below, extracted from the official notes.
One free email: every breaking change, retirement and price change across 23 coding agents. No spam, unsubscribe anytime.
Subscribe free← All Codex CLI releases and breaking changes
## New Features - The opt-in terminal workspace supports multiple side-chat tabs. Switch between them with the keyboard or mouse, and reopen saved local side chats after restarting Codex. (#59784, #60152, #60181) - Search older tasks from the agent command center by name, prompt preview, or working directory. (#60286) - Turn on **Collapse turn details** in the full-screen transcript to fold completed activity beneath each prompt while keeping answers visible and tool output searchable. (#60554, #60555, #60556, #60557) - Add or edit custom model providers from the terminal. With custom gateway onboarding enabled, you can create a provider during sign-in and use a device code for supported gateways over SSH or without a local browser. (#59779, #60009, #60186, #60486, #60662) - Press `Ctrl+S` in the terminal report editor to save a diagnostic ZIP locally, even when uploads are disabled. (#60542) - With the opt-in Cloud connection on macOS and Linux, send images, choose a model and reasoning effort, and archive or restore Cloud conversations from the terminal. (#59828, #60061, #60635, #60651) ## Bug Fixes - `codex exec` keeps project configuration and MCP servers disabled in untrusted directories, even with `--sandbox workspace-write`. Use `--trust` with `codex exec` or `codex review` to explicitly save project trust. (#60041) - **Yes, clear context and implement** now hands the full approved plan to the fresh session and keeps the current session open if the handoff fails. (#60763) - Fixed Windows sandbox handling for quoted `cmd.exe` paths and for PowerShell sessions whose working directory has an unreadable parent. (#60624, #60647) - Pasted images on macOS retain their intended orientation and use native PNG or JPEG clipboard data when available. (#60455) - The terminal no longer stays busy waiting for MCP servers that a shared app server did not report. (#60280, #60622) - Interrupted turns now close cleanly, and delayed aborts or file approval cancellations no longer interrupt a later turn. (#59910, #60700) ## Documentation - Updated the `openai-docs` skill to focus on Codex and ChatGPT Work questions and first-time API setup, with dedicated guidance for configuring Codex across a team. (#59944, #59949) - Documented how app-server clients can list models or authorize a gateway for a configured provider without changing the default provider. (#59776, #59819) ## Chores - Updated bundled SQLite to 3.54 to pick up write-ahead log fixes. (#60432) - Plugin marketplace upgrades can reuse Git objects already on disk, reducing repeat downloads. (#60528) ## Changelog Full Changelog: https://github.com/openai/codex/compare/rust-v0.168.0...rust-v0.169.0 - #59739 Add a sidebar chooser and floating workspace shortcut panels @fcoury-oai - #59743 Forward explicit cyber access programs with header authentication @jamy-OAI - #59745 Repair legacy Windows sandbox bin permissions for SYSTEM @zm-oai - #59746 Add typed Cloud user-message submission receipts @bc-openai - #59749 Use runtime authentication for OpenAI MCP and app requests @cooper-oai - #59750 Stop Noise relay recovery on rejected executor credentials @richardopenai - #59752 Configure the Opus Bazel patch and isolate auth tests @bkotsopoulos - #59754 Enforce host-required cyber access programs per thread @jamy-OAI - #59759 Update WebSocket dependency forks @charliemarsh-oai - #59767 Add sidebar tabs and nonblocking side-chat creation @fcoury-oai - #59768 Stop prefetching plugin discovery at app-server startup @zamoshchin-openai - #59769 Reuse decoded WebSocket event kinds in telemetry @charliemarsh-oai - #59770 Add shared service-tier support for host-owned agents @rhan-oai - #59772 Remove the legacy sandbox policy constructor @ioanbudea-OAI - #59774 Remove the legacy Seatbelt command wrapper @ioanbudea-OAI - #59776 Allow selecting a configured provider in `model/list` @abhinav-oai - #59778 Expose acceptance metadata and code-cell links in rollout traces @tz-openai - #59779 Add provider configuration editing to the TUI @alexsong-oai - #59780 Enable safe identical code folding for x86-64 musl releases @dkovalenko-oai - #59783 Tie gRPC code-mode connection lifetime to live sessions @frantic-openai - #59784 Support multiple side chats in the TUI sidebar @fcoury-oai - #59785 Decouple message lifecycle state from model-visible item IDs @euroelessar - #59787 Support credential export commands for gateway authentication @alexsong-oai - #59789 Render delegated thread messages as Markdown in the TUI @bc-openai - #59792 Centralize managed proxy preparation and sandbox routing @viyatb-oai - #59793 Support update-boundary paging across forked thread histories @owenlin0 - #59794 Check extension budgets before model generation requests @rhan-oai - #59795 Support optional thread IDs in hosted file uploads @lt-oai - #59805 Pack relative relocations in x86-64 musl release builds @dkovalenko-oai - #59816 Retry gateway credential exports after unauthorized responses @alexsong-oai - #59817 Handle TUI message submission receipts and preserve uncertain drafts @bc-openai - #59819 Allow provider selection for gateway OAuth reads and logins @abhinav-oai - #59822 Add device-code authorization for gateway OAuth @smurching-oai - #59823 Bind runtime auth to the provider's selected credential source @cooper-oai - #59824 Enable resizing the sidebar chooser @fcoury-oai - #59826 Preserve client metadata through queued submissions @eddie-openai - #59828 Add a gated Cloud backend to the TUI @bc-openai - #59832 Add opt-in incremental tools for regular OpenAI Responses @akira-oai - #59842 Carry targeted moderation decisions on final-answer messages @psachdeva-oai - #59887 Remove incomplete prereleases after asset upload failures @jif-oai - #59891 Bound REPL provenance costs in elastic context preparation @jif-oai - #59893 Recompute the approval reviewer when switching models @jif-oai - #59902 Keep verified question/answer records whole under elastic budgets @jif-oai - #59903 Delete incomplete prereleases by release ID @jif-oai - #59905 Validate implicit API keys for Guardian Decisions @jif-oai - #59908 Avoid full image decoding for original-detail context estimates @jif-oai - #59910 Scope file change approval cancellation to the requesting turn @jif-oai - #59913 Resolve Guardian policy from the reviewed thread's catalog @jif-oai - #59914 Bind Guardian Decisions requests to their credential source @jif-oai - #59928 Improve sidebar chat selection and tab hover highlighting @fcoury-oai - #59933 Use permission profiles for protected-model startup downgrades @ioanbudea-OAI - #59944 Narrow openai-docs to product Q&A and first-time API setup @provencher-oai - #59949 Route broad Codex setup questions through self-knowledge guidance @vb-openai - #59954 Resolve skill display names in read and installations tools @jif-oai - #59955 Bump `ignore` to `0.4.30` @iceweasel-oai - #59958 Expose model metadata from each thread's catalog and settings @seanh-oai - #59960 Skip the network denial grace period when remote decisions drain @jif-oai - #59963 Normalize turn context permissions to a required profile @ioanbudea-OAI - #59969 Reduce contention in thread writer lock coordination @dkovalenko-oai - #59972 Fix Opus header installation with relative symlink inputs @bc-openai - #59973 Enable gRPC and host output truncation by default for Code Mode @seanh-oai - #59974 Test command completion before network denial grace expires @jif-oai - #59980 Test rejection of PNGs with readable dimensions but corrupt pixels @fjord-oai - #59983 Render typed prompts as Markdown in the TUI @bc-openai - #59987 Resolve startup models using thread creation options @seanh-oai - #59988 Add inherited styling to TUI display trees @joesavona - #59991 Preserve app invocation context across MCP tool refreshes @fahad-OAI - #59993 Add fixed read views for local message boards @felixxia-oai - #59994 Add read-only evidence retrieval tools for Guardian reviewers @felixxia-oai - #59995 Add subscription tools for Guardian reviewers @felixxia-oai - #59998 Add atomic bulk channel subscription updates @felixxia-oai - #59999 Add model-driven Guardian channel selection @felixxia-oai - #60000 Plan Guardian evidence delivery in source order @felixxia-oai - #60001 Add bounded original-evidence delivery for Guardian reviewers @felixxia-oai - #60002 Decouple Guardian retrieval from local message-board handles @felixxia-oai - #60003 Apply runtime authentication to realtime connections @cooper-oai - #60004 Expose ChatGPT user IDs in `account/read` responses @dand-oai - #60006 Reduce SQLite write overhead for thread activity and history @jonluca - #60007 Start cloud threads with the local GitHub project @bc-openai - #60008 Refactor TUI clipboard and composer input handling @bc-openai - #60009 Add custom gateway selection to TUI sign-in @alexsong-oai - #60010 Add a shared Windows Bazel setup action @dkovalenko-oai - #60011 Adapt multi-agent mode guidance for hosted tools @rhan-oai - #60014 Honor managed runtime authentication modes and expand coverage @cooper-oai - #60017 Disable bundled skills in the prompt-prefix comparison test @felixxia-oai - #60018 Propagate turn triggers to usage analytics events @chrisdong-oai - #60019 Add theme-aware semantic colors to extension UI trees @joesavona - #60020 Strip terminal commands from UI tree strings @joesavona - #60021 Normalize inline UI tree text across styled leaves @joesavona - #60022 Separate UI tree preparation from line rendering @joesavona - #60026 Add multiline layout and row wrapping to UI trees @joesavona - #60027 Keep configured status lines on the native renderer @joesavona - #60028 Reuse prepared UI trees for footer rendering @joesavona - #60029 Render UI trees directly into terminal buffers @joesavona - #60031 Unify TUI status line layout for extension content @joesavona - #60032 Allow extension status content to use multiple footer rows @joesavona - #60034 Omit sensitive process inputs from spawn trace logs @etraut-openai - #60035 Fix authentication for git-attribution settings requests @cooper-oai - #60037 Preserve MCP sharing discovery when deferring cached stdio startup @charliemarsh-oai - #60038 Surface MCP server startup errors when preparing cached tool calls @charliemarsh-oai - #60039 Add opt-in lazy startup for cached stdio MCP servers @charliemarsh-oai - #60040 Restrict legacy incremental tools to Amazon Bedrock providers @akira-oai - #60041 Require explicit project trust in non-interactive runs @etraut-openai - #60042 Centralize Windows sandbox filesystem override resolution @viyatb-oai - #60046 Derive MCP network policy and preserve saved denials @viyatb-oai - #60048 Allow plugin starter prompts up to 512 characters @karenwong-openai - #60049 Preserve model catalogs when starting child agents @evanz-oai - #60055 Reauthenticate runtime requests before reusing WebSocket access @cooper-oai - #60061 Support Cloud image messages and editable draft handoffs @bc-openai - #60064 Use thread runtime auth for Guardian Decisions and memory quota checks @cooper-oai - #60067 Ensure side-chat policy reaches the first model request @fcoury-oai - #60073 Use runtime authentication for remote-control requests @cooper-oai - #60075 Support asynchronous host service-tier reads and acceptance @rhan-oai - #60080 Allow asynchronous model request budget checks @rhan-oai - #60082 Fetch account security reminders through app-server @cooper-oai - #60096 Stop retrying terminal runtime authentication denials @cooper-oai - #60101 Use runtime authentication for Analytics requests @cooper-oai - #60118 Buffer payload JSON reads during rollout trace replay @tz-openai - #60122 Preserve code mode dispatch errors in rollout traces @tz-openai - #60152 Persist local workspace side chats and add tab close controls @fcoury-oai - #60157 Add support for incremental code mode tool definitions @akira-oai - #60163 Wire incremental exec tool updates into Code Mode sessions @akira-oai - #60172 Preserve display instructions in answer moderation @psachdeva-oai - #60173 Test exec catalog preservation across session and compaction changes @akira-oai - #60177 Add metrics for incremental exec catalog updates @akira-oai - #60180 Attach typed punctuation to completed skill mentions @bc-openai - #60181 Add keyboard and mouse navigation for sidebar tabs @fcoury-oai - #60186 Allow creating custom providers during sign-in @alexsong-oai - #60188 Allow model overrides for incremental Code Mode tool messages @akira-oai - #60190 Expose agent tree IDs and environment removal @richardopenai - #60206 Increase Bazel core unit test shards from 8 to 16 @seanh-oai - #60270 Warn when a CLI model is absent from the ChatGPT model list @etraut-openai - #60271 Keep the agents overview open when there is no chat to return to @etraut-openai - #60280 Fix MCP startup tracking when attaching to shared app servers @charliemarsh-oai - #60286 Search task history from the command center @etraut-openai - #60309 Defer executor readiness when prewarming a selected project @bc-openai - #60319 Improve side-chat discovery and navigation in the TUI @fcoury-oai - #60320 Include older itemless Cloud failures in full transcripts @bc-openai - #60327 Suppress stale cloud stream disconnects after reopening a thread @bc-openai - #60335 Avoid duplicate assistant messages when resuming Cloud threads @bc-openai - #60342 Treat goal objectives as untrusted context @dylan-hurd-oai - #60389 Include Codex Apps configuration in cloud prewarm requests @bc-openai - #60390 Allow deferring plain-text MCP output in thread item listings @btraut-openai - #60391 Simplify Guardian's post-denial approval guidance @olliem-oai - #60414 Enable model catalog discovery with gateway OAuth @smurching-oai - #60416 Keep fitting URLs intact in fullscreen Markdown transcripts @etraut-openai - #60418 Let terminal status become done while background terminals run @etraut-openai - #60423 Expose deferred MCP servers in resource listings @charliemarsh-oai - #60432 Upgrade bundled SQLite to 3.54 for WAL fixes @ioanbudea-OAI - #60433 Bind API workload identity source reuse to session claims @cooper-oai - #60434 Reset app-server turn summaries when a turn starts @cooper-oai - #60435 Dismiss the model switch prompt when account usage recovers @etraut-openai - #60436 Revalidate request auth ownership after budget checks @won-openai - #60443 Support cancellation and deadlines for realtime attachments @parabolala - #60454 Update OpenSSL Rust dependencies @dkovalenko-oai - #60455 Prefer native clipboard images on macOS and honor image orientation @dkovalenko-oai - #60461 Honor permission grant scopes in executor capability discovery @dkovalenko-oai - #60462 Route TUI question answers through Cloud message admission @bc-openai - #60466 Keep thread storage available when diagnostic logs fail @dkovalenko-oai - #60472 Serialize default thread permissions as a permission profile @ioanbudea-OAI - #60473 Respect error retry policy during local compaction @charliemarsh-oai - #60475 Stop retrying explicit invalid-workspace errors @charliemarsh-oai - #60476 Treat access program denials as terminal errors @charliemarsh-oai - #60479 Treat content policy violations as terminal errors @charliemarsh-oai - #60480 Treat workspace access denials as terminal errors @charliemarsh-oai - #60481 Treat invalid access program stream errors as terminal @charliemarsh-oai - #60482 Handle context length errors consistently across response transports @charliemarsh-oai - #60486 Add device authorization to app-server gateway OAuth @smurching-oai - #60487 Enable untrusted context tool outputs by default @akira-oai - #60488 Remove the Xcode 26.4 MCP elicitation compatibility workaround @jameswt-oai - #60489 Honor feature overrides when starting the app-server daemon @iceweasel-oai - #60492 Add local-only Claude Code skill migration @aramaraju-oai - #60496 Preserve typed gRPC code-mode session admission errors @seanh-oai - #60498 Unify Guardian context preparation across reviewers @ioanbudea-OAI - #60500 Derive sandbox telemetry labels directly from permission profiles @ioanbudea-OAI - #60505 Trace MCP refresh causes and plugin metadata changes @charliemarsh-oai - #60506 Preserve MCP trace context when tracing is disabled @joesavona - #60507 Use hermetic LLVM for Windows MSVC Bazel builds @zbarsky-openai - #60511 Treat inference hook denials as terminal errors @ccui-oai - #60513 Record an MCP refresh reason for session permission grants @charliemarsh-oai - #60517 Route sandbox CLI launches through the shared sandbox manager @viyatb-oai - #60519 Handle unfinished tool calls in restored history @etraut-openai - #60522 Fragment large Responses WebSocket messages into bounded frames @charliemarsh-oai - #60523 Add policy-checked TCP upstream tunneling for SOCKS @viyatb-oai - #60524 Encapsulate thread metadata construction @ioanbudea-OAI - #60525 Preserve first-party catalog display order in app-server model lists @dpatel-oai - #60526 Disable Daybreak when the selected model lacks access @jamy-OAI - #60528 Reuse installed Git objects when upgrading marketplaces @charliemarsh-oai - #60542 Add local diagnostic ZIP saves to the TUI @smurching-oai - #60554 Add optional tool call summaries to the full-screen transcript @etraut-openai - #60555 Extend output-free transcript summaries to more tools @etraut-openai - #60556 Group consecutive tool calls in the full-screen conversation @etraut-openai - #60557 Collapse completed turn activity beneath transcript prompts @etraut-openai - #60558 Discard opening prompts when side chat creation fails @etraut-openai - #60559 Preserve inherited previews for paginated thread forks @etraut-openai - #60560 Avoid periodic wakeups in idle Windows file watchers @chess-oai - #60568 Add an OpenSSH ProxyCommand mode to `codex tcp-tunnel` @apanasenko-oai - #60574 Allow searching persisted attached threads @btraut-openai - #60578 Add published OAuth metadata discovery to the RMCP client @vishnu-oai - #60599 Keep the TUI responsive while opening saved side chats @fcoury-oai - #60613 Clarify safety recourse messaging and add a reporting option @xiaohk - #60617 Support incremental tool declarations on GCP @akira-oai - #60620 Allow sampling in-progress turns with `thread/sample` @keyz - #60622 Use app-server MCP configuration and startup events in the TUI @etraut-openai - #60624 Preserve script quotes in Windows sandbox cmd invocations @malsamiri-oai - #60635 Support archiving and restoring cloud threads @bc-openai - #60637 Show pending key chords in a shared floating shortcut guide @fcoury-oai - #60638 Honor read-only MCP tool hints in automatic approval @cazhang-oai - #60639 Refresh Apps tools outside the MCP runtime gate @dkovalenko-oai - #60644 Keep interrupts responsive during host service-tier updates @rhan-oai - #60645 Update the safety consent test for the current dialog @ambrosino-oai - #60646 Use trusted Guardian templates for managed policies @won-openai - #60647 Restore PowerShell's working directory in the MXC sandbox @zm-oai - #60651 Enable model and reasoning effort selection for Cloud conversations @bc-openai - #60655 Support environment updates in app-server settings APIs @sayan-oai - #60662 Support gateway device-code sign-in in headless TUI sessions @smurching-oai - #60663 Defer exec-server sandbox preparation to the execution host @viyatb-oai - #60665 Add a content helper for forwarding MCP blocks in Code Mode @cconger - #60669 Skip submodule worktree scans when checking repository changes @dhavalkapil-oai - #60670 Initialize Guardian evidence cursors from thread history state @felixxia-oai - #60671 Add sign-only mode and tighten macOS signing verification @tarunoai - #60673 Preserve agent message deliveries in rollout traces @cassirer-openai - #60675 Avoid redundant reads and screen clears when switching side chats @fcoury-oai - #60680 Keep TUI status content separate from composer hints @joesavona - #60681 Prioritize draft space when allocating