Skip to content

Codex Version History

This changelog tracks Codex releases across the CLI, desktop app, and IDE extension. For the full official changelog, see developers.openai.com/codex/changelog.

Latest

CLI v0.137.0 - June 4, 2026

F13-F24 Keybindings, Controller Pairing, Parallel Web Search

Install: npm install -g @openai/codex@0.137.0

  • TUI adds F13-F24 keybinding support and paste into searchable menus
  • Enterprise flows surface monthly credit limits and support cloud-managed config bundles for EDU workspaces
  • codex remote-control clients can initiate pairing and manage controller grants via app-server v2 RPCs
  • Plugin workflows gain machine-readable JSON output and cached remote catalog suggestions
  • Hosted web and image tools reach more code-mode flows, with a parallel standalone web-search capability
  • MultiAgentV2 preserves the runtime choice per thread, with cleaner follow-up and metadata defaults

CLI v0.136.0 - June 1, 2026

/archive Sessions, Clickable Links, Windows Elevated Sandbox Setup

Install: npm install -g @openai/codex@0.136.0

  • Archive sessions with the /archive slash command or codex archive / codex unarchive; archived sessions are protected from resume and fork
  • TUI markdown keeps clickable web links via OSC 8 metadata; cramped tables collapse into readable key/value records
  • App-server integrations resume threads with an initial turns page, plus richer MCP server status visibility
  • Windows admins gain an alpha codex sandbox setup --elevated provisioning path
  • ChatGPT auth refreshes tokens before the five-minute expiry window, with better handling of reused refresh tokens

CLI v0.135.0 - May 28, 2026

codex doctor Diagnostics, Vim Text Objects, Cleaner Tables

Install: npm install -g @openai/codex@0.135.0

  • codex doctor now reports richer environment, Git, terminal, app-server, and thread-inventory diagnostics for support cases
  • /status shows remote connection details and server version when the TUI is connected over a remote transport
  • Vim mode gains text-object editing, improved word/line-end motions, and a configurable interrupt-turn binding
  • /permissions understands named permission profiles and lists configured custom profiles
  • Markdown tables and multiline lists render more readably in the TUI; output is more stable on macOS and Zellij
  • Python SDK exposes friendly Sandbox presets for thread and turn APIs

CLI v0.134.0 - May 26, 2026

History Search, --profile Standardization, MCP Env Targeting

Install: npm install -g @openai/codex@0.134.0

  • Search across local conversation history — case-insensitive content matches with result previews
  • --profile is now the primary profile selector across the CLI, TUI permissions, and sandbox flows; legacy profile configs are rejected with migration guidance
  • MCP setup gains per-server environment targeting and OAuth options for streamable HTTP servers
  • Read-only MCP tools can run concurrently when they advertise readOnlyHint
  • Richer extension/hook context — conversation history for extension tools, subagent identity in hook inputs

CLI v0.133.0 - May 21, 2026

Goals On by Default, codex remote-control Foreground, Permission Profiles

Install: npm install -g @openai/codex@0.133.0

  • Goals are now enabled by default, backed by dedicated storage and tracking progress across active turns
  • codex remote-control runs like a foreground command — waits for readiness, reports machine status, and keeps explicit start/stop daemon commands
  • Permission profiles gain list APIs, inheritance, managed requirements.toml support, and stronger Windows sandbox integration
  • Plugin discovery is easier to inspect: marketplace-aware list output, installed versions, visible marketplace roots, remote collections
  • Extensions observe more lifecycle events — subagent start/stop, tool execution, and turn metadata

CLI v0.132.0 - May 20, 2026

Python SDK Auth, codex exec resume --output-schema, Faster Startup

Install: npm install -g @openai/codex@0.132.0

  • Python SDK gains first-class authentication — API key, ChatGPT browser and device-code flows, account inspection, and logout
  • codex exec resume accepts --output-schema, so resumed automations keep session context while still enforcing structured JSON output
  • Faster TUI startup — terminal capability probes are batched instead of run serially
  • Goal continuations now stop on usage limits or a repeated blocker instead of looping and burning tokens
  • Remote executor registration can use standard Codex auth instead of a separate registry credential flow

