Primary navigation

Codex changelog

Latest updates to Codex, OpenAI's coding agent

November 2025 October 2025 September 2025 August 2025 June 2025 May 2025

November 2025

  • Usage and credits fixes

    Minor updates to address a few issues with Codex usage and credits:

    • Adjusted all usage dashboards to show “limits remaining” for consistency. The CLI previously displayed “limits used.”
    • Fixed an issue preventing users from buying credits if their ChatGPT subscription was purchased via iOS or Google Play.
    • Fixed an issue where the CLI could display stale usage information; it now refreshes without needing to send a message first.
    • Optimized the backend to help smooth out usage throughout the day, irrespective of overall Codex load or how traffic is routed. Before, users could get unlucky and hit a few cache misses in a row, leading to much less usage.

  • Codex CLI 0.63.0

  • Codex CLI 0.61.0 

    $ npm install -g @openai/codex@0.61.0
    View details

    Highlights

    • ExecPolicy2 integration and exec-server prep: core now integrates ExecPolicy2 with exec-server refactors and cutover groundwork, plus quickstart docs to help teams adopt the new policy engine.
    • Improved truncation and error reporting: single-pass truncation reduces duplicate work, and error events can now carry optional status codes for clearer observability.
    • Shell reliability and sandbox warnings: fallback shell selection is hardened and world-writable directory warnings are less noisy, including improved messaging on Windows.
    • UX fixes: corrected reasoning display, preserved review footer context after /review, and the model migration screen now shows only once.

    PRs Merged

    Full release on Github

  • Codex CLI 0.60.1

  • Codex CLI 0.59.0 

    $ npm install -g @openai/codex@0.59.0
    View details

    Highlights

    • GPT-5.1-Codex-Max: introducing our newest frontier agentic coding model. GPT-5.1-Codex-Max delivers higher reliability, faster iteration, and support for long-running, project-scale workflows. Learn more at https://www.openai.com/index/gpt-5-1-codex-max
    • Native Compaction Support: added first-class support for Compaction, improving performance across extended coding sessions.
    • Expanded Tool Token Limits: codex models now support up to 10,000 tool output tokens. Configure this via tool_output_token_limit in config.toml.
    • Windows Agent mode: Introduced Agent mode for native Windows. Codex can read files, write files, and run commands in your working folder with fewer approvals. Agent mode uses a new experimental Windows sandbox to limit filesystem and network access. Learn more at https://developers.openai.com/codex/windows
    • TUI and UX Improvements
      • Eliminated ghost snapshot notifications when no git repository is present.
      • Codex Resume now displays branches and respects the current working directory for filtering.
      • Added placeholder icons for images.
      • Credits are now visible in /status.

    PRs Merged

    • fix: don't truncate at new lines (#6907) — @aibrahim
    • feat: arcticfox in the wild (#6906) — @aibrahim
    • [app-server] populate thread>turns>items on thread/resume (#6848) — @owenlin0
    • nit: useless log to debug (#6898) — @jif
    • fix(core) Support changing /approvals before conversation (#6836) — @dylan.hurd
    • chore: consolidate compaction token usage (#6894) — @jif
    • chore(app-server) world-writable windows notification (#6880) — @dylan.hurd
    • fix: parallel tool call instruction injection (#6893) — @jif
    • nit: stable (#6895) — @jif
    • feat: warning large commits (#6838) — @jif
    • fix label (#6892) — @tibo
    • Move shell to use truncate_text (#6842) — @aibrahim
    • Run remote auto compaction (#6879) — @pakrym
    • flaky-unified_exec_formats_large_output_summary (#6884) — @aibrahim
    • shell_command returns freeform output (#6860) — @pakrym
    • chore(core) arcticfox (#6876) — @dylan.hurd
    • fix(tui) ghost snapshot notifications (#6881) — @dylan.hurd
    • fix: typos in model picker (#6859) — @aibrahim
    • chore: update windows docs url (#6877) — @AE
    • feat: tweak windows sandbox strings (#6875) — @AE
    • fix: add more fields to ThreadStartResponse and ThreadResumeResponse (#6847) — @mbolin
    • chore: update windows sandbox docs (#6872) — @AE
    • Remote compaction on by-default (#6866) — @pakrym
    • [app-server] introduce turn/completed v2 event (#6800) — @celia
    • update credit status details (#6862) — @zhao
    • tui: add branch to 'codex resume', filter by cwd (#6232) — @172423086+nornagon-openai
    • smoketest for browser vuln, rough draft of Windows security doc (#6822) — @iceweasel
    • windows sandbox: support multiple workspace roots (#6854) — @iceweasel
    • updating codex backend models (#6855) — @zhao
    • exec-server (#6630) — @172423086+nornagon-openai
    • Fix tests so they don't emit an extraneous config.toml in the source tree (#6853) — @etraut
    • [app-server-test-client] feat: auto approve command (#6852) — @owenlin0
    • Improved runtime of generated_ts_has_no_optional_nullable_fields test (#6851) — @etraut
    • fix: local compaction (#6844) — @jif
    • Fix typo in config.md for MCP server (#6845) — @simcoea
    • [codex][otel] support mtls configuration (#6228) — @apanasenko
    • feat: review in app server (#6613) — @jif
    • chore(config) enable shell_command (#6843) — @dylan.hurd
    • Prompt to turn on windows sandbox when auto mode selected. (#6618) — @iceweasel
    • Add the utility to truncate by tokens (#6746) — @aibrahim
    • Update faq.md section on supported models (#6832) — @adpena
    • fixing localshell tool calls (#6823) — @zhao
    • feat: enable parallel tool calls (#6796) — @jif
    • feat: remote compaction (#6795) — @jif
    • nit: app server (#6830) — @jif
    • nit: mark ghost commit as stable (#6833) — @jif
    • feat: git branch tooling (#6831) — @jif
    • 🐛 fix(rmcp-client): refresh OAuth tokens using expires_at (#6574) — @LaelLuo
    • fix(windows) shell_command on windows, minor parsing (#6811) — @dylan.hurd
    • chore(core) Add shell_serialization coverage (#6810) — @dylan.hurd
    • Update defaults to gpt-5.1 (#6652) — @aibrahim
    • Demote function call payload log to debug to avoid noisy error-level stderr (#6808) — @Cassirer
    • execpolicy2 extension (#6627) — @zhao
    • [app-server] feat: add v2 command execution approval flow (#6758) — @owenlin0
    • background rate limits fetch (#6789) — @zhao
    • move cap_sid file into ~/.codex so the sandbox cannot overwrite it (#6798) — @iceweasel
    • Fix TUI issues with Alt-Gr on Windows (#6799) — @etraut
    • core: add a feature to disable the shell tool (#6481) — @172423086+nornagon-openai
    • chore(core) Update shell instructions (#6679) — @dylan.hurd
    • fix: annotate all app server v2 types with camelCase (#6791) — @owenlin0
    • LM Studio OSS Support (#2312) — @Rugved
    • [app-server] add events to readme (#6690) — @celia
    • core/tui: non-blocking MCP startup (#6334) — @172423086+nornagon-openai
    • chore: delete chatwidget::tests::binary_size_transcript_snapshot tui test (#6759) — @owenlin0
    • feat: execpolicy v2 (#6467) — @zhao
    • nit: personal git ignore (#6787) — @jif
    • tmp: drop sccache for windows 2 (#6775) — @jif
    • feat: placeholder for image that can't be decoded to prevent 400 (#6773) — @jif
    • fix(core) serialize shell_command (#6744) — @dylan.hurd
    • Fix FreeBSD/OpenBSD builds: target-specific keyring features and BSD hardening (#6680) — @jinxiaoyong
    • Exempt the "codex" github user from signing the CLA (#6724) — @etraut
    • chore(deps): bump actions/github-script from 7 to 8 (#6755) — @49699333+dependabot[bot]
    • Fix: Claude models return incomplete responses due to empty finish_reason handling (#6728) — @dulikaifazr
    • Fix AltGr/backslash input on Windows Codex terminal (#6720) — @pornotato
    • Revert "tmp: drop sccache for windows (#6673)" (#6751) — @etraut
    • fix: resolve Windows MCP server execution for script-based tools (#3828) — @jlee14281
    • Fix documentation errors for Custom Prompts named arguments and add canonical examples (#5910) — @169171880+Sayeem3051
    • Tighten panic on double truncation (#6701) — @aibrahim
    • Improve compact (#6692) — @aibrahim
    • Refactor truncation helpers into its own file (#6683) — @aibrahim
    • Revert "templates and build step for validating/submitting winget package" (#6696) — @aibrahim
    • ci: only run CLA assistant for openai org repos (#6687) — @joshka
    • Handle "Don't Trust" directory selection in onboarding (#4941) — @viniciusmotta8
    • Ignore unified_exec_respects_workdir_override (#6693) — @pakrym
    • Order outputs before inputs (#6691) — @pakrym
    • feat: add app-server-test-client crate for internal use (#5391) — @owenlin0
    • fix codex detection, add new security-focused smoketests. (#6682) — @iceweasel
    • feat(ts-sdk): allow overriding CLI environment (#6648) — @lopopolo
    • templates and build step for validating/submitting winget package (#6485) — @iceweasel
    • Add test timeout (#6612) — @pakrym
    • Enable TUI notifications by default (#6633) — @172423086+nornagon-openai
    • tmp: drop sccache for windows (#6673) — @jif
    • [App server] add mcp tool call item started/completed events (#6642) — @celia
    • feat: cache tokenizer (#6609) — @jif
    • feat: better UI for unified_exec (#6515) — @jif
    • feat: add resume logs when doing /new (#6660) — @jif
    • tests: replace mount_sse_once_match with mount_sse_once for SSE mocking (#6640) — @pakrym
    • Promote shared helpers for suite tests (#6460) — @aibrahim
    • Use shared network gating helper in chat completion tests (#6461) — @aibrahim
    • Avoid double truncation (#6631) — @aibrahim
    • Revert "Revert "Overhaul shell detection and centralize command generation for unified exec"" (#6607) — @pakrym
    • [app-server] small fixes for JSON schema export and one-of types (#6614) — @owenlin0
    • [App-server] add new v2 events:item/reasoning/delta, item/agentMessage/delta & item/reasoning/summaryPartAdded (#6559) — @celia
    • chore(core) Consolidate apply_patch tests (#6545) — @dylan.hurd
    • Only list failed tests (#6619) — @pakrym
    • feat: Add support for --add-dir to exec and TypeScript SDK (#6565) — @33551757+danfhernandez
    • Add AbortSignal support to TypeScript SDK (#6378) — @33551757+danfhernandez
    • Enable close-stale-contributor-prs.yml workflow (#6615) — @pakrym
    • Update default yield time (#6610) — @pakrym
    • Close stale PRs workflow (#6594) — @pakrym
    • Migrate prompt caching tests to test_codex (#6605) — @pakrym
    • Revert "Overhaul shell detection and centralize command generation for unified exec" (#6606) — @pakrym
    • Overhaul shell detection and centralize command generation for unified exec (#6577) — @pakrym

    Full release on Github

  • Introducing GPT-5.1-Codex-Max

    Today we are releasing GPT-5.1-Codex-Max, our new frontier agentic coding model.

    GPT‑5.1-Codex-Max is built on an update to our foundational reasoning model, which is trained on agentic tasks across software engineering, math, research, and more. GPT‑5.1-Codex-Max is faster, more intelligent, and more token-efficient at every stage of the development cycle–and a new step towards becoming a reliable coding partner.

    Starting today, the CLI and IDE Extension will default to gpt-5.1-codex-max for users that are signed in with ChatGPT. API access for the model will come soon.

    For non-latency-sensitive tasks, we’ve also added a new Extra High (xhigh) reasoning effort, which lets the model think for an even longer period of time for a better answer. We still recommend medium as your daily driver for most tasks.

    If you have a model specified in your config.toml configuration file, you can instead try out gpt-5.1-codex-max for a new Codex CLI session using:

    codex --model gpt-5.1-codex-max

    You can also use the /model slash command in the CLI. In the Codex IDE Extension you can select GPT-5.1-Codex from the dropdown menu.

    If you want to switch for all sessions, you can change your default model to gpt-5.1-codex-max by updating your config.toml configuration file:

    model = "gpt-5.1-codex-max”

  • Introducing GPT-5.1-Codex and GPT-5.1-Codex-Mini

    Along with the GPT-5.1 launch in the API, we are introducing new gpt-5.1-codex-mini and gpt-5.1-codex model options in Codex, a version of GPT-5.1 optimized for long-running, agentic coding tasks and use in coding agent harnesses in Codex or Codex-like harnesses.

    Starting today, the CLI and IDE Extension will default to gpt-5.1-codex on macOS and Linux and gpt-5.1 on Windows.

    If you have a model specified in your config.toml configuration file, you can instead try out gpt-5.1-codex for a new Codex CLI session using:

    codex --model gpt-5.1-codex

    You can also use the /model slash command in the CLI. In the Codex IDE Extension you can select GPT-5.1-Codex from the dropdown menu.

    If you want to switch for all sessions, you can change your default model to gpt-5.1-codex by updating your config.toml configuration file:

    model = "gpt-5.1-codex”

  • Codex CLI 0.58.0 

    $ npm install -g @openai/codex@0.58.0
    View details

    Highlights

    • Support for gpt5.1 models family. Read more
    • App server enhancements: new JSON schema generator command, item started/completed events, macro cleanup, reduced boilerplate, and tightened duplicate-code hygiene (#6406 #6517 #6470 #6488).
    • Quality of life fixes: doc updates (web_search, SDK, config), TUI shortcuts inline, seatbelt/Wayland/brew/compaction/cloud-tasks bugfixes, clearer warnings, auth-aware status output, and OTEL test stabilization (#5889 #6424 #6425 #6376 #6421 #4824 #6238 #5856 #6446 #6529 #6541).

    PRs Merged

    • #6381 — Improve world-writable scan (917f39ec1)
    • #5889 — feat(tui): Display keyboard shortcuts inline for approval options (5beb6167c)
    • #6389 — more world-writable warning improvements (a47181e47)
    • #6425 — Fix SDK documentation: replace “file diffs” with “file change notifications” (8b80a0a26)
    • #6421 — fix(seatbelt): Allow reading hw.physicalcpu (c07461e6f)
    • #5856 — fix(cloud-tasks): respect cli_auth_credentials_store config (5f1fab0e7)
    • #6387 — For npm upgrade on Windows, go through cmd.exe to get path traversal working (625f2208c)
    • #6437 — chore(deps): bump codespell-project/actions-codespell from 2.1 to 2.2 (7c7c7567d)
    • #6438 — chore(deps): bump taiki-e/install-action from 2.60.0 to 2.62.49 (082d2fa19)
    • #6443 — chore(deps): bump askama from 0.12.1 to 0.14.0 in /codex-rs (78b2aeea5)
    • #6444 — chore(deps): bump zeroize from 1.8.1 to 1.8.2 in /codex-rs (e2598f509)
    • #6446 — Fix warning message phrasing (131c38436)
    • #6424 — Fix config documentation: correct TOML parsing description (557ac6309)
    • #6454 — Move compact (50a77dc13)
    • #6376 — Updated docs to reflect recent changes in web_search configuration (65cb1a1b7)
    • #6407 — fix: use generate_ts from app_server_protocol (42683dadf)
    • #6419 — Support exiting from the login menu (b46012e48)
    • #6422 — Don’t lock PRs that have been closed without merging (591615315)
    • #6406 — [app-server] feat: add command to generate json schema (fbdedd9a0)
    • #6238 — fix: update brew auto update version check (788badd22)
    • #6433 — Add opt-out for rate limit model nudge (e743d251a)
    • #6246 — Add user command event types (980886498)
    • #6466 — feat: add workdir to unified_exec (f01f2ec9e)
    • #6468 — [app-server] chore: move initialize out of deprecated API section (2ac49fea5)
    • #4824 — Fix wayland image paste error (52e97b9b6)
    • #4098 — add codex debug seatbelt --log-denials (0271c20d8)
    • #6477 — refactor(tui): job-control for Ctrl-Z handling (60deb6773)
    • #6470 — [app-server] update macro to make renaming methods less boilerplate-y (3838d6739)
    • #6478 — upload Windows .exe file artifacts for CLI releases (9aff64e01)
    • #6482 — flip rate limit status bar (930f81a17)
    • #6480 — Use codex-linux-sandbox in unified exec (6c36318bd)
    • #6489 — Colocate more of bash parsing (bb7b0213a)
    • #6488 — [hygiene][app-server] have a helper function for duplicate code in turn APIs (695187277)
    • #6041 — Enable ghost_commit feature by default (052b05283)
    • #6503 — nit: logs to trace (ad279eacd)
    • #6492 — Add unified exec escalation handling and tests (807e2c27f)
    • #6517 — [app-server] add item started/completed events for turn items (e357fc723)
    • #6523 — Update full-auto description with on-request (eb1c651c0)
    • #6528 — Re-add prettier log-level=warn to generate-ts (424bfecd0)
    • #6507 — feat: warning switch model on resume (530db0ad7)
    • #6510 — feat: shell_command tool (29364f3a9)
    • #6516 — chore: verify boolean values can be parsed as config overrides (c3a710ee1)
    • #6541 — Fix otel tests (7d9ad3eff)
    • #6534 — feat: only wait for mutating tools for ghost commit (e00eb50db)
    • #6529 — Fixed status output to use auth information from AuthManager (ad09c138b)
    • #6551 — Add gpt-5.1 model definitions (ec69a4a81)
    • #6558 — Do not double encode request bodies in logging (2f58e6999)
    • #6483 — [app-server] feat: thread/resume supports history, path, and overrides (964220ac9)
    • #6561 — NUX for gpt5.1 (e63ab0dd6)
    • #6568 — Set verbosity to low for 5.1 (f97874093)
    • #6567 — Update subtitle of model picker as part of the nux (966d71c02)
    • #6569 — Change model picker to include gpt5.1 (ad7eaa80f)
    • #6575 — Avoid hang when tool’s process spawns grandchild that shares stderr/stdout (73ed30d7e)
    • #6580 — remove porcupine model slug (b1979b70a)
    • #6583 — feat: show gpt mini (e3aaee00c)
    • #6585 — copy for model migration nudge (305fe73d8)
    • #6586 — Reasoning level update (e3dd362c9)
    • #6593 — Default to explicit medium reasoning for 5.1 (34621166d)
    • #6588 — chore(core) Update prompt for gpt-5.1 (8dcbd29ed)
    • #6597 — feat: proxy context left after compaction (2a417c47a)
    • #6589 — fix model picker wrapping (ba74cee6f)

    Full release on Github

  • Codex CLI 0.57.0 

    $ npm install -g @openai/codex@0.57.0
    View details

    Highlights

    • TUI quality-of-life: ctrl-n/p navigation for slash command lists and backtracking skips the /status noise.
    • Improve timeout on long running commasnds

    PRs Merged

    • #6233 – Freeform unified exec output formatting
    • #6342 – Make generate_ts prettier output warn-only
    • #6335 – TUI: fix backtracking past /status
    • #1994 – Enable CTRL-n/CTRL-p for navigating slash commands, files, history
    • #6340 – Skip retries on insufficient_quota errors
    • #6345 – Remove shell tool when unified exec is enabled
    • #6347 – Refresh AI labeler rules to match issue tracker labels
    • #6346 – Prefer wait_for_event over wait_for_event_with_timeout (initial update)
    • #5486 – Fix apply_patch rename/move path resolution
    • #6349 – Prefer wait_for_event over wait_for_event_with_timeout (follow-up)
    • #6336 – App-server: implement account/read endpoint
    • #6338 – App-server: expose additional fields on Thread
    • #6353 – App-server: add auth v2 doc & update Codex MCP interface section
    • #6368 – App-server: README updates for threads and turns
    • #6351 – Promote shell config tool to model family config
    • #6369 – TUI: add inline comments to tui.rs
    • #6370 – Add --promote-alpha option to create_github_release script
    • #6367 – SDK: add network_access and web_search options to TypeScript SDK
    • #6097 (includes work from #6086) – WSL: normalize Windows paths during update
    • #6377 – App-server docs: add initialization section
    • #6373 – Terminal refactor: remove deprecated flush logic
    • #6252 – Core: replace Cloudflare 403 HTML with friendly message
    • #6380 – Unified exec: allow safe commands without approval
    • #5258 – Kill shell tool process groups on timeout

    Full release on Github

  • Introducing GPT-5-Codex-Mini

    Today we are introducing a new gpt-5-codex-mini model option to Codex CLI and the IDE Extension. The model is a smaller, more cost-effective, but less capable version of gpt-5-codex that provides approximately 4x more usage as part of your ChatGPT subscription.

    Starting today, the CLI and IDE Extension will automatically suggest switching to gpt-5-codex-mini when you reach 90% of your 5-hour usage limit, to help you work longer without interruptions.

    You can try the model for a new Codex CLI session using:

    codex --model gpt-5-codex-mini

    You can also use the /model slash command in the CLI. In the Codex IDE Extension you can select GPT-5-Codex-Mini from the dropdown menu.

    Alternatively, you can change your default model to gpt-5-codex-mini by updating your config.toml configuration file:

    model = "gpt-5-codex-mini”

  • Codex CLI 0.56.0 

    $ npm install -g @openai/codex@0.56.0
    View details

    Highlights

    • Introducing our new model GPT-5-Codex-Mini — a more compact and cost-efficient version of GPT-5-Codex

    PRs merged

    • #6211 fix: Update the deprecation message to link to the docs
    • #6212 [app-server] feat: export.rs supports a v2 namespace, initial v2
      notifications
    • #6230 Fix nix build
    • #3643 fix(core): load custom prompts from symlinked Markdown files
    • #4200 allow codex to be run from pid 1
    • #6234 Upgrade rmcp to 0.8.4
    • #6237 Add modelReasoningEffort option to TypeScript SDK
    • #5565 tui: refactor ChatWidget and BottomPane to use Renderables
    • #6229 refactor Conversation history file into its own directory
    • #6231 Improved token refresh handling to address “Re-connecting” behavior
    • #6261 Update rmcp to 0.8.5
    • #6214 [app-server] feat: v2 Thread APIs
    • #6282 Fixes intermittent test failures in CI
    • #6249 stop capturing r when environment selection modal is open
    • #6183 [App-server] Implement v2 for account/login/start and account/login/completed
    • #6285 Prevent dismissal of login menu in TUI
    • #4388 fix: ToC so it doesn’t include itself or duplicate the end marker
    • #6288 [App-server] Add account/login/cancel v2 endpoint
    • #6286 feat: add model nudge for queries
    • #6300 feat: support models with single reasoning effort
    • #6319 chore: rename for clarity
    • #6216 [app-server] feat: v2 Turn APIs
    • #6295 docs: Fix code fence and typo in advanced guide
    • #6326 chore: fix grammar mistakes
    • #6283 Windows Sandbox: Show Everyone-writable directory warning
    • #6289 chore: move relevant tests to app-server/tests/suite/v2
    • #6333 feat: clarify that gpt-5-codex should not amend commits unless requested
    • #6332 Updated contributing guidelines and PR template to request link to bug report
      in PR notes
    • #5980 core: widen sandbox to allow certificate ops when network is enabled
    • #6337 [App Server] Add more session metadata to listConversations

    Full release on Github

  • GPT-5-Codex model update

    We’ve shipped a minor update to GPT-5-Codex:

    • More reliable file edits with apply_patch.
    • Fewer destructive actions such as git reset.
    • More collaborative behavior when encountering user edits in files.
    • 3% more efficient in time and usage.

  • Codex CLI 0.55.0 

    $ npm install -g @openai/codex@0.55.0
    View details

    Highlights

    #6222 reverted #6189, fixing #6220 (and other similar reports of the Codex CLI failing to start on Linux).

    Merged PRs

    • #6222 Revert "fix: pin musl 1.2.5 for DNS fixes"
    • #6208 ignore deltas in codex_delegate

    Full release on Github

  • Codex CLI 0.54.0 

    $ npm install -g @openai/codex@0.54.0
    View details

    ⚠️ WARNING: Attempting to pin musl 1.2.5 for DNS fixes in #6189 turned out to be the wrong fix. We reverted it in #6222 and published 0.55.0.

    Otherwise, this release was mostly bugfixes and documentation tweaks.

    Merged PRs

    • #6189 fix: pin musl 1.2.5 for DNS fixes (#6189)
    • #6202 fix: ignore reasoning deltas because we send it with turn item (#6202)
    • #6175 [App-server] v2 for account/updated and account/logout (#6175)
    • #6156 Fix is_api_message to correctly exclude reasoning messages (#6156)
    • #4453 Follow symlinks during file search (#4453)
    • #5175 docs: add example config.toml (#5175)
    • #6180 fix: --search shouldn't show deprecation message (#6180)
    • #6143 Fixed notify handler so it passes correct input_messages details (#6143)
    • #6171 log sandbox commands to $CODEX_HOME instead of cwd (#6171)
    • #5996 feat: add the time after aborting (#5996)
    • #5541 tui: refine text area word separator handling (#5541)
    • #6167 Do not skip trust prompt on Windows if sandbox is enabled. (#6167)
    • #6129 feat: add options to responses-api-proxy to support Azure (#6129)
    • #6161 Include reasoning tokens in the context window calculation (#6161)
    • #6051 Fix rmcp client feature flag reference (#6051)
    • #6159 Fix typo in error message for OAuth login (#6159)
    • #5685 Add documentation for slash commands in docs/slash_commands.md. (#5685)
    • #6111 fix: improve usage URLs in status card and snapshots (#6111)
    • #6124 Fix "archive conversation" on Windows (#6124)
    • #6137 chore(deps): bump actions/upload-artifact from 4 to 5 (#6137)
    • #4903 fix: pasting api key stray character (#4903)
    • #6131 Fix incorrect "deprecated" message about experimental config key (#6131)
    • #6091 Changes to sandbox command assessment feature based on initial experiment feedback (#6091)
    • #5956 Parse the Azure OpenAI rate limit message (#5956)
    • #5649 docs: Fix link anchor and markdown format in advanced guide (#5649)
    • #5659 Fixing small typo in docs (#5659)
    • #5935 tui: patch crossterm for better color queries (#5935)
    • #6050 [codex][app-server] improve error response for client requests (#6050)
    • #4973 docs: fix broken link in contributing guide (#4973)
    • #6027 feat: compactor 2 (#6027)
    • #6052 Add warning on compact (#6052)
    • #6043 chore: Add shell serialization tests for json (#6043)
    • #5979 Truncate total tool calls text (#5979)
    • #4797 docs: "Configuration" is not belongs "Getting started" (#4797)
    • #4804 chore(deps): bump indexmap from 2.10.0 to 2.11.4 in /codex-rs (#4804)
    • #4802 chore(deps): bump anyhow from 1.0.99 to 1.0.100 in /codex-rs (#4802)
    • #4800 chore(deps): bump actions/checkout from 4 to 5 (#4800)
    • #4801 chore(deps): bump actions/github-script from 7 to 8 (#4801)
    • #6045 fix: brew upgrade link (#6045)
    • #6034 test: undo (#6034)
    • #4426 chore(deps): bump thiserror from 2.0.16 to 2.0.17 in /codex-rs (#4426)
    • #6010 Update user instruction message format (#6010)
    • #4266 fix(tui): propagate errors in insert_history_lines_to_writer (#4266)

    Full release on Github

October 2025

  • Codex CLI 0.53.0 

    $ npm install -g @openai/codex@0.53.0
    View details

    Highlights

    • Fixing error 400 issues
    • Improve sandboxing for Java

    PRs

    #5897 – codex: add developer instructions
    #5939 – app-server: remove serde(skip_serializing_if = "Option::is_none") annotations
    #3754 – docs: add missing period
    #5976 – hygiene: remove include_view_image_tool config
    #3987 – fix: update Seatbelt policy for Java on macOS
    #4905 – Windows Sandbox alpha version
    #5997 – build: bump Windows stack size to 8 MB
    #5986 – remove last-turn reasoning filtering
    #6005 – app-server: split API types into v1 and v2
    #6002 – feat: add /exit slash-command alias for quit
    #6000 – rate-limit errors now return absolute time
    #4144 – docs: fix markdown list spacing in review_prompt.md
    #6007 – override verbosity for gpt-5-codex

    Full release on Github

  • Credits on ChatGPT Pro and Plus

    Codex users on ChatGPT Plus and Pro can now use on-demand credits for more Codex usage beyond what’s included in your plan. Learn more.

  • Codex CLI 0.52.0 

    $ npm install -g @openai/codex@0.52.0
    View details

    Highlights

    • TUI polish: queued messages visible during streaming; Windows auto-mode guidance; undo op; compaction prompt configurable.
    • Images: client-side image resizing; prevent crashes with MIME verification; SDK image forwarding tests re-enabled.
    • Execute commands directly with !<cmd>
    • Ability to buy credits for more usage. More information

    Other improvements

    • Auth: new CLI auth storage abstraction with keyring support and configurable backend.
    • App server: GetConversationSummary RPC; fetch/resume conversation summaries by id; refined account/protocol types.
    • Execution/events: item streaming events; ghost commits; clearer deprecation warnings; better token refresh handling and logs.
    • Conversation management: centralized truncation for all tool outputs; filter out prior-turn reasoning; annotate conversations with model_provider.

    List of merged PRs

    1. Log HTTP Version in #5475
    2. feat: local tokenizer in #5508
    3. chore: drop approve all in #5503
    4. [MCP] Add support for specifying scopes for MCP oauth in #5487
    5. chore: clean spec tests in #5517
    6. [MCP] Remove the legacy stdio client in favor of rmcp in #5529
    7. [app-server] send account/rateLimits/updated notifications in #5477
    8. Fix unified exec session id test helper in #5535
    9. [app-server] add new account method API stubs in #5527
    10. chore: clean handle_container_exec_with_params in #5516
    11. fix: approval issue in #5525
    12. tui: show aggregated output in display in #5539
    13. Handle cancelling/aborting while processing a turn in #5543
    14. chore: testing on apply_path in #5557
    15. feat: use actual tokenizer for unified_exec truncation in #5514
    16. feat: end events on unified exec in #5551
    17. Use Option symbol for mac key hints in #5582
    18. Moving token_info to ConversationHistory in #5581
    19. [MCP] Update rmcp to 0.8.3 in #5542
    20. [MCP] Improve startup errors for timeouts and github in #5595
    21. fix: flaky tests in #5625
    22. adding messaging for stale rate limits + when no rate limits are cached in #5570
    23. Add CodexHttpClient wrapper with request logging in #5564
    24. [app-server] fix account/read response annotation in #5642
    25. Add instruction for upgrading codex with brew in #5640
    26. Log more types of request IDs in #5645
    27. Added model summary and risk assessment for commands that violate sandbox policy in #5536
    28. [MCP] Redact environment variable values in /mcp and mcp get in #5648
    29. [MCP] Properly gate login after mcp add with experimental_use_rmcp_client in #5653
    30. [codex][app-server] introduce codex/event/raw_item events in #5578
    31. Fixed flaky unit test in #5654
    32. Improve feedback in #5661
    33. Followup feedback in #5663
    34. Skip flaky test in #5680
    35. Added support for sandbox_mode in profiles in #5686
    36. Reduced runtime of unit test that was taking multiple minutes in #5688
    37. [MCP] Minor docs clarifications around stdio tokens in #5676
    38. fix: use codex-exp prefix for experimental models and consider codex- models to be production in #5797
    39. fix: revert "[app-server] fix account/read response annotation (#5642)" in #5796
    40. Add feedback upload request handling in #5682
    41. feat: annotate conversations with model_provider for filtering in #5658
    42. feat: update NewConversationParams to take an optional model_provider in #5793
    43. feat: undo wiring in #5630
    44. feat: async ghost commit in #5618
    45. feat: TUI undo op in #5629
    46. nit: doc on session task in #5809
    47. chore: undo nits in #5631
    48. fix: test yield time in #5811
    49. feat: introduce GetConversationSummary RPC in #5803
    50. feat: return an error if unknown enabled/disabled feature in #5817
    51. Made token refresh code resilient to missing id_token in #5782
    52. [Auth] Introduce New Auth Storage Abstraction for Codex CLI in #5569
    53. feat: support verbosity in model_family in #5821
    54. [Auth] Add keyring support for Codex CLI in #5591
    55. Centralize truncation in conversation history in #5652
    56. fix: move account struct to app-server-protocol and use camelCase in #5829
    57. [MCP] Render MCP tool call result images to the model in #5600
    58. fix image drag drop in #5794
    59. Truncate the content-item for mcp tools in #5835
    60. feat(tui): clarify Windows auto mode requirements in #5568
    61. [Auth] Choose which auth storage to use based on config in #5792
    62. chore: speed-up pipeline in #5812
    63. chore: drop useless shell stuff in #5848
    64. chore: use anyhow::Result for all app-server integration tests in #5836
    65. chore: decompose submission loop in #5854
    66. fix advanced.md in #5833
    67. tui: show queued messages during response stream in #5540
    68. Filter out reasoning items from previous turns in #5857
    69. revert #5812 release file in #5887
    70. remove beta experimental header in #5892
    71. Fixed bug that results in a sporadic hang when attaching images in #5891
    72. verify mime type of images in #5888
    73. [app-server] Annotate more exported types with a title in #5879
    74. [App Server] Allow fetching or resuming a conversation summary from the conversation id in #5890
    75. [codex][app-server] resume conversation from history in #5893
    76. Refresh tokens more often and log a better message when both auth and token refresh fails in #5655
    77. fix(windows-path): preserve PATH order; include core env vars in #5579
    78. chore: merge git crates in #5909
    79. feat: deprecation warning in #5825
    80. feat: add output even in sandbox denied in #5908
    81. Add missing "nullable" macro to protocol structs that contain optional fields in #5901
    82. Add a wrapper around raw response items in #5923
    83. fix: icu_decimal version in #5919
    84. chore: config editor in #5878
    85. Delegate review to codex instance in #5572
    86. [exec] Add MCP tool arguments and results in #5899
    87. Add item streaming events in #5546
    88. Re-enable SDK image forwarding test in #5934
    89. ignore agent message deltas for the review mode in #5937
    90. asdf in #5940
    91. Add debug-only slash command for rollout path in #5943
    92. Add debug-only slash command for rollout path in #5936
    93. Send delegate header in #5942
    94. chore: unify config crates in #5958
    95. Pass initial history as an optional to codex delegate in #5950
    96. feat: compaction prompt configurable in #5959
    97. nit: log rmcp_client in #5978
    98. chore: testing on freeform apply_patch in #5952
    99. [codex] add developer instructions in #5897
    100. [app-server] remove serde(skip_serializing_if = "Option::is_none") annotations in #5939

    Full release on Github

  • Codex CLI 0.50.0 

    $ npm install -g @openai/codex@0.50.0
    View details

    Highlights

    • Improved /feedback to get better diagnostics. Please use it to report any issues. (#5661, #5663).

    Merged PRs

    Full release on Github

  • Codex CLI 0.49.0

  • Codex CLI 0.48.0 

    $ npm install -g @openai/codex@0.48.0
    View details

    Highlights

    • --add-dir to add an additional working directory.
    • Many MCP improvements:
      • stdio servers now use a new client backed by the official rust MCP sdk
      • stdio servers can specify a cwd
      • All servers can specify enabled_tools or disabled_tools
      • Streamable HTTP servers can specify scopes during codex mcp login
      • Improved startup error messages
      • Better instruction following for calling tools
    • Configuration options for forced_login_method and forced_chatgpt_workspace_id which can be paired with managed configs to give enterprises more control over Codex usage.

    Full list of merged PRs:

    New Contributors

    Full Changelog: rust-v0.47.0...rust-v0.48.0

    Full release on Github

  • Tag @Codex on GitHub Issues and PRs

    You can now tag @codex on a teammate’s pull request to ask clarifying questions, request a follow-up, or ask Codex to make changes. GitHub Issues now also support @codex mentions, so you can kick off tasks from any issue, without leaving your workflow.

    Codex responding to a GitHub pull request and issue after an @Codex mention.

  • Codex CLI 0.47.0 

    $ npm install -g @openai/codex@0.47.0
    View details

    Highlights

    • Improvements and bug-fixes in Codex CLI
    • Code signing binaries on MacOS
    • Auto update banner
    • 🆕 Warning when enabling "full access" mode

    Full list of merged PRs:

    • Indentation mode for read_file (#4887)
    • Message when stream get correctly resumed (#4988)
    • Make shortcut works even with capslock (#5049)
    • Discard prompt starting with a slash (#5048)
    • Add header for task kind (#5142)
    • Pass codex thread ID in notifier metadata (#4582)
    • Updated github issue template (#5191)
    • Agent override file (#5215)
    • Prompt mcp login when adding a streamable HTTP server that supports oauth (#5193)
    • Add parsed command to ExecApprovalRequestEvent (#5222)
    • Add warning about rate limit when using high effort (#5035)
    • Auto update approval (#5185)
    • Add macOS notarization step to release workflow (#5233)
    • Add confirmation prompt for enabling full access approvals (#4980)
    • Add path field to ParsedCommand::Read variant (#5275)
    • Better UX during refusal (#5260)
    • Lagged output in unified_exec buffer (#4992)
    • Sandbox denied error logs (#4874)
    • Add code signing for MacOS binary (#4899)
    • Fix wrapping in user approval decisions (#5008)
    • Fix wrapping in trust_directory (#5007)
    • /diff mode wraps long lines (#4891)
    • Fix crash when alt+bksp past unicode nbsp (#5016)
    • Include the image name in the textarea placeholder (#5056)
    • Detect Bun installs in CLI update banner (#5074)
    • Add dangerous auto-approval for codex exec (#5043)
    • Update tui to sandbox_workspace_write (#3341)
    • Codex cloud exec (#5060)

    Full release on Github

  • Codex CLI 0.46.0 

    $ npm install -g @openai/codex@0.46.0
    View details

    Highlights

    Improved MCP support

    We are in the middle of significantly improving support for connecting to MCP servers including support for streamable http servers with optional bearer token or oauth login support.

    Enable the experimental_use_rmcp_client = true flag in config.toml to use the new MCP stack. If you encounter issues, create a GitHub issue and add the mcp label. We would like to remove the experimental flag soon and will continue to expand MCP support over time.

    What's Changed

    New Contributors

    Full Changelog: rust-v0.45.0...rust-v0.46.0

    Full release on Github

  • Codex is now GA

    Codex is now generally available with 3 new features — @Codex in Slack, Codex SDK, and new admin tools.

    @Codex in Slack

    You can now questions and assign tasks to Codex directly from Slack. See the Slack guide to get started.

    Codex SDK

    Integrate the same agent that powers the Codex CLI inside your own tools and workflows with the Codex SDK in Typescript. With the new Codex GitHub Action, you can easily add Codex to CI/CD workflows. See the Codex SDK guide to get started.

    import { Codex } from "@openai/codex-sdk";

const agent = new Codex();
const thread = await agent.startThread();

const result = await thread.run("Explore this repo");
console.log(result);

const result2 = await thread.run("Propose changes");
console.log(result2);

    New admin controls and analytics

    ChatGPT workspace admins can now edit or delete Codex Cloud environments. With managed config files, they can set safe defaults for CLI and IDE usage and monitor how Codex uses commands locally. New analytics dashboards help you track Codex usage and code review feedback. Learn more in the enterprise admin guide.

    Availability and pricing updates

    The Slack integration and Codex SDK are available to developers on ChatGPT Plus, Pro, Business, Edu, and Enterprise plans starting today, while the new admin features will be available to Business, Edu, and Enterprise. Beginning October 20, Codex Cloud tasks will count toward your Codex usage. Review the Codex pricing guide for plan-specific details.

  • Codex CLI 0.45.0 

    $ npm install -g @openai/codex@0.45.0
    View details

    Breaking changes

    codex login --api-key was replaced with codex login --with-api-key that reads the key from stdin to improve security.

    Sample usage:

    printenv OPENAI_API_KEY | codex login --with-api-key

    Highlights:

    • #4517 Experimental support for OAuth MCP server authentication

    Full list of merged PRs:

    • #4636 Replace --api-key with --with-api-key for logging into the CLI with an API key
    • #4644 Only write the final message to stdout for codex exec
    • #4676 Default to gpt-5 for Windows users who have not set a default model
    • #4689 Remove the requirement to use experimental_use_rmcp_client for streamable HTTP MCP servers that don't require OAuth
    • #4673 Fix colors when refocusing the terminal after a system theme update
    • #4694 Fix reasoning effort title
    • #4616 Updated device code login copy
    • #4706 Fix command output truncation that sometimes used too much of the context window
    • #4663 Initial parallel tool call support
    • #4736 Pulsing dot loading state

    Full release on Github

September 2025

  • GPT-5-Codex in the API

    GPT-5-Codex is now available in the Responses API, and you can also use it with your API Key in the Codex CLI. We plan on regularly updating this model snapshot. It is available at the same price as GPT-5. You can learn more about pricing and rate limits for this model on our model page.

  • Introducing GPT-5-Codex

    New model: GPT-5-Codex

    codex-switch-model

    GPT-5-Codex is a version of GPT-5 further optimized for agentic coding in Codex. It’s available in the IDE extension and CLI when you sign in with your ChatGPT account. It also powers the cloud agent and Code Review in GitHub.

    To learn more about GPT-5-Codex and how it performs compared to GPT-5 on software engineering tasks, see our announcement blog post.

    Image outputs

    codex-image-outputs

    When working in the cloud on front-end engineering tasks, GPT-5-Codex can now display screenshots of the UI in Codex web for you to review. With image output, you can iterate on the design without needing to check out the branch locally.

    New in Codex CLI

    • You can now resume sessions where you left off with codex resume.
    • Context compaction automatically summarizes the session as it approaches the context window limit.

    Learn more in the latest release notes

August 2025

  • Late August update

    IDE extension (Compatible with VS Code, Cursor, Windsurf)

    Codex now runs in your IDE with an interactive UI for fast local iteration. Easily switch between modes and reasoning efforts.

    Sign in with ChatGPT (IDE & CLI)

    One-click authentication that removes API keys and uses ChatGPT Enterprise credits.

    Move work between local ↔ cloud

    Hand off tasks to Codex web from the IDE with the ability to apply changes locally so you can delegate jobs without leaving your editor.

    Code Reviews

    Codex goes beyond static analysis. It checks a PR against its intent, reasons across the codebase and dependencies, and can run code to validate the behavior of changes.

  • Mid August update

    Image inputs

    You can now attach images to your prompts in Codex web. This is great for asking Codex to implement frontend changes or follow up on whiteboarding sessions.

    Container caching

    Codex now caches containers to start new tasks and followups 90% faster, dropping the median start time from 48 seconds to 5 seconds. You can optionally configure a maintenance script to update the environment from its cached state to prepare for new tasks. See the docs for more.

    Automatic environment setup

    Now, environments without manual setup scripts automatically run the standard installation commands for common package managers like yarn, pnpm, npm, go mod, gradle, pip, poetry, uv, and cargo. This reduces test failures for new environments by 40%.

June 2025

  • Best of N

    Codex can now generate multiple responses simultaneously for a single task, helping you quickly explore possible solutions to pick the best approach.

    Fixes & improvements

    • Added some keyboard shortcuts and a page to explore them. Open it by pressing ⌘-/ on macOS and Ctrl+/ on other platforms.

    • Added a “branch” query parameter in addition to the existing “environment”, “prompt” and “tab=archived” parameters.

    • Added a loading indicator when downloading a repo during container setup.

    • Added support for cancelling tasks.

    • Fixed issues causing tasks to fail during setup.

    • Fixed issues running followups in environments where the setup script changes files that are gitignored.

    • Improved how the agent understands and reacts to network access restrictions.

    • Increased the update rate of text describing what Codex is doing.

    • Increased the limit for setup script duration to 20 minutes for Pro and Business users.

    • Polished code diffs: You can now option-click a code diff header to expand/collapse all of them.

  • June update

    Agent internet access

    Now you can give Codex access to the internet during task execution to install dependencies, upgrade packages, run tests that need external resources, and more.

    Internet access is off by default. Plus, Pro, and Business users can enable it for specific environments, with granular control of which domains and HTTP methods Codex can access. Internet access for Enterprise users is coming soon.

    Learn more about usage and risks in the docs.

    Update existing PRs

    Now you can update existing pull requests when following up on a task.

    Voice dictation

    Now you can dictate tasks to Codex.

    Fixes & improvements

    • Added a link to this changelog from the profile menu.

    • Added support for binary files: When applying patches, all file operations are supported. When using PRs, only deleting or renaming binary files is supported for now.

    • Fixed an issue on iOS where follow up tasks where shown duplicated in the task list.

    • Fixed an issue on iOS where pull request statuses were out of date.

    • Fixed an issue with follow ups where the environments were incorrectly started with the state from the first turn, rather than the most recent state.

    • Fixed internationalization of task events and logs.

    • Improved error messages for setup scripts.

    • Increased the limit on task diffs from 1 MB to 5 MB.

    • Increased the limit for setup script duration from 5 to 10 minutes.

    • Polished GitHub connection flow.

    • Re-enabled Live Activities on iOS after resolving an issue with missed notifications.

    • Removed the mandatory two-factor authentication requirement for users using SSO or social logins.

May 2025

  • Reworked environment page

    It’s now easier and faster to set up code execution.

    Fixes & improvements

    • Added a button to retry failed tasks

    • Added indicators to show that the agent runs without network access after setup

    • Added options to copy git patches after pushing a PR

    • Added support for unicode branch names

    • Fixed a bug where secrets were not piped to the setup script

    • Fixed creating branches when there’s a branch name conflict.

    • Fixed rendering diffs with multi-character emojis.

    • Improved error messages when starting tasks, running setup scripts, pushing PRs, or disconnected from GitHub to be more specific and indicate how to resolve the error.

    • Improved onboarding for teams.

    • Polished how new tasks look while loading.

    • Polished the followup composer.

    • Reduced GitHub disconnects by 90%.

    • Reduced PR creation latency by 35%.

    • Reduced tool call latency by 50%.

    • Reduced task completion latency by 20%.

    • Started setting page titles to task names so Codex tabs are easier to tell apart.

    • Tweaked the system prompt so that agent knows it’s working without network, and can suggest that the user set up dependencies.

    • Updated the docs.

  • Codex in the ChatGPT iOS app

    Start tasks, view diffs, and push PRs—while you’re away from your desk.