Codex Changelog

New features

• Added a Worktrees setting to turn automatic cleanup of Codex-managed worktrees on or off.
• Added Handoff support for moving a thread between Local and Worktree.
• Added an explicit English option in the language menu.

Performance improvements and bug fixes

• Improved GitHub and pull request workflows.
• Improved approval prompts and app connection sign-in flows.
• Additional performance improvements and bug fixes.

Performance improvements and bug fixes

• Fixed a regression where conversation and task views could stop updating while Codex was streaming a response.
• Additional performance improvements and bug fixes.

New features

• Added pull request status badges in task rows and PR buttons, including draft, open, merged, and closed states.
• Added a Worktrees setting to choose how many Codex-managed worktrees to keep before older ones are cleaned up.

Performance improvements and bug fixes

• Improved scrolling and navigation in long conversations and code review, including fixes for thread jumpiness, sidebar jitter, and diff scrolling.
• Improved app startup reliability and keyboard zoom behavior.
• Additional performance improvements and bug fixes.

New features

• Added new MCP shortcuts in the composer, including install keyword suggestions and an MCP server submenu in Add context.
• Added support for @mentions and skill mentions in inline review comments.

Performance improvements and bug fixes

• Improved rendering of MCP tool calls and Mermaid diagram error handling.
• Fixed an issue where stopped terminal commands could continue appearing as running.
• Additional performance improvements and bug fixes.

New features

• Added drag-and-drop support to reorder queued messages.
• Added a warning when the selected model is downgraded.

Improvements and bug fixes

• Improved file workflows with fuzzy file search and better attachment recovery after restart.
• Additional performance improvements and bug fixes.

Today, we're releasing a research preview of GPT-5.3-Codex-Spark, a smaller version of GPT-5.3-Codex and our first model designed for real-time coding. Codex-Spark is optimized to feel near-instant, delivering more than 1000 tokens per second while remaining highly capable for real-world coding tasks.

Codex-Spark is available in research preview for ChatGPT Pro users in the latest Codex app, CLI, and IDE extension. This release also marks the first milestone in our partnership with Cerebras.

At launch, Codex-Spark is text-only with a 128k context window. During the research preview, usage has separate model-specific limits and doesn't count against standard Codex limits. During high demand, access may slow down or queue while we balance reliability across users.

To switch to GPT-5.3-Codex-Spark:

• In the CLI, start a new thread with:

  codex --model gpt-5.3-codex-spark

  Or use /model during a session.
• In the IDE extension, choose GPT-5.3-Codex-Spark from the model selector in the composer.
• In the Codex app, choose GPT-5.3-Codex-Spark from the model selector in the composer.

If you don't see GPT-5.3-Codex-Spark yet, update the CLI, IDE extension, or Codex app to the latest version.

GPT-5.3-Codex-Spark isn't available in the API at launch. For API-key workflows, continue using gpt-5.2-codex.

New features

• Support for GPT-5.3-Codex-Spark
• Added conversation forking
• Added floating pop-out window to take a conversation with you

Bug fixes

• Improved performance and bug fixes

Alpha testing for the Codex app on Windows is also starting. Sign up here to be a potential alpha tester.

New features

• Added branch search in the branch picker.
• Added clearer guidance for entering plan mode when you type plan in the composer.
• Added support for parallel approvals.

Improvements and bug fixes

• Additional performance improvements and bug fixes.

Starting today, GPT-5.3-Codex is available natively in Cursor and VS Code.

API access is starting with a small set of customers as part of a phased release.

This is the first model treated as a high security capability under the Preparedness Framework.

Safety controls will continue to scale, and API access will expand over the next few weeks.

New features

• Added MCP and personality actions to the command palette.
• Updated follow-up behavior to queue by default.

Improvements and bug fixes

• Additional performance improvements and bug fixes.

New features

• Added a file-reference action to reveal files directly in your OS file manager.

Improvements and bug fixes

• Improved handling of large reviews by removing the overall diff-size cap in the review pane.
• Additional performance improvements and bug fixes.

Today we're releasing GPT-5.3-Codex, the most capable agentic coding model to date for complex, real-world software engineering.

GPT-5.3-Codex combines the frontier coding performance of GPT-5.2-Codex with stronger reasoning and professional knowledge capabilities, and runs 25% faster for Codex users. It's also better at collaboration while the agent is working—delivering more frequent progress updates and responding to steering in real time.

GPT-5.3-Codex is available with paid ChatGPT plans everywhere you can use Codex: the Codex app, the CLI, the IDE extension, and Codex Cloud on the web. API access for the model will come soon.

To switch to GPT-5.3-Codex:

• In the CLI, start a new thread with:

  codex --model gpt-5.3-codex

  Or use /model during a session.
• In the IDE extension, make sure you are signed in with ChatGPT, then choose GPT-5.3-Codex from the model selector in the composer.
• In the Codex app, make sure you are signed in with ChatGPT, then choose GPT-5.3-Codex from the model selector in the composer.
• If you don't see GPT-5.3-Codex, update the CLI, IDE extension, or Codex app to the latest version.

For API-key workflows, continue using gpt-5.2-codex while API support rolls out.

New features

• Support for GPT-5.3-Codex.
• Added mid-turn steering. Submit a message while Codex is working to direct its behavior.
• Attach or drop any file type.

Bug fixes

• Fix flickering of the app.

New features

• Added Zed and Textmate as options to open files and folders.
• Added PDF preview in the review panel.

Bug fixes

• Performance improvements.

New features

• Added thread renaming on double-click in the thread list.

Improvements and bug fixes

• Renamed Sync to Handoff and added clearer source/destination stats in the handoff UI.
• Additional performance improvements and bug fixes.

Codex app

The Codex app for macOS is a desktop interface for running agent threads in parallel and collaborating with agents on long-running tasks. It includes a project sidebar, thread list, and review pane for tracking work across projects.

Key features:

• Multitask across projects
• Built-in worktree support
• Voice dictation
• Built-in Git tooling
• Skills
• Automations

For a limited time, ChatGPT Free and Go include Codex, and Plus, Pro, Business, Enterprise, and Edu plans get double rate limits. Those higher limits apply in the app, the CLI, your IDE, and the cloud.

Learn more in the Introducing the Codex app blog post.

Check out the Codex app documentation for more.

Codex now enables web search for local tasks in the Codex CLI and IDE Extension. By default, Codex uses a web search cache, which is an OpenAI-maintained index of web results. Cached mode returns pre-indexed results instead of fetching live pages, while live mode fetches the most recent data from the web. If you are using --yolo or another full access sandbox setting, web search defaults to live results. To disable this behavior or switch modes, use the web_search configuration option:

• web_search = "cached" (default; serves results from the web search cache)
• web_search = "live" (fetches the most recent data from the web; same as --search)
• web_search = "disabled" to remove the tool

To learn more, check out the configuration documentation.

Team Config groups the files teams use to standardize Codex across repositories and machines. Use it to share:

• config.toml defaults
• rules/ for command controls outside the sandbox
• skills/ for reusable workflows

Codex loads these layers from .codex/ folders in the current working directory, parent folders, and the repo root, plus user (~/.codex/) and system (/etc/codex/) locations. Higher-precedence locations override lower-precedence ones.

Admins can still enforce constraints with requirements.toml, which overrides defaults regardless of location.

Learn more in Team Config.

Custom prompts are now deprecated. Use skills for reusable instructions and workflows instead.

GPT-5.2-Codex is now available in the API and for users who sign into Codex with the API.

To learn more about using GPT-5.2-Codex check out our API documentation.