CLI v0.131.0 - May 18, 2026

codex doctor, Unified @ Picker, Marketplace Plugin CLI

Install: npm install -g @openai/codex@0.131.0

  • Added codex doctor for support-ready diagnostics across runtime, auth, terminal, network, config, and local state
  • @ mentions now search files, directories, plugins, and skills in one picker
  • Plugin workflows gain marketplace CLI commands, version-aware sharing, share checkout, and default-enabled plugin hooks
  • Remote workflows support daemon-managed codex remote-control with runtime enable/disable APIs and status reads
  • Python SDK moved to openai-codex / openai_codex with pinned runtime-generated types and concurrent turn routing
  • TUI status line shows blended token usage, permissions/approval mode, and effective workspace roots

CLI v0.130.0 - May 8, 2026

Plugin Sharing, codex remote-control, App-Server Thread Pagination

Install: npm install -g @openai/codex@0.130.0

  • Plugin sharing now exposes link metadata and discoverability controls — share/unshare individual plugins or entire workspaces, with source filtering and local share-path tracking
  • New codex remote-control command for headless app-server operation — orchestrate Codex sessions from CI, cron, or other agents without a TUI
  • App-server thread pagination with variable detail levels — list, peek, and replay long-running multi-agent threads efficiently
  • AWS Bedrock authentication now supports console-login credentials in addition to AWS profiles and access-key pairs
  • Multi-environment view_image — image references resolve across whichever environment the turn is running in
  • Live app-server threads now refresh from updated config without restart — change a model, profile, or hook and the next turn picks it up
  • Turn diffs remain accurate across nested apply_patch operations
  • Fixed remote-control retry handling under flaky network conditions

CLI v0.129.0 - May 7, 2026

/vim, Theme-Aware Status, /hooks Browser, Goal Discoverability

Install: npm install -g @openai/codex@0.129.0

  • /vim — modal Vim editing in the composer with configurable defaults (normal, insert, off)
  • Redesigned resume/fork picker with raw scrollback mode and workspace-aware /diff
  • Theme-aware status line colors plus optional PR and branch summaries in the prompt area
  • /hooks browser — comprehensive plugin management with workspace sharing, share access controls, source filtering, local share path tracking, plus pre/post-compaction hook execution
  • Goal workflows are now discoverable/goals lists active and paused goals, paused goals survive --resume unless opted back in
  • TUI improvements: /copy works in tmux; Alt+Enter and modified Delete/Backspace behavior corrected; Windows typing latency reduced
  • Large paste placeholders and Ctrl+C drafts now survive clear/editor workflows; startup probes bounded
  • Linux sandbox reliability improvements; Windows sandbox handles named pipes and ConPTY teardown
  • Infrastructure: Linux releases bundle a standalone bwrap fallback; Bubblewrap vendored at 0.11.2 with upstream security updates

CLI v0.128.0 - April 30, 2026

Persistent /goal Workflows, Permission Profiles, MultiAgentV2

Install: npm install -g @openai/codex@0.128.0

  • Persistent /goal workflows with app-server APIs, model tools, runtime continuation, and TUI controls for create / pause / resume / clear — goals round-trip across sessions and survive --resume
  • codex update command with configurable TUI keymaps and plan-mode nudges
  • Action-required terminal titlesiTerm2, WezTerm, and other compatible terminals reflect “needs input” / “running” in the title bar
  • Active-turn /statusline and /title editing without restarting the session
  • Permission profiles: built-in defaults, sandbox CLI profile selection, cwd controls — switch profile per-task without rewriting config.toml
  • Plugin marketplace install, remote bundle caching, remote uninstall, plugin-bundled hooks
  • External agent session import including background imports and title handling — bring sessions from Claude Code or Aider into Codex with state preserved
  • MultiAgentV2 made explicit: thread caps, wait-time controls, root/subagent hints, v2-specific depth handling — no more silent unbounded fan-out
  • Documentation: Bundled OpenAI Docs skill updated for GPT-5.5 and gpt-image-2
  • Fixed stale interrupt hangs, persisted provider restoration, large remote response handling
  • Fixed TUI terminal resize reflow, markdown spacing, slash-command layout
  • Managed network hardened for deferred denials and proxy bypass

