$ npm install -g @openai/codex@0.156.1View details
New Features
- Choose GPT-6 Sol or GPT-6 Luna from the model picker. The rate-limit switch prompt now recommends GPT-6 Luna. (#47405)
Changelog
Full Changelog: rust-v0.156.0...rust-v0.156.1
.md to the page URL.
Latest updates to ChatGPT and Codex
$ npm install -g @openai/codex@0.156.1Full Changelog: rust-v0.156.0...rust-v0.156.1
GPT-6 Sol and GPT-6 Luna are rolling out to Codex and ChatGPT Work at lower token prices than their GPT-5.6 predecessors. Use Sol for complex coding and agentic workflows, and Luna for focused, high-volume tasks.
Both models are rolling out to Plus, Pro, Business, Enterprise, and Edu users. Free and Go users can access Luna in the desktop app. Availability depends on rollout and workspace settings; Enterprise administrators must enable the new models. In ChatGPT, the models are available in Work and Codex, but not Chat.
Choose a model in the picker when available. In the CLI, use /model or start
a task with codex --model gpt-6-sol or codex --model gpt-6-luna.
See Models for selection and migration guidance, Pricing for credit rates and usage, and Workspace model availability for administrator controls.
$ npm install -g @openai/codex@0.156.0/tui for your next launch, including transcript search, mouse selection, and right-click copying. (#46732, #46734, #46883, #46895)/voice settings picker, and bundled audio runtimes for Linux and Windows. (#44921, #46071, #44622, #44714, #44922)/usage analytics dashboard. (#45764, #45769)/daemon, or bypass it with --no-daemon. (#45854, #46088)friendly and pragmatic personality settings no longer select response styles. (#45809)? matches a single character in network proxy allow and deny patterns. (#46027)Full Changelog: rust-v0.155.0...rust-v0.156.0
codex doctor @etraut-openai/voice settings to choose a voice for future conversations @bc-openaiquinn-proto and allow the pinned H3 Git source @richardopenaithread/rollback API @owenlin0YARN_NO_PROXY in the managed proxy environment @viyatb-oaiguardian-context @felixxia-oairustls and AWS-LC dependencies in Cargo and Bazel lockfiles @zm-oaidaybreakEnabled when starting a thread @faizan-oaiImageReference type @kchainani-oaiAgentControl @jif-oaiAgentControl @jif-oaiguardian-context @felixxia-oaiReviewModel through guardian review sessions @felixxia-oai/responses with identifying headers @jif-oai/usage @fcoury-oaiImageUserInput in the Python SDK @kchainani-oai/daemon menu for local background server updates @etraut-openaicodex-prompts @rhan-oai? wildcards in network proxy domain patterns @viyatb-oaidone prefix from TUI completion timestamps @etraut-openai--no-daemon to bypass the shared background server @etraut-openaispawn_agent description @rhan-oaispawn_agent description @surajs-oaiEnvironmentAccess @anp-oaicodex-async-utils @bolinfest/review during MCP startup @etraut-openaiAgentControl to LocalAgentControl @jif-oaicom.apple.runningboard from Seatbelt platform defaults @nornagon-openaienv_inherit in workspace_root_test @bolinfestCodexErr @anp-oaicodex doctor @etraut-openaiLiveAgent records from agent listing @jif-oaiLocalAgentControl @jif-oaicodex-utils-pty @charliemarsh-oai/tui to choose the terminal UI mode for the next launch @fcoury-oai/status @etraut-openaiError prefix from TUI config.toml load errors @etraut-openaicodex doctor errors @jif-oaiToolPolicy @felixxia-oaiArc @charliemarsh-oai$ npm install -g @openai/codex@0.155.1Full Changelog: rust-v0.155.0...rust-v0.155.1
$ npm install -g @openai/codex@0.155.0/voice conversations with live transcripts and microphone controls on supported builds, enabled through /experimental. (#43581, #43651, #44331)codex app-server daemon update; saved threads and active goals can recover after daemon restarts. (#43542, #43562, #44314)Full Changelog: rust-v0.154.0...rust-v0.155.0
/copy picker @copyberry__oailb routing cookies in ChatGPT HTTP clients @copyberryCodexThread @copyberryStartThreadOptions across thread fork APIs @copyberry/sandbox-add-read-dir slash command @copyberryupdate_goal @copyberryStartThreadOptions @copyberry:root filesystem policies in MXC @copyberryrepo_url from skill invocation analytics events @copyberryGPT-5.3-Codex-Spark was deprecated on September 14, 2026. The research preview is no longer available in the ChatGPT desktop app, Codex CLI, or IDE extension.
Switch to one of the recommended models,
and update saved configurations, custom agents, and scripts that select
gpt-5.3-codex-spark.
For faster responses with a supported model, see Fast mode.
On October 14, 2026, GPT-5.5 will retire from ChatGPT, ChatGPT Work, and Codex on all plans, including consumer, Business, Enterprise, and Edu plans. This retirement does not apply to the OpenAI API.
For Codex with ChatGPT sign-in, switch from gpt-5.5 to gpt-5.6-sol
(GPT-5.6 Sol) before the retirement date.
Update workspace defaults, saved model settings, managed configurations,
custom agents, scheduled tasks, and scripts that still select gpt-5.5.
See GPT-5.5 retirement and workspace model availability for migration guidance.
Keep ChatGPT close while you work in other apps. In the ChatGPT desktop app on
macOS and Windows, you can now type a quick chat from the floating Pets controls
and press Enter to send it. Use @ to add context and $ to choose a skill.
Select the bell icon to follow progress in your threads, then select a thread
to open the full conversation.
Choose a companion or show just the controls in Settings > Pets. Press Option+Space on macOS or Windows+Alt+P on Windows to show the controls and focus Quick Chat. Pressing the shortcut again keeps Quick Chat open. You can change Show pet in Settings > Keyboard shortcuts. To hide the controls, select Hide pet in the command menu or Settings > Pets.
On macOS, you can also send an appshot to the floating controls. Keep the main ChatGPT window in the background and choose Automatic for Appshot destination.
Learn more about Pets.
Appshots are now available in the ChatGPT desktop app on Windows. Press both Alt keys to share the frontmost app window with ChatGPT, then ask a question or describe what you want to do. An appshot includes a screenshot and available text from that window. You can customize the shortcut and choose which chat receives it in settings.
$ npm install -g @openai/codex@0.154.0Install with pip install --upgrade openai-codex==0.154.0 (Python 3.10 or later). This release includes the matching openai-codex-cli-bin==0.154.0 runtime.
max and ultra reasoning-effort values. #39662ExternalMessage to synchronous and asynchronous run() and turn() calls. External content can start a turn or join an active regular turn with tool-level authority; it does not grant user authorization. Consumers receive independent event streams. #44086include_turns on resume/fork, turn_service_tier for one newly started turn, and source metadata. History selection changes the returned response, not model context. Existing defaults are preserved when these options are omitted. #44084Check these migrations when upgrading:
HookMetadata wraps its handler in .root. Replace accesses such as hook.command with hook.root.command, checking hook.root.handler_type before reading handler-specific fields..params; unknown or invalid payloads still use UnknownNotification.TransportClosedError. Use thread.read(include_turns=True) for saved history. Handles returned directly by thread.turn(...) retain events from when their request is sent.Custom codex_bin overrides require CLI 0.151.0 or newer for ExternalMessage and the new history/per-turn options.
$ npm install -g @openai/codex@voice-cygwin-108b38cf67cbb731CI-only build tools for native Windows voice releases. These archives are not included in Codex user packages.
cygwin-build-inputs.tar.gz: 103 pinned Cygwin binary packages and the signed package index used by the offline build installer.cygwin-build-sources.tar: all 83 corresponding source package archives at the exact versions named by that index. It includes the upstream source, patches, and build recipes provided in Cygwin's -src packages.cygwin-source-map.json: each selected binary package mapped to its source archive and the source size and SHA-512 digest from the pinned index.CYGWIN-SOURCE-NOTICE.txt: source access and licensing notice.The binary and source archive SHA-256 pins live in .github/scripts/voice-cygwin-snapshot.json in the Codex repository. Cygwin describes the licensing terms at https://cygwin.com/licensing.html. Licenses vary by package; consult the corresponding source and binary package archives for their notices.
$ npm install -g @openai/codex@0.154.0--worktree or /worktree, then browse and resume them. (#42652, #43069, #43120, #43286)R replace mode with undo and dot-repeat, plus more reliable Escape handling in legacy terminals. (#42194, #42584)/copy can copy status output or individual session fields. (#42847, #43055)codex mcp-server entry point is no longer available. (#42993)Full Changelog: rust-v0.153.0...rust-v0.154.0
apply_patch in the executor path context @copyberrycodex-otel @copyberrycodex exec @copyberrycodex doctor @copyberrycodex mcp-server command @copyberryapp/installed @copyberry/copy to copy status output and individual fields @copyberryguardianv2 configuration @copyberrycwd in TUI resume and fork test fixtures @copyberryAGENTS.md @copyberryguardian_review @copyberryrecursion_limit to 256 for app-server, exec, and TUI @copyberry@ mentions.The codex mcp-server command and standalone codex-mcp-server binary have
been removed after their deprecation on August 24, 2026. Update integrations
that launch either command before upgrading Codex.
Use the Codex app server for integrations. The app-server command is experimental and isn’t supported for production workloads.
See the migration guidance for details. Codex continues to
support connecting to external MCP servers through codex mcp.
$ npm install -g @openai/codex@0.153.4Full Changelog: rust-v0.153.3...rust-v0.153.4
$ npm install -g @openai/codex@0.153.3Full Changelog: rust-v0.153.2...rust-v0.153.3
$ npm install -g @openai/codex@0.153.2Full Changelog: rust-v0.153.1...rust-v0.153.2
$ npm install -g @openai/codex@0.153.1Full Changelog: rust-v0.153.0...rust-v0.153.1
$ npm install -g @openai/codex@0.153.0u and redo with Ctrl+R, preserving complete drafts including pasted content and attachments. (#41941, #42140)tui.auto_recap = false to disable automatic recaps while keeping manual /recap available. (#42101)codex exec resume handles compressed rollouts when selecting by working directory, and thread forks work with symlinked session roots. (#42039, #42135)model and reasoningEffort fields. Structured asynchronous questions are supported through request_user_input_async when enabled by the model catalog. (#42151, #42178)tui.disable_paste_burst replaces the top-level setting, which remains supported as a fallback. (#41976)features.context_management.experimental_mode configuration. When enabled for eligible ChatGPT Plus, Pro, or Pro Lite sessions using the Codex backend, it activates token-budget context, history notes, and the new_context tool. API-key sessions, custom providers, and temporary structured threads remain excluded. (#42385)disable_paste_burst under [tui]PluginsManager$ npm install -g @openai/codex@0.152.1Full Changelog: rust-v0.152.0...rust-v0.152.1
$ npm install -g @openai/codex@0.152.0/ and ? searches within drafts, highlighted matches, and repeat navigation with n and N. (#41586)codex exec show credential-refresh progress, including Amazon Bedrock reauthentication. (#41239):, @, /, and ., supporting package-style names throughout CLI commands and authentication. (#41700)output_token_limit setting, with consistent truncation across session resumes. (#41421)thread/shellCommand timeouts, including deadlines longer than one hour. (#41384)Vim-enabled composers now start fresh drafts in Insert mode, including after submitting messages or dispatching slash commands. (#41921)
Automatic approval reviews can retain longer messages and a larger conversation transcript. (#41931)
Automatic approval reviews preserve user instructions, answers, and valid authorizations across history compaction. (#41660, #41846, #41852)
Resumed threads restore their saved working directory when none is supplied, and client metadata updates preserve filesystem permissions. (#41567, #41464)
MCP tools remain available through cache refreshes and remote plugin changes; authentication retries use refreshed helper-provided headers. (#41336, #41344, #41396, #41400)
Opening the model picker refreshes available models without losing the highlighted choice. (#41467)
Fixed Windows sandbox execution with Microsoft Store PowerShell, subprocess hangs on terminal queries, and cursor-related display corruption in older JediTerm terminals. (#41227, #41436, #41673)
Cloud task requests reject untrusted backend URLs and disable redirects to protect saved credentials. (#41403)
tools.update_plan.enabled = true. (#41744)Full Changelog: rust-v0.151.0...rust-v0.152.0
project/list @copyberryopenai/elicitation form requests @copyberry$ npm install -g @openai/codex@0.151.0/cd from weakening sandbox restrictions. (#41192)Full Changelog: rust-v0.150.0...rust-v0.151.0
ToolRouter @copyberryMore browsers: Use the ChatGPT browser extension in Microsoft Edge, Brave, Opera, and Vivaldi, as well as Chrome. Set up your browser in Settings > Computer Use in the ChatGPT desktop app. All five support tab mentions and browser control; Opera doesn’t support side chat.
Site tools (WebMCP): In the desktop app’s built-in browser, ChatGPT Work and Codex can use tools provided by a website to work with the page. Use GPT-5.6 Sol or GPT-5.6 Terra and update to the latest desktop app. Site tools aren’t available with GPT-5.6 Luna or in Enterprise or Edu workspaces.
Cloud browser sign-in: On eligible plans, ChatGPT Work on the web, iOS, and Android can ask you to sign in to a supported website through the cloud browser. Enter your details in the sign-in flow, not in the chat. Cloud browser sessions stay separate from your local browser. Website sign-in isn’t available for Enterprise or Edu workspaces.
Availability depends on rollout and workspace settings. Website-access and action-confirmation requirements still apply.
ChatGPT scheduled tasks can now run when supported events occur in Gmail, Slack, or GitHub. Filter Gmail messages by sender or subject, watch selected Slack channels, or respond to pull request activity such as reviews, comments, commit updates, and merges.
Event-triggered tasks are available in ChatGPT on the web and mobile for eligible plans. Connect the relevant app and approve its requested access before creating a task. The ChatGPT Slack app must be a member of each watched channel, and the connected GitHub app must have access to each watched repository.
An event-triggered task can’t also use a time-based schedule. When matching events arrive close together, ChatGPT may combine them in one run. Open Scheduled to review pending events or choose Run now.
The codex mcp-server command is now deprecated. Use the Codex app
server instead.
Update, September 5, 2026: The command and standalone codex-mcp-server
binary have been removed. See the migration guidance.
Apple Messages: Use the Apple Messages plugin to read and search Messages chats on your Mac and prepare or send messages. It’s available on all plans in the ChatGPT desktop app for macOS. You can use the plugin in ChatGPT Work and Codex. By default, ChatGPT sends messages only after you approve the message and its recipients. See the plugin guide for persistent-approval risks, revocation steps, and the known issue with tasks that disable approval prompts.
Site co-editing: Where Site collaboration is available, owners can invite active members of the same workspace as editors. Editors can read the Site’s live database data, update the Site, save versions, and publish changes after the owner publishes the Site for the first time. Owners retain control of the audience, settings, analytics, ownership, version restoration, and editor access.
Editable Site URLs: Where URL editing is available, owners can change an existing Site’s ChatGPT-hosted address without creating another deployment. The previous address redirects to the new URL. Custom domains are a separate, existing feature and aren’t changed by this setting.
Computer History in Europe: Computer History is now available in the EEA, Switzerland, and the United Kingdom for ChatGPT Pro, Business, and Enterprise users in the ChatGPT desktop app on macOS. It’s off by default and requires Memories. Business and Enterprise administrators must enable access before workspace members can choose to turn it on.
Shared thread snapshots: On all Codex plans, share a read-only snapshot of a local Codex thread from the ChatGPT desktop app for macOS. The snapshot doesn’t update when the original thread changes. Personal-account links can be opened by anyone with the link; workspace-account links are limited to members of the originating workspace. Codex redacts known secret patterns, but review the shared content because sensitive content may remain. View or revoke links in ChatGPT data controls, under Shared links.
Unified pinned threads: Keep the same pinned chats across the ChatGPT desktop app and iOS.
GitLab support is available in beta on all ChatGPT plans. Connect a GitLab
project to Codex cloud, create an environment for it, start tasks from issues
or merge requests with @codex, and request one-off or automatic merge request
reviews.
The integration runs in Codex cloud. A managed workspace admin can disable the connector. GitLab-triggered activity requires permission to configure the applicable webhook. For GitLab Self-Managed or GitLab Dedicated, a workspace admin must configure the connection, and webhook activity requires GitLab 19.0 or later.
Codex cannot complete a review when GitLab omits a collapsed or oversize diff.
Learn how to use Codex with GitLab.
Eligible ChatGPT Enterprise workspace owners and admins can download a CSV of the public plugins visible to their workspace. The export includes plugin, app, and Chat skill names and descriptions, along with developer, version, date added in UTC, and OpenAI verification metadata.
Open Admin > Plugins, select Public, and then select the download icon (Export CSV). The export uses a public-catalog snapshot that can be up to 48 hours old and does not include plugins created for the workspace. It isn’t available in FedRAMP workspaces.
Learn more about plugin controls.
Computer History is an opt-in feature in the ChatGPT desktop app on macOS that turns activity across apps and websites into memories and a timeline that ChatGPT and Codex can use. Choose which apps and websites contribute, pause collection, and review or delete your history at any time.
Computer History is available to ChatGPT Pro, Business, and Enterprise users. Business and Enterprise administrators must enable access before workspace members can turn it on. Initial availability excludes the European Economic Area (EEA), Switzerland, and the United Kingdom.
The ChatGPT desktop app for Linux is available in
preview for supported Ubuntu, Debian, and Fedora desktop distributions on x64
and ARM64 processors. Download the .deb or .rpm package for your
distribution, then sign in to work with projects, local files, and Codex.
The desktop app supports Claude Code, Claude Cowork, and Cursor. Import instructions, settings, skills, plugins, projects, and recent work, then turn on automatic updates in Settings > Import to keep imported work in sync.
Codex CLI can also import supported setup and recent chats from Claude Code
and Cursor with /import.
Daybreak now offers two access tiers for approved defenders: Daybreak Blue and Daybreak Red. Use them to move from security findings to validated fixes in explicitly authorized engagements.
Start with Daybreak Blue for most defensive security work. It provides access to general-purpose models such as GPT-5.6 Sol for vulnerability discovery, secure code review, detection engineering, incident response, malware analysis, and patch validation.
Daybreak Red provides separately approved access to purpose-trained models such as GPT-5.6 Cyber for authorized vulnerability reproduction, exploit validation, penetration testing, red teaming, and complex system analysis.
Access requires approval through Trusted Access for Cyber and applies only to the approved identity, workspace or API organization and project, model, and product surface. Daybreak Red requires separate approval and provisioning; Daybreak Blue access doesn’t grant access to Daybreak Red.
Work in an isolated environment, define your engagement scope, use least-privilege permission profiles, and configure Auto-review for eligible actions before they cross the sandbox boundary.
Learn more about Cyber Safety, Codex credit rates, and API token prices.
/goal prompts after completing a goal.On August 31, 2026, GPT-5.4 and GPT-5.4 mini will no longer be available in Codex for users signed in with ChatGPT. GPT-5.4 and GPT-5.4 mini will remain available on the OpenAI API and Codex sessions authenticated with an API key.
Switch to their recommended replacements:
gpt-5.4 with gpt-5.6-terra (GPT-5.6 Terra).gpt-5.4-mini with gpt-5.6-luna (GPT-5.6 Luna).Before the cutoff, update workspace defaults, saved model settings, managed configurations, custom agents, and scheduled tasks that use either model.
See Codex models and workspace model availability for details.
Record & Replay is now available in the European Union, the United Kingdom, and Switzerland. On macOS, demonstrate a workflow and turn it into a reusable skill. Computer Use must also be available and enabled.
The latest ChatGPT desktop app update makes browsing, reviewing code, and editing generated images faster and easier.
Learn more about the built-in browser and the Chrome extension.
See all repositories in a multi-folder project and the lines changed in each one. Select Review to inspect diffs across those repositories without switching between separate review views.
Open generated images in an expanded viewer, and switch between Focused view and Canvas view. Add comments across images, choose the ones you want, and send targeted edits without leaving your conversation. Learn more about image generation.
Sign in with ChatGPT is beginning to roll out in beta across select plugins and partner sites, starting with Airtable, GitLab, HubSpot, Notion, Supabase, and Vercel.
When you connect a supported plugin from the ChatGPT plugin directory, you can use Sign in with ChatGPT to create or link an account with that service in fewer steps. On participating partner sites, you can also select Sign in with ChatGPT to create or access your account.
This makes it easier to start working with supported tools in ChatGPT and Codex.
When you sign in, the partner receives only your name, email address, and profile picture, if available. You must still review and approve each plugin’s requested access as a separate step.
Powered by GPT-Live, ChatGPT Voice lets you talk through work and coordinate tasks in Chat, Work, and Codex in the ChatGPT desktop app.
Start a new chat or task in voice mode, then ask ChatGPT to start, check, or steer work in other threads. On macOS, turn on Screen context to share an appshot of your frontmost window.
Voice is available with Plus, Pro, Business, Edu, and Enterprise plans in the desktop app and through Remote on iOS.
Local projects in the ChatGPT desktop app can now include multiple related
folders. From a project’s menu, select Edit project to add folders and choose
the primary folder. New chats, Git operations, and automatic discovery of
AGENTS.md, skills, and config.toml use the primary folder. Secondary
folders remain available for file search, reading, and editing.
Get started with ChatGPT Voice and multi-folder local projects.
Codex is now part of the ChatGPT desktop app on macOS and Windows. Existing Codex app users can update as usual and keep their projects, settings, and workflows. You can make Codex the default view and, on macOS, keep the Codex app icon.
Codex Remote has reached general availability. Use Codex from the ChatGPT mobile app to start or continue work on a connected Mac or Windows host, review progress, and approve actions from your phone.
Remote Control now uses authenticated one-to-one QR pairing between each iOS or Android device and each host. Update the ChatGPT mobile app and Codex App to the latest versions before connecting. Connections used since June 8, 2026, remain paired; older inactive connections need to pair again.
The new DigitalOcean plugin lets Codex provision a DigitalOcean Droplet, configure SSH access, and connect it to the Codex App as a remote workspace.
See Remote connections for setup and troubleshooting.
More Codex app capabilities are rolling out to users in the European Economic Area, the United Kingdom, and Switzerland:
/init command to the app composer for creating project
instructions with the same initialization workflow as the Codex CLI./goal support for creating and managing goals from Codex Mobile.Sites is now available in preview in the Codex app. Use the Sites plugin to create, save, deploy, and inspect websites, dashboards, internal tools, web apps, and games hosted by OpenAI.
Open Sites in the app sidebar to return to your projects and manage hosted environment variables and secrets.
ChatGPT Business workspaces include Sites by default. ChatGPT Enterprise admins can enable Sites for the appropriate roles through role-based access control (RBAC).
/side <prompt> to start a side
conversation with an initial question.Codex can now use supported OpenAI models available through Amazon Bedrock. Configure Amazon Bedrock as your model provider to run Codex locally with AWS-managed authentication, account controls, and billing.
GPT-5.3-Codex and GPT-5.2 are now deprecated as user-selectable models in Codex for users signed in with ChatGPT. API-key workflows aren’t affected.
Use a current Codex model, such as GPT-5.5, GPT-5.4, or GPT-5.4 mini. See Codex models for model availability and Codex pricing for credit rates.
/side for opening a side conversation.Appshots are now available in the Codex app on macOS. Press both Command keys to send the frontmost app window to Codex with a screenshot and available text, so Codex can work from context in another app without you copying, pasting, or describing it manually.
This launch also includes:
You can now use Codex from the ChatGPT mobile app by connecting it to a Mac running the Codex app. Codex runs from the connected host, so the same projects, files, credentials, plugins, skills, and configuration are available from your phone.
See Remote connections for mobile setup, choosing a host, what comes from the connected machine, and SSH hosts. This launch also includes Hooks general availability, Codex access tokens for trusted automation, and Enterprise admin setup guidance.
Added a dedicated Auto-review page covering the reviewer lifecycle, trigger conditions, failure behavior, and local or managed configuration.
Also updated the Agent approvals & security and Sandbox docs so they explain more clearly how Auto-review relates to the sandbox boundary.
Ctrl+V paste in the Windows terminal, opening modified external links outside the in-app browser, and keeping feedback slash commands attached to the right thread.With the new extension for Chrome, Codex is even better at working with apps and websites in your browser. It works in parallel across tabs in the background without taking over your browser, and you stay in control of which websites Codex can use.
Learn more in the Codex Chrome extension documentation.
Updated the Codex enterprise governance guide with more detailed coverage of the Analytics dashboard charts, data export options, and enterprise Analytics API endpoints.
ChatGPT Enterprise workspace owners and admins can allow permitted members to create Codex access tokens for trusted, non-interactive Codex local workflows. Members can use access tokens to run Codex from scripts, schedulers, and private CI runners with their ChatGPT workspace identity.
Learn more in Access tokens.
GPT-5.5 is now available in Codex as OpenAI’s newest frontier model for complex coding, computer use, knowledge work, and research workflows.
GPT-5.5 is the recommended choice for most Codex tasks when it appears in your model picker. It’s especially useful for implementation, refactors, debugging, testing, validation, and knowledge-work artifacts.
To switch to GPT-5.5:
codex --model gpt-5.5
Or use /model during a session.If you don’t see GPT-5.5 yet, update the CLI, IDE extension, or Codex app to the latest version. During the rollout, continue using GPT-5.4 if GPT-5.5 is not yet available.
The Codex app can now let Codex operate the in-app browser for local development servers and file-backed pages. Ask Codex to use the browser when it needs to click through a rendered UI, reproduce a visual bug, or verify a local fix inside the app.
Browser use runs through the bundled Browser plugin. In settings, you can manage the plugin and review allowed or blocked websites.
Codex can route eligible approval prompts through an automatic reviewer agent before the request runs. When configured, the Codex app shows an automatic review item with the review status and risk level, so you can see whether the reviewer approved, denied, stopped, or timed out before deciding.
Codex is becoming a broader workspace for getting work done with AI. This update makes it easier to start work with less setup, verify what Codex is building, create richer outputs, and keep momentum across longer-running tasks.
The Codex app now includes an early in-app browser. You can open local or public pages that don’t require sign-in, comment directly on the rendered page, and ask Codex to address page-level feedback.
Computer use lets Codex operate macOS apps by seeing, clicking, and typing, which helps with native app testing, simulator flows, low-risk app settings, and GUI-only bugs.
The feature isn’t available in the European Economic Area, the United Kingdom, or Switzerland at launch.
Chats are threads you can start without choosing a project folder first. They’re useful for research, writing, planning, analysis, source gathering, and tool-driven work that doesn’t begin in a codebase.
For work that needs a later check-in, thread automations can wake up the same thread on a schedule while preserving the conversation context. Use them to check a long-running process, watch for updates, or continue a follow-up loop without starting from scratch.
The task sidebar makes plans, sources, generated artifacts, and summaries easier to follow while Codex works. Context-aware suggestions can also help you pick up relevant follow-ups when you start or return to Codex.
Codex now brings more of the pull request workflow into the app. You can inspect GitHub pull requests in the sidebar, review comments in the diff, review changed files, then ask Codex to explain feedback, make changes, check them, and keep the review moving.
The artifact viewer can preview generated files such as PDF files, spreadsheets, documents, and presentations in the sidebar before you commit or share them. Memories, where available, can also carry useful context from past tasks into future threads, including stable preferences, project conventions, and recurring work patterns.
Cmd+P routing into workspace file search.We’re updating model availability for users who sign in with ChatGPT. Starting
April 7, the model picker no longer shows gpt-5.2-codex,
gpt-5.1-codex-mini, gpt-5.1-codex-max, gpt-5.1-codex, gpt-5.1, or
gpt-5. On April 14, we’ll remove those models from Codex for ChatGPT sign-in.
Users can still choose from gpt-5.4, gpt-5.4-mini, gpt-5.3-codex, and
gpt-5.2. ChatGPT Pro users can also choose gpt-5.3-codex-spark.
To use another API-supported model in Codex, sign in with an API key or configure a model provider.
@ mentions in the automation composer, surfaced subagent diff stats in the composer, and added artifact cards for generated file citations.@-mention results, duplicate project labeling, Windows runGit behavior, and revert, unstage, and stage-all actions.Codex now supports plugins: installable bundles that package skills, app integrations, and MCP server configuration for reusable workflows.
Plugins are available in the Codex app, CLI, and IDE extensions.
You can install curated plugins from the plugin directory, or scaffold a local
plugin with @plugin-creator and test it with workspace-scoped or home-scoped
marketplaces.
Learn more in the plugins documentation.

Every plugin is a folder with a required .codex-plugin/plugin.json manifest
and optional supporting files:
my-plugin/
.codex-plugin/
plugin.json # Required: plugin manifest
skills/ # Optional: packaged skills
.app.json # Optional: app or connector mappings
.mcp.json # Optional: MCP server configuration
assets/ # Optional: icons, logos, screenshots
You can install plugins for just yourself with
~/.agents/plugins/marketplace.json and ~/.codex/plugins/, or for everyone
on a project with .agents/plugins/marketplace.json and a repo-local plugin
directory such as ./plugins/.
Codex surfaces curated public plugins in the plugin directory. Codex also ships
with the built-in @plugin-creator skill to help you scaffold a plugin, add a
local marketplace entry, and test it before sharing it with teammates.
@ menu so you can insert them from the composer alongside other mentions.Cmd/Ctrl+F now starts with your current text selection, which makes searching reviews and diffs faster, alongside broader review navigation improvements such as a refreshed file tree and percentage-based file tree resizing.GPT-5.4 mini is now available in Codex as a fast, efficient model for lighter coding tasks and subagents.
It improves over GPT-5 mini across coding, reasoning, image understanding, and tool use while running more than 2x faster. In Codex, GPT-5.4 mini uses 30% as much of your included limits as GPT-5.4, so comparable tasks can last about 3.3x longer before you hit those limits.
GPT-5.4 mini is available in the Codex app, the CLI, the IDE extension, and Codex on the web. GPT-5.4 mini is also available in the API.
Use GPT-5.4 mini for codebase exploration, large-file review, processing supporting documents, and other less reasoning-intensive subagent work. For more complex planning, coordination, and final judgment, start with GPT-5.4.
To switch to GPT-5.4 mini:
codex --model gpt-5.4-mini
Or use /model during a session.If you don’t see GPT-5.4 mini yet, update the CLI, IDE extension, or Codex app to the latest version.
Change the Codex app appearance in Settings by choosing a base theme, adjusting accent, background, and foreground colors, and changing the UI and code fonts. You can also share your custom theme with friends.
You can now choose whether automations run locally or on a worktree, define custom reasoning levels and models, and use templates to find inspiration for new automations.
Various bug fixes and performance improvements.
GPT-5.4 is now available in Codex as OpenAI’s most capable and efficient frontier model for professional work.
It combines recent advances in reasoning, coding, and agentic workflows in one model, and it’s the recommended choice for most Codex tasks.
In Codex, GPT-5.4 is the first general-purpose model with native computer-use capabilities. GPT-5.4 in Codex includes experimental support for the 1M context window. It supports complex workflows across applications and long-horizon tasks, with stronger tool use and tool search that help agents find and use the right tools more efficiently.
GPT-5.4 is available everywhere you can use Codex: the Codex app, the CLI, the IDE extension, and Codex Cloud on the web. GPT-5.4 is also available in the API.
To switch to GPT-5.4:
codex --model gpt-5.4
Or use /model during a session.If you don’t see GPT-5.4 yet, update the CLI, IDE extension, or Codex app to the latest version.
codex://new links could stop prefilling a new conversation when the app was already open.The Codex app is now available on Windows. The app gives you one interface for working across projects, running parallel agent threads, and reviewing results in one place.
The Codex app runs natively on Windows using PowerShell and a native Windows sandbox for bounded permissions, so you can use Codex on Windows without moving your workflow into WSL, onto a virtual machine, or by deactivating the sandbox.
The Windows app includes the same core features as the rest of the Codex app:
If you prefer to develop in WSL, you can also switch the Codex agent and the integrated terminal to run there.
Download it from the Microsoft Store and sign in with your ChatGPT account or an API key. For setup and configuration details, see Setup, Use WSL with the Codex app, and Customize the app for your development setup.
@mentions and skill mentions in inline review comments.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:
codex --model gpt-5.3-codex-spark
Or use /model during a session.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.
Alpha testing for the Codex app on Windows is also starting. Sign up here to be a potential alpha tester.
plan in the composer.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.
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:
codex --model gpt-5.3-codex
Or use /model during a session.For API-key workflows, continue using gpt-5.2-codex while API support rolls
out.
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:
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 toolTo 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 defaultsrules/ for command controls outside the sandboxskills/ for reusable workflowsCodex 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.
Codex now supports agent skills: reusable bundles of instructions (plus optional scripts and resources) that help Codex reliably complete specific tasks.
Skills are available in both the Codex CLI and IDE extensions.
You can invoke a skill explicitly by typing $skill-name (for example, $skill-installer or the experimental $create-plan skill after installing it), or let Codex select a skill automatically based on your prompt.
Learn more in the skills documentation.




Following the open agent skills specification, a skill is a folder with a required SKILL.md and optional supporting files:
my-skill/
SKILL.md # Required: instructions + metadata
scripts/ # Optional: executable code
references/ # Optional: documentation
assets/ # Optional: templates, resources
You can install skills for just yourself in ~/.codex/skills, or for everyone on a project by checking them into .codex/skills in the repository.
Codex also ships with a few built-in system skills to get started, including $skill-creator and $skill-installer. The $create-plan skill is experimental and needs to be installed (for example: $skill-installer install the create-plan skill from the .experimental folder).
Codex ships with a small curated set of skills inspired by popular workflows at OpenAI. Install them with $skill-installer, and expect more over time.
Today we are releasing GPT-5.2-Codex, the most advanced agentic coding model yet for complex, real-world software engineering.
GPT-5.2-Codex is a version of GPT-5.2 further optimized for agentic coding in Codex, including improvements on long-horizon work through context compaction, stronger performance on large code changes like refactors and migrations, improved performance in Windows environments, and significantly stronger cybersecurity capabilities.
Starting today, the CLI and IDE Extension will default to gpt-5.2-codex for users who are signed in with ChatGPT. API access for the model will come soon.
If you have a model specified in your config.toml configuration file, you can instead try out gpt-5.2-codex for a new Codex CLI session using:
codex --model gpt-5.2-codex
You can also use the /model slash command in the CLI. In the Codex IDE Extension you can select GPT-5.2-Codex from the dropdown menu.
If you want to switch for all sessions, you can change your default model to gpt-5.2-codex by updating your config.toml configuration file:
model = "gpt-5.2-codex” Assign or mention @Codex in an issue to kick-off a Codex cloud task. As Codex works, it posts updates back to Linear, providing a link to the completed task so you can review, open a PR, or keep working.

To learn more about how to connect Codex to Linear both locally through MCP and through the new integration, check out the Codex for Linear documentation.
Minor updates to address a few issues with Codex usage and credits:
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” 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” 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” We’ve shipped a minor update to GPT-5-Codex:
apply_patch.git reset.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.
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 is now generally available with 3 new features — @Codex in Slack, Codex SDK, and new admin tools.

You can now questions and assign tasks to Codex directly from Slack. See the Slack guide to get started.
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);

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.
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.
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.

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.

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.
codex resume.Learn more in the latest release notes
Codex now runs in your IDE with an interactive UI for fast local iteration. Easily switch between modes and reasoning efforts.
One-click authentication that removes API keys and uses ChatGPT Enterprise credits.
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.
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.

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.

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.
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%.

Codex can now generate multiple responses simultaneously for a single task, helping you quickly explore possible solutions to pick the best approach.
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.

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.

Now you can update existing pull requests when following up on a task.
Now you can dictate tasks to Codex.
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.
It’s now easier and faster to set up code execution.

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.
Start tasks, view diffs, and push PRs—while you’re away from your desk.

Loading docs agent...