GPT-5.5 Release - April 23, 2026

Introducing GPT-5.5 in Codex

  • GPT-5.5 — OpenAI’s latest frontier model — now rolls out across Codex (CLI, App, IDE)
  • Stronger agentic coding, computer use, knowledge work, and research workflows
  • 1M context, pricing $5 / $30 per MTok input/output; GPT-5.5 Pro at $30 / $180
  • Available in Codex when signed in with ChatGPT (Plus / Pro / Business / Enterprise); API-key access followed on April 24, 2026
  • Switch with /model gpt-5.5 in the CLI, or pick it in the app/IDE model selector
  • Fast service tier enabled by default for eligible ChatGPT plans

CLI v0.124.0 - April 23, 2026

Reasoning Controls, Multi-Environment, Hooks Stable

Install: npm install -g @openai/codex@0.124.0

  • TUI reasoning controls: Alt+, decreases reasoning level, Alt+. increases it
  • Multi-environment support in app-server sessions with per-turn environment selection
  • Amazon Bedrock integration with AWS SigV4 signing and credential-based authentication
  • Remote plugin marketplace listing and cross-repo plugin sources
  • Hooks now stable — configurable inline in config.toml and requirements.toml
  • Fast service tier now defaults for eligible ChatGPT plans
  • Fixed Cloudflare cookie preservation across ChatGPT hosts
  • Remote app-server reliability improvements
  • Permission mode drift corrections
  • Fixed MCP startup through app-server sessions

CLI v0.123.0 - April 23, 2026

Amazon Bedrock, /mcp verbose, Plugin MCP Loading

Install: npm install -g @openai/codex@0.123.0

  • Built-in Amazon Bedrock model provider with AWS profile support
  • /mcp verbose for comprehensive MCP server diagnostics and resources
  • Enhanced plugin MCP loading — accepts both mcpServers and top-level server maps
  • Improved realtime handoffs with transcript deltas
  • Host-specific remote_sandbox_config requirements
  • Fixed post-rollback /copy functionality
  • Fixed Unicode/dead-key input support in VS Code WSL terminals
  • Fixed proxy environment variable handling from shell snapshots
  • Fixed codex exec inheritance of root-level shared flags

CLI v0.122.0 - April 20, 2026

Standalone Installs, /side Conversations, Plan Mode Preview

Install: npm install -g @openai/codex@0.122.0

  • Standalone installs improvedcodex app now opens Desktop correctly on Windows and Intel Macs
  • TUI /side conversations for quick questions with queued input, supporting slash commands
  • Plan Mode context-usage preview before implementing
  • Enhanced plugin workflows: tabbed browsing, inline toggles, marketplace removal
  • Filesystem deny-read glob policies with managed requirements and sandbox enforcement
  • Tool discovery and image generation enabled by default with higher-detail handling
  • New flags: --ignore-user-config and --ignore-rules for isolated codex exec runs
  • Split filesystem permission policies support
  • Fixed app-server approvals and MCP elicitations now disappear when resolved remotely
  • Remote-control startup tolerates missing ChatGPT auth
  • Resumed/forked threads replay token usage immediately

Codex App v26.415 - April 16, 2026

In-App Browser, Computer Use, Thread Automations, PR Reviews

  • In-app browser for local/public pages without sign-in, with direct comments on rendered pages
  • Computer use for macOS app operation (clicking, typing, visual interaction)
  • Chats as project-agnostic threads for research and analysis
  • Thread automations for scheduled wake-ups preserving conversation context
  • Task sidebar for tracking plans, sources, artifacts, and summaries
  • GitHub pull request reviews with diff inspection and comment review
  • Artifact viewer for PDFs, spreadsheets, documents, presentations
  • Memories carrying context from past tasks
  • Remote connections (SSH, alpha rollout)
  • Multi-terminal and multi-window support
  • Intel Mac and Windows system tray support

CLI v0.121.0 - April 15, 2026

Marketplace Add, Prompt History, Memory Controls

Install: npm install -g @openai/codex@0.121.0

  • codex marketplace add supporting GitHub, git URLs, local directories, and direct marketplace.json URLs (now reached via codex plugin marketplace add)
  • TUI prompt history with Ctrl+R reverse search and local recall for accepted slash commands
  • Memory mode controls: reset/deletion and cleanup in TUI and app-server
  • MCP Apps tool calls, namespaced MCP registration, parallel-call opt-in
  • Realtime output modality and transcript completion events
  • Secure devcontainer profile with bubblewrap support
  • Symlink-aware filesystem metadata
  • Fixed macOS sandbox/proxy handling for private DNS
  • Fixed Windows path matching with verbatim prefixes for resume --last
  • Guardian timeouts distinguished from policy denials with visible history entries
  • Broken symlinks skipped in fs/readDirectory

CLI v0.117.0 - March 26, 2026

Plugins First-Class & Sub-Agent Addressing

Install: npm install -g @openai/codex@0.117.0

  • Plugins are now a first-class workflow with startup syncing, browsing, and installation capabilities
  • Sub-agent addressing: Sub-agents now use readable path-based addresses like /root/agent_a with structured messaging
  • Image workflows improved: view_image returns URLs for code mode, generated images are reopenable, history survives resume
  • Terminal title picker (/title) works in both TUI variants for session identification
  • App-server clients support shell commands, filesystem watches, and remote websocket connections
  • Prompt history recall now works in app-server TUI across sessions
  • App-server-backed TUI enabled by default
  • Bug fixes: duplicate live reasoning summaries eliminated, terminal state restoration on early exits, Linux sandbox reliability improvements

Plugin System Announcement - March 25, 2026

Build and Install Plugins in Codex

  • Plugin system now available across app, CLI, and IDE extensions
  • Plugin structure features .codex-plugin/plugin.json manifest with optional skills, app configs, and MCP server settings
  • Supports per-user or per-repo installation via marketplace files and local directories
  • Built-in @plugin-creator skill for scaffolding new plugins
  • Codex surfaces curated public plugins alongside community contributions

Codex App v26.323 - March 24, 2026

Thread Search & Archive

  • Search for past threads with sidebar shortcuts and keyboard navigation
  • One-click archive option for all local threads in projects
  • Settings sync between Codex app and VS Code extension

CLI v0.116.0 - March 19, 2026

Plugin Setup, Hooks & Realtime Sessions

Install: npm install -g @openai/codex@0.116.0

  • App-server TUI supports device-code ChatGPT sign-in and token refresh
  • Plugin setup improvements: prompts for missing plugins, honors suggestion allowlist, syncs state remotely
  • Added userpromptsubmit hook to block or augment prompts before execution
  • Realtime sessions start with recent thread context; reduced self-interruption during audio playback
  • Bug fixes: websocket prewarm stall with timeout fallback, conversation history for remote operations, Linux sandbox startup on symlinked checkouts

Codex App v26.318 - March 19, 2026

Skills in @ Menu

  • Skills now appear in the @ menu alongside other mentions for quick composer insertion
  • Cmd/Ctrl+F starts with current text selection for faster review searching

GPT-5.3-Codex Announcement - February 5, 2026

Introducing GPT-5.3-Codex

  • The most capable agentic coding model to date for complex, real-world software engineering
  • Combines frontier coding performance of GPT-5.2-Codex with stronger reasoning and professional knowledge
  • Runs 25% faster for Codex users
  • Better collaboration while working — more frequent progress updates and real-time steering
  • Available across CLI, app, IDE extension, and Codex Cloud
  • Switch via codex --model gpt-5.3-codex or model selector in app/IDE

CLI v0.98.0 - February 5, 2026

GPT-5.3-Codex & Steer Mode Stable

Install: npm install -g @openai/codex@0.98.0

  • GPT-5.3-Codex support
  • Steer mode is now stable and enabled by default — Enter sends immediately during running tasks, Tab queues follow-up input
  • Fixed resumeThread() argument ordering in TypeScript SDK
  • Fixed model-instruction handling when changing models mid-conversation or resuming with a different model
  • Fixed remote compaction mismatch for token pre-estimation
  • Restored default assistant personality to Pragmatic

CLI v0.97.0 - February 5, 2026

Allow and Remember, Live Skills, Memory Plumbing

Install: npm install -g @openai/codex@0.97.0

  • Allow and remember — session-scoped option for MCP/App tool approvals, so repeated calls to the same tool auto-approve
  • Live skill updates — skill file changes picked up without restarting
  • /debug-config slash command to inspect effective configuration
  • Memory plumbing — initial API client and local persistence for thread memory summaries
  • Configurable log_dir for log redirection
  • Mixed text and image content in dynamic tool outputs for app-server integrations
  • Bug fixes: TUI jitter in apps/connectors picker, working status indicator restored, cloud requirements reliability

Codex App v260205 - February 5, 2026

GPT-5.3-Codex & Mid-Turn Steering

  • Support for GPT-5.3-Codex
  • Mid-turn steering — submit a message while Codex is working to direct its behavior
  • Attach or drop any file type
  • App flickering fix

CLI v0.96.0 - February 4, 2026

Thread Compact API & Unified Exec

Install: npm install -g @openai/codex@0.96.0

  • thread/compact async trigger in v2 app-server API for client-controlled compaction
  • WebSocket-side rate limit signaling via codex.rate_limits event
  • unified_exec enabled on all non-Windows platforms
  • Constrained requirement values include source provenance for /debug-config
  • Bug fixes: Esc handling in request_user_input, thread listing from state DB, dynamic tool injection transactions

Codex App v260204 - February 4, 2026

Zed & TextMate Support

  • Added Zed and TextMate as options to open files and folders
  • PDF preview in the review panel
  • Performance improvements

CLI v0.95.0 - February 4, 2026

Codex App Launcher, Personal Skills, Parallel Shell

Install: npm install -g @openai/codex@0.95.0

  • codex app <path> on macOS — launch Codex Desktop from CLI (auto-downloads DMG if missing)
  • Personal skills loaded from ~/.agents/skills (with ~/.codex/skills compatibility)
  • Remote skill listing and download via app-server APIs
  • Parallel shell tools — shell-related tools can run in parallel for improved throughput
  • /plan accepts inline prompt arguments and pasted images
  • Shell executions receive CODEX_THREAD_ID for active session detection
  • Vendored Bubblewrap (bwrap) sandbox groundwork for Linux
  • Bug fixes: Git command safety hardened, resume/thread listing reliability, sandbox mode consistency, codex exec hang after interrupt

Codex App Launch - February 2, 2026

Introducing the Codex Desktop App

  • macOS desktop interface for running agent threads in parallel
  • Project sidebar, thread list, and review pane
  • Built-in worktree support for isolated changes
  • Voice dictation and built-in Git tooling
  • Multitask across multiple projects simultaneously
  1. May 2025: Codex CLI initial release as open-source tool
  2. June-August 2025: MCP integration, GitHub Actions, sandbox improvements
  3. September 2025: Skills system, configuration overhaul
  4. October 2025: IDE extension launch, app-server API
  5. November 2025: Cloud environments (Codex Cloud), Slack integration
  6. December 2025: Linear integration, worktree support
  7. January 2026: Enhanced review mode, automation improvements
  8. February 2026: GPT-5.3-Codex, Codex Desktop App, steer mode stable, personal skills, parallel shell tools, memory plumbing
  9. March 2026: Plugin system first-class, sub-agent addressing, thread search, userpromptsubmit hook, realtime sessions
  10. April 2026: GPT-5.5 rolling out, in-app browser, computer use (macOS), thread automations, GitHub PR reviews, Amazon Bedrock provider, TUI reasoning controls, hooks stable, marketplace add
  11. May 2026: codex doctor diagnostics, Vim editing in the composer, persistent goals on by default, codex remote-control foreground daemon, permission profiles, Python SDK auth
  12. June 2026: Session archiving (/archive), clickable TUI links, F13-F24 keybindings, controller pairing, parallel standalone web search, Windows elevated sandbox setup