OpenAI Codex CLI
rust-v0.152.0-alpha.6 open-sourceLightweight coding agent that runs in your terminal
tools:
update_plan:
enabled: true
codex mcp add npm:@modelcontextprotocol/server-sequential.thinking
features:
sleep_tool:
mode: always_on
[features.guardianv2]
persist_scores = true
[features.guardianv2]
free_guardian = true
features:
guardianv2:
review_scope:
computer_use_only: true
codex exec --thread-source automated_review --skip-git-repo-check --json
codex exec --thread-source automated_review --json --skip-git-repo-check "Review the diff and suggest fixes"
[tui.keymap.chat]
next_permission_mode = "]"
previous_permission_mode = "["
codex queue <session-id> 'Run the full test suite and report failures'
codex resume --no-alt-screen <session-id>
/export
codex exec fork
/status
/export
codex exec fork
/status
codex agents
codex agents
const codex = new Codex({
configOverrides: [
'--config', 'sandbox.writable_roots."/var/myapp/data"=true'
]
});
const codex = new Codex({
configOverrides: [
'--config', 'sandbox.writable_roots."/var/myapp/data"=true'
]
});
oauth:
callback_port: 9876
oauth:
callback_port: 9876
thread-credits, estimated-thread-cost
thread-credits, estimated-thread-cost
codex migrate-rollouts
codex migrate-rollouts
codex exec fork session-123 'continue refactoring the auth module'
/export ~/projects/my-session.md
CODEX_AGENT_IDENTITY_AUTHAPI_BASE_URL=https://staging-auth.example.com CODEX_AGENT_IDENTITY_JWKS_BASE_URL=https://staging-jwks.example.com codex
codex exec fork session-123 'continue refactoring the auth module'
/export ~/projects/my-session.md
CODEX_AGENT_IDENTITY_AUTHAPI_BASE_URL=https://staging-auth.example.com CODEX_AGENT_IDENTITY_JWKS_BASE_URL=https://staging-jwks.example.com codex
codex migrate-rollouts --verbose --json
codex migrate-rollouts --apply --thread <THREAD_ID> --max-mib-per-second 50
codex migrate-rollouts --verbose --json
codex migrate-rollouts --apply --thread <THREAD_ID> --max-mib-per-second 50
codex exec --approve-for-me --sandbox workspace-write 'refactor auth module to use JWT'
codex --approve-for-me 'refactor the auth module to use async/await'
codex exec --sandbox workspace-write 'add unit tests for the payments service'
codex exec-server --concurrent-requests 4 --listen ws://127.0.0.1:8080
codex --psp
codex exec-server --concurrent-requests 4 --listen ws://127.0.0.1:8080
codex --psp
/new my-audit-session
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
codex-app-server --code-mode-host wss://example.com/code-mode --listen stdio://
codex-app-server --code-mode-host wss://example.com/code-mode --listen stdio://
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
codex remote-control pair
# In your Codex config, enable system proxy resolution:
respect_system_proxy: true
codex delete
codex plugin marketplace list --json
/app
codex plugin list --json
codex plugin list --json
codex archive <session-id>
codex unarchive <session-id>
codex app-server --stdio
codex doctor
CODEX_NON_INTERACTIVE=1 bash install.sh
/status
codex --profile my-restricted-profile sandbox <target>
codex mcp add --oauth https://example.com/mcp
codex exec resume <session-id> --output-schema '{"type":"object","properties":{"result":{"type":"string"}}}'
codex doctor
codex remote-control
/vim
/hooks
/keymap debug
codex update
codex /statusline "Running recon phase…"
codex exec --json 'Audit this codebase for hardcoded credentials' | jq '.usage.reasoning_tokens'
# Inside the Codex TUI, press Alt+, to lower reasoning or Alt+. to raise it
[hooks]
[[hooks.post_tool_use]]
tool = "apply_patch"
command = "ruff check --fix ."
/mcp verbose
/side What does this function return when input is nil?
/status
codex marketplace add https://github.com/<org>/<marketplace-repo>
codex marketplace add /path/to/local/marketplace
# Inside the Codex TUI composer, press Ctrl+R and type keywords to reverse-search prompt history.
cat main.rs | codex exec "Refactor this to use idiomatic error handling"
/plugins
/title
# In your Codex hooks config, register the new hook:
# hooks:
# userpromptsubmit:
# - <path-to-your-hook-script>
openai_base_url = "https://my-proxy.internal/v1"
curl -sf http://localhost:<port>/healthz && echo 'healthy'
const utils = await import('./scripts/utils.mjs');
utils.analyzeResults(data);
/fast
/agent
codex debug clear-memories
# In your Codex config file (e.g. ~/.codex/config.toml)
[features]
voice_transcription = true
WS_PROXY=ws://proxy.corp.example.com:3128 codex
/m_drop
/m_update
/statusline
# requirements.toml
[requirements]
allowed_web_search_modes = ["safe"]
[network]
# network constraints defined here
/debug-config
/plan refactor the authentication module to use JWT tokens
echo "Running in Codex thread: $CODEX_THREAD_ID"
# In your codex config (e.g., ~/.codex/config.toml)
personality = "friendly"
tui:
notifications_method: "system"
/permissions
/skill
codex cloud list
model_instructions_file = "/path/to/instructions.md"
# Place SKILL.toml at your project root:
cat SKILL.toml
# name = "My Skill"
# description = "Does X and Y"
# icon = "🔍"
# brand_color = "#FF6600"
# default_prompt = "Start by summarizing the repo."
codex --no-alt-screen "refactor the auth module"
/elevate-sandbox
[analytics]
enabled = false
# While in the Codex TUI, press Ctrl+G to open the current prompt in $VISUAL or $EDITOR, edit, save, and quit — edits are synced back automatically.
# In your project's requirements.toml
allowed_sandbox_modes = ["workspace-write"]
/ps
/experimental
/resume
/skills
# In your Codex config file:
history:
max_bytes: 10485760
npx @openai/codex-shell-tool-mcp login
# In ~/.codex/config.toml
tool_output_token_limit = 10000
codex debug seatbelt --log-denials
/exit
!git status
codex --add-dir ../shared-lib 'Refactor the auth module to use the shared validation helpers'
# In your Codex config (e.g. ~/.codex/config.toml):
[mcp_servers.my_server]
enabled_tools = ["read_file", "search_code"]
# In managed config:
forced_login_method = "chatgpt"
forced_chatgpt_workspace_id = "ws-abc123"
codex exec --dangerous-auto-approval 'run the test suite and output results'
codex cloud exec 'refactor the auth module to use JWT'
# In ~/.config/codex/config.toml
experimental_use_rmcp_client = true
[[mcp_servers]]
name = "my-server"
url = "https://my-mcp-server.example.com"
enabled = false
printenv OPENAI_API_KEY | codex login --with-api-key
codex cloud
CODEX_SECURE_MODE=1 codex <prompt>
/status
codex exec --output-schema '{"type":"object","properties":{"result":{"type":"string"}}}' 'Summarize the findings in ./report.txt'
codex exec --include-plan-tool 'Refactor the auth module in ./src/auth.rs to use async/await'
[mcp_servers.my_server]
tool_timeout_sec = 120
/review
codex login --api-key "sk-...your-key..."
# In your codex config (e.g., ~/.codex/config.toml)
[mcp_servers.my_server]
command = "my-mcp-server"
startup_timeout_ms = 15000
codex --resume
codex --continue
mkdir -p ~/.codex/prompts
echo 'Summarize the security implications of the following code:' > ~/.codex/prompts/secreview.md
# Then inside a Codex session, type: /secreview
# While messages are queued, press ESC to move them back to the composer for editing.
# Inside a running codex TUI session, press Ctrl+T to open transcript mode and scroll through the history.
# In your codex config file:
model_verbosity = "low"
/model
/approvals
/mcp
# While Codex TUI is running, press:
ctrl-z
# To resume:
fg
codex --ask-for-approval on-request 'refactor the auth module to use JWT'
codex --sandbox workspace-write --ask-for-approval on-request 'add unit tests for src/api.rs'
/compact
codex exec --json 'summarize the security findings in REPORT.md'
codex apply
# In your Codex config file:
model_supports_reasoning_summaries: true
codex completion bash
codex --sandbox <sandbox-policy> "refactor the auth module" Summary
OpenAI Codex CLI is an open-source coding agent, free to use, that runs locally in your terminal to inspect files, edit code, run commands, and automate repeatable development tasks against your own repository. It is installed via a standalone script, npm, or Homebrew and run as the `codex` command from a project directory, either interactively or through `codex exec` in scripts and CI pipelines, making it suited to application developers who want an agent working directly against their local codebase rather than a cloud sandbox. The README distinguishes it from OpenAI's own IDE extension and cloud-based Codex Web offering, positioning the CLI specifically as the local, terminal-native option. Started in 2025, it has drawn nearly 700 contributors and over a hundred releases in the past year, with the latest just two weeks old, pointing to active, fast-moving development.
Lightweight coding agent that runs in your terminal
What OpenAI Codex CLI answers
Does it work with tools connected through MCP?
reports detailed server status and diagnoses HTTP send failures from within the CLI, and preserves complex tool schemas so more MCP servers work correctly
Can I hand a task off to something with a GUI partway through?
a running session can be pushed into Codex Desktop on macOS or Windows without losing its context
Can I script it for CI or audit pipelines?
plugin inventories, marketplace actions, and session archiving all support structured output so results can be parsed instead of read
How does it handle a session I'm not ready to resume yet?
sessions can be archived and later restored, so a completed or paused thread isn't accidentally continued or forked
Can multiple agents work on a thread at once?
a multi-agent mode keeps a separate runtime choice per thread and tracks follow-up tasks and metadata for each spawned agent
Does it run on Windows the same way as macOS or Linux?
an admin-provisioned, elevated sandbox setup is available as an alpha path, alongside constrained requirements for supported Windows sandbox implementations
Examples
Command line
No option matches that search.
| option | found in | since | description |
|---|
No option matches that search.
Values are placeholders taken from each option’s declared default. Nothing is executed here — the output shown is a recording of a run that already happened.
Release history
- rust-v0.152.0-alpha.6
Codex CLI alpha.6 adds actionable rate-limit banners in the TUI and makes the
update_plantool opt-in via config.└──▷ GET THIS VERSION$ git clone --branch rust-v0.152.0-alpha.6 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.152.0-alpha.6
└──▷ USE ITRe-enable theupdate_plantool when your workflow depends on Codex explicitly tracking and updating a plan during long-running tasks.tools: update_plan: enabled: true- ›Adds
tools.update_plan.enabledconfig key (defaults tofalse); set it totrueto explicitly expose theupdate_plantool — removing bundled planning guidance from prompts when disabled. - ›Adds actionable rate-limit banners in the TUI rendered above the composer, with actions for usage, credits, resets, owner notifications, plan management, and automatic fallback-model switching when instructed by the banner.
- ›Sets
history_ingest_requestedtotruein Responses turn metadata when the history-notes token-budget extension is enabled, and reserves the key so caller-provided metadata cannot override it.
└──▷ BREAKING ON UPGRADE- !The
update_plantool now defaults to disabled (tools.update_plan.enabled: false); any workflow relying onupdate_planbeing available by default will stop receiving it until the key is explicitly set totrue.
- ›Adds
- rust-v0.152.0-alpha.5
Codex CLI now accepts package-style MCP server names containing
:,@,/, and.└──▷ GET THIS VERSION$ git clone --branch rust-v0.152.0-alpha.5 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.152.0-alpha.5
└──▷ TRY ITRegister an npm-scoped MCP server using its full package-style name so the tool namespace and OAuth credentials stay properly isolated.$ codex mcp add npm:@modelcontextprotocol/server-sequential.thinking- ›MCP server names may now contain
:,@,/, and.in addition to letters, numbers,-, and_, enabling names likenpm:@modelcontextprotocol/server-sequential.thinkingacrossmcp add,get,list, andremovecommands, runtime tool namespaces, and OAuth credential lookup.
- ›MCP server names may now contain
- rust-v0.152.0-alpha.4
Codex CLI gains clock tools from model metadata, per-tool MCP output limits, configurable sleep-tool gating, and elicitation form support.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.152.0-alpha.4 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.152.0-alpha.4
- ›Adds
clock.curr_timeandclock.sleeptools when a model listsclockinexperimental_supported_toolsmetadata, with current-time reminder injection controlled separately by thecurrent_time_reminderfeature. - ›Adds configurable gating for the sleep tool.
- ›Adds Vim search motions to the TUI composer.
- ›Subagents now follow the root service tier.
- ›Guardian context rolls over before follow-up reviews to handle exhausted context windows, replaying the full transcript and image evidence after compaction.
+3 moreshow less
- ›History notes images are forwarded to the model.
- ›MCP HTTP helper headers are refreshed after authorization failures.
- ›Executor hooks now run for interrupted turns.
- ›Adds
- rust-v0.151.0-alpha.7.2
Adds configurable
sleep_toolfeature gating, model-metadata-driven clock tools, and one-shot exec fallback withtimeout_msin managed mode.└──▷ GET THIS VERSION$ git clone --branch rust-v0.151.0-alpha.7.2 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.151.0-alpha.7.2
└──▷ USE ITForce the sleep tool on regardless of model metadata, useful when automating workflows that need deliberate pauses.features: sleep_tool: mode: always_on- ›Adds
features.sleep_toolconfig key withmodel_drivenandalways_onmodes to independently gate registration of the built-in sleep tool, separate from the broader clock tool. - ›Registers both
clock.curr_timeandclock.sleeptools automatically when a model advertisesclockin itsexperimental_supported_toolsmetadata. - ›Preserves
exec_commandin completion-only (one-shot) mode whenunified_execis disabled, adding atimeout_msargument and terminating timed-out commands with exit code 124. - ›Removes
tty,yield_time_ms,session_id, andwrite_stdinfrom one-shot exec mode whenunified_execis disabled.
└──▷ BREAKING ON UPGRADE- !
tty,yield_time_ms,session_id, andwrite_stdinare removed fromexec_commandwhen operating in completion-only mode withunified_execdisabled.
- ›Adds
- rust-v0.152.0-alpha.1
Codex CLI 0.152.0-alpha.1 adds clock tools, configurable sleep gating, per-tool MCP output limits, configurable thread shell timeouts, and elicitation form support.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.152.0-alpha.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.152.0-alpha.1
- ›Adds configurable gating for the
sleeptool, allowing it to be independently controlled. - ›Adds support for per-tool MCP output limits to cap individual tool response sizes.
- ›Adds support for configurable timeouts for thread shell commands.
- ›Adds support for
openai/elicitationform requests in the agent runtime. - ›Exposes the PowerShell version in environment context for Windows sessions.
+6 moreshow less
- ›Adds app-server notification media filtering to suppress media from function call output notifications.
- ›Supports compression for shared rollout lineages.
- ›Preloads plugin recommendations during session startup for faster availability.
- ›Forwards history note images to the model for multimodal context.
- ›Makes subagents follow the root service tier for consistent resource usage.
- ›Supports app targets in executor plugin hooks.
- ›Adds configurable gating for the
- rust-v0.151.0
Codex CLI adds configurable MCP startup grace period, extension MCP result interception, and per-repo plugin catalog merging.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.151.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.151.0
- ›Adds a configurable grace period for discovering tools from optional MCP servers at startup, preventing slow servers from blocking the agent.
- ›Enables extensions to inspect or replace MCP tool results before they reach the model, allowing middleware-style transformation of tool output.
- ›Plugin catalogs now merge per-repository configuration with global settings and surface invalid project marketplace entries without suppressing valid plugins.
- rust-v0.151.0-alpha.12
Codex CLI alpha.12 adds compression for shared rollout lineages, per-tool MCP output limits, and configurable shell command timeouts.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.151.0-alpha.12 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.151.0-alpha.12
- ›Adds opt-in
local_thread_store_shared_compressionfeature flag to enable zstd compression for shared rollout lineages, including referenced sources and fork pointers. - ›Supports per-tool MCP output limits, letting operators cap how much output individual MCP tools can return.
- ›Records
codex.app_server.codex_home.size_bytesmetrics forCODEX_HOME,sessions, andarchived_sessionssubdirectories at app-server startup. - ›Responds to terminal queries from TTY subprocesses, improving compatibility with interactive tools run inside the agent.
- ›Restricts cloud task credentials to trusted origins, narrowing the credential exposure surface.
- ›Adds opt-in
- rust-v0.151.0-alpha.11
Adds configurable
timeoutMstothread/shellCommandand platform-aware Windows shell guidance forexec_command.└──▷ GET THIS VERSION$ git clone --branch rust-v0.151.0-alpha.11 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.151.0-alpha.11
- ›Adds optional
timeoutMsparameter tothread/shellCommandto set per-command deadlines; defaults to one hour when omitted ornull, treats0as an immediate timeout, and rejects negative values. - ›Adapts
exec_commandtool description to include Windows-specific safety guidance when the executor platform is Windows, and omits it for non-Windows executors. - ›Measures
CODEX_HOMEdisk usage at app-server startup, recordingcodex.app_server.codex_home.size_bytesfor the home directory andsessions/archived_sessionssubdirectories.
- ›Adds optional
- rust-v0.151.0-alpha.3
Codex CLI adds
write_stdin_approvalfeature flag to gate input to escalated terminals and exposes MCP provenance to tool lifecycle extensions.└──▷ GET THIS VERSION$ git clone --branch rust-v0.151.0-alpha.3 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.151.0-alpha.3
- ›Adds
write_stdin_approvalfeature flag (disabled by default) to require an explicit approval before sending non-empty input to an escalated unified-exec terminal, routing reviews through hooks, Guardian, app-server, and the TUI aswriteStdinapprovals. - ›Exposes MCP provenance metadata via optional
McpToolContextinToolStartInput, classifying MCP calls as connectors, configured servers, plugin servers, executor-selected plugins, or other registrations. - ›Gives Guardian a bounded trusted context fragment for user-configured MCP tools and connectors, while keeping tool descriptions, outputs, and unrelated tools untrusted.
- ›Records Windows sandbox world-writable scan results in the
codex.windows_sandbox.world_writable_scan_flagged_directorieshistogram, tagged withsuccessorerror, for both startup and warning-triggered scans. - ›Prearms Guardian's WebSocket pool in a background task so thread startup and resume are no longer blocked by initial Guardian connection delays.
- ›Adds
- rust-v0.151.0-alpha.2
Codex CLI adds Guardian V2 risk score persistence, dedicated Guardian endpoints, Vim buffer jump motions, and layered plugin config support.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.151.0-alpha.2 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.151.0-alpha.2
└──▷ USE ITEnable Guardian risk score persistence to disk for a debugging session — scores are written to rollout files only when this is explicitly set.[features.guardianv2] persist_scores = true
Route Guardian inference through dedicated endpoints instead of/responsesto reduce latency and separate Guardian traffic.[features.guardianv2] free_guardian = true
- ›Adds
features.guardianv2.persist_scoresconfig option (defaultfalse) to opt into writing Guardian V2 reviewed actions and risk scores to rollout files for debugging. - ›Adds
features.guardianv2.free_guardianconfig option to route eligible Guardian reviews to/guardianand asynchronous classifications to/guardian-classifierinstead of/responses. - ›Honors layered configuration (not just user config) when loading plugins and marketplace sources.
- ›Adds Vim buffer jump motions to the TUI.
- ›Attaches originating Responses item ID to MCP tool request metadata as
_meta.itemId.
+4 moreshow less
- ›Classifies streaming rate-limit errors as
RateLimitExceededfor more precise error handling. - ›Enables clock tools for persistent reasoning turns.
- ›Restricts macOS scratch directory access to process sandboxes.
- ›Records
call_idandactionfields onSecurityRiskScoreso persisted scores identify the tool call and bounded action that produced them.
- ›Adds
- rust-v0.150.0
Codex CLI v0.150.0 adds task
@mentions,/copytarget picker, Interrupt hooks, and keybindings for permission-mode cycling.└──▷ GET THIS VERSION$ git clone --branch rust-v0.150.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.150.0
- ›Adds
/copycommand picker to select full responses, individual code blocks, or blockquotes when copying output. - ›Adds
/renamecommand that suggests an editable title for the current task based on the conversation. - ›New Interrupt hooks let you run commands or MCP handlers when an active top-level turn is interrupted.
- ›Adds keybindings for cycling through TUI permission modes, and
.in Vim mode to repeat the last edit. - ›Supports referencing other Codex tasks with
@mentions, enabling agents to read, create, or message tasks from the terminal.
+2 moreshow less
- ›Unnamed terminal tasks now receive descriptive titles automatically.
- ›Markdown links render as clickable labels in supported terminals, with visible URLs retained in other terminals.
- ›Adds
- rust-v0.150.0-alpha.11
Codex CLI alpha.11 adds per-turn cyber access program selection and hardens MCP OAuth callback handling.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.150.0-alpha.11 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.150.0-alpha.11
- ›Adds the experimental
turn/start.cyberAccessProgramoption withstandard,daybreakBlue, anddaybreakRedvalues, forwarded asaccess_programs.cyberon Responses, WebSocket, and remote-compaction requests when using ChatGPT authentication. - ›Hardens MCP OAuth callback handling by validating issuer-bound authorization responses, persisting registered callback URLs for MCP servers and plugins, and inserting the active listener port into portless loopback redirects.
- ›Adds a hidden
--feedbackflag tocodex doctorthat bounds each SQLite database integrity scan to a one-second deadline when collecting diagnostic attachments. - ›Restricts
--code-mode-hoston the app server to accept onlyhttp://andhttps://gRPC endpoints; WebSocket (ws://,wss://) host URLs are now rejected at CLI parse time.
└──▷ BREAKING ON UPGRADE- !The app server
--code-mode-hostflag no longer acceptsws://orwss://URLs; onlyhttp://andhttps://gRPC endpoints are valid. Any configuration passing a WebSocket URL to--code-mode-hostwill fail at startup.
- ›Adds the experimental
- rust-v0.150.0-alpha.10
Codex CLI alpha.10 adds managed AWS Bedrock access keys, computer-use-only Guardian scope, dot-repeat in Vim mode, and OTEL turn-cost metrics.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.150.0-alpha.10 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.150.0-alpha.10
└──▷ USE ITRestrict Guardian v2 fast approvals to browser/computer-use tools only, keeping shell commands on the stricter synchronous path.features: guardianv2: review_scope: computer_use_only: true- ›Adds
features.guardianv2.review_scope.computer_use_onlyconfig key to restrict async Guardian v2 classification and fast approvals exclusively to browser and computer-use REPL tools, keeping all other tools on the synchronous approval path. - ›Adds
amazonBedrockAccessKeyslogin flow, persisting SigV4-signed credentials in the configured auth store and reportingbedrockAccessKeysas a distinct auth mode. - ›Adds
root_turn_idfield to turn and tool-item analytics events to associate subagent activity with its originating top-level turn. - ›Introduces paginated thread history APIs and defaults durable threads to paginated history.
- ›Adds Amazon Bedrock setup to the TUI onboarding flow.
+5 moreshow less
- ›Adds worktree settings parser for per-worktree configuration.
- ›Brokers credential aliases in child environments, replacing embedded credentials with broker dummies and restoring only virtualized aliases.
- ›Shows reconnect guidance in the TUI when disconnecting from tasks.
- ›Allows extensions to skip host skill discovery.
- ›Reconnects MCP servers automatically when authentication mode changes or startup timeout is updated.
- ›Adds
- rust-v0.150.0-alpha.9
Codex CLI adds managed AWS access keys for Amazon Bedrock, computer-use-only Guardian v2 scope, OTEL turn-cost metrics, and dot-repeat in Vim mode.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.150.0-alpha.9 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.150.0-alpha.9
- ›Adds
BedrockAccessKeysas a distinct auth mode, enabling the experimentalamazonBedrockAccessKeysapp-server login flow with SigV4-signed Bedrock requests; credentials are persisted in the configured auth store and reported asbedrockAccessKeysin login status. - ›Adds
features.guardianv2.review_scope.computer_use_onlyconfig option to restrict async classification and fast approvals exclusively to browser and computer-use REPL tools, giving this scope precedence oversandboxed_exec_commandswhen both are enabled. - ›Brokers credential aliases in child environments by discovering, replacing, and restoring credentials inherited from the parent even when their canonical provider variable is filtered out of the child environment.
- ›Adds dot-repeat support to Vim mode in the TUI.
- ›Generates descriptive TUI thread titles and suggests conversation-based titles via
/rename.
+2 moreshow less
- ›Persists realtime events in the thread timeline and adds persisted thread artifact models.
- ›Adds hooks for interrupted turns.
- ›Adds
- rust-v0.149.1
Codex CLI gains
--thread-sourceflag to classify new threads, plus an opt-incompaction_image_budgetfor image-aware remote compaction.└──▷ GET THIS VERSION$ git clone --branch rust-v0.149.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.149.1
└──▷ TRY ITTag threads created by an automated review pipeline so they are distinguishable from interactive user sessions.$ codex exec --thread-source automated_review --skip-git-repo-check --json
- ›Adds global
--thread-source <SOURCE>flag tocodex execto classify newly created or forked threads (e.g.automated_review,memory_consolidation); defaults touserwhen omitted and does not override the source when resuming an existing thread. - ›Adds opt-in
compaction_image_budgetfeature to charge retained images against the remote compaction budget using the existing image size estimate, preventing image-heavy histories from exceeding the intended context budget.
- ›Adds global
- rust-v0.149.0-alpha.4.3
Codex CLI gains
--thread-sourceflag for classifying new threads, plus Amazon Bedrock multi-agent and compaction improvements.└──▷ GET THIS VERSION$ git clone --branch rust-v0.149.0-alpha.4.3 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.149.0-alpha.4.3
└──▷ TRY ITLabel an automated CI pipeline's Codex exec run as machine-initiated so threads are classified correctly in metadata.$ codex exec --thread-source automated_review --json --skip-git-repo-check "Review the diff and suggest fixes"
- ›Switches Amazon Bedrock to multi-agent V1 protocol, which does not require response items unsupported by Bedrock.
- ›Enables Responses compaction (
compaction_triggeritems via/v1/responses) for Amazon Bedrock, bringing it in line with OpenAI and Azure Responses providers.
- rust-v0.150.0-alpha.7
Codex CLI adds app signature verification, MCP event streaming, shell snapshot caching, hostname in TUI status, and
codex agentssession config└──▷ GET THIS VERSION$ git clone --branch rust-v0.150.0-alpha.7 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.150.0-alpha.7
- ›Adds
codex agentssubcommand to allow session configuration directly from the CLI. - ›Adds keybindings for cycling TUI permission modes interactively.
- ›Adds a response target picker to the
/copycommand. - ›Enforces issuer binding for MCP OAuth endpoints.
- ›Enables discovery of HTTP MCP servers from selected executors.
+4 moreshow less
- ›Supports attaching to existing realtime calls.
- ›Enforces environment network policies for remote execution.
- ›Makes tool-result telemetry limits configurable.
- ›Ignores project instructions for untrusted projects.
- ›Adds
- rust-v0.149.0-alpha.7.2
Amazon Bedrock gets multi-agent V1 support and Responses-based compaction; Guardian reviews now cancel with their tool calls.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.149.0-alpha.7.2 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.149.0-alpha.7.2
- ›Enables multi-agent V1 protocol for Amazon Bedrock models, which do not support the response items required by multi-agent V2.
- ›Switches Amazon Bedrock remote compaction to
compaction_triggeritems sent through/v1/responses, replacing the legacy dedicated compaction protocol. - ›Propagates tool cancellation tokens into Guardian approval reviews so interrupting a tool also aborts its pending review, including server-initiated MCP approval elicitation.
└──▷ BREAKING ON UPGRADE- !The legacy dedicated compaction protocol is removed from provider capabilities; remote compaction now defaults to unsupported and must be explicitly enabled per provider (currently OpenAI, Azure Responses, and Amazon Bedrock).
- rust-v0.150.0-alpha.6
Codex CLI alpha.6 adds Guardian internal sessions, Amazon Bedrock app-server setup, browser/computer-use config, and a response target picker for
/copy.└──▷ GET THIS VERSION$ git clone --branch rust-v0.150.0-alpha.6 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.150.0-alpha.6
- ›Adds a response target picker to the
/copycommand, letting users choose which response to copy. - ›Implements Amazon Bedrock setup in the app server, enabling Bedrock-backed model configuration.
- ›Adds browser and computer-use configuration and exposes browser/computer-use requirements through the app server.
- ›Adds Guardian internal session support, with escalated commands routed through synchronous Guardian review and Guardian reviews reused in async risk scoring.
- ›Enforces environment network policies for remote execution, composing owner rules with controller constraints and saved network decisions.
+1 moreshow less
- ›Hides Fast mode status for models that do not support it.
- ›Adds a response target picker to the
- rust-v0.150.0-alpha.3
Codex CLI alpha.3 adds
codex agentssession config, TUI permission-mode keybindings, and existing-realtime-call attachment.└──▷ GET THIS VERSION$ git clone --branch rust-v0.150.0-alpha.3 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.150.0-alpha.3
└──▷ USE ITBind keys to cycle through TUI permission modes without touching the active config file.[tui.keymap.chat] next_permission_mode = "]" previous_permission_mode = "["
- ›Adds
previous_permission_modeandnext_permission_modeactions totui.keymap.chatinconfig.toml, letting users bind keys to cycle through available built-in permission modes in the TUI. - ›Adds
existingCalltransport tothread/realtime/start, accepting a client-providedcallIdand optionalrealtimeSessionIdso clients can attach Codex to a pre-negotiated realtime call. - ›Allows
codex agentsto accept session-configuration options — model, approval policy, sandbox mode, web search, working directory, and config overrides — when opening the agents dashboard. - ›Discovers HTTP MCP servers from selected executors and honors required MCP servers declared by those executors.
- ›Enforces issuer binding for MCP OAuth endpoints.
+2 moreshow less
- ›Adds in-memory shell snapshots to unified exec and honors request PATH in exec-server shell snapshots.
- ›Supports voice-aware configuration and version-skew builds.
- ›Adds
- rust-v0.150.0-alpha.2
Codex CLI alpha adds macOS app signature verification, shell snapshot caching, MCP event streaming, and Amazon Bedrock multi-agent support.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.150.0-alpha.2 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.150.0-alpha.2
- ›Adds
additional_developer_instructionsto managed requirements, exposed viaconfigRequirements/readasadditionalDeveloperInstructions, with a 10,000 estimated-token size limit. - ›Adds app-server MCP event streaming.
- ›Adds hostname to the configurable TUI status line.
- ›Adds history and notes tools for token-budget sessions.
- ›Adds
resolve_permission_profile_selectionto select the effective permission profile using configured defaults, managed requirements, and allowlists without compiling platform-specific paths.
+8 moreshow less
- ›Verifies Codex desktop app bundle signatures using Apple codesign (bundle identifier
com.openai.codex, team ID2DC432GLL2) before launching or installing on macOS. - ›Enables multi-agent V1 protocol and Responses compaction for Amazon Bedrock models.
- ›Requires filesystem backends to implement directory walks with bounded local walks on a blocking task, including symlink cycle detection, deterministic ordering, error collection, and response-size limits.
- ›Includes suggestion IDs in plugin install metadata.
- ›Supports turn cost telemetry for custom model providers.
- ›Supports standalone named function call outputs handled as external context.
- ›Refreshes bundled model definitions.
- ›Retries transient registry failures during initial exec connection.
- ›Adds
- rust-v0.149.0-alpha.4.1
Codex CLI adds Amazon Bedrock multi-agent V1 support and Responses-based compaction for Bedrock providers.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.149.0-alpha.4.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.149.0-alpha.4.1
- ›Enables multi-agent V1 protocol for Amazon Bedrock models, normalizing Bedrock model catalogs to advertise
MultiAgentVersion::V1to work around Bedrock's lack of support for response items required by multi-agent V2. - ›Switches Amazon Bedrock remote compaction to use
compaction_triggeritems sent through/v1/responsesinstead of the legacy dedicated compaction protocol, and explicitly enables remote compaction for OpenAI, Azure Responses, and Amazon Bedrock providers.
└──▷ BREAKING ON UPGRADE- !The legacy dedicated compaction protocol is removed from provider capabilities; remote compaction now defaults to unsupported and must be explicitly enabled per provider.
- ›Enables multi-agent V1 protocol for Amazon Bedrock models, normalizing Bedrock model catalogs to advertise
- rust-v0.150.0-alpha.1
Codex CLI 0.150.0-alpha.1 adds app signature verification, shell snapshot caching, MCP event streaming, and configurable TUI hostname display.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.150.0-alpha.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.150.0-alpha.1
- ›Adds
shellSnapshotV2executor capability and an optional shell snapshot request toExecParams, caching and restoring Unix shell state and profile exports forbash,zsh, andshin an in-memory, attachment-scoped cache. - ›Adds
additional_developer_instructionsto managed requirements, exposed throughconfigRequirements/readasadditionalDeveloperInstructions, with a 10,000 estimated-token size limit and support across compaction, resume, and agent forks. - ›Adds app-server MCP event streaming support.
- ›Adds hostname to the configurable TUI status line.
- ›Verifies Codex desktop app bundle signatures against OpenAI's Apple Team ID (
2DC432GLL2) usingcodesign --verify --deep --strictbefore launch or install.
+8 moreshow less
- ›Adds
resolve_permission_profile_selectionto select the effective permission profile using configured defaults, managed requirements, and allowlists, returning a merged catalog without compiling platform-specific paths. - ›Requires filesystem backends to implement directory walks natively, with bounded local walks including symlink cycle detection, deterministic ordering, error collection, and response-size limits.
- ›Supports turn cost telemetry for custom model providers.
- ›Supports standalone named function call outputs handled as external context.
- ›Refreshes bundled model definitions.
- ›Retries transient registry failures during initial exec server connection.
- ›Includes suggestion IDs in plugin install metadata.
- ›Supports host-accepted exec-server WebSockets.
- ›Adds
- rust-v0.149.0
Codex CLI v0.149.0 adds an interactive agents dashboard,
codex queue, TUI working-directory commands, and expandedcodex doctordiagnostics.└──▷ GET THIS VERSION$ git clone --branch rust-v0.149.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.149.0
└──▷ TRY ITSend a follow-up instruction to an already-running local or remote session without attaching to it interactively.$ codex queue <session-id> 'Run the full test suite and report failures'- ›Adds
codex agentscommand with an interactive dashboard for searching, starting, opening, renaming, and stopping tasks, with configurable shortcuts. - ›Adds
codex queuecommand for sending messages to existing local or remote sessions. - ›Adds
/cd,/pwd, and/cwdcommands for managing the working directory inside TUI sessions. - ›Expands
codex doctorto diagnose endpoint protection, network/proxy failures, desktop app state, Windows sandbox provisioning, and update connectivity. - ›SDK users can now pass exact CLI config overrides and select
maxorultrareasoning effort.
+1 moreshow less
- ›Expands Vim editing in the TUI composer with character replacement and change motions including
cw,c$, andcc.
- ›Adds
- rust-v0.149.0-alpha.4
Codex CLI alpha.4 raises MCP tool name limit to 128 bytes, adds
--no-alt-screenflag, warns on deprecatedcodex mcp-server, and hardens sandbox IPC isolation.└──▷ GET THIS VERSION$ git clone --branch rust-v0.149.0-alpha.4 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.149.0-alpha.4
└──▷ TRY ITKeep the TUI output inline (no alternate screen) when resuming a session inside a terminal that does not handle alt-screen well.$ codex resume --no-alt-screen <session-id>
- ›Adds
--no-alt-screenflag to theresumeandforksubcommands, preserved across both interactive and subcommand invocations. - ›Emits a deprecation warning when
codex mcp-serveris invoked: 'warning:codex mcp-serveris deprecated and will be removed in a future release.' - ›Passes
--unshare-ipcin Bubblewrap sandbox arguments to isolate IPC namespaces in both restricted-filesystem and full-filesystem sandbox paths. - ›Guardian V2 now satisfies required model reviews and skips sandboxed shell commands by default.
- ›Exposes permission profile resolution in the core API.
+11 moreshow less
- ›Validates linked worktrees before inheriting project trust.
- ›Binds MCP OAuth refresh tokens to their issuer and hardens OAuth fallback credential writes.
- ›Applies composer editing preferences to TUI text prompts.
- ›Preserves inline TUI scrollback in Windows Terminal.
- ›Shows strict review warnings in the TUI and hides approved automatic review warnings.
- ›Prompts to unarchive sessions before resuming or forking.
- ›Adds cwd-relative turn diff paths.
- ›Enforces filesystem permissions when loading
AGENTS.md. - ›Advertises the Desktop app in graphical Linux sessions.
- ›Restricts plugin migration to home scope and hardens skill installation against unsafe symlinks.
- ›Streams executor capability and skill file reads.
└──▷ BREAKING ON UPGRADE- !The
untrustedapproval policy has been retired and is no longer available.
- ›Adds
- rust-v0.149.0-alpha.1
codex doctor gains endpoint protection, network, desktop, sandbox, and security diagnostics in v0.149.0-alpha.1
└──▷ GET THIS VERSION$ git clone --branch rust-v0.149.0-alpha.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.149.0-alpha.1
- ›Expands
codex doctorwith desktop app diagnostics, desktop update diagnostics, and desktop security enforcement diagnostics. - ›Improves
codex doctornetwork diagnostics with dedicated network checks via newnetworkmodule. - ›Adds sandbox checks to
codex doctorvia newsandbox_check. - ›Adds working-directory commands to the TUI, letting users change the working directory from within the interactive session.
- ›Adds a configurable skill catalog token budget.
+8 moreshow less
- ›Isolates external editor buffers from sandbox-writable paths, protecting composer text from exposure under restricted filesystem policies.
- ›Adds experimental app-server project APIs.
- ›Enforces environment-specific command policies and honors per-environment shell variable policies.
- ›Restricts MCP HTTP redirects to the configured origin and isolates MCP resource headers during OAuth requests.
- ›Adds managed gates for in-app chat and dictation.
- ›Compacts successful command activity in the TUI for a cleaner transcript view.
- ›Enables editing queued messages with Vim history-up bindings.
- ›Identifies Mac mini hosts in remote control handshakes.
└──▷ BREAKING ON UPGRADE- !Rejects obsolete app-server permission profile fields — configs using removed fields will be refused on upgrade.
- !Stops loading legacy managed config on Windows.
- ›Expands
- rust-v0.148.0
Codex CLI gains Markdown conversation export, session forking/archiving, Bedrock support, and async hooks in v0.148.0
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0
└──▷ TRY ITExport the current TUI conversation to a Markdown file for sharing or archiving after a long coding session.$ /exportFork an existing session to explore an alternative approach without losing the original conversation state.$ codex exec forkCheck estimated cost or thread credits consumed so far for the current workspace session.$ /status- ›Adds
/exportTUI command to export complete conversations to Markdown, sending output to the clipboard or a new file. - ›Adds
codex exec forksubcommand to fork sessions, plus archive and restore actions in the TUI resume picker. - ›Adds Amazon Bedrock Runtime as a built-in provider with AWS profile, region, and GPT-5.6 routing support.
- ›Hooks can now run commands asynchronously and invoke MCP tools.
- ›Adds
/statuscommand display and status-line/terminal-title indicators for estimated thread credits or cost in eligible workspaces.
+1 moreshow less
- ›Draft prompts can now be composed while the TUI initializes, with resume and fork progress shown during startup.
- ›Adds
- rust-v0.148.0
Codex CLI v0.148.0 adds Markdown export, session forking, Amazon Bedrock, async hooks, and cost visibility in the TUI.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0
└──▷ TRY ITExport your current TUI conversation to a Markdown file to share or archive a debugging session.$ /exportFork an existing session to explore an alternative approach without losing the original conversation state.$ codex exec forkCheck estimated credit usage or cost for the current thread directly in the TUI.$ /status- ›Adds
/exportTUI command to export full conversations to Markdown, either to the clipboard or a new file. - ›Adds
codex exec forksubcommand to fork sessions, plus archive and restore actions in the TUI resume picker. - ›Adds Amazon Bedrock Runtime as a built-in provider with AWS profile, region, and GPT-5.6 routing support.
- ›Hooks can now run commands asynchronously and invoke MCP tools.
- ›Adds estimated thread credits or cost display in
/status, status lines, and terminal titles for eligible workspaces.
+1 moreshow less
- ›Supports drafting prompts while the TUI initializes, with resume and fork progress shown during startup.
- ›Adds
- rust-v0.148.0-alpha.23
Codex CLI alpha.23 adds exec-server forwarding mode, PowerShell Tree-sitter safety analysis, and hardens auth isolation for custom providers.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.23 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.23
- ›Adds exec-server forwarding mode via a new
ExecServerSubcommand(accessible ascodex exec-server <subcommand>), enabling the exec-server to be composed in additional topologies. - ›Adds
--remote <URL>flag toexec-server(now markedglobal) for registering the exec-server as a remote environment, and makes--strict-configglobal so subcommands inherit it. - ›Adds a fail-closed Tree-sitter-based PowerShell lowerer that converts a conservative subset of literal PowerShell commands into argument vectors, rejecting dynamic expressions,
#requiresdirectives, and unrecognized syntax instead of guessing. - ›Adds symlink-safe reading of sensitive files via
read_sensitive_file_to_string, refusing to follow the final symlink component on Unix or reparse points on Windows. - ›Rejects symbolic links used as memory workspace roots and removes links created during consolidation, preventing path-traversal out of the workspace.
+5 moreshow less
- ›Adds provider-owned authentication recovery, allowing providers to handle their own auth refresh flow independently.
- ›Scopes MCP resource reads by connector, preventing cross-connector data access.
- ›Requires fresh approval beneath denied permission paths, closing a re-approval gap in the permission model.
- ›Adds Guardian v2 approval review metrics, risk classification improvements, and Node REPL policy injection into Guardian review sessions.
- ›Reconnects WebRTC Realtime sideband transports on disconnection for improved reliability of real-time agent communication.
- ›Adds exec-server forwarding mode via a new
- rust-v0.148.0-alpha.23
Codex CLI alpha.23 adds exec-server forwarding mode, PowerShell Tree-sitter safety analysis, and hardens auth isolation for custom providers.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.23 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.23
- ›Adds exec-server forwarding mode via a new
ExecServerSubcommand(accessible ascodex exec-server <subcommand>), enabling the exec-server to be composed in additional topologies. - ›Adds
--remote <URL>flag toexec-server(now markedglobal) for registering the exec-server as a remote environment, and makes--strict-configglobal so subcommands inherit it. - ›Adds a fail-closed Tree-sitter-based PowerShell lowerer that converts a conservative subset of literal PowerShell commands into argument vectors, rejecting dynamic expressions,
#requiresdirectives, and unrecognized syntax instead of guessing. - ›Adds symlink-safe reading of sensitive files via
read_sensitive_file_to_string, refusing to follow the final symlink component on Unix or reparse points on Windows. - ›Rejects symbolic links used as memory workspace roots and removes links created during consolidation, preventing path-traversal out of the workspace.
+5 moreshow less
- ›Adds provider-owned authentication recovery, allowing providers to handle their own auth refresh flow independently.
- ›Scopes MCP resource reads by connector, preventing cross-connector data access.
- ›Requires fresh approval beneath denied permission paths, closing a re-approval gap in the permission model.
- ›Adds Guardian v2 approval review metrics, risk classification improvements, and Node REPL policy injection into Guardian review sessions.
- ›Reconnects WebRTC Realtime sideband transports on disconnection for improved reliability of real-time agent communication.
- ›Adds exec-server forwarding mode via a new
- rust-v0.148.0-alpha.22
Codex CLI adds
codex agentsdashboard, desktop diagnostics incodex doctor, and queued-message dispatch for multi-process sessions.└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.22 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.22
└──▷ TRY ITOpen the interactive agents dashboard to monitor and navigate running agent tasks in the TUI.$ codex agents- ›Adds
codex agentsas a dedicated interactive task dashboard command for monitoring and navigating agents in the TUI. - ›Adds desktop app diagnostics and desktop update diagnostics to
codex doctor, covering app-server handshake status, security enforcement (macOS Gatekeeper/XProtect, Windows), and update state. - ›Adds a command to queue messages for existing sessions, enabling other processes to write to a running thread's durable queue and have idle threads dispatch them automatically.
- ›Adds configurable keyboard shortcuts for the agents dashboard.
- ›Restricts MCP HTTP redirects to the configured origin, tightening network policy for MCP app integrations.
+8 moreshow less
- ›Applies user MCP policy to selected executor plugins.
- ›Adds network policy metadata to environment configuration.
- ›Raises the GPT-5.6 maximum context window.
- ›Drops capabilities from Linux sandbox processes, hardening the sandbox security posture.
- ›Hardens Windows sandbox provisioning against reparse points.
- ›Surfaces interactive requests in realtime conversations.
- ›Requires approval for commands with dynamic shell words.
- ›Adds managed gates for in-app chat and dictation.
└──▷ BREAKING ON UPGRADE- !The experimental thread config endpoint has been removed (Remove the experimental thread config endpoint).
- !Skill model delegation support has been removed.
- ›Adds
- rust-v0.148.0-alpha.22
Codex CLI adds
codex agentsdashboard, desktop diagnostics incodex doctor, and queued-message dispatch for multi-process sessions.└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.22 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.22
└──▷ TRY ITOpen the interactive agents dashboard to monitor and navigate running agent tasks in the TUI.$ codex agents- ›Adds
codex agentsas a dedicated interactive task dashboard command for monitoring and navigating agents in the TUI. - ›Adds desktop app diagnostics and desktop update diagnostics to
codex doctor, covering app-server handshake status, security enforcement (macOS Gatekeeper/XProtect, Windows), and update state. - ›Adds a command to queue messages for existing sessions, enabling other processes to write to a running thread's durable queue and have idle threads dispatch them automatically.
- ›Adds configurable keyboard shortcuts for the agents dashboard.
- ›Restricts MCP HTTP redirects to the configured origin, tightening network policy for MCP app integrations.
+8 moreshow less
- ›Applies user MCP policy to selected executor plugins.
- ›Adds network policy metadata to environment configuration.
- ›Raises the GPT-5.6 maximum context window.
- ›Drops capabilities from Linux sandbox processes, hardening the sandbox security posture.
- ›Hardens Windows sandbox provisioning against reparse points.
- ›Surfaces interactive requests in realtime conversations.
- ›Requires approval for commands with dynamic shell words.
- ›Adds managed gates for in-app chat and dictation.
└──▷ BREAKING ON UPGRADE- !The experimental thread config endpoint has been removed (Remove the experimental thread config endpoint).
- !Skill model delegation support has been removed.
- ›Adds
- rust-v0.148.0-alpha.21
Codex CLI gains endpoint protection detection in
codex doctor, improved network diagnostics, and working-directory TUI commands.└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.21 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.21
└──▷ USE ITPass a raw TOML permission-map override with a literal path key via the TypeScript SDK when the structured config API cannot represent it.const codex = new Codex({ configOverrides: [ '--config', 'sandbox.writable_roots."/var/myapp/data"=true' ] });- ›Improves
codex doctornetwork diagnostics, including proxy environment details, macOS system proxy configuration detection, and rejection of proxy authentication challenges (HTTP 407). - ›Adds
CodexOptions.configOverridesto the TypeScript SDK for passing ordered--config key=valuearguments to Codex CLI unchanged, enabling TOML permission maps with literal path keys. - ›Adds working-directory commands to the TUI.
- ›Supports per-environment shell variable policies and environment-specific command policies.
- ›Adds experimental app-server project APIs.
+4 moreshow less
- ›Adds a configurable skill catalog token budget.
- ›Compacts successful command activity in the TUI for a cleaner history view.
- ›Enables editing queued messages with Vim history-up keybinding in the TUI composer.
- ›Removes the workspace settings gate for apps and plugins.
- ›Improves
- rust-v0.148.0-alpha.21
Codex CLI gains endpoint protection detection in
codex doctor, improved network diagnostics, and working-directory TUI commands.└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.21 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.21
└──▷ USE ITPass a raw TOML permission-map override with a literal path key via the TypeScript SDK when the structured config API cannot represent it.const codex = new Codex({ configOverrides: [ '--config', 'sandbox.writable_roots."/var/myapp/data"=true' ] });- ›Improves
codex doctornetwork diagnostics, including proxy environment details, macOS system proxy configuration detection, and rejection of proxy authentication challenges (HTTP 407). - ›Adds
CodexOptions.configOverridesto the TypeScript SDK for passing ordered--config key=valuearguments to Codex CLI unchanged, enabling TOML permission maps with literal path keys. - ›Adds working-directory commands to the TUI.
- ›Supports per-environment shell variable policies and environment-specific command policies.
- ›Adds experimental app-server project APIs.
+4 moreshow less
- ›Adds a configurable skill catalog token budget.
- ›Compacts successful command activity in the TUI for a cleaner history view.
- ›Enables editing queued messages with Vim history-up keybinding in the TUI composer.
- ›Removes the workspace settings gate for apps and plugins.
- ›Improves
- rust-v0.148.0-alpha.20
Codex CLI gains disk-space diagnostics in
codex doctor, MCP tool handler hooks, and live hook refresh after plugin changes.└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.20 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.20
- ›Adds storage diagnostics to
codex doctor, reporting free space for bothCODEX_HOMEand the worktree with warning (5 GiB) and failure (1 GiB) thresholds; on Windows, also checks Dev Drive health. - ›Propagates W3C
traceparentandtracestatetrace context through exec-server relay frames, including fragmented encrypted Noise-protocol requests. - ›Supports pending environment attachment configuration so threads start immediately without blocking while attachment configuration is not yet available, with a new failed-attachment state that recovers on a ready update.
- ›Uses paginated history for persistent exec threads to keep memory usage bounded across long sessions.
- ›Shows resume and fork status indicators during TUI startup.
- ›Adds storage diagnostics to
- rust-v0.148.0-alpha.20
Codex CLI gains disk-space diagnostics in
codex doctor, MCP tool handler hooks, and live hook refresh after plugin changes.└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.20 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.20
- ›Adds storage diagnostics to
codex doctor, reporting free space for bothCODEX_HOMEand the worktree with warning (5 GiB) and failure (1 GiB) thresholds; on Windows, also checks Dev Drive health. - ›Propagates W3C
traceparentandtracestatetrace context through exec-server relay frames, including fragmented encrypted Noise-protocol requests. - ›Supports pending environment attachment configuration so threads start immediately without blocking while attachment configuration is not yet available, with a new failed-attachment state that recovers on a ready update.
- ›Uses paginated history for persistent exec threads to keep memory usage bounded across long sessions.
- ›Shows resume and fork status indicators during TUI startup.
- ›Adds storage diagnostics to
- rust-v0.148.0-alpha.18
Codex CLI alpha.18 enables unified exec on Windows by default, makes Guardian v2 risk classification configurable, and removes the gRPC code-mode session limit.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.18 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.18
- ›Makes
features.guardianv2in config accept either a boolean toggle or a structured object specifying classifier instructions, review threshold, reasoning effort, action/instruction token limits, transcript source controls, per-entry and total token budgets, and the number of recent non-user entries. - ›Adds an override to skip project configuration at startup.
- ›Enables
unified_execby default on Windows, exposingexec_commandandwrite_stdininstead ofshell_commandon that platform. - ›Removes the gRPC code-mode open session limit, allowing more than
MAX_IN_FLIGHT_REQUESTSconcurrent sessions. - ›Adds MCP protocol discovery metrics: records a counter and duration per discovery attempt, tagged with
legacyorautomode and classified asmodern,legacy, orfailure.
+1 moreshow less
- ›Routes 'None of the above' selection in request input prompts to the notes editor on Enter (in addition to Tab), preventing accidental submission.
- ›Makes
- rust-v0.148.0-alpha.18
Codex CLI alpha.18 enables unified exec on Windows by default, makes Guardian v2 risk classification configurable, and removes the gRPC code-mode session limit.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.18 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.18
- ›Makes
features.guardianv2in config accept either a boolean toggle or a structured object specifying classifier instructions, review threshold, reasoning effort, action/instruction token limits, transcript source controls, per-entry and total token budgets, and the number of recent non-user entries. - ›Adds an override to skip project configuration at startup.
- ›Enables
unified_execby default on Windows, exposingexec_commandandwrite_stdininstead ofshell_commandon that platform. - ›Removes the gRPC code-mode open session limit, allowing more than
MAX_IN_FLIGHT_REQUESTSconcurrent sessions. - ›Adds MCP protocol discovery metrics: records a counter and duration per discovery attempt, tagged with
legacyorautomode and classified asmodern,legacy, orfailure.
+1 moreshow less
- ›Routes 'None of the above' selection in request input prompts to the notes editor on Enter (in addition to Tab), preventing accidental submission.
- ›Makes
- rust-v0.148.0-alpha.16
Codex CLI alpha.16 adds Guardian V2 risk scoring, parallel tool calls for all models, and stricter MCP auto-review enforcement.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.16 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.16
- ›Enforces strict auto-review for MCP tool calls even when the approval policy, tool annotations, or a remembered session decision would otherwise skip review.
- ›Adds Guardian V2 risk scoring: initializes per-thread samplers, records risk scores as snapshots on threads, preserves transcript boundaries in sampling input, and requires automatic review for high-risk actions.
- ›Installs Guardian V2 in the app server and isolates Guardian reviewer sessions from parent extensions.
- ›Reuses pending MCP server connections during reconciliation when identity, catalog limit, and protocol mode still match, avoiding duplicate startups.
- ›Adds
agent_namefield to Responses API turn metadata, falling back to/rootwhen no canonical agent path exists, and reserves the key from client metadata overrides.
+3 moreshow less
- ›Instructs the model to use
tool_searchto discover relevant tools when an explicitly selected plugin has apps available, before falling back to built-in tools. - ›Restricts filesystem helper sandbox access for tighter isolation.
- ›Honors cloud-managed requirements in feature listings.
- rust-v0.148.0-alpha.16
Codex CLI alpha.16 adds Guardian V2 risk scoring, parallel tool calls for all models, and stricter MCP auto-review enforcement.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.16 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.16
- ›Enforces strict auto-review for MCP tool calls even when the approval policy, tool annotations, or a remembered session decision would otherwise skip review.
- ›Adds Guardian V2 risk scoring: initializes per-thread samplers, records risk scores as snapshots on threads, preserves transcript boundaries in sampling input, and requires automatic review for high-risk actions.
- ›Installs Guardian V2 in the app server and isolates Guardian reviewer sessions from parent extensions.
- ›Reuses pending MCP server connections during reconciliation when identity, catalog limit, and protocol mode still match, avoiding duplicate startups.
- ›Adds
agent_namefield to Responses API turn metadata, falling back to/rootwhen no canonical agent path exists, and reserves the key from client metadata overrides.
+3 moreshow less
- ›Instructs the model to use
tool_searchto discover relevant tools when an explicitly selected plugin has apps available, before falling back to built-in tools. - ›Restricts filesystem helper sandbox access for tighter isolation.
- ›Honors cloud-managed requirements in feature listings.
- rust-v0.148.0-alpha.15
Codex CLI adds an Amazon Bedrock Runtime provider and skill-level model annotations with Luna delegation support.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.15 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.15
- ›Adds the built-in
amazon-bedrock-runtimeprovider for regional OpenAI-compatible Bedrock endpoints, with SigV4 auth, per-provider AWS profile/region/transport overrides, global and US cross-region model variants, and web search disabled. - ›Adds an optional
modelfield to skill frontmatter (e.g.model: luna), enabling per-skill model annotations while silently ignoring unsupported values. - ›Adds
SkillModelDelegationInstructionso skills requesting Luna can delegate to it when Luna is available in the current provider namespace, with bounded/validated model identifiers and instruction size limits.
- ›Adds the built-in
- rust-v0.148.0-alpha.15
Codex CLI adds an Amazon Bedrock Runtime provider and skill-level model annotations with Luna delegation support.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.15 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.15
- ›Adds the built-in
amazon-bedrock-runtimeprovider for regional OpenAI-compatible Bedrock endpoints, with SigV4 auth, per-provider AWS profile/region/transport overrides, global and US cross-region model variants, and web search disabled. - ›Adds an optional
modelfield to skill frontmatter (e.g.model: luna), enabling per-skill model annotations while silently ignoring unsupported values. - ›Adds
SkillModelDelegationInstructionso skills requesting Luna can delegate to it when Luna is available in the current provider namespace, with bounded/validated model identifiers and instruction size limits.
- ›Adds the built-in
- rust-v0.148.0-alpha.14
Codex CLI gains per-server MCP OAuth callback ports, running-task exit menu, and experimental thread queue APIs.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.14 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.14
└──▷ USE ITPin a specific MCP server to its own OAuth callback port so it does not conflict with other servers sharing the global port.oauth: callback_port: 9876
- ›Adds
oauth.callback_portto MCP server configuration, letting each server override the globalmcp_oauth_callback_portfor CLI login, app-server, plugin installation, executor, and skill dependency OAuth flows. - ›Adds experimental thread queue APIs to the app server.
- ›Adds a running-task exit menu to local daemon sessions: pressing Ctrl-C with an empty composer while a task runs now offers choices to cancel and stay, exit while leaving the task running, or stop and exit.
- ›Exposes model upgrade retirement times in the model context.
- ›Preserves client-authored developer messages across context compaction when
retain_client_developer_messagesis enabled.
+5 moreshow less
- ›Provides Guardian V2 with full tool action context — conversation transcript and a structured planned-action object containing tool name and arguments — for more accurate risk classification.
- ›Wraps injected current-time reminders in
<current_time_reminder>tags in model context. - ›Deduplicates current-time reminders when spawning full-history subagents, replacing inherited parent reminders with a single fresh reminder.
- ›Adds structured telemetry for response retries.
- ›Includes node_repl images in Guardian review evidence.
- ›Adds
- rust-v0.148.0-alpha.14
Codex CLI gains per-server MCP OAuth callback ports, running-task exit menu, and experimental thread queue APIs.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.14 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.14
└──▷ USE ITPin a specific MCP server to its own OAuth callback port so it does not conflict with other servers sharing the global port.oauth: callback_port: 9876
- ›Adds
oauth.callback_portto MCP server configuration, letting each server override the globalmcp_oauth_callback_portfor CLI login, app-server, plugin installation, executor, and skill dependency OAuth flows. - ›Adds experimental thread queue APIs to the app server.
- ›Adds a running-task exit menu to local daemon sessions: pressing Ctrl-C with an empty composer while a task runs now offers choices to cancel and stay, exit while leaving the task running, or stop and exit.
- ›Exposes model upgrade retirement times in the model context.
- ›Preserves client-authored developer messages across context compaction when
retain_client_developer_messagesis enabled.
+5 moreshow less
- ›Provides Guardian V2 with full tool action context — conversation transcript and a structured planned-action object containing tool name and arguments — for more accurate risk classification.
- ›Wraps injected current-time reminders in
<current_time_reminder>tags in model context. - ›Deduplicates current-time reminders when spawning full-history subagents, replacing inherited parent reminders with a single fresh reminder.
- ›Adds structured telemetry for response retries.
- ›Includes node_repl images in Guardian review evidence.
- ›Adds
- rust-v0.148.0-alpha.12
Codex CLI alpha.12 adds interrupted turn recovery, unified network approval pipeline, and sandboxed inline visualization protection.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.12 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.12
- ›Adds
RecoverTurnRequestandCodexThread::recover_turn_if_idleto resume an interrupted regular turn using its existing turn ID and updated thread settings, including Plan-mode recovery without injecting an empty user message. - ›Routes blocked network requests through the shared approval pipeline so permission hooks, automatic review, and user review all use the common approval flow — including for background terminals started by an earlier turn.
- ›Materializes inline visualization viewer documents in a dedicated cache under
CODEX_HOME, keyed by source and artifact thread IDs, so sandboxed sessions cannot overwrite viewer files before they are opened in a browser. - ›Persists deny amendments for blocked network requests and keeps denied requests denied across turns.
- ›Records the final applied network decision in tool telemetry without exposing the destination or assigning an approval source.
+1 moreshow less
- ›Disables visualization links for full-disk-write sessions and rejects viewer cache paths containing symbolic links; reuses materialized viewer documents in memory when the source is unchanged.
- ›Adds
- rust-v0.148.0-alpha.12
Codex CLI alpha.12 adds interrupted turn recovery, unified network approval pipeline, and sandboxed inline visualization protection.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.12 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.12
- ›Adds
RecoverTurnRequestandCodexThread::recover_turn_if_idleto resume an interrupted regular turn using its existing turn ID and updated thread settings, including Plan-mode recovery without injecting an empty user message. - ›Routes blocked network requests through the shared approval pipeline so permission hooks, automatic review, and user review all use the common approval flow — including for background terminals started by an earlier turn.
- ›Materializes inline visualization viewer documents in a dedicated cache under
CODEX_HOME, keyed by source and artifact thread IDs, so sandboxed sessions cannot overwrite viewer files before they are opened in a browser. - ›Persists deny amendments for blocked network requests and keeps denied requests denied across turns.
- ›Records the final applied network decision in tool telemetry without exposing the destination or assigning an approval source.
+1 moreshow less
- ›Disables visualization links for full-disk-write sessions and rejects viewer cache paths containing symbolic links; reuses materialized viewer documents in memory when the source is unchanged.
- ›Adds
- rust-v0.148.0-alpha.11
Codex CLI alpha.11 adds thread usage displays,
thread-creditsandestimated-thread-costterminal title items, and improved MCP tool-call approval routing.└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.11 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.11
└──▷ USE ITSurface per-thread credit consumption and estimated cost directly in your terminal title bar while running Codex.thread-credits, estimated-thread-cost
- ›Adds
thread-creditsandestimated-thread-costas configurable terminal title items, letting practitioners track per-thread quota consumption at a glance. - ›Shows estimated thread usage in the
/statuscommand and TUI status surfaces. - ›Adds dynamic HTTP header helpers for MCP servers.
- ›Integrates workload identity with Codex authentication.
- ›Supports gRPC code-mode hosts in the app server via
--code-mode-host.
+8 moreshow less
- ›Enables executor skill packages to be passed directly to
skills.readwithout a precedingskills.listlookup, including support for skill root aliases. - ›Enforces non-interactive approval policy for Codex delegate sessions.
- ›Reconnects gRPC code-mode sessions automatically after host restarts.
- ›Adds per-thread usage queries to the backend client.
- ›Stamps conversation history items with creation times.
- ›Adds durable reverts for paginated threads.
- ›Adds manifest-defined metrics and bounded measurement analytics for trusted plugin scripts.
- ›Attaches connector ID, action name, and model to file creation requests for hosted app tool calls.
- ›Adds
- rust-v0.148.0-alpha.11
Codex CLI alpha.11 adds thread usage displays,
thread-creditsandestimated-thread-costterminal title items, and improved MCP tool-call approval routing.└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.11 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.11
└──▷ USE ITSurface per-thread credit consumption and estimated cost directly in your terminal title bar while running Codex.thread-credits, estimated-thread-cost
- ›Adds
thread-creditsandestimated-thread-costas configurable terminal title items, letting practitioners track per-thread quota consumption at a glance. - ›Shows estimated thread usage in the
/statuscommand and TUI status surfaces. - ›Adds dynamic HTTP header helpers for MCP servers.
- ›Integrates workload identity with Codex authentication.
- ›Supports gRPC code-mode hosts in the app server via
--code-mode-host.
+8 moreshow less
- ›Enables executor skill packages to be passed directly to
skills.readwithout a precedingskills.listlookup, including support for skill root aliases. - ›Enforces non-interactive approval policy for Codex delegate sessions.
- ›Reconnects gRPC code-mode sessions automatically after host restarts.
- ›Adds per-thread usage queries to the backend client.
- ›Stamps conversation history items with creation times.
- ›Adds durable reverts for paginated threads.
- ›Adds manifest-defined metrics and bounded measurement analytics for trusted plugin scripts.
- ›Attaches connector ID, action name, and model to file creation requests for hosted app tool calls.
- ›Adds
- rust-v0.148.0-alpha.7
Codex CLI alpha.7 adds configurable goal token budget limits, session ID exposure to shell commands, and configurable Responses API request metadata.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.7 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.7
- ›Adds configurable goal token budget limits via PR #37878 (Add configurable goal token budget limits).
- ›Exposes the session ID to shell commands, enabling scripts and tools to reference the current session context.
- ›Adds configurable Responses API request metadata, allowing custom metadata to be attached to API requests.
- ›Supports MCP form input in full-access user threads, expanding interactive MCP workflows.
- ›Adds
packagedDefaultsas a new lowest-precedence configuration layer, with its source path reported through config diagnostics and the app-server protocol; returns an error when a configured packaged defaults file is missing.
+9 moreshow less
- ›Caches tool catalogs for streamable HTTP MCP servers, reducing repeated catalog fetches.
- ›Speeds up MCP OAuth credential reads.
- ›Exposes plugin ownership in MCP server status.
- ›Honors per-directory bundled skill settings in
skills/listrequests. - ›Simplifies
skills.readso thatpackageis the only required argument, resolving the owning orchestrator or executor catalog automatically and defaulting omittedresourcevalues to the package's mainSKILL.md. - ›Adds the
codex.turn.unified_exec.running_processescounter to track background terminal processes remaining at turn completion. - ›Validates images before returning
view_imageoutput. - ›Honors the configured Windows sandbox level for managed networking.
- ›Runs plugin and skill tests on Windows, extending platform coverage.
└──▷ BREAKING ON UPGRADE- !Config lockfile support has been removed (Remove config lockfile support).
- rust-v0.148.0-alpha.7
Codex CLI alpha.7 adds configurable goal token budget limits, session ID exposure to shell commands, and configurable Responses API request metadata.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.7 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.7
- ›Adds configurable goal token budget limits via PR #37878 (Add configurable goal token budget limits).
- ›Exposes the session ID to shell commands, enabling scripts and tools to reference the current session context.
- ›Adds configurable Responses API request metadata, allowing custom metadata to be attached to API requests.
- ›Supports MCP form input in full-access user threads, expanding interactive MCP workflows.
- ›Adds
packagedDefaultsas a new lowest-precedence configuration layer, with its source path reported through config diagnostics and the app-server protocol; returns an error when a configured packaged defaults file is missing.
+9 moreshow less
- ›Caches tool catalogs for streamable HTTP MCP servers, reducing repeated catalog fetches.
- ›Speeds up MCP OAuth credential reads.
- ›Exposes plugin ownership in MCP server status.
- ›Honors per-directory bundled skill settings in
skills/listrequests. - ›Simplifies
skills.readso thatpackageis the only required argument, resolving the owning orchestrator or executor catalog automatically and defaulting omittedresourcevalues to the package's mainSKILL.md. - ›Adds the
codex.turn.unified_exec.running_processescounter to track background terminal processes remaining at turn completion. - ›Validates images before returning
view_imageoutput. - ›Honors the configured Windows sandbox level for managed networking.
- ›Runs plugin and skill tests on Windows, extending platform coverage.
└──▷ BREAKING ON UPGRADE- !Config lockfile support has been removed (Remove config lockfile support).
- rust-v0.147.0-alpha.6.6
Codex CLI alpha.6.6 adds Amazon Bedrock web search, expanded MCP namespace descriptions, and Agent Plugin runtime isolation.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.6.6 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.6.6
- ›Raises the MCP namespace tool-spec description limit from 1,000 bytes to 512 KiB, truncating only at a UTF-8 character boundary, so complete server instructions are preserved in tool-search source metadata.
- ›Enables cached web search for Amazon Bedrock: advertises hosted text web search while marking external live and indexed web access as unsupported, and resolves those modes to cached search (or disables the tool when cached search is prohibited by managed requirements).
- ›Bounds model-visible skill instructions, plugin instructions, MCP descriptions, schemas, individual tools, and the aggregate Agent Plugin MCP tool set within plugin manifests.
- ›Gives
externalAgentConfig/detectits own global serialization queue so configuration reads, writes, and external agent imports remain responsive while detection is running. - ›Skips symbolic links (and other non-file, non-directory entries) when copying a plugin into the store, allowing plugin installation to proceed without failing on symlinked skill files or executables.
+1 moreshow less
- ›Bounds Cursor project path resolution to a set of 128 path candidates using common filename separators instead of walking the full directory tree, rejecting ambiguous matches and unsafe encoded components.
- rust-v0.147.0-alpha.6.6
Codex CLI alpha.6.6 adds Amazon Bedrock web search, expanded MCP namespace descriptions, and Agent Plugin runtime isolation.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.6.6 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.6.6
- ›Raises the MCP namespace tool-spec description limit from 1,000 bytes to 512 KiB, truncating only at a UTF-8 character boundary, so complete server instructions are preserved in tool-search source metadata.
- ›Enables cached web search for Amazon Bedrock: advertises hosted text web search while marking external live and indexed web access as unsupported, and resolves those modes to cached search (or disables the tool when cached search is prohibited by managed requirements).
- ›Bounds model-visible skill instructions, plugin instructions, MCP descriptions, schemas, individual tools, and the aggregate Agent Plugin MCP tool set within plugin manifests.
- ›Gives
externalAgentConfig/detectits own global serialization queue so configuration reads, writes, and external agent imports remain responsive while detection is running. - ›Skips symbolic links (and other non-file, non-directory entries) when copying a plugin into the store, allowing plugin installation to proceed without failing on symlinked skill files or executables.
+1 moreshow less
- ›Bounds Cursor project path resolution to a set of 128 path candidates using common filename separators instead of walking the full directory tree, rejecting ambiguous matches and unsafe encoded components.
- rust-v0.148.0-alpha.6
Codex CLI adds paginated TUI history, dual-WebSocket code-mode transport, cached web search for Amazon Bedrock, and tool registry collision policies.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.6 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.6
- ›Adds
--pspflag toapp-serverfor process-scoped PSP routing of first-party ChatGPT requests. - ›Adds tool registry collision policy configuration (
#36954) and enforces strict tool name collision errors. - ›Adds
includeTurnsreads for paginated threads to support incremental transcript access. - ›Adds a dual-WebSocket transport for code mode, enabling a new host-communication path.
- ›Enables cached web search for Amazon Bedrock.
+16 moreshow less
- ›Enables remote compaction for Amazon Bedrock.
- ›Adds paginated transcript history in the TUI, allowing large session histories to load incrementally.
- ›Supports deferred loading for freeform tools and deferred custom tools in tool search.
- ›Supports custom tools in namespaces.
- ›Supports leaf models in multi-agent v2.
- ›Adds opt-in concurrent exec-server request dispatch.
- ›Adds durable per-thread user submission queues.
- ›Adds host skill root loading and moves host skills service into the skills extension.
- ›Prompts before trusting local project directories and rejects implicitly discovered bare Git repositories.
- ›Adds Codex attribution links in pull request bodies.
- ›Allows disabling the built-in image viewer.
- ›Redacts secrets from app-server command execution items and improves bearer token secret redaction.
- ›Negotiates MCP extensions per app-server session and handles late MCP startup results after lag timeout.
- ›Preserves complete MCP namespace descriptions.
- ›Identifies agents by name in token budget context and makes token budget context identity configurable.
- ›Includes policy approval reasons in Guardian reviews.
- ›Adds
- rust-v0.148.0-alpha.6
Codex CLI adds paginated TUI history, dual-WebSocket code-mode transport, cached web search for Amazon Bedrock, and tool registry collision policies.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.6 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.6
- ›Adds
--pspflag toapp-serverfor process-scoped PSP routing of first-party ChatGPT requests. - ›Adds tool registry collision policy configuration (
#36954) and enforces strict tool name collision errors. - ›Adds
includeTurnsreads for paginated threads to support incremental transcript access. - ›Adds a dual-WebSocket transport for code mode, enabling a new host-communication path.
- ›Enables cached web search for Amazon Bedrock.
+16 moreshow less
- ›Enables remote compaction for Amazon Bedrock.
- ›Adds paginated transcript history in the TUI, allowing large session histories to load incrementally.
- ›Supports deferred loading for freeform tools and deferred custom tools in tool search.
- ›Supports custom tools in namespaces.
- ›Supports leaf models in multi-agent v2.
- ›Adds opt-in concurrent exec-server request dispatch.
- ›Adds durable per-thread user submission queues.
- ›Adds host skill root loading and moves host skills service into the skills extension.
- ›Prompts before trusting local project directories and rejects implicitly discovered bare Git repositories.
- ›Adds Codex attribution links in pull request bodies.
- ›Allows disabling the built-in image viewer.
- ›Redacts secrets from app-server command execution items and improves bearer token secret redaction.
- ›Negotiates MCP extensions per app-server session and handles late MCP startup results after lag timeout.
- ›Preserves complete MCP namespace descriptions.
- ›Identifies agents by name in token budget context and makes token budget context identity configurable.
- ›Includes policy approval reasons in Guardian reviews.
- ›Adds
- rust-v0.148.0-alpha.5
Codex CLI adds
migrate-rolloutssubcommand, Markdown conversation export, session forking incodex exec, and a Guardian circuit-breaker for cyber models.└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.5 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.5
└──▷ TRY ITInspect or migrate legacy local sessions to paginated thread history before resuming old conversations.$ codex migrate-rollouts- ›Adds
migrate-rolloutssubcommand to inspect or migrate legacy local sessions to paginated thread history. - ›Adds Markdown conversation export to the TUI.
- ›Adds session forking to
codex exec. - ›Adds session archiving and restore to the resume picker.
- ›Adds MCP event discovery and subscriptions.
+10 moreshow less
- ›Mounts a minimal
/devin full-filesystem Bubblewrap sandboxes. - ›Tracks context windows per agent.
- ›Exposes multi-agent versions in
model/list. - ›Exposes app-server diagnostics through the experimental API.
- ›Adds process diagnostics snapshots.
- ›Fetches remote installed plugins across all scopes.
- ›Recovers MCP servers after OAuth reauthentication.
- ›Starts cached MCP servers lazily for subagents.
- ›Adds tool namespace metadata configuration.
- ›Includes call IDs in MCP requests.
- ›Adds
- rust-v0.148.0-alpha.5
Codex CLI adds
migrate-rolloutssubcommand, Markdown conversation export, session forking incodex exec, and a Guardian circuit-breaker for cyber models.└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.5 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.5
└──▷ TRY ITInspect or migrate legacy local sessions to paginated thread history before resuming old conversations.$ codex migrate-rollouts- ›Adds
migrate-rolloutssubcommand to inspect or migrate legacy local sessions to paginated thread history. - ›Adds Markdown conversation export to the TUI.
- ›Adds session forking to
codex exec. - ›Adds session archiving and restore to the resume picker.
- ›Adds MCP event discovery and subscriptions.
+10 moreshow less
- ›Mounts a minimal
/devin full-filesystem Bubblewrap sandboxes. - ›Tracks context windows per agent.
- ›Exposes multi-agent versions in
model/list. - ›Exposes app-server diagnostics through the experimental API.
- ›Adds process diagnostics snapshots.
- ›Fetches remote installed plugins across all scopes.
- ›Recovers MCP servers after OAuth reauthentication.
- ›Starts cached MCP servers lazily for subagents.
- ›Adds tool namespace metadata configuration.
- ›Includes call IDs in MCP requests.
- ›Adds
- rust-v0.148.0-alpha.4
Codex CLI alpha adds multi-agent version metadata in model/list, MCP event discovery, process diagnostics, and a shared project-instruction byte budget.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.4 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.4
- ›Adds nullable
multiAgentVersionfield tov2model/listresponses, with supported valuesdisabled,v1, orv2, exposing multi-agent capability metadata for each model. - ›Adds
codex-diagnosticscrate that snapshots process ID, resident-memory measurements, and registered process-wide gauges; tracks liveCodexThreadinstances via thecore.threads.livegauge. - ›Adds MCP event discovery and subscriptions, enabling clients to subscribe to server-side events over MCP.
- ›Includes call IDs in MCP requests for end-to-end traceability.
- ›Treats
project_doc_max_bytesas a single shared byte budget across all selected environments, truncating at the limit and skipping later environments once exhausted, capping total project instruction payload size.
+7 moreshow less
- ›Exposes app-server and runtime activity diagnostics through the experimental API.
- ›Includes sandbox mode in response metadata.
- ›Keeps response streams alive through connection failures, improving resilience for long-running agent turns.
- ›Disables Nagle's algorithm for code-mode WebSockets, reducing latency for interactive sessions.
- ›Reports temporary directories in exec-server environment info.
- ›Includes tool namespace inventory in turn metadata.
- ›Generalizes skill locator aliases across providers and aliases resource-backed skill locators under context pressure.
- ›Adds nullable
- rust-v0.148.0-alpha.4
Codex CLI alpha adds multi-agent version metadata in model/list, MCP event discovery, process diagnostics, and a shared project-instruction byte budget.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.4 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.4
- ›Adds nullable
multiAgentVersionfield tov2model/listresponses, with supported valuesdisabled,v1, orv2, exposing multi-agent capability metadata for each model. - ›Adds
codex-diagnosticscrate that snapshots process ID, resident-memory measurements, and registered process-wide gauges; tracks liveCodexThreadinstances via thecore.threads.livegauge. - ›Adds MCP event discovery and subscriptions, enabling clients to subscribe to server-side events over MCP.
- ›Includes call IDs in MCP requests for end-to-end traceability.
- ›Treats
project_doc_max_bytesas a single shared byte budget across all selected environments, truncating at the limit and skipping later environments once exhausted, capping total project instruction payload size.
+7 moreshow less
- ›Exposes app-server and runtime activity diagnostics through the experimental API.
- ›Includes sandbox mode in response metadata.
- ›Keeps response streams alive through connection failures, improving resilience for long-running agent turns.
- ›Disables Nagle's algorithm for code-mode WebSockets, reducing latency for interactive sessions.
- ›Reports temporary directories in exec-server environment info.
- ›Includes tool namespace inventory in turn metadata.
- ›Generalizes skill locator aliases across providers and aliases resource-backed skill locators under context pressure.
- ›Adds nullable
- rust-v0.148.0-alpha.2
Codex CLI gains session forking, Markdown conversation export, session archiving, MCP tool hook config, and agent identity endpoint overrides.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.2 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.2
└──▷ TRY ITFork an existing session by ID and immediately send a follow-up prompt to continue work on a new branch of the conversation.$ codex exec fork session-123 'continue refactoring the auth module'Export the current TUI conversation to a Markdown file for documentation or sharing.$ /export ~/projects/my-session.mdPoint agent identity registration and verification at a staging environment instead of production.$ CODEX_AGENT_IDENTITY_AUTHAPI_BASE_URL=https://staging-auth.example.com CODEX_AGENT_IDENTITY_JWKS_BASE_URL=https://staging-jwks.example.com codex- ›Adds
forksubcommand tocodex execthat forks a previous session by UUID or thread name into a new session, with optional--image/-iflag for attachments and an optional prompt argument. - ›Adds
/exportTUI command to export the complete conversation history as structured Markdown, with clipboard and file destinations (including default filename prompt and support for an explicit path argument). - ›Supports
CODEX_AGENT_IDENTITY_AUTHAPI_BASE_URLandCODEX_AGENT_IDENTITY_JWKS_BASE_URLenvironment variables to override agent identity registration and verification endpoints. - ›Adds session archiving to the resume picker, allowing sessions to be archived and restored from within the TUI.
- ›Recognizes
mcp_toolhook handler configurations (with server, tool, JSON input, and optional timeout and status message fields) and returns them fromconfigRequirements/read.
+1 moreshow less
- ›Adds executor-local config layer loading for the exec server, enabling per-executor configuration overrides.
- ›Adds
- rust-v0.148.0-alpha.2
Codex CLI gains session forking, Markdown conversation export, session archiving, MCP tool hook config, and agent identity endpoint overrides.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.2 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.2
└──▷ TRY ITFork an existing session by ID and immediately send a follow-up prompt to continue work on a new branch of the conversation.$ codex exec fork session-123 'continue refactoring the auth module'Export the current TUI conversation to a Markdown file for documentation or sharing.$ /export ~/projects/my-session.mdPoint agent identity registration and verification at a staging environment instead of production.$ CODEX_AGENT_IDENTITY_AUTHAPI_BASE_URL=https://staging-auth.example.com CODEX_AGENT_IDENTITY_JWKS_BASE_URL=https://staging-jwks.example.com codex- ›Adds
forksubcommand tocodex execthat forks a previous session by UUID or thread name into a new session, with optional--image/-iflag for attachments and an optional prompt argument. - ›Adds
/exportTUI command to export the complete conversation history as structured Markdown, with clipboard and file destinations (including default filename prompt and support for an explicit path argument). - ›Supports
CODEX_AGENT_IDENTITY_AUTHAPI_BASE_URLandCODEX_AGENT_IDENTITY_JWKS_BASE_URLenvironment variables to override agent identity registration and verification endpoints. - ›Adds session archiving to the resume picker, allowing sessions to be archived and restored from within the TUI.
- ›Recognizes
mcp_toolhook handler configurations (with server, tool, JSON input, and optional timeout and status message fields) and returns them fromconfigRequirements/read.
+1 moreshow less
- ›Adds executor-local config layer loading for the exec server, enabling per-executor configuration overrides.
- ›Adds
- rust-v0.148.0-alpha.1
Codex CLI adds
migrate-rolloutssubcommand, Guardian circuit-breaker for cyber models, and a durable user-message queue.└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.1
└──▷ TRY ITDry-run to see which local sessions are eligible for migration to paginated thread history before committing.$ codex migrate-rollouts --verbose --json
Migrate a specific thread to paginated history with a bandwidth cap to avoid saturating disk I/O.$ codex migrate-rollouts --apply --thread <THREAD_ID> --max-mib-per-second 50
- ›Adds
migrate-rolloutssubcommand with--apply,--thread <THREAD_ID>,--max-mib-per-second <MIB>,--json, and--verboseflags to inspect or migrate legacy local sessions to paginated thread history. - ›Adds a Guardian circuit-breaker policy that interrupts model turns after the first Guardian denial for models whose catalog specialty is
cyber, while retaining existing denial thresholds for all other models. - ›Mounts a minimal
/devinside full-filesystem Bubblewrap sandboxes. - ›Starts cached MCP servers lazily for subagents, and recovers MCP servers automatically after OAuth reauthentication.
- ›Fetches remote installed plugins across all scopes and supports plugin roots in the host skill loader.
+1 moreshow less
- ›Sends model routing hints to the Codex backend to improve model selection.
- ›Adds
- rust-v0.148.0-alpha.1
Codex CLI adds
migrate-rolloutssubcommand, Guardian circuit-breaker for cyber models, and a durable user-message queue.└──▷ GET THIS VERSION$ git clone --branch rust-v0.148.0-alpha.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.148.0-alpha.1
└──▷ TRY ITDry-run to see which local sessions are eligible for migration to paginated thread history before committing.$ codex migrate-rollouts --verbose --json
Migrate a specific thread to paginated history with a bandwidth cap to avoid saturating disk I/O.$ codex migrate-rollouts --apply --thread <THREAD_ID> --max-mib-per-second 50
- ›Adds
migrate-rolloutssubcommand with--apply,--thread <THREAD_ID>,--max-mib-per-second <MIB>,--json, and--verboseflags to inspect or migrate legacy local sessions to paginated thread history. - ›Adds a Guardian circuit-breaker policy that interrupts model turns after the first Guardian denial for models whose catalog specialty is
cyber, while retaining existing denial thresholds for all other models. - ›Mounts a minimal
/devinside full-filesystem Bubblewrap sandboxes. - ›Starts cached MCP servers lazily for subagents, and recovers MCP servers automatically after OAuth reauthentication.
- ›Fetches remote installed plugins across all scopes and supports plugin roots in the host skill loader.
+1 moreshow less
- ›Sends model routing hints to the Codex backend to improve model selection.
- ›Adds
- rust-v0.147.0
Codex CLI v0.147.0 adds
--approve-for-meauto-approval, portable Agent Plugins, MCP 2026-07-28 protocol support, and Bedrock cached web search.└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0
└──▷ TRY ITRun a coding task in CI or unattended pipelines without being prompted to approve each agent action.$ codex exec --approve-for-me --sandbox workspace-write 'refactor auth module to use JWT'
- ›Adds
--approve-for-meCLI flag to enable automatically reviewed approvals without manual confirmation prompts. - ›Removes the deprecated
codex exec --full-autoflag;--sandbox workspace-writeis now the required replacement. - ›Supports the opt-in MCP 2026-07-28 protocol, including paginated discovery, multi-round requests, and non-blocking server startup.
- ›Installs portable Agent Plugins and searches across local, personal, workspace, and remote plugin catalogs.
- ›Enables cached web search and remote conversation compaction for Amazon Bedrock.
+2 moreshow less
- ›Organizes conversations into persistent, manually ordered sections with incremental browsing of long transcripts.
- ›Imports Cursor-managed skills and synchronizes changes to imported Claude and Cursor conversations without creating duplicates.
└──▷ BREAKING ON UPGRADE- !The
codex exec --full-autoflag has been removed; use--sandbox workspace-writeinstead. - !Redundant Linux bundle archives are no longer published; use the standard
codex-package-<target>release archives instead.
- ›Adds
- rust-v0.147.0
Codex CLI v0.147.0 adds
--approve-for-me, portable Agent Plugins, MCP 2026 protocol support, and Amazon Bedrock cached web search.└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0
└──▷ TRY ITRun a coding task in CI without manual approval prompts by enabling auto-reviewed approvals.$ codex --approve-for-me 'refactor the auth module to use async/await'
Run a sandboxed exec task using the replacement for the removed--full-autoflag.$ codex exec --sandbox workspace-write 'add unit tests for the payments service'
- ›Adds
--approve-for-meCLI flag tocodexto enable automatically reviewed approvals without manual confirmation prompts. - ›Adds support for the opt-in MCP 2026-07-28 protocol, including paginated discovery, multi-round requests, and non-blocking server startup.
- ›Replaces the removed
codex exec --full-autoflag with--sandbox workspace-writeas the supported equivalent. - ›Introduces installable portable Agent Plugins with search across local, personal, workspace, and remote plugin catalogs.
- ›Enables cached web search and remote conversation compaction for Amazon Bedrock backends.
+3 moreshow less
- ›Adds persistent, manually ordered conversation sections and incremental browsing of long transcripts in the TUI.
- ›Supports importing Cursor-managed skills and synchronizing changes to imported Claude and Cursor conversations without duplicates.
- ›Standardizes Linux release artifacts to
codex-package-<target>archives, dropping the previously published redundant bundle archives.
└──▷ BREAKING ON UPGRADE- !The
--full-autoflag oncodex exechas been removed; use--sandbox workspace-writeinstead. - !Redundant Linux bundle archives are no longer published; use the standard
codex-package-<target>release archives.
- ›Adds
- rust-v0.147.0-alpha.13
Codex CLI alpha adds thread section ordering,
thread/section/moveAPI, named forked chats, and MCP OAuth credential isolation.└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.13 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.13
- ›Adds
--pspflag to the app-server to enable process-only PSP routing for first-party ChatGPT requests. - ›Enables naming forked chats from the TUI.
- ›Loads cloud-managed servers in MCP CLI commands.
- ›Isolates MCP OAuth credentials by environment and restricts hosted MCP credentials to local environments.
- ›Exposes MCP read-only hints in tool call items.
+8 moreshow less
- ›Distinguishes unknown MCP authentication status as a separate state.
- ›Enables skills in the MCP server.
- ›Supports Enterprise automation account plans.
- ›Denies network access when an allow amendment fails, tightening sandbox enforcement.
- ›Requires explicit sandbox permissions with shell justifications.
- ›Restricts
shell_commandto a single local environment. - ›Detects connectors used in external agent sessions.
- ›Records attempted tool calls in response metadata.
└──▷ BREAKING ON UPGRADE- !Legacy
--full-autohandling is removed fromcodex exec. - !Legacy Linux bundle archives are no longer published.
- ›Adds
- rust-v0.147.0-alpha.13
Codex CLI alpha adds thread section ordering,
thread/section/moveAPI, named forked chats, and MCP OAuth credential isolation.└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.13 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.13
- ›Adds
--pspflag to the app-server to enable process-only PSP routing for first-party ChatGPT requests. - ›Enables naming forked chats from the TUI.
- ›Loads cloud-managed servers in MCP CLI commands.
- ›Isolates MCP OAuth credentials by environment and restricts hosted MCP credentials to local environments.
- ›Exposes MCP read-only hints in tool call items.
+8 moreshow less
- ›Distinguishes unknown MCP authentication status as a separate state.
- ›Enables skills in the MCP server.
- ›Supports Enterprise automation account plans.
- ›Denies network access when an allow amendment fails, tightening sandbox enforcement.
- ›Requires explicit sandbox permissions with shell justifications.
- ›Restricts
shell_commandto a single local environment. - ›Detects connectors used in external agent sessions.
- ›Records attempted tool calls in response metadata.
└──▷ BREAKING ON UPGRADE- !Legacy
--full-autohandling is removed fromcodex exec. - !Legacy Linux bundle archives are no longer published.
- ›Adds
- rust-v0.147.0-alpha.12
Adds disabled-by-default image resize notices, local auth requirement enforcement, and symlinked skill discovery path tracking.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.12 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.12
- ›Adds the disabled-by-default
image_resize_noticefeature: when enabled, appends a developer message after resized images reporting each image's original and prepared dimensions, for both user messages and tool outputs. - ›Adds local
requirements.tomlallowlists for login methods and ChatGPT workspaces, enforced before stored or environment-provided credentials are used — including during bootstrap before cloud requirements are fetched. - ›Makes Windows
PathUriequality and hashing ASCII-case-insensitive for drive and UNC paths while preserving case-sensitive POSIX behavior, includingstarts_withandrelative_path_fromcomparisons.
- ›Adds the disabled-by-default
- rust-v0.147.0-alpha.12
Adds disabled-by-default image resize notices, local auth requirement enforcement, and symlinked skill discovery path tracking.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.12 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.12
- ›Adds the disabled-by-default
image_resize_noticefeature: when enabled, appends a developer message after resized images reporting each image's original and prepared dimensions, for both user messages and tool outputs. - ›Adds local
requirements.tomlallowlists for login methods and ChatGPT workspaces, enforced before stored or environment-provided credentials are used — including during bootstrap before cloud requirements are fetched. - ›Makes Windows
PathUriequality and hashing ASCII-case-insensitive for drive and UNC paths while preserving case-sensitive POSIX behavior, includingstarts_withandrelative_path_fromcomparisons.
- ›Adds the disabled-by-default
- rust-v0.147.0-alpha.6.5
Codex CLI alpha.6.5 adds Amazon Bedrock cached web search, tightened Agent Plugin runtime boundaries, and fuller MCP namespace descriptions.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.6.5 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.6.5
- ›Raises the MCP namespace tool-spec description limit from 1,000 bytes to 512 KiB, truncating only at a UTF-8 character boundary, so complete server instructions are preserved in tool-search metadata.
- ›Enables cached web search for Amazon Bedrock: advertises hosted web search while marking external live/indexed access unsupported, and resolves unsupported modes to cached search or disables the tool when managed requirements prohibit it.
- ›Skips symbolic links and other non-file, non-directory entries when installing a plugin into the store, allowing installations that include symlinked skill files or executables to succeed.
- rust-v0.147.0-alpha.6.5
Codex CLI alpha.6.5 adds Amazon Bedrock cached web search, tightened Agent Plugin runtime boundaries, and fuller MCP namespace descriptions.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.6.5 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.6.5
- ›Raises the MCP namespace tool-spec description limit from 1,000 bytes to 512 KiB, truncating only at a UTF-8 character boundary, so complete server instructions are preserved in tool-search metadata.
- ›Enables cached web search for Amazon Bedrock: advertises hosted web search while marking external live/indexed access unsupported, and resolves unsupported modes to cached search or disables the tool when managed requirements prohibit it.
- ›Skips symbolic links and other non-file, non-directory entries when installing a plugin into the store, allowing installations that include symlinked skill files or executables to succeed.
- rust-v0.147.0-alpha.11
Codex CLI alpha.11 adds per-session code-mode execution limits and switches API-key Guardian reviews to gpt-5.6-luna.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.11 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.11
- ›Adds
create_session_with_limitsand session-scoped cell execution limits viaCodeModeSessionCellExecutionLimits, clamping execute and wait yield times tomax_yield_time_mswithout terminating the running cell; limits are negotiated with remote code-mode hosts and included insession/openonly when non-default. - ›Switches Guardian approval reviews for API-key authenticated sessions to the
gpt-5.6-lunamodel (retainingcodex-auto-reviewfor ChatGPT authentication), routing API-key reviews through Responses Lite with fallback to the bundled Guardian policy. - ›Caches
McpBindingper published MCP runtime once the tool catalog revision is stable, reusing the binding across sampling steps and rebuilding only after a runtime publish or catalog change. - ›Bounds interactive TUI telemetry shutdown to a 500 ms budget via
OtelProvider::shutdown_with_timeout, preventing a stalled OTLP exporter from blocking exit indefinitely.
- ›Adds
- rust-v0.147.0-alpha.11
Codex CLI alpha.11 adds per-session code-mode execution limits and switches API-key Guardian reviews to gpt-5.6-luna.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.11 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.11
- ›Adds
create_session_with_limitsand session-scoped cell execution limits viaCodeModeSessionCellExecutionLimits, clamping execute and wait yield times tomax_yield_time_mswithout terminating the running cell; limits are negotiated with remote code-mode hosts and included insession/openonly when non-default. - ›Switches Guardian approval reviews for API-key authenticated sessions to the
gpt-5.6-lunamodel (retainingcodex-auto-reviewfor ChatGPT authentication), routing API-key reviews through Responses Lite with fallback to the bundled Guardian policy. - ›Caches
McpBindingper published MCP runtime once the tool catalog revision is stable, reusing the binding across sampling steps and rebuilding only after a runtime publish or catalog change. - ›Bounds interactive TUI telemetry shutdown to a 500 ms budget via
OtelProvider::shutdown_with_timeout, preventing a stalled OTLP exporter from blocking exit indefinitely.
- ›Adds
- rust-v0.147.0-alpha.10
Codex CLI alpha adds concurrent exec-server dispatch, tool registry collision policy, paginated TUI history, and leaf model support for multi-agent v2.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.10 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.10
└──▷ TRY ITRun the exec-server with up to 4 concurrent requests per connection to increase throughput in high-load environments.$ codex exec-server --concurrent-requests 4 --listen ws://127.0.0.1:8080
Start Codex with process-scoped PSP routing enabled for first-party ChatGPT requests.$ codex --psp
- ›Adds
--concurrent-requestsflag (alias--concurrent-requests COUNT, default1) to the exec-server subcommand for opt-in concurrent request dispatch across connections. - ›Adds
--pspglobal flag to enable process-scoped PSP routing for first-party ChatGPT requests. - ›Adds tool registry collision policy configuration with strict tool name collision errors enforced under a new canonical
functionsnamespace. - ›Adds paginated transcript history loading in the TUI, enabling navigation of long session histories.
- ›Enables cached web search for Amazon Bedrock.
+11 moreshow less
- ›Enables remote compaction for Amazon Bedrock.
- ›Prompts before trusting local project directories, and rejects implicitly discovered bare Git repositories.
- ›Adds durable per-thread user submission queues.
- ›Links Codex attribution in pull request bodies.
- ›Allows disabling the built-in image viewer.
- ›Skips symlinks when installing plugins.
- ›Limits RMCP logs persisted to SQLite.
- ›Negotiates MCP extensions per app-server session.
- ›Makes token budget context identity configurable.
- ›Supports configured ChatGPT cookies in HTTP clients.
- ›Adds safer TUI defaults for cyber models.
└──▷ BREAKING ON UPGRADE- !Legacy collaboration mode variants have been removed (Remove legacy collaboration mode variants).
- ›Adds
- rust-v0.147.0-alpha.10
Codex CLI alpha adds concurrent exec-server dispatch, tool registry collision policy, paginated TUI history, and leaf model support for multi-agent v2.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.10 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.10
└──▷ TRY ITRun the exec-server with up to 4 concurrent requests per connection to increase throughput in high-load environments.$ codex exec-server --concurrent-requests 4 --listen ws://127.0.0.1:8080
Start Codex with process-scoped PSP routing enabled for first-party ChatGPT requests.$ codex --psp
- ›Adds
--concurrent-requestsflag (alias--concurrent-requests COUNT, default1) to the exec-server subcommand for opt-in concurrent request dispatch across connections. - ›Adds
--pspglobal flag to enable process-scoped PSP routing for first-party ChatGPT requests. - ›Adds tool registry collision policy configuration with strict tool name collision errors enforced under a new canonical
functionsnamespace. - ›Adds paginated transcript history loading in the TUI, enabling navigation of long session histories.
- ›Enables cached web search for Amazon Bedrock.
+11 moreshow less
- ›Enables remote compaction for Amazon Bedrock.
- ›Prompts before trusting local project directories, and rejects implicitly discovered bare Git repositories.
- ›Adds durable per-thread user submission queues.
- ›Links Codex attribution in pull request bodies.
- ›Allows disabling the built-in image viewer.
- ›Skips symlinks when installing plugins.
- ›Limits RMCP logs persisted to SQLite.
- ›Negotiates MCP extensions per app-server session.
- ›Makes token budget context identity configurable.
- ›Supports configured ChatGPT cookies in HTTP clients.
- ›Adds safer TUI defaults for cyber models.
└──▷ BREAKING ON UPGRADE- !Legacy collaboration mode variants have been removed (Remove legacy collaboration mode variants).
- ›Adds
- rust-v0.147.0-alpha.6.4
Codex CLI now enables cached web search for Amazon Bedrock, falling back from unsupported live/indexed modes automatically.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.6.4 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.6.4
- ›Adds hosted web search support for Amazon Bedrock, advertising cached web search while marking external live and indexed web access as unsupported — unsupported modes resolve to cached search, or the tool is disabled when cached search is prohibited by managed requirements.
- ›Normalizes built-in and configured Bedrock model catalogs to text-only web search payloads, removing the
search_content_typesfield that Bedrock rejects for multimodal search. - ›Retains the runtime provider in session configuration so per-turn setup can apply provider-specific capabilities (e.g. text-only search for Bedrock).
- rust-v0.147.0-alpha.6.4
Codex CLI now enables cached web search for Amazon Bedrock, falling back from unsupported live/indexed modes automatically.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.6.4 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.6.4
- ›Adds hosted web search support for Amazon Bedrock, advertising cached web search while marking external live and indexed web access as unsupported — unsupported modes resolve to cached search, or the tool is disabled when cached search is prohibited by managed requirements.
- ›Normalizes built-in and configured Bedrock model catalogs to text-only web search payloads, removing the
search_content_typesfield that Bedrock rejects for multimodal search. - ›Retains the runtime provider in session configuration so per-turn setup can apply provider-specific capabilities (e.g. text-only search for Bedrock).
- rust-v0.147.0-alpha.6.3
Codex CLI raises MCP namespace tool-spec description limit from 1,000 bytes to 512 KiB, preserving complete server instructions.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.6.3 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.6.3
- ›Raises the MCP namespace tool-spec description limit from 1,000 bytes to 512 KiB, truncating only at a UTF-8 character boundary when the new limit is exceeded — preserving complete server instructions and preventing tools from being hidden.
- ›Keeps complete MCP namespace descriptions in tool-search source metadata.
- rust-v0.147.0-alpha.6.3
Codex CLI raises MCP namespace tool-spec description limit from 1,000 bytes to 512 KiB, preserving complete server instructions.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.6.3 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.6.3
- ›Raises the MCP namespace tool-spec description limit from 1,000 bytes to 512 KiB, truncating only at a UTF-8 character boundary when the new limit is exceeded — preserving complete server instructions and preventing tools from being hidden.
- ›Keeps complete MCP namespace descriptions in tool-search source metadata.
- rust-v0.147.0-alpha.7
Codex CLI alpha.7 adds dual-WebSocket transport for code mode, MCP conformance regression gates, and per-environment login shell policy.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.7 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.7
- ›Adds
exec resume --lastperformance improvement by querying the state database first, avoiding a full rollout scan; falls back to scanning only on a complete database miss. - ›Supports per-environment
allow_login_shellpolicy, exposing theloginargument for shell tools when any selected environment permits login shells and validating each command against its own environment's policy. - ›Adds a dual-WebSocket transport for code mode, routing frames to the appropriate transport lane via transport_lane().
- ›Adds MCP client conformance regression gates covering HTTP and stdio transports, OAuth scenarios, shipping/intermediate/modern protocol versions, and an app-server regression matrix for transport, security, schema, pagination, SSE, multi-round, and catalog-boundary behavior.
- ›Adds
codex-utils-audioworkspace crate for canonicalizing audio inputs and estimating token usage.
+4 moreshow less
- ›Supports deferred loading for freeform tools and custom tools in namespaces.
- ›Adds timeout handling for stalled code-mode host requests.
- ›Identifies agents by name in token budget context.
- ›Prefers SQLite-backed names when resolving local
archive,delete, andunarchivesession targets before falling back to rollout scanning.
- ›Adds
- rust-v0.147.0-alpha.7
Codex CLI alpha.7 adds dual-WebSocket transport for code mode, MCP conformance regression gates, and per-environment login shell policy.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.7 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.7
- ›Adds
exec resume --lastperformance improvement by querying the state database first, avoiding a full rollout scan; falls back to scanning only on a complete database miss. - ›Supports per-environment
allow_login_shellpolicy, exposing theloginargument for shell tools when any selected environment permits login shells and validating each command against its own environment's policy. - ›Adds a dual-WebSocket transport for code mode, routing frames to the appropriate transport lane via transport_lane().
- ›Adds MCP client conformance regression gates covering HTTP and stdio transports, OAuth scenarios, shipping/intermediate/modern protocol versions, and an app-server regression matrix for transport, security, schema, pagination, SSE, multi-round, and catalog-boundary behavior.
- ›Adds
codex-utils-audioworkspace crate for canonicalizing audio inputs and estimating token usage.
+4 moreshow less
- ›Supports deferred loading for freeform tools and custom tools in namespaces.
- ›Adds timeout handling for stalled code-mode host requests.
- ›Identifies agents by name in token budget context.
- ›Prefers SQLite-backed names when resolving local
archive,delete, andunarchivesession targets before falling back to rollout scanning.
- ›Adds
- rust-v0.147.0-alpha.2
Codex CLI adds MCP 2026 protocol support, cloud-managed sandbox profiles, non-blocking MCP startup, and concurrent tool resolution.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.2 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.2
- ›Adds MCP 2026-07-28 discovery support and completes full MCP 2026 client support.
- ›Loads cloud-managed profiles for
codex sandbox, enabling centrally provisioned sandbox configurations. - ›Routes MCP OAuth through configured HTTP clients, unifying network proxy handling for MCP authentication flows.
- ›Adds configurable developer instructions for v2 subagents.
- ›Supports model-owned token budget defaults, applying model-catalog-supplied budgets when no explicit token-budget configuration is set.
+8 moreshow less
- ›Routes WebRTC sideband joins to the Realtime API.
- ›Adds persisted thread sections for organizing conversation threads.
- ›Enables network policy callbacks for remote exec.
- ›Terminates Windows non-TTY processes on interrupt, improving Ctrl-C behavior on Windows.
- ›Loads thread titles concurrently during session startup.
- ›Supports self-serve Business ProLite accounts.
- ›Supports plaintext collaboration tool messages.
- ›Honors the configured SQLite home in the logs client.
- rust-v0.147.0-alpha.2
Codex CLI adds MCP 2026 protocol support, cloud-managed sandbox profiles, non-blocking MCP startup, and concurrent tool resolution.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.2 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.2
- ›Adds MCP 2026-07-28 discovery support and completes full MCP 2026 client support.
- ›Loads cloud-managed profiles for
codex sandbox, enabling centrally provisioned sandbox configurations. - ›Routes MCP OAuth through configured HTTP clients, unifying network proxy handling for MCP authentication flows.
- ›Adds configurable developer instructions for v2 subagents.
- ›Supports model-owned token budget defaults, applying model-catalog-supplied budgets when no explicit token-budget configuration is set.
+8 moreshow less
- ›Routes WebRTC sideband joins to the Realtime API.
- ›Adds persisted thread sections for organizing conversation threads.
- ›Enables network policy callbacks for remote exec.
- ›Terminates Windows non-TTY processes on interrupt, improving Ctrl-C behavior on Windows.
- ›Loads thread titles concurrently during session startup.
- ›Supports self-serve Business ProLite accounts.
- ›Supports plaintext collaboration tool messages.
- ›Honors the configured SQLite home in the logs client.
- rust-v0.146.0-alpha.9.1
Codex CLI adds managed in-app updates so the tool can keep itself current without manual reinstallation.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.9.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.9.1
- ›Adds managed in-app updates, allowing Codex CLI to update itself automatically from within the application.
- rust-v0.146.0-alpha.9.1
Codex CLI adds managed in-app updates so the tool can keep itself current without manual reinstallation.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.9.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.9.1
- ›Adds managed in-app updates, allowing Codex CLI to update itself automatically from within the application.
- rust-v0.147.0-alpha.1
Codex CLI adds
features.code_mode_hosttable config, MCP 2026 support, cloud-managed sandbox profiles, and exec-server network policy callbacks.└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.1
- ›Adds MCP 2026-07-28 discovery support and completes the full MCP 2026 client specification.
- ›Raises the MCP server recursion limit to unblock deeper tool-call chains.
- ›Exposes cached MCP tools before the MCP server finishes starting up, reducing turn latency at session start.
- ›Routes MCP OAuth flows through the configured HTTP clients, ensuring proxy and routing settings apply to all authentication requests.
- ›Adds persisted sections for organizing threads in the TUI.
+9 moreshow less
- ›Adds configurable developer instructions for v2 subagents.
- ›Supports model-owned token budget defaults.
- ›Routes curated plugins by authentication mode.
- ›Supports self-serve Business ProLite accounts.
- ›Scales skill metadata budgets with context windows.
- ›Adds bounded metadata for executed tool calls.
- ›Adds managed policy support for in-app updates.
- ›Terminates Windows non-TTY processes on interrupt, improving Ctrl-C behavior in non-interactive pipelines.
- ›Raises the Windows exec yield floor to 10 seconds for more reliable subprocess scheduling.
- rust-v0.147.0-alpha.1
Codex CLI adds
features.code_mode_hosttable config, MCP 2026 support, cloud-managed sandbox profiles, and exec-server network policy callbacks.└──▷ GET THIS VERSION$ git clone --branch rust-v0.147.0-alpha.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.147.0-alpha.1
- ›Adds MCP 2026-07-28 discovery support and completes the full MCP 2026 client specification.
- ›Raises the MCP server recursion limit to unblock deeper tool-call chains.
- ›Exposes cached MCP tools before the MCP server finishes starting up, reducing turn latency at session start.
- ›Routes MCP OAuth flows through the configured HTTP clients, ensuring proxy and routing settings apply to all authentication requests.
- ›Adds persisted sections for organizing threads in the TUI.
+9 moreshow less
- ›Adds configurable developer instructions for v2 subagents.
- ›Supports model-owned token budget defaults.
- ›Routes curated plugins by authentication mode.
- ›Supports self-serve Business ProLite accounts.
- ›Scales skill metadata budgets with context windows.
- ›Adds bounded metadata for executed tool calls.
- ›Adds managed policy support for in-app updates.
- ›Terminates Windows non-TTY processes on interrupt, improving Ctrl-C behavior in non-interactive pipelines.
- ›Raises the Windows exec yield floor to 10 seconds for more reliable subprocess scheduling.
- rust-v0.146.0
Codex CLI gains session naming, thread pinning, fork history, Agent Plugins with Bedrock/Claude marketplaces, WebSocket Code Mode, and standalone web search.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0
└──▷ TRY ITName a new session inline when starting a fresh conversation, keeping thread history organized.$ /new my-audit-session- ›Enables naming new sessions directly from the
/newor/clearcommands and pinning important threads for persistent access. - ›Supports Agent Plugins manifests, workspace plugin publishing, and additional plugin marketplaces for Amazon Bedrock and Claude Code.
- ›Adds thread forking with paginated history, including temporary forks that do not appear in thread listings.
- ›Connects app-server to remote Code Mode hosts over WebSocket.
- ›Enables standalone web search for compatible custom model providers.
+2 moreshow less
- ›Discovers executor-provided skills and securely reads their associated resources, including explicitly selected skills.
- ›Adds enterprise-plan recognition and administrator controls for in-app updates.
- ›Enables naming new sessions directly from the
- rust-v0.146.0
Codex CLI v0.146.0 adds named sessions, thread pinning, thread forking, WebSocket Code Mode, web search for custom providers, and Agent Plugin marketplace support.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0
└──▷ TRY ITForce the Codex installer to use GitHub Releases instead ofreleases.openai.com, useful when the OpenAI CDN is unreachable in a restricted environment.$ curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
- ›Enables standalone web search for compatible custom model providers via the
allow custom providers to opt into standalone web searchcapability (PR #34846). - ›Supports
CODEX_INSTALLER_USE_RELEASES_OPENAI_COMenvironment variable to control whether the installer pulls fromhttps://releases.openai.com/codexor falls back to GitHub Releases. - ›Name new sessions using
/newor/clearslash commands inside the TUI. - ›Pin important threads and switch between side conversations without closing them.
- ›Fork threads with paginated history, including temporary forks that do not appear in thread listings.
+4 moreshow less
- ›Connects app-server to remote Code Mode hosts over WebSocket.
- ›Adds support for Agent Plugins manifests, workspace plugin publishing, and additional plugin marketplaces for Amazon Bedrock and Claude Code.
- ›Discovers executor-provided skills and securely reads their associated resources, including explicitly selected skills.
- ›Adds enterprise-plan recognition and administrator controls for in-app updates.
- ›Enables standalone web search for compatible custom model providers via the
- rust-v0.146.0-alpha.10
Codex CLI alpha adds configurable code-mode host fallback, hardened network approval concurrency, and richer Responses Lite metadata.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.10 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.10
- ›Adds
disable_in_process_fallbackkey inside afeatures.code_mode_hostconfiguration table, letting operators suppress the embedded-V8 fallback so that a failed standalone host surfaces as tool output instead of silently falling back. - ›Preserves backward compatibility:
features.code_mode_hoststill accepts a plain boolean toggle in addition to the new table form. - ›Adds
code_mode_tool_namesfield to Responses Lite turn metadata, mapping each normalized code-mode identifier to its structuredToolName(omitted from external MCP server metadata and non-Lite requests). - ›Scopes pending network approvals to a turn and execution, coalesces duplicate requests within one execution, and cancels in-flight Guardian reviews when their owner is dropped — eliminating races between concurrent allow/deny decisions.
- ›Adds
- rust-v0.146.0-alpha.10
Codex CLI alpha adds configurable code-mode host fallback, hardened network approval concurrency, and richer Responses Lite metadata.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.10 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.10
- ›Adds
disable_in_process_fallbackkey inside afeatures.code_mode_hostconfiguration table, letting operators suppress the embedded-V8 fallback so that a failed standalone host surfaces as tool output instead of silently falling back. - ›Preserves backward compatibility:
features.code_mode_hoststill accepts a plain boolean toggle in addition to the new table form. - ›Adds
code_mode_tool_namesfield to Responses Lite turn metadata, mapping each normalized code-mode identifier to its structuredToolName(omitted from external MCP server metadata and non-Lite requests). - ›Scopes pending network approvals to a turn and execution, coalesces duplicate requests within one execution, and cancels in-flight Guardian reviews when their owner is dropped — eliminating races between concurrent allow/deny decisions.
- ›Adds
- rust-v0.146.0-alpha.8
Codex CLI alpha adds ent26 enterprise plan support, MCP OAuth proxy routing, ephemeral thread forks, and workspace plugin publish capability.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.8 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.8
- ›Adds
canPublishToWorkspacenullable metadata to plugin share contexts andplugin/share/saveresponses, letting clients surface workspace-directory publishing only when the capability is available. - ›Supports
excludeTurns: trueinthread/forkto create ephemeral forks from paginated thread history without creating a rollout path or exposing the fork viathread/list. - ›Routes MCP OAuth discovery and authentication status through each server's runtime HTTP client so MCP servers behind configured proxies are reliably discovered; caps local discovery at five seconds while preserving explicit login timeouts.
- ›Adds recognition of the
ent26enterprise plan across authentication, account protocol, backend rate-limit payloads, and app-server schemas, treating it as an enterprise workspace plan for cloud-config eligibility and usage-limit guidance.
- ›Adds
- rust-v0.146.0-alpha.8
Codex CLI alpha adds ent26 enterprise plan support, MCP OAuth proxy routing, ephemeral thread forks, and workspace plugin publish capability.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.8 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.8
- ›Adds
canPublishToWorkspacenullable metadata to plugin share contexts andplugin/share/saveresponses, letting clients surface workspace-directory publishing only when the capability is available. - ›Supports
excludeTurns: trueinthread/forkto create ephemeral forks from paginated thread history without creating a rollout path or exposing the fork viathread/list. - ›Routes MCP OAuth discovery and authentication status through each server's runtime HTTP client so MCP servers behind configured proxies are reliably discovered; caps local discovery at five seconds while preserving explicit login timeouts.
- ›Adds recognition of the
ent26enterprise plan across authentication, account protocol, backend rate-limit payloads, and app-server schemas, treating it as an enterprise workspace plan for cloud-config eligibility and usage-limit guidance.
- ›Adds
- rust-v0.146.0-alpha.7
Codex CLI gains Agent Plugins manifest support, MCP runtime prewarming, and background MCP refresh coordination.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.7 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.7
- ›Supports Agent Plugins 1.0 schema: recognizes root
plugin.jsonfiles and maps their portable metadata,skills/, andmcp.jsoninto Codex plugin manifests, with.codex-plugin/plugin.jsonas a fallback overlay. - ›Adds
WaitForEnvironmentToolConfigas thread extension data, letting hosts override the model-visiblewait_for_environmenttool andenvironment_iddescriptions. - ›Adds background MCP runtime prewarming — a per-session worker eagerly rebuilds dirty MCP state after configuration, authentication, or explicit refresh changes, coalescing queued refreshes.
- ›Refreshes MCP runtimes automatically when session auth changes (auth mode, account details, or token), and rebuilds the initial MCP projection if authentication changes during session startup.
- ›Adds explicit
RefreshMcpServersbehavior that forces reconnection to every configured MCP server rather than reusing existing connections.
+4 moreshow less
- ›Refreshes MCP runtimes across thread startup and independently across active threads when managed MCP requirements change.
- ›Supports paginated thread forks.
- ›Exposes executor skills through skill tools and enables resource reads for explicit executor skills.
- ›Preserves output from hooks that exit before reading stdin (fast-exiting hooks no longer lose stdout when stdin is not consumed).
- ›Supports Agent Plugins 1.0 schema: recognizes root
- rust-v0.146.0-alpha.7
Codex CLI gains Agent Plugins manifest support, MCP runtime prewarming, and background MCP refresh coordination.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.7 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.7
- ›Supports Agent Plugins 1.0 schema: recognizes root
plugin.jsonfiles and maps their portable metadata,skills/, andmcp.jsoninto Codex plugin manifests, with.codex-plugin/plugin.jsonas a fallback overlay. - ›Adds
WaitForEnvironmentToolConfigas thread extension data, letting hosts override the model-visiblewait_for_environmenttool andenvironment_iddescriptions. - ›Adds background MCP runtime prewarming — a per-session worker eagerly rebuilds dirty MCP state after configuration, authentication, or explicit refresh changes, coalescing queued refreshes.
- ›Refreshes MCP runtimes automatically when session auth changes (auth mode, account details, or token), and rebuilds the initial MCP projection if authentication changes during session startup.
- ›Adds explicit
RefreshMcpServersbehavior that forces reconnection to every configured MCP server rather than reusing existing connections.
+4 moreshow less
- ›Refreshes MCP runtimes across thread startup and independently across active threads when managed MCP requirements change.
- ›Supports paginated thread forks.
- ›Exposes executor skills through skill tools and enables resource reads for explicit executor skills.
- ›Preserves output from hooks that exit before reading stdin (fast-exiting hooks no longer lose stdout when stdin is not consumed).
- ›Supports Agent Plugins 1.0 schema: recognizes root
- rust-v0.146.0-alpha.6
Codex CLI alpha.6 adds remote code-mode host support via
--code-mode-host, skill catalog context warnings, and nonblocking TUI turn interrupts.└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.6 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.6
└──▷ TRY ITConnect the app server to a remote code-mode host over a secure WebSocket instead of the default local transport.$ codex-app-server --code-mode-host wss://example.com/code-mode --listen stdio://
- ›Adds
--code-mode-hostflag tocodex-app-server, accepting awss://WebSocket URL to connect the app server to a remote code-mode host (invalid schemes such ashttp://or barews://are rejected at parse time). - ›Adds WebSocket transport to the code-mode host, enabling remote code-mode host connections through the app server.
- ›Exposes Browser Use requirements and remote skill icon URLs through the app server for downstream consumers.
- ›Attributes command executions to trusted plugin scripts, with attribution preserved across command approvals.
- ›Routes exec-server HTTP and WebSocket traffic through the configured proxy policy.
+4 moreshow less
- ›Preserves refreshed Apps tools across MCP runtime updates and keeps side conversations open when switching threads.
- ›Enforces writer ownership for thread archive and deletion operations.
- ›Supports incremental replay of updated thread items.
- ›Honors the configured SQLite home directory consistently across all state consumers, including startup backfill, thread listing, and paginated history.
- ›Adds
- rust-v0.146.0-alpha.6
Codex CLI alpha.6 adds remote code-mode host support via
--code-mode-host, skill catalog context warnings, and nonblocking TUI turn interrupts.└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.6 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.6
└──▷ TRY ITConnect the app server to a remote code-mode host over a secure WebSocket instead of the default local transport.$ codex-app-server --code-mode-host wss://example.com/code-mode --listen stdio://
- ›Adds
--code-mode-hostflag tocodex-app-server, accepting awss://WebSocket URL to connect the app server to a remote code-mode host (invalid schemes such ashttp://or barews://are rejected at parse time). - ›Adds WebSocket transport to the code-mode host, enabling remote code-mode host connections through the app server.
- ›Exposes Browser Use requirements and remote skill icon URLs through the app server for downstream consumers.
- ›Attributes command executions to trusted plugin scripts, with attribution preserved across command approvals.
- ›Routes exec-server HTTP and WebSocket traffic through the configured proxy policy.
+4 moreshow less
- ›Preserves refreshed Apps tools across MCP runtime updates and keeps side conversations open when switching threads.
- ›Enforces writer ownership for thread archive and deletion operations.
- ›Supports incremental replay of updated thread items.
- ›Honors the configured SQLite home directory consistently across all state consumers, including startup backfill, thread listing, and paginated history.
- ›Adds
- rust-v0.146.0-alpha.3.1
Codex CLI adds
supports_standalone_web_searchsetting so custom model providers can opt into the standaloneweb.runtool.└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.3.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.3.1
- ›Adds
supports_standalone_web_searchmodel-provider setting (defaults tofalse) that lets custom Responses API providers opt into the standaloneweb.runweb-search tool when web search is enabled. - ›Routes standalone web search requests through the custom provider's own endpoint and authentication when
supports_standalone_web_searchis enabled.
- ›Adds
- rust-v0.146.0-alpha.3.1
Codex CLI adds
supports_standalone_web_searchsetting so custom model providers can opt into the standaloneweb.runtool.└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.3.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.3.1
- ›Adds
supports_standalone_web_searchmodel-provider setting (defaults tofalse) that lets custom Responses API providers opt into the standaloneweb.runweb-search tool when web search is enabled. - ›Routes standalone web search requests through the custom provider's own endpoint and authentication when
supports_standalone_web_searchis enabled.
- ›Adds
- rust-v0.146.0-alpha.5
Codex CLI alpha.5 adds thread pinning, MCP tool prefix control, custom provider web search, and MCP connection reuse.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.5 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.5
└──▷ TRY ITForce the standalone installer to use GitHub Releases instead ofreleases.openai.com, useful in environments that block the primary CDN.$ curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
- ›Adds
isPinnedfield to thread responses and allowsthread/metadata/updateto pin or unpin stored threads. - ›Adds
isPinnedfilter tothread/list, supporting cursor-based pagination and combinations with relationship filters. - ›Allows omitting MCP tool prefixes per server, reducing namespace clutter in multi-server setups.
- ›Allows custom providers to opt into standalone web search.
- ›Allows disabling the multi-agent wait tool.
+9 moreshow less
- ›Sets a default user agent for MCP HTTP requests.
- ›Reuses MCP connections across runtime refreshes and replaces closed MCP connections during reconciliation, reducing reconnect overhead.
- ›Caches remote plugin catalogs by scope for faster plugin resolution.
- ›Tracks
compaction_msin turn profile facts and analytics events as a dedicated profile phase. - ›Preserves user input in conversation history when MCP startup is interrupted mid-turn.
- ›Infers the bundled Claude Code plugin marketplace automatically.
- ›Uses the API plugin marketplace for Amazon Bedrock.
- ›Preserves timestamps when importing external agent sessions.
- ›Standalone installers now prefer
releases.openai.comby default and fall back to GitHub Releases; setCODEX_INSTALLER_USE_RELEASES_OPENAI_COM=falseto force GitHub Releases.
- ›Adds
- rust-v0.146.0-alpha.5
Codex CLI alpha.5 adds thread pinning, MCP tool prefix control, custom provider web search, and MCP connection reuse.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.146.0-alpha.5 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.146.0-alpha.5
└──▷ TRY ITForce the standalone installer to use GitHub Releases instead ofreleases.openai.com, useful in environments that block the primary CDN.$ curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
- ›Adds
isPinnedfield to thread responses and allowsthread/metadata/updateto pin or unpin stored threads. - ›Adds
isPinnedfilter tothread/list, supporting cursor-based pagination and combinations with relationship filters. - ›Allows omitting MCP tool prefixes per server, reducing namespace clutter in multi-server setups.
- ›Allows custom providers to opt into standalone web search.
- ›Allows disabling the multi-agent wait tool.
+9 moreshow less
- ›Sets a default user agent for MCP HTTP requests.
- ›Reuses MCP connections across runtime refreshes and replaces closed MCP connections during reconciliation, reducing reconnect overhead.
- ›Caches remote plugin catalogs by scope for faster plugin resolution.
- ›Tracks
compaction_msin turn profile facts and analytics events as a dedicated profile phase. - ›Preserves user input in conversation history when MCP startup is interrupted mid-turn.
- ›Infers the bundled Claude Code plugin marketplace automatically.
- ›Uses the API plugin marketplace for Amazon Bedrock.
- ›Preserves timestamps when importing external agent sessions.
- ›Standalone installers now prefer
releases.openai.comby default and fall back to GitHub Releases; setCODEX_INSTALLER_USE_RELEASES_OPENAI_COM=falseto force GitHub Releases.
- ›Adds
- rust-v0.145.0-alpha.30
Codex CLI alpha.30 adds Esc-key session interruption and parallel stdin writes across unified-exec sessions.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.145.0-alpha.30 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.145.0-alpha.30
- ›Adds Esc key as an interrupt mechanism to cancel a running agent task mid-session, now documented in the status indicator.
- ›Runs
write_stdinin parallel across unified-exec sessions, improving throughput when multiple shell sessions are active. - ›Updates bundled GPT-5.6 model variants with 272,000-token context windows and adds personality instruction variables.
- ›Adds GPT-5.5 availability notice to the bundled model catalog.
└──▷ BREAKING ON UPGRADE- !The
auto_reviewandpermissionsmessage fields and the legacysupports_reasoning_summary_parameterflag are removed from the bundled model catalog.
- rust-v0.145.0-alpha.30
Codex CLI alpha.30 adds Esc-key session interruption and parallel stdin writes across unified-exec sessions.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.145.0-alpha.30 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.145.0-alpha.30
- ›Adds Esc key as an interrupt mechanism to cancel a running agent task mid-session, now documented in the status indicator.
- ›Runs
write_stdinin parallel across unified-exec sessions, improving throughput when multiple shell sessions are active. - ›Updates bundled GPT-5.6 model variants with 272,000-token context windows and adds personality instruction variables.
- ›Adds GPT-5.5 availability notice to the bundled model catalog.
└──▷ BREAKING ON UPGRADE- !The
auto_reviewandpermissionsmessage fields and the legacysupports_reasoning_summary_parameterflag are removed from the bundled model catalog.
- rust-v0.145.0
Codex CLI gains paginated thread history, Amazon Bedrock support, audio I/O, multi-agent V2 stability, and expanded
/importmigration.└──▷ GET THIS VERSION$ git clone --branch rust-v0.145.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.145.0
- ›Adds
GPT-5.6 Solas the default Amazon Bedrock model, with experimental managed Bedrock login, custom endpoint, and custom authentication support. - ›Expands
/importto migrate settings, MCP servers, plugins, sessions, commands, and project-scoped memories from Cursor and Claude Code. - ›Adds experimental paginated thread history with efficient resume, search, persisted names, sub-agent support, and memories backed by a dedicated SQLite store.
- ›Adds audio inputs and tool outputs supporting common local audio formats, and introduces streaming realtime V3 conversations.
- ›Adds secure, clickable inline visualization links in the terminal UI.
- ›Adds
- rust-v0.145.0
Codex CLI v0.145.0 adds paginated thread history, Bedrock login, audio inputs, stabilized multi-agent V2, and expanded
/importmigration.└──▷ GET THIS VERSION$ git clone --branch rust-v0.145.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.145.0
- ›Adds experimental Amazon Bedrock login with managed authentication support, custom endpoint configuration, and GPT-5.6 Sol as the default Bedrock model.
- ›Expands
/importto migrate Cursor and Claude Code settings, MCP servers, plugins, sessions, commands, and project-scoped memories. - ›Adds experimental paginated thread history with efficient resume, search, persisted names, sub-agent support, and memories.
- ›Adds audio inputs and tool outputs supporting common local audio formats, and introduces streaming realtime V3 conversations.
- ›Adds secure, clickable inline visualization links rendered directly in the terminal UI.
- rust-v0.145.0-alpha.29
Codex CLI adds route-aware HTTP client pooling, system proxy support across all subsystems, and configurable external session detection limits.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.145.0-alpha.29 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.145.0-alpha.29
└──▷ TRY ITForce the Codex installer to use GitHub Releases instead ofreleases.openai.comwhen behind a network that blocks the default source.$ curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
- ›Adds
maxSessionAgeDaysandmaxSessionsfields to the external-agent config detection request, making session discovery limits configurable (defaults remain 30-day max age and 50 sessions). - ›Adds
CARGO_HTTP_CAINFOto the curated custom CA environment variables so Cargo inherits the managed MITM trust bundle in proxy environments. - ›Adds an optional opaque
providerIdfield toexternalAgentConfig/importfor analytics attribution of external agent imports, independently of themigrationSourceselector. - ›Introduces a route-aware HTTP client pool (
RouteAwareClientPool) that resolves the outbound proxy route per request URL, with a bounded cache of 16 routes — enabling correct PAC and system-proxy handling across redirects. - ›Extends system proxy settings to cover the daemon updater, remote plugins, plugin startup sync, and cloud environment discovery.
+4 moreshow less
- ›Preserves thread settings for goal-first and forked threads on restart, so resumed threads use the configuration active when they were created rather than current config.
- ›Adds an optional
releases.openai.cominstaller source, withCODEX_INSTALLER_USE_RELEASES_OPENAI_COMcontrolling fallback to GitHub Releases. - ›Mirrors Rust release artifacts and metadata to Cloudflare R2 as an additional distribution channel.
- ›Supports alpha hotfix release versions in the version scheme (mapping Python
aN.postMto-alpha.N.Mtags) across installers, npm publishing, and release validation.
- ›Adds
- rust-v0.145.0-alpha.29
Codex CLI adds route-aware HTTP client pooling, system proxy support across all subsystems, and configurable external session detection limits.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.145.0-alpha.29 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.145.0-alpha.29
└──▷ TRY ITForce the Codex installer to use GitHub Releases instead ofreleases.openai.comwhen behind a network that blocks the default source.$ curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
- ›Adds
maxSessionAgeDaysandmaxSessionsfields to the external-agent config detection request, making session discovery limits configurable (defaults remain 30-day max age and 50 sessions). - ›Adds
CARGO_HTTP_CAINFOto the curated custom CA environment variables so Cargo inherits the managed MITM trust bundle in proxy environments. - ›Adds an optional opaque
providerIdfield toexternalAgentConfig/importfor analytics attribution of external agent imports, independently of themigrationSourceselector. - ›Introduces a route-aware HTTP client pool (
RouteAwareClientPool) that resolves the outbound proxy route per request URL, with a bounded cache of 16 routes — enabling correct PAC and system-proxy handling across redirects. - ›Extends system proxy settings to cover the daemon updater, remote plugins, plugin startup sync, and cloud environment discovery.
+4 moreshow less
- ›Preserves thread settings for goal-first and forked threads on restart, so resumed threads use the configuration active when they were created rather than current config.
- ›Adds an optional
releases.openai.cominstaller source, withCODEX_INSTALLER_USE_RELEASES_OPENAI_COMcontrolling fallback to GitHub Releases. - ›Mirrors Rust release artifacts and metadata to Cloudflare R2 as an additional distribution channel.
- ›Supports alpha hotfix release versions in the version scheme (mapping Python
aN.postMto-alpha.N.Mtags) across installers, npm publishing, and release validation.
- ›Adds
- rust-v0.145.0-alpha.28
Codex CLI alpha.28 adds concurrent terminal stdin, Amazon Bedrock custom transports, audio I/O, and incremental Markdown streaming.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.145.0-alpha.28 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.145.0-alpha.28
- ›Supports custom transports for Amazon Bedrock, enabling non-default network or proxy configurations when connecting to Bedrock-backed models.
- ›Adds an app-server API for reading installed app runtime state.
- ›Adds audio input and output support: audio variants in user input protocols, audio inputs forwarded to the Responses API, audio output in dynamic tools and code mode, and audio history gated by model input modalities.
- ›Adds
SessionEndhooks for thread teardown, enabling cleanup logic when a session ends. - ›Adds batched executor capability discovery.
+18 moreshow less
- ›Adds occurrence search for paginated threads.
- ›Renders inline visualization links in the TUI.
- ›Renders streamed Markdown incrementally in the TUI, reducing layout work and redundant redraws while streaming.
- ›Allows users to remember the working directory for resumed sessions.
- ›Allows publishing plugins through share updates.
- ›Allows selecting path-backed agents in the TUI agent picker.
- ›Confirms usage-limit resets before redemption, preventing accidental redemption.
- ›Suppresses empty multi-agent mode messages in the TUI.
- ›Reports detailed session import error types.
- ›Tracks collaboration mode instructions and permission instructions in world state.
- ›Centralizes thread MCP connections in
McpRuntime. - ›Supports ChatGPT-branded Desktop app builds.
- ›Adds bounded batch lookups and batched persistent history reads for message history, improving reverse-search performance.
- ›Launches managed network proxies on remote executors.
- ›Makes parent-owned sub-agent threads read-only in the TUI.
- ›Exposes plugin installation interstitial requirements.
- ›Records web search result payload sizes.
- ›Seeds realtime V3 sessions with initial text items and streams realtime V3 Codex handoff output.
- rust-v0.145.0-alpha.28
Codex CLI alpha.28 adds concurrent terminal stdin, Amazon Bedrock custom transports, audio I/O, and incremental Markdown streaming.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.145.0-alpha.28 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.145.0-alpha.28
- ›Supports custom transports for Amazon Bedrock, enabling non-default network or proxy configurations when connecting to Bedrock-backed models.
- ›Adds an app-server API for reading installed app runtime state.
- ›Adds audio input and output support: audio variants in user input protocols, audio inputs forwarded to the Responses API, audio output in dynamic tools and code mode, and audio history gated by model input modalities.
- ›Adds
SessionEndhooks for thread teardown, enabling cleanup logic when a session ends. - ›Adds batched executor capability discovery.
+18 moreshow less
- ›Adds occurrence search for paginated threads.
- ›Renders inline visualization links in the TUI.
- ›Renders streamed Markdown incrementally in the TUI, reducing layout work and redundant redraws while streaming.
- ›Allows users to remember the working directory for resumed sessions.
- ›Allows publishing plugins through share updates.
- ›Allows selecting path-backed agents in the TUI agent picker.
- ›Confirms usage-limit resets before redemption, preventing accidental redemption.
- ›Suppresses empty multi-agent mode messages in the TUI.
- ›Reports detailed session import error types.
- ›Tracks collaboration mode instructions and permission instructions in world state.
- ›Centralizes thread MCP connections in
McpRuntime. - ›Supports ChatGPT-branded Desktop app builds.
- ›Adds bounded batch lookups and batched persistent history reads for message history, improving reverse-search performance.
- ›Launches managed network proxies on remote executors.
- ›Makes parent-owned sub-agent threads read-only in the TUI.
- ›Exposes plugin installation interstitial requirements.
- ›Records web search result payload sizes.
- ›Seeds realtime V3 sessions with initial text items and streams realtime V3 Codex handoff output.
- rust-v0.145.0-alpha.27
Codex CLI alpha.27 lets Esc interrupt a running session and updates bundled model metadata for GPT-5.6 and GPT-5.5.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.145.0-alpha.27 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.145.0-alpha.27
- ›Allows pressing Esc to interrupt the current agent session while a task is running, with Esc now documented as an interrupt key in the status indicator.
- ›Updates bundled GPT-5.6 model variant context windows to 272,000 tokens and refreshes model instructions, message configuration, and reasoning-summary support across the model catalog.
- ›Adds personality instruction variables for GPT-5.6 model variants and adds a GPT-5.5 availability notice to the bundled catalog.
- ›Runs
write_stdinin parallel across unified-exec sessions, improving throughput for multi-session workloads.
└──▷ BREAKING ON UPGRADE- !The
auto_reviewandpermissionsmessage fields and the legacysupports_reasoning_summary_parameterflag are removed from the bundled model catalog.
- rust-v0.145.0-alpha.27
Codex CLI alpha.27 lets Esc interrupt a running session and updates bundled model metadata for GPT-5.6 and GPT-5.5.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.145.0-alpha.27 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.145.0-alpha.27
- ›Allows pressing Esc to interrupt the current agent session while a task is running, with Esc now documented as an interrupt key in the status indicator.
- ›Updates bundled GPT-5.6 model variant context windows to 272,000 tokens and refreshes model instructions, message configuration, and reasoning-summary support across the model catalog.
- ›Adds personality instruction variables for GPT-5.6 model variants and adds a GPT-5.5 availability notice to the bundled catalog.
- ›Runs
write_stdinin parallel across unified-exec sessions, improving throughput for multi-session workloads.
└──▷ BREAKING ON UPGRADE- !The
auto_reviewandpermissionsmessage fields and the legacysupports_reasoning_summary_parameterflag are removed from the bundled model catalog.
- rust-v0.144.0
Codex CLI adds a
writesapproval mode, interactive MCP auth by default, and Ultra concurrency warnings in v0.144.0.└──▷ GET THIS VERSION$ git clone --branch rust-v0.144.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.144.0
- ›Adds a
writesapp-approval mode that allows declared read-only actions without prompting while still requiring approval for write operations. - ›Enables MCP tool interactive authentication by default — no experimental opt-in required.
- ›Usage-limit reset credits now display their type and expiration date, with an interactive picker to choose which credit to redeem.
- ›App-server hosts can now supply Codex authentication at runtime and redirect users to a hosted page after successful login.
- ›Selecting Ultra reasoning now triggers a warning when high multi-agent concurrency is configured, alerting users to potential rapid usage increases.
- ›Adds a
- rust-v0.143.0
Codex CLI gains system proxy routing, Amazon Bedrock new models, MCP session auth, and a remote-control pairing command.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.143.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.143.0
└──▷ TRY ITGenerate a pairing code when you need to connect a remote-control client to an already-running Codex daemon without restarting it.$ codex remote-control pair- ›Enables remote plugins by default, with richer catalog rows, npm marketplace sources, and visible remote/local version info.
- ›Routes authentication and Responses API traffic through macOS and Windows system proxies, including PAC and WPAD configurations.
- ›Adds
codex remote-control pairsubcommand for generating manual pairing codes from a running daemon. - ›Adds Amazon Bedrock GPT-5.6 Sol, Terra, and Luna models with first-class support for
maxreasoning effort. - ›Enables MCP tool search by default; ChatGPT-hosted MCP servers can now explicitly use session authentication.
+1 moreshow less
- ›App-server clients can inspect environments, list descendant threads, and fork history through a specific turn.
- rust-v0.142.2
Codex CLI gains default MCP tool search, macOS system proxy support, and dark-mode plugin logos.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.142.2 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.142.2
└──▷ USE ITRoute Codex CLI traffic through a corporate PAC/WPAD proxy on macOS without manual proxy configuration.# In your Codex config, enable system proxy resolution: respect_system_proxy: true
- ›Enables tool search for MCP tools by default when the model/provider supports it, improving tool discovery while staying compatible with older models.
- ›Adds macOS system proxy, PAC, and WPAD resolution when
respect_system_proxyis enabled, letting the CLI route through corporate proxies automatically. - ›Supports dark-mode logos for plugins via local manifests and remote catalogs.
- ›Surfaces richer safety-buffering UI using server-provided visibility and faster-model metadata.
- rust-v0.142.1
OpenAI Codex CLI adds opt-in Windows system proxy support including PAC, WPAD, static proxies, and bypass rules.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.142.1 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.142.1
- ›Adds opt-in Windows system proxy support for authentication, covering PAC, WPAD, static proxies, and bypass rules.
- rust-v0.142.0
Codex CLI gains indexed web search, rollout token budgets, multi-agent delegation controls, plugin sections, and scheduled time reminders.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.142.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.142.0
- ›Adds
/usagecommand support for viewing and redeeming earned usage-limit reset credits, with confirmation, retry, and refreshed availability states. - ›Organizes
/pluginsremote plugins into OpenAI Curated, Workspace, and Shared with me sections; eligible turns can now recommend and install relevant plugins. - ›Introduces configurable rollout token budgets that track usage across agent threads, surface remaining-budget reminders, and abort turns when the budget is exhausted.
- ›Enables app-server clients to configure multi-agent delegation as disabled, explicit-request-only, or proactive at both the thread and turn level.
- ›Adds an indexed web-search mode that allows live searches while restricting direct page access to server-approved URLs.
+1 moreshow less
- ›Supports scheduled UTC time reminders and direct current-time queries, including through client-provided app-server clocks.
- ›Adds
- rust-v0.141.0
Codex CLI gains Noise-encrypted remote execution, per-thread MCP servers, auto-resolving TUI prompts, and richer app-server APIs.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.141.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.141.0
- ›Adds authenticated, end-to-end encrypted Noise relay channels for remote executors.
- ›Cross-platform remote execution now preserves executor-native working directories and shells, including filesystem permission paths across app-server and exec-server boundaries.
- ›Selected executor plugins can activate their stdio MCP servers per thread; plugin discovery adds a created-by-me marketplace and auth-specific curated catalogs.
- ›App-server clients can list immediate child threads, correlate external-agent import results, and read or redeem rate-limit reset credits.
- ›Realtime clients can explicitly append speech, control how Codex responses enter conversations, and omit startup context.
- rust-v0.140.0
Codex CLI v0.140.0 adds usage dashboards, session deletion, Claude Code import, @
-mentionsmenu, and managed Bedrock auth.└──▷ GET THIS VERSION$ git clone --branch rust-v0.140.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.140.0
└──▷ TRY ITPermanently remove a stale session and all its subagents to keep your session list clean.$ codex delete- ›Adds
/usagecommand with daily, weekly, and cumulative account token activity views. - ›Adds
codex delete,/delete, and app-serverthread/deletefor permanent session deletion with confirmation safeguards and subagent cleanup. - ›Adds
/importfor selectively importing setup, project configuration, and recent chats from Claude Code. - ›Typing
@now opens a unified mentions menu for files, plugins, and skills by default. - ›Adds managed Amazon Bedrock API-key authentication with encrypted local storage for CLI and MCP OAuth credentials.
+1 moreshow less
- ›Preserves oversized text, large pasted blocks, and image attachments in
/goal, including in remote app-server sessions.
- ›Adds
- rust-v0.139.0
Codex CLI adds standalone web search in code mode, richer MCP schema support, and improved plugin marketplace JSON output.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.139.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.139.0
└──▷ TRY ITList all plugin marketplace sources in JSON to script or audit which catalogs are configured.$ codex plugin marketplace list --json
- ›Enables standalone web search in code mode, including from nested JavaScript tool calls, returning plaintext results.
- ›Tool and connector input schemas now preserve
oneOfandallOf, and large schemas retain more shallow structure when compacted for better MCP tool compatibility. - ›
codex doctornow includes editor and pager environment details in the local report, with raw values redacted in JSON output. - ›
codex plugin marketplace list --jsonnow includes each marketplace source per entry. - ›Plugin lists can now return from the cached remote catalog before refreshing in the background, improving responsiveness.
+2 moreshow less
- ›Adds
-Pas a sandbox permissions profile alias flag. - ›Shows effective sandbox modes in
/debug-config.
- rust-v0.138.0
Codex CLI gains Desktop handoff, richer plugin JSON output, image path exposure, PAT v2 auth, and flexible reasoning effort selection.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.138.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.138.0
└──▷ TRY ITHand off an active CLI session to Codex Desktop on macOS or Windows without losing context.$ /appGet structured JSON output from plugin marketplace commands for scripting or CI pipelines.$ codex plugin list --json
- ›Adds
/appcommand to hand off the current CLI thread into Codex Desktop on macOS and native Windows, with Windows workspace launches opening directly into Desktop. - ›Exposes saved file paths for local image attachments and standalone image generations to the model, enabling more reliable follow-up edits and file references.
- ›Adds fallback keyboard shortcuts in the TUI for reasoning effort selection on terminals missing Alt bindings, and supports model-defined effort levels in model-advertised order.
- ›App-server integrations can now read account token usage via the API.
- ›Adds support for v2 personal access tokens in CLI and app-server authentication flows.
+1 moreshow less
- ›Adds
--jsonoutput to plugin add/remove and marketplace commands; plugin list JSON now includes marketplace source; plugin detail data exposes default prompts, remote MCP servers, and unavailable app templates.
- ›Adds
- rust-v0.137.0
Codex CLI gains F13-F24 keybindings,
codex plugin list --json, remote-control pairing RPCs, and multi-agent v2 per-thread runtimes.└──▷ GET THIS VERSION$ git clone --branch rust-v0.137.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.137.0
└──▷ TRY ITGet a machine-readable list of all installed plugins for scripting or audit pipelines.$ codex plugin list --json
- ›Adds F13-F24 function key support in TUI keymaps for extended keyboard bindings.
- ›Enables paste in searchable selection menus within the TUI.
- ›Adds a compact reasoning-only status/title item to the TUI status surface.
- ›Adds
codex plugin list --jsonfor machine-readable plugin inventory output. - ›Caches remote plugin catalog suggestions for faster plugin discovery.
+9 moreshow less
- ›Adds remote-control pairing start and client management RPCs (list/revoke controller grants) via app-server v2.
- ›Shows enterprise monthly credit limits in the status display for admin/enterprise flows.
- ›Supports applying cloud-managed config bundles, including EDU workspace accounts.
- ›Enables parallel standalone web search calls in code-mode flows.
- ›Exposes standalone image generation and hosted web/image tools in code-only mode.
- ›Multi-agent v2 keeps runtime choice per-thread and exposes cleaner follow-up and metadata defaults for spawned agents.
- ›Adds skills extension scaffold with per-turn catalog resolution and v1 prompt injection.
- ›Keys request-permission grants by environment identity for scoped approvals.
- ›Exports readable CA bundles to child commands when managed MITM proxying is active.
└──▷ BREAKING ON UPGRADE- !The
persist_extended_historybool flag is removed from app-server (the experimental flag no longer exists). - !The multi-agent v2
assign_taskfield is renamed tofollowup_task. - !
hide_spawn_agent_metadatanow defaults totrue, changing the default metadata visibility for spawned agents.
- rust-v0.136.0
Codex CLI v0.136.0 adds session archiving, OSC 8 clickable links, stdio app-server mode, Windows sandbox provisioning, and a standalone image generation extension.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.136.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.136.0
└──▷ TRY ITArchive a completed session from the CLI to prevent it from being resumed or forked accidentally.$ codex archive <session-id>Restore an archived session so it can be resumed or forked again.$ codex unarchive <session-id>Start the app-server in stdio mode for direct process-level integration without a network socket.$ codex app-server --stdio
- ›Adds
/archiveslash command in the TUI andcodex archive/codex unarchiveCLI commands to protect sessions from accidental resume or fork until restored. - ›TUI markdown now renders clickable web links via OSC 8 metadata, and cramped tables automatically reformat as readable key/value records while preserving link targets.
- ›Launches app-server in stdio mode with
codex app-server --stdiofor easier process-level integrations. - ›Supports
CODEX_API_KEYregistration for approved OpenAI hosts in remote execution setup; remote-control websockets now use short-lived server tokens instead of ChatGPT access tokens. - ›Adds alpha
codex sandbox setup --elevatedprovisioning path for Windows admins, plus constrained requirements support for allowed Windows sandbox implementations.
+4 moreshow less
- ›Adds a feature-gated standalone image generation extension that runs through the native Codex image artifact completion pipeline.
- ›Exposes richer MCP server status information in app-server integrations.
- ›Adds focused diagnostics for MCP HTTP send failures.
- ›Adds
experimental_request_user_inputtoggle in config.
- ›Adds
- rust-v0.135.0
Codex CLI gains richer
doctordiagnostics, Vim text-object editing, named permission profiles, and non-interactive install support.└──▷ GET THIS VERSION$ git clone --branch rust-v0.135.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.135.0
└──▷ TRY ITCapture full environment, Git, terminal, and thread inventory diagnostics to share with support.$ codex doctorRun a silent, unattended Codex install in a CI pipeline or provisioning script.$ CODEX_NON_INTERACTIVE=1 bash install.shInspect which remote server you're connected to and its version without leaving the TUI.$ /status- ›Adds richer environment, Git, terminal, app-server, and thread inventory diagnostics to
codex doctorfor support cases. - ›New
/statuscommand shows remote connection details and server version when connected over a remote transport. - ›Vim mode gains text-object editing, improved word/line-end behavior, and a configurable turn-interruption keybind.
- ›Adds named permission profile picker to
/permissions, which now displays configured custom profiles. - ›Packaged Codex builds can discover and use the bundled patched zsh helper on supported macOS and Linux targets.
+1 moreshow less
- ›Supports non-interactive installation mode via
install.sh/install.ps1whenCODEX_NON_INTERACTIVE=1is set.
- ›Adds richer environment, Git, terminal, app-server, and thread inventory diagnostics to
- rust-v0.134.0
Codex CLI gains conversation history search, concurrent read-only MCP tools, OAuth for MCP servers, and richer extension/hook context.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.134.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.134.0
└──▷ TRY ITSelect a named permission profile when starting a session, now consistently honored across CLI, TUI, and sandbox.$ codex --profile my-restricted-profile sandbox <target>
Add an MCP server with OAuth enabled for a streamable HTTP endpoint.$ codex mcp add --oauth https://example.com/mcp
- ›Adds search across local conversation history with case-insensitive content matching and result previews.
- ›Makes
--profilethe primary profile selector across CLI, TUI permissions, and sandbox flows; legacy profile configs now rejected with migration guidance. - ›Supports per-server environment targeting and OAuth options for streamable HTTP MCP servers via
codex mcp add. - ›Enables concurrent execution of read-only MCP tools that advertise
readOnlyHint. - ›Preserves local
$ref/$defsstructures and compacts oversized schemas for more reliable connector tool schemas.
+1 moreshow less
- ›Exposes conversation history to extension tools and adds subagent identity to hook inputs for richer extension and hook context.
└──▷ BREAKING ON UPGRADE- !Legacy profile v1 config selectors are now rejected;
--profileis the required flag and legacy profile configs must be migrated.
- rust-v0.133.0
Codex CLI gains always-on goal tracking, improved remote-control UX, richer extension lifecycle hooks, and smarter plugin discovery.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.133.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.133.0
- ›Enables Goals by default with dedicated storage and cross-turn progress tracking.
- ›Permission profiles gain a list API, inheritance resolution, managed
requirements.tomlsupport, runtime refresh, and deeper Windows sandbox integration. - ›Plugin list output is now tabulated and marketplace-aware, showing installed versions, visible marketplace roots, and remote collection support.
- ›Extensions can now observe SubagentStart/SubagentStop lifecycle hooks, tool execution events, turn-start metadata, and async approval/turn processing.
- ›Adds a
/btwalias for the side slash command.
+5 moreshow less
- ›Adds
turn_idandtruncation_policyfields to extension tool calls. - ›Adds a standalone web-search API client.
- ›Adds MITM hook config model and wires MITM hooks into runtime enforcement with named permissions config.
- ›Adds
thread/settings/updateapp-server API for syncing TUI thread settings. - ›Exposes a
--versionflag oncodex-app-server.
- rust-v0.132.0
Codex CLI gains
--output-schemafor resumed execs, faster TUI startup, and auth-backed remote executor registration.└──▷ GET THIS VERSION$ git clone --branch rust-v0.132.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.132.0
└──▷ TRY ITResume a long-running automation and enforce a structured JSON schema on its output without losing session context.$ codex exec resume <session-id> --output-schema '{"type":"object","properties":{"result":{"type":"string"}}}'
- ›Adds
--output-schemaflag tocodex exec resume, enabling resumed automations to enforce structured JSON output while preserving session context. - ›Enables remote executor registration via standard Codex auth, eliminating the need for a separate registry credential flow.
- ›Optimizes TUI startup by batching terminal capability probes, reducing time to first interactive frame.
- ›Supports preserving requested image fidelity — including original-resolution local images — across user inputs and image-producing tools in app-server turns.
- ›Adds
- rust-v0.131.0
Codex CLI v0.131.0 adds
codex doctor, unified@mention picker, remote daemon control, marketplace plugin commands, and a richer TUI.└──▷ GET THIS VERSION$ git clone --branch rust-v0.131.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.131.0
└──▷ TRY ITRun environment-wide diagnostics before filing a support ticket or debugging auth/network issues.$ codex doctor- ›Adds
codex doctorcommand for support-ready diagnostics covering runtime, auth, terminal, network, config, and local state. - ›Unified
@mention picker now searches files, directories, plugins, and skills in a single interface backed by app-server plugin metadata. - ›Remote workflows gain
codex remote-controldaemon management, runtime enable/disable APIs, status reads, and registry-backed remote environments. - ›Plugin system adds marketplace CLI commands, version-aware sharing, share checkout, shared-workspace buckets, and default-enabled plugin hooks.
- ›TUI gains data-driven service-tier slash commands, blended token usage display, permissions/approval mode visibility, effective workspace roots, and responsive Markdown tables.
+8 moreshow less
- ›Python SDK renamed to
openai-codex/openai_codex, with pinned runtime-generated types, concurrent turn routing by ID, and approval modes. - ›Adds Windows deny-read sandbox parity matching existing macOS/Linux sandbox behavior.
- ›Adds Windows hook command overrides for customizing hook behavior per-platform.
- ›Supports
PreToolUseupdatedInputrewrites, allowing hooks to modify tool inputs before execution. - ›Supports multi-environment
apply_patchselection for applying patches across multiple configured environments. - ›TUI keymap config now accepts
minusas a key binding value. - ›Adds ambient terminal pets to the TUI.
- ›Exec-server now uses protobuf relay frames for transport.
- ›Adds
- rust-v0.130.0
Codex CLI gains
codex remote-control, AWS Bedrock console-login auth, thread pagination, and plugin sharing controls.└──▷ GET THIS VERSION$ git clone --branch rust-v0.130.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.130.0
└──▷ TRY ITStart a headless Codex app-server that can be driven remotely — useful for CI pipelines or remote automation.$ codex remote-control- ›Adds
codex remote-controlas a top-level command for starting a headless, remotely controllable app-server. - ›Bedrock auth now supports AWS console-login credentials from
aws loginprofiles, enabling SSO-based access. - ›App-server clients can page large threads with unloaded, summary, or full turn item views via new thread pagination APIs.
- ›Plugin details now display bundled hooks, and plugin sharing exposes link metadata plus discoverability controls.
- ›Adds
- rust-v0.129.0
Codex CLI v0.129.0 adds Vim composer mode,
/hooksbrowser,/idecontext injection, workspace-aware/diff, and a/keymapdebug inspector.└──▷ GET THIS VERSION$ git clone --branch rust-v0.129.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.129.0
└──▷ TRY ITSwitch the TUI composer into Vim normal mode for keyboard-driven editing during a session.$ /vimInspect all registered lifecycle hooks and toggle them on or off without leaving the TUI.$ /hooksDiagnose unexpected key binding behaviour by viewing raw terminal key events as you press them.$ /keymap debug- ›Adds modal Vim editing in the TUI composer via
/vimcommand, configurable default mode, and Vim-specific keymap contexts. - ›Adds
/hooksbrowser for browsing and toggling lifecycle hooks, with support for pre/post-compaction hooks andPreToolUsecontext. - ›Adds
/idecontext injection so TUI workflows can pull in IDE-side context directly. - ›Adds workspace-aware
/diffcommand for comparing workspace state within TUI sessions. - ›Adds
/keymap debuginspector to inspect and diagnose terminal key events.
+10 moreshow less
- ›Adds PR summary and branch-change summaries to the status line, with theme-aware colors.
- ›Adds redesigned resume/fork picker with raw scrollback mode for easier workflow resumption and copying.
- ›Adds plugin marketplace upgrade flow (
/pluginsupgrade) and marketplace removal support. - ›Adds workspace plugin sharing, share access controls, source filtering, local share path tracking, and admin-disabled status handling for plugins.
- ›Adds remote plugin bundle sync and refresh on auth changes.
- ›Experimental goals now stay paused across thread resumes unless the user opts back in, with clearer validation and multi-day duration display.
- ›Enforces
animations = falsesetting for screen readers in the TUI. - ›Retires
/approvalsand renames/autoreviewto/approve. - ›Adds Codex Apps auth and eligible MCP elicitations surfaced through TUI/Guardian flows.
- ›Linux releases now bundle and verify a standalone
bwrapfallback for npm and DotSlash installs.
└──▷ BREAKING ON UPGRADE- !The
/autoreviewcommand is renamed to/approve; any scripts or muscle memory invoking/autoreviewwill no longer work.
- ›Adds modal Vim editing in the TUI composer via
- rust-v0.128.0
Codex CLI gains persisted
/goalworkflows, codex update, configurable keymaps, plugin marketplace, and richer MultiAgentV2 controls.└──▷ GET THIS VERSION$ git clone --branch rust-v0.128.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.128.0
└──▷ TRY ITKeep the CLI up to date without manually downloading a new binary.$ codex updateCheck or update the active status line without interrupting an in-progress agent turn.$ codex /statusline "Running recon phase…"- ›Adds persisted
/goalworkflows with app-server APIs, model tools, runtime continuation, and TUI controls for create, pause, resume, and clear. - ›Adds
codex updatecommand for in-place CLI self-update. - ›Adds configurable TUI keymaps, plan-mode nudges, and action-required terminal titles.
- ›Enables
/statuslineand/titleslash commands during active turns. - ›Expands permission profiles with built-in defaults, sandbox CLI profile selection, cwd controls, and active-profile metadata for clients.
+3 moreshow less
- ›Adds plugin marketplace installation, remote bundle caching, remote uninstall, plugin-bundled hooks, hook enablement state, and external-agent config import.
- ›Adds external agent session import, including background imports and imported-session title handling.
- ›Makes MultiAgentV2 configuration more explicit with thread caps, wait-time controls, root/subagent context hints, and v2-specific depth handling.
└──▷ BREAKING ON UPGRADE- !
--full-autois deprecated; users must migrate to explicit permission profiles and trust flows. - !GNU Linux binaries are no longer published as release artifacts.
- ›Adds persisted
- rust-v0.125.0
Codex CLI v0.125.0 adds Unix socket transport, remote plugin installs, reasoning-token reporting, and sticky environments for app-server workflows.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.125.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.125.0
└──▷ TRY ITCapture reasoning-token usage programmatically when running a non-interactive task in CI or scripted pipelines.$ codex exec --json 'Audit this codebase for hardcoded credentials' | jq '.usage.reasoning_tokens'
- ›Adds Unix socket transport for app-server integrations alongside existing transports.
- ›Adds
excludeTurnsparameter tothread/resumeandthread/forkendpoints for pagination-friendly session management. - ›Adds remote thread config/store plumbing and a remote thread config endpoint to app-server.
- ›Adds sticky environment API and thread state to app-server integrations.
- ›Enables remote plugin install writes and marketplace upgrade via a new
app-servermarketplace upgrade RPC.
+5 moreshow less
- ›Permission profiles now round-trip across TUI sessions, user turns, MCP sandbox state, shell escalation, and app-server APIs.
- ›Model providers now own model discovery; AWS/Bedrock account state is exposed to app clients via
account/read. - ›
codex exec --jsonnow surfaces reasoning-token usage in its JSON output. - ›Rollout tracing now records tool, code-mode, session, and multi-agent relationships, with a debug trace reduction command for inspection.
- ›App-server persists device key bindings in SQLite.
- rust-v0.124.0
Codex CLI v0.124.0 adds Amazon Bedrock support, stable hooks, quick TUI reasoning controls, and remote plugin marketplace access.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.124.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.124.0
└──▷ TRY ITTemporarily lower reasoning mid-session in the TUI when you want faster, cheaper responses without changing your config.$ # Inside the Codex TUI, press Alt+, to lower reasoning or Alt+. to raise itConfigure a stable hook in config.toml to observe every apply_patch edit and run a linter automatically.[hooks] [[hooks.post_tool_use]] tool = "apply_patch" command = "ruff check --fix ."
- ›Adds Alt+, /
Alt+.keyboard shortcuts in the TUI to lower or raise reasoning level on the fly; model upgrades now reset reasoning to the new model's default. - ›Adds first-class Amazon Bedrock support for OpenAI-compatible providers, including AWS SigV4 signing and AWS credential-based authentication.
- ›Hooks are now stable: configurable inline in
config.tomlandrequirements.toml, and can observe MCP tools,apply_patchedits, and long-running Bash sessions. - ›App-server sessions can now manage multiple environments and select an environment and working directory per turn, enabling precise multi-workspace and remote targeting.
- ›Remote plugin marketplaces can now be listed and read directly, with larger result pages and more reliable detail lookups.
+1 moreshow less
- ›Eligible ChatGPT plans now default to the Fast service tier unless explicitly opted out.
- ›Adds Alt+, /
- rust-v0.123.0
Codex CLI gains native Amazon Bedrock support, verbose MCP diagnostics, and flexible .mcp.json plugin loading.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.123.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.123.0
└──▷ TRY ITInspect full MCP server state — resources, templates, and diagnostics — during a session to debug a misbehaving MCP tool.$ /mcp verbose- ›Adds built-in
amazon-bedrockmodel provider with configurable AWS profile support. - ›Adds
/mcp verbosesubcommand for full MCP server diagnostics, resources, and resource templates without slowing down plain/mcp. - ›Supports both
mcpServersand top-level server maps in.mcp.jsonfor plugin MCP loading. - ›Improves realtime handoffs so background agents receive transcript deltas and can explicitly stay silent.
- ›Adds
remote_sandbox_configrequirements for host-specific remote environment configuration.
+1 moreshow less
- ›Refreshes bundled model metadata, including
gpt-5.4as the current default.
- ›Adds built-in
- rust-v0.122.0
Codex CLI v0.122.0 adds side conversations, Plan Mode context control, plugin tabbed browsing, and deny-read glob sandbox policies.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.122.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.122.0
└──▷ TRY ITAsk a quick question without leaving the current task — open a side conversation mid-session.$ /side What does this function return when input is nil?Check current context usage and default reasoning effort before continuing a plan.$ /status- ›New
/sidecommand in the TUI opens a side conversation for quick questions without interrupting the main session. - ›Queued input now accepts slash commands and
!shell prompts while work is already running. - ›Plan Mode can start implementation in a fresh context, with context-usage displayed before deciding whether to carry the planning thread forward.
- ›Plugin workflows gain tabbed browsing, inline enable/disable toggles, marketplace removal, and support for remote, cross-repo, or local marketplace sources.
- ›Filesystem permissions support new deny-read glob policies, managed deny-read requirements, and platform sandbox enforcement.
+12 moreshow less
- ›
codex execruns can now be isolated to ignore user config or rules. - ›Tool discovery (ToolSearch) and image generation are now enabled by default.
- ›Image handling adds higher-detail support and original-detail metadata for MCP and
js_replimage outputs. - ›Image resizing updated to fit within 2048-square bounds.
- ›New
codex appcommand correctly opens or installs the Desktop app on Windows and Intel Macs. - ›Standalone installs are now more self-contained.
- ›New
thread/turns/listAPI and sorting/backwards-cursor support added tothread/list. - ›Default reasoning effort is now shown in
/status. - ›Adds MCP server environment config support.
- ›Adds piped stdin support in the exec process API.
- ›Remote compaction now supported for Azure responses providers.
- ›Adds server-level approval defaults for custom MCP servers.
- ›New
- rust-v0.121.0
Codex CLI gains plugin marketplace install, Ctrl+R history search, memory controls, expanded MCP support, and secure devcontainer/bubblewrap sandboxing.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.121.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.121.0
└──▷ TRY ITInstall a plugin marketplace from a GitHub repo so Codex can discover and use plugins from that source.$ codex marketplace add https://github.com/<org>/<marketplace-repo>Install a marketplace from a local directory during offline development or internal distribution.$ codex marketplace add /path/to/local/marketplaceSearch your TUI prompt history interactively to re-run a previous command without retyping it.$ # Inside the Codex TUI composer, press Ctrl+R and type keywords to reverse-search prompt history.- ›Adds
codex marketplace addcommand to install plugin marketplaces from GitHub, git URLs, local directories, and directmarketplace.jsonURLs. - ›Adds Ctrl+R reverse search in the TUI composer for prompt history, plus local recall for accepted slash commands.
- ›Adds TUI and app-server controls for memory mode, memory reset/deletion, and memory-extension cleanup, including a dedicated endpoint to delete memories.
- ›Expands MCP/plugin support with MCP Apps tool calls, namespaced MCP tool registration,
supports_parallel_tool_callsopt-in flag, and sandbox-state metadata sent through MCP tool metadata. - ›Adds realtime and app-server APIs for output modality, transcript completion events, and raw turn item injection.
+7 moreshow less
- ›Adds symlink-aware filesystem metadata flag to
fsAPI. - ›Adds a secure devcontainer profile with bubblewrap sandboxing support.
- ›Adds Unix socket allowlists for the macOS sandbox.
- ›Adds context percentage indicator to the TUI status line.
- ›Adds WebSocket capability token-hash support in the app-server.
- ›Exposes instruction sources (AGENTS.md) via the app server.
- ›Adds a CLI update announcement notification.
- ›Adds
- rust-v0.120.0
Codex CLI v0.120.0 adds Realtime V2 background agent streaming, improved hook TUI, MCP outputSchema support, and richer SessionStart context.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.120.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.120.0
- ›Streams Realtime V2 background agent progress live while work is still running, and queues follow-up responses until the active response completes.
- ›Improves TUI hook activity display: live running hooks shown separately, completed hook output retained only when useful.
- ›Adds thread title as a variable available in custom TUI status line configurations.
- ›Includes MCP
outputSchemadetails in Code-mode tool declarations so structured tool results carry precise typing. - ›Enables SessionStart hooks to distinguish sessions created by
/clearfrom fresh startup or resume sessions.
- rust-v0.119.0
Codex CLI v0.119.0 adds voice v2 WebRTC,
codex exec-server, Ctrl+O copy,/resumeby ID, and richer MCP server support.└──▷ GET THIS VERSION$ git clone --branch rust-v0.119.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.119.0
- ›Realtime voice sessions now default to the v2 WebRTC path with configurable transport, voice selection, and native TUI media support.
- ›New experimental
codex exec-serversubcommand for remote/app-server workflows. - ›Remote app-server sessions now support egress WebSocket transport and remote
--cdforwarding. - ›Press Ctrl+O in the TUI to copy the latest agent response to the clipboard, with improved SSH and cross-platform clipboard behavior.
- ›
/resumecan now jump directly to a session by ID or name from the TUI session picker.
+5 moreshow less
- ›TUI notifications are more configurable, adding Warp OSC 9 support and an opt-in mode for notifications even while the terminal is focused.
- ›MCP Apps and custom MCP servers gain support for resource reads, tool-call metadata, custom-server tool search, server-driven elicitations, and file-parameter uploads.
- ›Runtime remote-control enablement and sandbox-aware filesystem APIs added for app-server workflows.
- ›Enables disabling prompt instruction blocks and environment context injection via config.
- ›Fuzzy file search is now case-insensitive in the TUI.
└──▷ BREAKING ON UPGRADE- !The
OPENAI_BASE_URLconfig fallback has been removed.
- rust-v0.118.0
Codex CLI gains Windows proxy-only egress enforcement, piped stdin for
codex exec, dynamic bearer tokens for custom model providers, and device-code ChatGPT login.└──▷ GET THIS VERSION$ git clone --branch rust-v0.118.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.118.0
└──▷ TRY ITPipe a file's contents into Codex while supplying a distinct prompt — useful for scripted code review or transformation tasks in CI.$ cat main.rs | codex exec "Refactor this to use idiomatic error handling"- ›Enforces proxy-only networking on Windows sandboxes with OS-level egress rules, replacing environment-variable-only controls.
- ›Adds ChatGPT device-code sign-in flow for app-server clients when browser-callback login is unavailable.
- ›Supports prompt-plus-stdin piping in
codex exec, letting you pipe input while passing a separate prompt on the command line. - ›Enables custom model providers to fetch and refresh short-lived bearer tokens dynamically instead of relying on static config or environment credentials.
- rust-v0.117.0
Codex CLI gains first-class plugin management, path-based multi-agent addressing, and richer app-server capabilities in v0.117.0.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.117.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.117.0
└──▷ TRY ITBrowse, install, or remove plugins from within an active Codex session.$ /pluginsLabel a terminal session with a custom title so parallel Codex sessions are easy to tell apart.$ /title- ›Adds first-class plugin workflow: Codex syncs product-scoped plugins at startup, lets you browse them via
/plugins, and install or remove them with auth/setup handling built in. - ›Introduces path-based sub-agent addressing (e.g.
/root/agent_a) with structured inter-agent messaging and agent listing for multi-agent v2 workflows. - ›Adds
/titleterminal-title picker to both the classic TUI and the app-server TUI, making parallel sessions easier to distinguish. - ›App-server clients can now send
!shell commands, watch filesystem changes, and connect to remote WebSocket servers with bearer-token authentication. - ›Enables prompt history recall in the app-server TUI, persisting across sessions.
+1 moreshow less
- ›
view_imagenow returns image URLs for code mode, generated images are reopenable from the TUI, and image-generation history survives session resume.
└──▷ BREAKING ON UPGRADE- !The legacy artifact tool has been removed, and the old
read_fileandgrep_fileshandlers have been retired — any workflow relying on these tool surfaces will break on upgrade. - !The app-server-backed TUI is now enabled by default, and plugin/app rollout flags have been flipped on in normal builds — setups that depended on the previous defaults may behave differently.
- ›Adds first-class plugin workflow: Codex syncs product-scoped plugins at startup, lets you browse them via
- rust-v0.116.0
Codex CLI gains ChatGPT device-code sign-in, a userpromptsubmit hook, smarter plugin management, and richer realtime sessions.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.116.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.116.0
└──▷ TRY ITIntercept every user prompt before it runs — useful for adding mandatory prefixes or blocking disallowed patterns in shared environments.$ # In your Codex hooks config, register the new hook: # hooks: # userpromptsubmit: # - <path-to-your-hook-script>- ›Adds device-code ChatGPT sign-in during onboarding and token refresh support in the app-server TUI.
- ›New
userpromptsubmithook lets users block or augment prompts before execution and before they enter history. - ›Plugin setup now prompts to install missing plugins/connectors, honors a configured suggestion allowlist, and syncs install/uninstall state remotely.
- ›Realtime sessions start with recent thread context and are less likely to self-interrupt during audio playback.
- rust-v0.115.0
Codex CLI gains full-resolution image inspection, realtime transcription, filesystem RPCs, Smart Approvals guardian routing, and a new Python app-server SDK.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.115.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.115.0
└──▷ USE ITOverride the OpenAI base URL (e.g., to point at a self-hosted or proxy endpoint) without changing the built-in provider.openai_base_url = "https://my-proxy.internal/v1"
- ›Adds full-resolution image inspection: models can now opt into
detail: "original"viaview_imageand codex.emitImage(..., detail: "original") for precision visual tasks. - ›Exposes
codex.cwdandcodex.homeDirinsidejs_repl, and persists codex.tool(...) / codex.emitImage(...) references across cells. - ›Adds a dedicated transcription mode for realtime WebSocket sessions, plus v2 handoff support via the
codextool, with a unified[realtime]session config block. - ›New v2 app-server filesystem RPCs cover file reads, writes, copies, directory operations, and path watching.
- ›New Python SDK for integrating with the v2 app-server filesystem API.
+4 moreshow less
- ›Smart Approvals can now route review requests through a guardian subagent in core, app-server, and TUI, reusing the same guardian session across follow-up approvals.
- ›App integrations now use the Responses API tool-search flow, can suggest missing tools (
tool_suggest), and fall back gracefully when the active model lacks search support. - ›Adds
openai_base_urlconfig override for the built-in provider. - ›The multi-agent wait tool is now consistently named
wait_agent, aligning withspawn_agentandsend_input.
└──▷ BREAKING ON UPGRADE- !The multi-agent wait tool is renamed to
wait_agent; any configuration or prompts referencing the old name will break.
- ›Adds full-resolution image inspection: models can now opt into
- rust-v0.114.0
Codex CLI gains experimental code mode, a hooks engine with SessionStart/Stop events, health endpoints, and skill-disabling config.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.114.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.114.0
└──▷ TRY ITCheck whether a running WebSocket app-server is healthy from a load balancer or monitoring script.$ curl -sf http://localhost:<port>/healthz && echo 'healthy'
- ›Adds experimental code mode for more isolated coding workflows.
- ›Adds experimental hooks engine with
SessionStartand Stop hook events. - ›Adds
GET /readyzandGET /healthzhealth-check endpoints to WebSocket app-server deployments. - ›Adds a config switch to disable bundled system skills entirely.
- ›Handoffs now carry realtime transcript context for improved continuity across turns.
+1 moreshow less
- ›Improves the
$mention picker with category labels (Skills, Apps, Plugins) and plugins surfaced first.
- rust-v0.113.0
Codex CLI gains runtime permission requests, a plugin marketplace, full web search config, and split sandbox policies.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.113.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.113.0
- ›Adds built-in
request_permissionstool so a running turn can request additional permissions at runtime, with new TUI rendering for those approval prompts. - ›Introduces a curated plugin marketplace with
plugin/listmetadata discovery, install-time auth checks, and aplugin/uninstallendpoint. - ›Upgrades app-server command execution with streaming stdin/stdout/stderr and TTY/PTY support; wires
execto the new in-process app-server path. - ›Expands web search tool configuration beyond on/off to support full options such as filters and location.
- ›Adds a new permission-profile config language and splits filesystem/network sandbox policies for more precise per-policy control.
+1 moreshow less
- ›Image generation now saves output files into the current working directory automatically.
- ›Adds built-in
- rust-v0.112.0
Codex CLI gains @plugin mentions in chat, a refreshed model picker, and safer per-turn sandbox privilege merging.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.112.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.112.0
- ›Adds
@pluginmentions so users can reference plugins directly in chat and auto-include their associated MCP/app/skill context. - ›Updates the model-selection surface so the latest model catalog changes are surfaced in the TUI picker flow.
- ›Merges executable permission profiles into per-turn sandbox policy for zsh-fork skill execution, enabling safer additive privilege handling for tool runs.
- ›Adds
- rust-v0.111.0
Codex CLI rust-v0.111.0 enables Fast mode by default, adds local ESM imports in js_repl, and exposes MCP elicitation as structured flows.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.111.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.111.0
└──▷ TRY ITImport a local workspace utility script inside a js_repl session to reuse shared helpers without copying code.$ const utils = await import('./scripts/utils.mjs'); utils.analyzeResults(data);- ›Enables Fast mode by default for all sessions; TUI session header now displays whether the session is running in Fast or Standard mode.
- ›Adds dynamic import of local
.jsand.mjsfiles injs_repl, allowing workspace scripts to be reused directly from the REPL. - ›Codex now reports enabled plugins (MCPs, apps, skills) to the model at session start, improving discovery of installed integrations.
- ›App-server v2 exposes MCP elicitation as a structured request/response flow instead of raw events, simplifying client integrations.
- ›Expands image workflow support for clients with client-side handling of image-generation events and model metadata for image-capable web search.
- rust-v0.110.0
Codex CLI gains a plugin system, multi-agent TUI upgrades, a
/fasttoggle, workspace-scoped memories, and a Windows installer.└──▷ GET THIS VERSION$ git clone --branch rust-v0.110.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.110.0
└──▷ TRY ITSwitch to fast mode mid-session to reduce latency when iterating quickly on a task.$ /fastSpin up a multi-agent workflow in the TUI and approve sub-agent actions interactively.$ /agent- ›Adds a plugin system that loads skills, MCP entries, and app connectors from config or a local marketplace, with an install endpoint for enabling plugins from the app server.
- ›Expands TUI multi-agent flow with approval prompts,
/agent-basedenablement, ordinal nicknames, role-labeled handoff context, and clearer prompts. - ›Adds a persisted
/fasttoggle in the TUI plus app-server support forfastandflexservice tiers. - ›Improves memories with workspace-scoped writes, renamed memory settings, and guardrails against saving stale or polluted facts.
- ›Adds a direct Windows installer script to published release artifacts.
- rust-v0.107.0
Codex CLI gains thread forking for sub-agents, configurable memories, multimodal custom tools, and richer voice device controls.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.107.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.107.0
└──▷ TRY ITHard-wipe all saved memory state when you want a clean slate — useful after major project switches or corrupted memory accumulation.$ codex debug clear-memories- ›Adds thread forking into sub-agents, letting you branch work from the current conversation without losing context.
- ›Enables microphone and speaker device selection for realtime voice sessions, with persistent device preferences and improved transcription-aligned audio format.
- ›Supports multimodal output (including images and structured content) from custom tools, beyond plain text.
- ›Introduces configurable memories and a new
codex debug clear-memoriescommand to fully reset saved memory state. - ›Exposes richer model availability and plan-upgrade metadata in the app server, surfacing plan-gated models with tooltips in the TUI.
+1 moreshow less
- ›Adds an
ephemeralfield to the Thread object in the app-server API.
- rust-v0.106.0
Codex CLI gains a direct install script, js_repl promotion, user-input in Default mode, and smarter memory management.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.106.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.106.0
- ›Adds a direct install script for macOS and Linux, published as a GitHub release asset alongside the
codexandrgbinaries. - ›Promotes
js_replto/experimentalwith startup compatibility checks, user-visible warnings for incompatible Node versions, and a lowered minimum Node requirement of22.22.0. - ›Enables
request_user_inputin Default collaboration mode, not only in Plan mode. - ›Makes the
5.3-codexmodel visible in the CLI model list for API users. - ›Introduces diff-based memory forgetting and usage-aware memory selection for improved long-session memory behavior.
+3 moreshow less
- ›Expands the app-server v2 thread API with experimental thread-scoped realtime endpoints/notifications and a
thread/unsubscribeflow to unload live threads without archiving them. - ›Adds structured OTEL audit logging for embedded
codex-network-proxypolicy decisions and blocks. - ›Reduces sub-agent startup overhead by skipping expensive history metadata scans during subagent spawns.
- ›Adds a direct install script for macOS and Linux, published as a GitHub release asset alongside the
- rust-v0.105.0
Codex CLI v0.105.0 adds syntax-highlighted diffs, voice dictation, multi-agent fan-out from CSV, new TUI commands, and granular approval controls.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.105.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.105.0
└──▷ USE ITEnable voice dictation so you can hold spacebar to record and transcribe prompts instead of typing.# In your Codex config file (e.g. ~/.codex/config.toml) [features] voice_transcription = true
- ›Adds syntax highlighting for fenced code blocks and diffs in the TUI, plus a
/themepicker with live preview and theme-aware diff colors for light and dark terminals. - ›Enables voice dictation in the TUI: hold spacebar to record and transcribe a prompt directly (enable with
features.voice_transcription = truein config). - ›New
spawn_agents_on_csvcapability fans out multi-agent work from a CSV file with built-in progress and ETA tracking. - ›Sub-agents now support nicknames, a cleaner picker UI, and visible child-thread approval prompts for easier multi-agent tracking.
- ›New
/copyTUI command copies the latest complete assistant reply to the clipboard.
+15 moreshow less
- ›New
/clearcommand and Ctrl-L shortcut clear the screen without losing thread context;/clearcan also start a fresh chat. - ›Codex can now request extra sandbox permissions for a command mid-session, and specific approval prompt types can be auto-rejected without disabling approvals entirely.
- ›App-server
thread/listnow supports searching threads by title. - ›Thread status is now exposed in
thread/readandthread/listresponses and in notifications. - ›App-server
thread/resumereturns the latest turn inline, reducing data loss on reconnects. - ›Adds configurable MCP OAuth callback URL for MCP server login.
- ›Adds
allow_login_shellconfig option. - ›Implements proxy-only egress for the Linux sandbox via a TCP-UDS-TCP bridge.
- ›Node module resolution paths can now be specified for
js_repl. - ›Adds configurable agent spawn depth.
- ›Adds configurable
write_stdintimeout. - ›Adds network proxy config wiring via
permissions.networkproxy config. - ›Adds JSON tracing logs for the app-server.
- ›Adds ability to attach extra files to feedback submissions.
- ›Profile-level
model_catalog_jsonoverride is now supported.
- ›Adds syntax highlighting for fenced code blocks and diffs in the TUI, plus a
- rust-v0.104.0
Codex CLI gains WebSocket proxy support, thread archive notifications, and distinct command approval IDs.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.104.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.104.0
└──▷ TRY ITRoute Codex CLI WebSocket traffic through a corporate proxy without modifying code or config files.$ WS_PROXY=ws://proxy.corp.example.com:3128 codex- ›Supports
WS_PROXY/WSS_PROXYenvironment variables (and lowercase variants) for proxying WebSocket connections through the network proxy. - ›App-server v2 now emits notifications when threads are archived or unarchived, so clients can react to state changes without polling.
- ›Core and protocol layers now carry distinct approval IDs per command approval, enabling multiple approvals within a single shell command execution flow.
- ›Supports
- rust-v0.103.0
Codex CLI gains richer app metadata in listings and a configurable prepare-commit-msg hook for co-author attribution.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.103.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.103.0
- ›App listing responses now include
app_metadata, branding, and labels, enabling richer app cards without extra requests. - ›Commit co-author attribution now uses a Codex-managed
prepare-commit-msghook, withcommand_attributionconfig support to set a default label, a custom label, or disable attribution entirely.
- ›App listing responses now include
- rust-v0.102.0
Codex CLI gains unified permissions flow, structured network approvals, multi-agent roles, and model reroute notifications.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.102.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.102.0
- ›Adds a unified permissions flow with clearer permissions history in the TUI and a new slash command to grant sandbox read access to blocked directories.
- ›Introduces structured network approval handling with richer host/protocol context shown directly in approval prompts.
- ›Adds customizable multi-agent roles configurable via the main config file.
- ›Adds a
model/reroutednotification so clients can detect and render model reroute events explicitly.
- rust-v0.100.0
Codex CLI gains a JS REPL runtime, memory slash commands, configurable sandbox read access, and multi-rate-limit support.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.100.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.100.0
└──▷ TRY ITDrop a persisted memory entry by name during a session to keep the agent's memory clean.$ /m_dropUpdate a persisted memory entry interactively from the TUI without leaving the session.$ /m_update- ›Adds experimental
js_replruntime that persists JavaScript state across tool calls, with optional runtime path overrides. - ›Adds
/m_updateand/m_dropTUI slash commands for in-session memory management. - ›Introduces
ReadOnlyAccesspolicy shape for configurable sandbox read access on Linux and Windows. - ›Supports multiple simultaneous rate limits across the protocol, backend client, and TUI status surfaces.
- ›Reintroduces app-server WebSocket transport with split inbound/outbound architecture and connection-aware thread resume subscriptions.
+2 moreshow less
- ›Enables Apps SDK apps in ChatGPT connector handling.
- ›Promotes Linux bubblewrap sandbox and Windows Sandbox to Experimental capability level.
└──▷ BREAKING ON UPGRADE- !The
disable_websocketsconfig key is renamed towebsockets_disabled. - !
CODEX_BWRAP_ENABLE_FFIenvironment variable is removed; vendored bubblewrap is now always compiled on Linux.
- ›Adds experimental
- rust-v0.99.0
Codex CLI v0.99.0 adds concurrent shell execution, new TUI controls, app-server steering APIs, and GIF/WebP image support.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.99.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.99.0
└──▷ TRY ITCustomize which metadata fields appear in the TUI status line without leaving the interface.$ /statuslineRestrict agents to specific web search modes and enforce network constraints for enterprise deployments.# requirements.toml [requirements] allowed_web_search_modes = ["safe"] [network] # network constraints defined here
- ›Enables concurrent shell command execution alongside active agent turns without interruption.
- ›Adds
/statuslinecommand for interactively configuring which metadata appears in the TUI footer. - ›Adds sortable resume picker with toggle between creation time and last-updated time, with an in-picker mode indicator.
- ›New app-server APIs for steering active turns (
turn/steer), listing experimental features, resuming agents (resume_agent), and opting out of specific notifications. - ›Enterprise
requirements.tomlnow supports restricting allowed web search modes (allowed_web_search_modes) and defining network constraints.
+2 moreshow less
- ›Image attachments now accept GIF and WebP formats in addition to previously supported types.
- ›Adds shell environment and
rcfile snapshotting to bootstrap shell commands.
- rust-v0.98.0
Codex CLI v0.98.0 ships GPT-5.3-Codex support and promotes Steer mode to stable-on-by-default.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.98.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.98.0
- ›Adds GPT-5.3-Codex as a supported model.
- ›Steer mode is now stable and enabled by default: Enter sends immediately during running tasks while Tab explicitly queues follow-up input.
└──▷ BREAKING ON UPGRADE- !Steer mode is now enabled by default, changing keyboard behavior: Enter sends immediately during running tasks instead of queuing input, and Tab is now the explicit queue key — any workflow that relied on the previous Enter
-to-queuebehavior will behave differently without reconfiguration.
- rust-v0.97.0
Codex CLI v0.97.0 adds session-scoped tool auto-approval, live skill reloading,
/debug-config, and configurable log_dir.└──▷ GET THIS VERSION$ git clone --branch rust-v0.97.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.97.0
└──▷ TRY ITInspect the exact merged configuration Codex is running with — useful when debugging unexpected behavior from config files, env vars, or MDM settings.$ /debug-config- ›Adds session-scoped 'Allow and remember' approval for MCP/App tools, so repeated calls to the same tool are auto-approved without re-prompting during a session.
- ›Adds live skill update detection so changes to skill files are picked up without restarting the CLI.
- ›Supports mixed text and image content in dynamic tool outputs for app-server integrations.
- ›New
/debug-configslash command in the TUI lets you inspect the effective configuration at runtime. - ›Introduces initial memory plumbing (API client and local persistence) to support thread memory summaries.
+1 moreshow less
- ›Adds configurable
log_dirto redirect logs, overridable via-cflag.
- rust-v0.96.0
Codex CLI v0.96.0 adds thread compaction API, WebSocket rate-limit signaling, and unified exec on all non-Windows platforms.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.96.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.96.0
- ›Adds
thread/compactas an async trigger RPC in the v2 app-server API, letting clients start compaction immediately and track completion separately. - ›Adds a
codex.rate_limitsWebSocket event for rate-limit signaling, with WebSocket parity for ETag and reasoning metadata handling. - ›Enables
unified_execon all non-Windows platforms. - ›Constrained requirement values now include source provenance, enabling source-aware config debugging in UI flows such as
/debug-config.
- ›Adds
- rust-v0.95.0
Codex CLI adds macOS app launcher, personal skills, parallel shell tools, and
CODEX_THREAD_IDinjection.└──▷ GET THIS VERSION$ git clone --branch rust-v0.95.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.95.0
└──▷ TRY ITInvoke/planwith an inline prompt in the TUI instead of typing it separately after the command.$ /plan refactor the authentication module to use JWT tokensUseCODEX_THREAD_IDin a skill or script to branch logic based on which Codex session is active.$ echo "Running in Codex thread: $CODEX_THREAD_ID"- ›Adds
codex app <path>command on macOS to launch Codex Desktop from the CLI, auto-downloading the DMG if not present. - ›Supports personal skill loading from
~/.agents/skills(with~/.codex/skillscompatibility) and new app-server APIs/events to list and download public remote skills. - ›
/plannow accepts inline prompt arguments and pasted images directly in the TUI, with improved slash-command editing and highlighting. - ›Shell-related tools can now execute in parallel, improving multi-command throughput.
- ›Injects
CODEX_THREAD_IDinto the shell environment so scripts and skills can detect the active thread/session.
+1 moreshow less
- ›Adds vendored Bubblewrap with FFI wiring in the Linux sandbox as groundwork for upcoming runtime integration.
- ›Adds
- rust-v0.94.0
Codex CLI v0.94.0 enables plan mode by default, stabilizes personality config, and adds skills loading from
.agents/skills.└──▷ GET THIS VERSION$ git clone --branch rust-v0.94.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.94.0
└──▷ USE ITSet your preferred personality in the Codex config file to control agent tone across all sessions.# In your codex config (e.g., ~/.codex/config.toml) personality = "friendly"
- ›Plan mode is now enabled by default with updated interaction guidance in the plan prompt.
- ›Personality configuration is now stable: default is
friendly, configured via thepersonalityconfig key, with automatic forward migration of existing settings. - ›Supports loading skills from
.agents/skills, with explicit relative-path lookup instructions and nested-folder markers supported. - ›Console output now includes runtime metrics for easier diagnostics.
- rust-v0.93.0
Codex CLI gains SOCKS5 proxy support, streaming Plan mode TUI, SQLite log DB, connector browsing, and smart approvals by default.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.93.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.93.0
└──▷ USE ITConfigure TUI notification delivery method in your Codex config.tui: notifications_method: "system"
- ›Adds an optional SOCKS5 proxy listener with policy enforcement and config gating.
- ›Plan mode now streams proposed plans into a dedicated TUI view, with a feature-gated
/planslash command for quick mode switching. - ›New
/appsslash command lets users browse connectors in the TUI, plus$insertion for app prompts. - ›App-server supports external auth mode, accepting ChatGPT auth tokens from a host app and requesting refreshes when needed.
- ›Smart approvals are now enabled by default, with explicit approval prompts for MCP tool calls.
+5 moreshow less
- ›Introduces a SQLite-backed log database with thread-ID filtering, 90-day log retention, and heuristic coloring via an improved logs client.
- ›Adds
features enable/features disablesubcommands for toggling feature flags. - ›Adds
tui.notifications_methodconfig option. - ›Adds output display to the
/pscommand. - ›Live web search is now enabled for the
DangerFullAccesssandbox policy.
- rust-v0.92.0
Codex CLI v0.92.0 adds dynamic tool injection, thread unarchive RPC, MCP OAuth scopes config, multi-agent explorer role, and cached web_search by default.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.92.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.92.0
- ›Enables dynamic tool injection at API v2 thread startup, routing tool calls and responses end-to-end through the server and core tool pipeline.
- ›Adds
thread/unarchiveRPC to restore archived rollouts back into active sessions. - ›Supports defining OAuth scopes for MCP servers directly in
config.toml, eliminating the need to pass--scopeson every login. - ›Expands multi-agent collaboration with an explorer role, improved collab event mapping, and max-depth guardrails to cap agent recursion.
- ›Adds thread list filtering in the app server to simplify browsing large thread sets.
+1 moreshow less
- ›Makes cached
web_searchthe default client-side behavior.
- rust-v0.90.0
Codex CLI gains a network sandbox proxy, connectors/MCP support, and a beta collaboration mode with ephemeral threads.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.90.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.90.0
- ›Adds a network sandbox proxy with policy enforcement to control outbound network access.
- ›Introduces connectors support (phase 1) via an app server and MCP integration, with new config surface.
- ›Ships collaboration mode as beta in the TUI, featuring a clearer plan → execute handoff and simplified Coding vs Plan mode selection.
- ›Supports ephemeral threads and improved provenance metadata for spawned collaboration threads.
- ›Adds proxy configuration support for WebSocket connections.
+1 moreshow less
- ›Enforces stricter limits on the number of concurrent multi-agents.
- rust-v0.89.0
Codex CLI gains
/permissionscommand, per-skill toggle UI, smarter slash-command matching, and expanded app-server APIs.└──▷ GET THIS VERSION$ git clone --branch rust-v0.89.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.89.0
└──▷ TRY ITQuickly review and adjust sandbox permissions mid-session without typing the full/approvalscommand.$ /permissionsEnable or disable a specific skill interactively during a session to control which capabilities Codex may invoke.$ /skill- ›Adds
/permissionscommand as a shorter alias for the approval workflow (original/approvalskept for compatibility). - ›Adds
/skillUI to enable or disable individual skills from within the TUI. - ›Improves slash-command selection by prioritizing exact and prefix matches over fuzzy matches.
- ›App server supports new
thread/readAPI and filtering of archived threads inthread/list. - ›App server clients support layered
config.tomlresolution;config/readcan compute the effective config from a given working directory.
+1 moreshow less
- ›Release artifacts now include a stable URL for the published config schema.
- ›Adds
- rust-v0.88.0
Codex CLI gains device-code auth, collaboration modes,
/forksessions, codex cloud list, and WebSocket proxy support.└──▷ GET THIS VERSION$ git clone --branch rust-v0.88.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.88.0
└──▷ TRY ITList available Codex cloud resources directly from the terminal.$ codex cloud listUse the renamed model instructions file key in your config to supply a custom system prompt.model_instructions_file = "/path/to/instructions.md"
- ›Adds device-code auth as a standalone fallback for headless environments where browser-based login is unavailable.
- ›Introduces collaboration modes (with presets and per-turn overrides) for multi-agent coordination.
- ›New
codex cloud listsubcommand to list cloud resources from the CLI. - ›New
/forkslash command to fork the current session instead of opening the session picker. - ›Shows forked-from session ID in
/statusoutput.
+14 moreshow less
- ›Supports enabling/disabling individual skills via config or API.
- ›Adds
model_personalityconfig option to customize model behavior. - ›Renames
experimental_instructions_filetomodel_instructions_filein config. - ›Adds
/experimentalmenu in TUI2 for accessing experimental features. - ›Supports proxy configuration for WebSocket connections.
- ›Auto-enables WebSocket transport when conditions are met.
- ›New
max_threadsconfig option to cap concurrent thread count. - ›Returns threads sorted by
created_atorupdated_atvia the app-server API. - ›Adds a request-user-input tool and overlay for interactive prompts during task execution.
- ›Introduces forward navigation in backtrack preview within the TUI.
- ›Closes all threads when
/newis invoked. - ›Detaches non-TTY child processes for cleaner headless operation.
- ›Displays raw shell command on user shell interactions.
- ›Preserves slash command order in search results.
└──▷ BREAKING ON UPGRADE- !The
experimental_instructions_fileconfig key is renamed tomodel_instructions_file; existing configs using the old key will need to be updated.
- rust-v0.87.0
Codex CLI v0.87.0 adds multi-ID collaboration waits, user-snapshot shell execution, and TUI approval surfacing for spawned threads.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.87.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.87.0
- ›Enables collaboration wait calls to block on multiple IDs in a single request, simplifying multi-thread coordination.
- ›Runs user shell commands under the user snapshot so aliases and shell config are honored.
- ›Surfaces approval requests from spawned/unsubscribed threads directly in the TUI.
- ›Adds user message metadata (text elements and byte ranges) round-tripping through protocol, app-server, and core so UI annotations survive history rebuilds.
- rust-v0.86.0
Codex CLI adds SKILL.toml metadata support and explicit web search disable control.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.86.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.86.0
└──▷ TRY ITDefine skill metadata for your project so it appears correctly in the Codex TUI and app server.$ # Place SKILL.toml at your project root: cat SKILL.toml # name = "My Skill" # description = "Does X and Y" # icon = "🔍" # brand_color = "#FF6600" # default_prompt = "Start by summarizing the repo."- ›Adds
SKILL.tomlsupport for defining skill metadata (names, descriptions, icons, brand color, default prompt) surfaced in the app server and TUI. - ›Enables clients to explicitly disable web search and signal eligibility via a header to align with server-side rollout controls.
- ›Adds
- rust-v0.85.0
Codex CLI v0.85.0 adds real-time agent collaboration events, agent role presets, and interrupt-capable send_input.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.85.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.85.0
- ›App-server v2 now emits collaboration tool calls as item events in the turn stream, enabling clients to render agent coordination in real time.
- ›New
spawn_agentparameter accepts an agent role preset for richer agent control in collaboration tools. - ›New
send_inputinterrupt capability lets callers optionally interrupt a running agent before delivering a message. - ›
/modelsmetadata now includesmigration_markdownso clients can display richer upgrade guidance when suggesting model migrations.
- rust-v0.84.0
Codex CLI Rust v0.84.0 adds metadata on text elements for richer client rendering and schema evolution.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.84.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.84.0
- ›Adds additional metadata fields to text elements in the Rust protocol/types, enabling richer client rendering and future schema evolution.
- rust-v0.81.0
Codex CLI gains gpt-5.2-codex default, headless device-code login, Linux read-only mounts, and MCP threadId support.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.81.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.81.0
└──▷ TRY ITKeep TUI output in the main scroll buffer (not alternate screen) so Zellij scrollback works correctly.$ codex --no-alt-screen "refactor the auth module"
- ›Switches default API model to gpt-5.2-codex.
- ›Adds
threadIdtocodex mcp-serverresponses, enabling chained use with thecodex-replytool. - ›Enables automatic device-code login flow when a headless (no-browser) environment is detected.
- ›Supports read-only bind mounts in the Linux sandbox to prevent writes to sensitive paths.
- ›Renders partial (in-flight) tool calls in the TUI transcript overlay.
+2 moreshow less
- ›Adds
tui.alternate_screenconfig key and--no-alt-screenCLI flag to control alternate-screen behaviour (e.g., for Zellij scrollback). - ›Publishes a generated JSON Schema for
config.tomlindocs/to enable config validation.
- rust-v0.80.0
Codex CLI gains session forking, sandbox elevation, skill invocations via v2 API, requirements exposure, and metrics observability.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.80.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.80.0
└──▷ TRY ITElevate sandbox permissions interactively when your agent needs capabilities beyond the default sandbox mode.$ /elevate-sandbox- ›Adds conversation/thread fork endpoints so clients can branch a session into a new thread.
- ›Introduces the
/elevate-sandboxcommand with onboarding prompts for upgrade/degraded sandbox mode. - ›Exposes
requirement/listendpoint so clients can readrequirements.tomland adapt agent-mode UX. - ›Supports explicit skill invocations through the v2 API
UserInput::Skill. - ›Introduces metrics capabilities with additional counters for observability.
- rust-v0.79.0
Codex CLI gains multi-conversation agent control, thread rollback, cached web search, and an analytics config toggle.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.79.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.79.0
└──▷ USE ITOpt out of analytics collection by adding the analytics section to your Codex config file.[analytics] enabled = false
- ›Adds multi-conversation 'agent control' so a session can programmatically spawn or message other conversations.
- ›Adds
thread/rollbackapp-server API so IDE clients can undo the last N turns without rewriting history. - ›Adds
web_search_cachedflag to return cached-only Web Search results as a safer alternative to live requests. - ›Allows global exec flags (model, json, sandbox toggles, etc.) to be passed after
codex exec resume. - ›Shows time/version-targeted announcement tips in the TUI, driven by a TOML file in the repo.
+1 moreshow less
- ›Adds
[analytics] enabled=...config section to control analytics collection behavior.
- rust-v0.78.0
Codex CLI gains external-editor prompt editing, project-aware config layering, MDM support, and richer exec policy justifications.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.78.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.78.0
└──▷ TRY ITEdit a long or complex prompt in your preferred editor mid-session instead of typing it inline in the TUI.$ # While in the Codex TUI, press Ctrl+G to open the current prompt in $VISUAL or $EDITOR, edit, save, and quit — edits are synced back automatically.- ›Adds Ctrl+G to open the current prompt in your configured external editor (
$VISUAL/$EDITOR) and sync edits back into the TUI. - ›Supports project-aware config layering: loads repo-local
.codex/config.toml, honors configurableproject_root_markers, and merges with system config like/etc/codex/config.toml. - ›Supports enterprise-managed configuration requirements on macOS via an MDM-provided TOML payload.
- ›Exec policy rules can now include human-readable justifications via a
justificationarg to prefix_rule() in*.rulesfiles, with policy loading following the unified config-layer stack. - ›Improves
tui2transcript navigation with multi-click selection, a copy shortcut/affordance, and a draggable auto-hiding scrollbar.
+1 moreshow less
- ›Starts Windows PowerShell sessions in UTF-8 mode to reduce encoding-related prompt/output issues.
- ›Adds Ctrl+G to open the current prompt in your configured external editor (
- rust-v0.77.0
Codex CLI v0.77.0 adds sandbox mode constraints, normalized TUI scrolling with config knobs, and flag-free MCP OAuth login.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.77.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.77.0
└──▷ USE ITLock a repo to only allow network-disabled sandbox modes, preventing contributors from accidentally running Codex with broader access.# In your project's requirements.toml allowed_sandbox_modes = ["workspace-write"]
- ›Adds
allowed_sandbox_modesfield torequirements.tomlto restrict which sandbox modes a project permits. - ›Adds
tui.scroll_*config settings and normalizes mouse wheel and trackpad scrolling behavior across terminals in TUI2. - ›MCP OAuth login for streamable HTTP servers no longer requires the
rmcp_clientfeature flag — works out of the box. - ›Improves fuzzy file search display consistency by centralizing file-name derivation in
codex-file-search. - ›Updates bundled model metadata (
models.json) with latest available models.
- ›Adds
- rust-v0.76.0
Codex CLI gains
/pscommand, ExternalSandbox policy, model list UI, admin-scoped skills, and system-wide UNIX config support.└──▷ GET THIS VERSION$ git clone --branch rust-v0.76.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.76.0
└──▷ TRY ITInspect processes currently running inside a Codex session — useful when debugging long-running agent tasks.$ /ps- ›Adds
/pscommand to list running processes from within the TUI. - ›Introduces
ExternalSandboxpolicy for delegating sandbox enforcement to an external process. - ›Supports system-wide
/etc/codex/requirements.tomlon UNIX for admin-managed dependency configuration. - ›Adds a model list UI for browsing and selecting available models interactively.
- ›Enables skills by default (previously opt-in), with support for admin-scoped skills.
+4 moreshow less
- ›Supports
shortDescriptionfield for skills entries, surfaced in the skills popup. - ›Adds macOS DMG build target for easier distribution and installation.
- ›Improves terminal detection metadata to enable per-terminal scroll tuning.
- ›Updates bundled system skills included with the CLI.
└──▷ BREAKING ON UPGRADE- !The
excludesetting now defaults totruein the app server, changing behavior for existing app-server deployments that relied on the previous default.
- ›Adds
- rust-v0.74.0
Codex CLI gains gpt-5.2-codex model, a new
/experimentalslash command, model picker UI, and configurable ghost-snapshot warnings.└──▷ GET THIS VERSION$ git clone --branch rust-v0.74.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.74.0
└──▷ TRY ITAccess experimental features mid-session without restarting the CLI.$ /experimental- ›New
/experimentalslash command for accessing experimental features from within the CLI. - ›New model picker UI for selecting models interactively.
- ›Adds config option to disable ghost snapshot warnings.
- ›Supports SYSTEM-level skills, expanding the skills system beyond user-defined entries.
- ›Adds public skills discovery with improved repo skill discovery and error UX.
+4 moreshow less
- ›TypeScript SDK gains
xhighreasoning effort support. - ›Model list loading is now non-blocking, improving startup responsiveness.
- ›Constrains allowed values for
approval_policyconfig field. - ›Sandboxes the
.codexsub-folder as read-only when it resides inside a writable root.
- ›New
- rust-v0.73.0
Codex CLI v0.73.0 adds OpenTelemetry tracing, ghost snapshot v2, ghost commit config support, and a reimplemented SkillsManager.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.73.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.73.0
- ›Adds ghost snapshot v2 for improved session capture.
- ›Supports ghost commits via config for session replay workflows.
- ›Reimplements skills loading via SkillsManager and
skills/listfor consistent discovery. - ›Adds OpenTelemetry tracing support for observability into Codex operations.
- rust-v0.72.0
Codex CLI v0.72.0 adds remote compaction for API-key sessions, expanded sandbox safety, and 1Password support.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.72.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.72.0
- ›Enables remote compacting (context compaction via API) for API-key-based sessions, not just OAuth users.
- ›Adds 1Password integration support.
- ›Introduces Elevated Sandbox levels 3 and 4, tightening sandboxing for shell command execution.
- ›Expands the safe-command allowlist, reducing unnecessary sandbox prompts for common operations.
- ›Adds reliable utilities for locating
pwsh.exeandpowershell.exeon Windows, and uses PowerShell to parse PowerShell syntax.
+2 moreshow less
- ›Signs two additional Windows executables for improved trust on Windows hosts.
- ›New config API with a cleaner config loading flow.
- rust-v0.71.0
Codex CLI rust-v0.71.0 adds gpt-5.2 support, shell snapshots, long-snapshot warnings, and an elevated Sandbox 2.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.71.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.71.0
- ›Adds gpt-5.2 as a selectable model, OpenAI's latest frontier model with improvements across knowledge, reasoning, and coding.
- ›Shows the default model in the model picker so practitioners can see at a glance what will be used.
- ›Adds shell snapshots for shell commands, capturing environment state for reproducibility.
- ›Adds warnings when snapshots grow too long, surfacing potential performance or context issues early.
- ›Introduces Elevated Sandbox 2, an upgraded sandboxing environment.
- rust-v0.69.0
Codex CLI gains Skills injection, MCP in-session login, vim TUI navigation, shell snapshotting, and an experimental tui2 frontend.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.69.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.69.0
- ›Adds Skills support: explicitly selecting a skill now injects its SKILL.md content into the turn; skills load once per session and warn on unreadable files.
- ›Adds MCP in-session login so users can authenticate to Model Context Protocol servers without leaving the CLI session.
- ›Adds vim-style navigation keys (hjkl/arrow equivalents) for both option selection menus and the transcript pager.
- ›Adds shell snapshotting in the exec/sandbox layer for safer and more reliable command execution.
- ›Introduces an experimental tui2 frontend, available behind a feature flag.
+6 moreshow less
- ›Elevates Linux sandbox allowances to permit sendmsg/recvmsg syscalls, unblocking more networked workloads.
- ›Adds support for using a remote branch when performing reviews if the local branch trails, enabling review of unsynced work.
- ›Rate-limit warnings now display as percentage of quota remaining for clearer visibility.
- ›Config writes now preserve comments and key order; model field is optional to match real-world config files.
- ›TUI log files now strip ANSI escape codes for cleaner plaintext logs.
- ›Adds
codex-maxprompt and tools support for experimental models.
- rust-v0.66.0
Codex CLI gains execpolicy TUI whitelisting,
--branchfor cloud exec, sigstore signing, and cloud status/diff/apply flows.└──▷ GET THIS VERSION$ git clone --branch rust-v0.66.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.66.0
- ›Adds TUI ability to whitelist command prefixes after an approval, so repeated similar commands skip future prompts.
- ›Sandbox denials now propose an execpolicy amendment in the TUI that you can accept inline.
- ›Shell MCP server now runs execpolicy, so MCP tools follow the same approval rules as direct commands.
- ›Execpolicy fallback checks now inspect each pipeline segment, catching unsafe tails like
| rm -rfthat were previously missed. - ›Adds
--branchflag tocodex cloud execfor targeting a specific branch on remote runs.
+4 moreshow less
- ›Adds
status,diff, andapplysubflows to the cloud exec path so you can inspect and apply cloud-run changes locally. - ›Linux release artifacts are now signed via sigstore for supply-chain verification.
- ›Adds is-mutating detection for the shell command handler to better classify dangerous shell operations.
- ›Skills are also loaded from the repository root in addition to existing search paths.
└──▷ BREAKING ON UPGRADE- !
experimental_use_rmcp_clientis removed from the config (the flag no longer exists).
- rust-v0.65.0
Codex CLI adds
/resumeand/skillscommands, history trimming, pycache exclusion, and Ctrl-P/N TUI navigation in v0.65.0└──▷ GET THIS VERSION$ git clone --branch rust-v0.65.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.65.0
└──▷ TRY ITResume a previous Codex session interactively without restarting from scratch.$ /resumeBrowse and activate skills defined in your skills.md during a session.$ /skillsCap local history file size to prevent unbounded growth across long-running projects.# In your Codex config file: history: max_bytes: 10485760
- ›Adds
/resumeslash command for snappier session resumption from the TUI. - ›Adds
/skillsslash command (also via$) for listing and selecting skills defined in skills.md. - ›Promotes Codex Max as the new default model.
- ›Trims
history.jsonlautomatically whenhistory.max_bytesis set, capping local history size. - ›Ignores common junk directories — including
__pycache__— by default to reduce context noise.
+10 moreshow less
- ›Adds Ctrl-P / Ctrl-N keyboard shortcuts for arrow navigation inside the TUI textarea.
- ›Renders tips and tooltips via Markdown with a bold 'Tip' label for richer in-app guidance.
- ›Adds model warning when
apply_patchis used with an incompatible model. - ›Supports listing MCP servers from the app-server API.
- ›Adds
--versionflag for the@openai/codex-shell-tool-mcppackage. - ›Adds one-off commands support to app-server v2.
- ›Introduces alias compaction for more efficient context management.
- ›Adds experimental support for
skills.mdskill definitions. - ›Displays tokens used when the context window size is unknown.
- ›Restores clipboard image paste support on native Windows in the TUI.
- ›Adds
- rust-v0.64.0
Codex CLI v0.64.0 adds detached review mode, MCP elicitations, per-run custom env injection, compaction events, and ImageView inline rendering.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.64.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.64.0
└──▷ TRY ITInstall the shell-tool MCP server from npm and log in so Codex can authenticate on your behalf.$ npx @openai/codex-shell-tool-mcp login- ›Adds experimental
expmodel selection for tool experimentation. - ›Adds unified exec basic pruning strategy to limit session bloat.
- ›Adds per-run custom environment injection for unified exec processes.
- ›Adds policy-approved command bypass so approved commands skip sandbox checks.
- ›Adds detached review mode with explicit enter/exit events and review thread IDs.
+18 moreshow less
- ›Adds MCP elicitations support for interactive model-initiated prompts.
- ›Adds shell-tool MCP login support and explicit server capability declaration.
- ›Publishes
@openai/codex-shell-tool-mcpto npm for public installation. - ›Adds compaction events emitted on threads and turns for observability.
- ›Adds token-usage and plan-update notifications on thread/turn events.
- ›Adds
item/fileChange/outputDeltaoutput deltas on file-change items. - ›Adds
ImageViewitem type that renders images inline in the app-server. - ›Exposes process IDs on command items for event handling.
- ›Adds thread and turn IDs propagated on every item and error notification.
- ›Exposes git info, current working directory, CLI version, and source metadata on threads.
- ›Adds
send-followup-v2to the app-server test client. - ›Adds config management utilities to the app-server.
- ›Enables history lookup on Windows and WSL.
- ›Enables enterprises to skip upgrade checks and messages.
- ›Windows sandbox flags risky browser or URL launches as dangerous before execution.
- ›Consolidates world-writable-directory scanning for improved safety defaults.
- ›Upgrades rmcp client to 0.10.0, enabling custom client notifications.
- ›Adds
cargo-auditandcargo-denyfor supply-chain security in CI.
- ›Adds experimental
- rust-v0.63.0
Codex CLI adds a Declined status for command execution approvals in the app server.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.63.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.63.0
- ›Adds a Declined status for command execution, allowing the app server to explicitly signal when a command has been rejected.
- rust-v0.59.0
Codex CLI gains GPT-5.1-Codex-Max, native Windows Agent mode, compaction support, and expanded 10K tool output tokens.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.59.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.59.0
└──▷ USE ITCap tool output size to avoid runaway token usage when working with verbose commands in long sessions.# In ~/.codex/config.toml tool_output_token_limit = 10000
Enable Windows Agent mode with the experimental sandbox when running Codex on a native Windows machine.📍# When prompted during onboarding, or select 'auto' mode — Codex will prompt to enable the Windows sandbox automatically.- ›Adds GPT-5.1-Codex-Max model for higher reliability and long-running, project-scale agentic coding workflows.
- ›Introduces native Windows Agent mode with an experimental sandbox that limits filesystem and network access, allowing Codex to read/write files and run commands with fewer approvals.
- ›Adds first-class Native Compaction support to improve performance across extended coding sessions, enabled by default.
- ›Expands tool output token limits to 10,000 tokens, configurable via
tool_output_token_limitinconfig.toml. - ›Adds LM Studio OSS model support.
+9 moreshow less
- ›Adds mTLS configuration support for OpenTelemetry via the
[otel]config section. - ›Enables parallel tool calls for faster multi-step agent execution.
- ›Adds git branch tooling so the model can query and work with branches programmatically.
- ›Adds
--add-dirflag to exec and the TypeScript SDK for specifying additional working directories. - ›Credits are now visible via the
/statuscommand. - ›Codex Resume now displays branches and filters sessions by current working directory.
- ›Adds placeholder icons for images that cannot be decoded to prevent API errors.
- ›Adds non-blocking MCP server startup so the TUI is responsive while MCP tools initialize.
- ›TUI notifications are now enabled by default.
- rust-v0.58.0
Codex CLI gains GPT-5.1 support, a new shell_command tool, seatbelt log-denials debugger, and app-server JSON schema generation.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.58.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.58.0
└──▷ TRY ITDiagnose why the seatbelt sandbox is blocking a command by capturing denial events in real time.$ codex debug seatbelt --log-denials
- ›Adds support for the gpt-5.1 model family, including model picker integration and NUX onboarding.
- ›New
shell_commandtool for executing shell commands from within the agent. - ›New
codex debug seatbelt --log-denialscommand for diagnosing sandbox permission denials. - ›App-server gains a new command to generate JSON schema for protocol definitions.
- ›App-server adds
item started/completedevents for turn items, enabling finer-grained lifecycle tracking.
+11 moreshow less
- ›App-server
thread/resumeendpoint now supportshistory,path, andoverridesparameters. - ›Adds
workdirfield tounified_execfor controlling working directory of executed commands. - ›Adds opt-out for rate-limit model nudge, giving users control over model-switch suggestions.
- ›Unified exec gains escalation handling for more robust sandboxed execution.
- ›Enables
ghost_commitfeature by default, committing only after mutating tools complete. - ›TUI now displays keyboard shortcuts inline for approval options.
- ›Windows
.exeartifacts are now uploaded for CLI releases, enabling direct Windows binary downloads. - ›Auth-aware status output now uses authentication information from
AuthManager. - ›Rate-limit status bar is now surfaced in the UI.
- ›Warns when a model switch occurs on session resume.
- ›Proxy context is preserved across compaction events.
- rust-v0.57.0
Codex CLI gains Ctrl-N/P slash-command navigation, unified exec safe-command auto-approval, and new app-server endpoints.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.57.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.57.0
└──▷ HOW TO FIND ITNavigate slash-command suggestions or history without leaving the keyboard while typing a prompt.📍# Inside the Codex TUI, type '/' to open the slash-command list, then press Ctrl-N / Ctrl-P to move up and down through suggestions.- ›Adds Ctrl-N / Ctrl-P keyboard navigation for slash command lists, file pickers, and history in the TUI.
- ›Unified exec mode now allows safe commands to run without requiring user approval.
- ›Skips retries automatically when the API returns an
insufficient_quotaerror, avoiding unnecessary wait loops. - ›Removes the shell tool when unified exec is enabled, streamlining the tool surface.
- ›Promotes shell config tool to model family config level.
+6 moreshow less
- ›App-server implements the
account/readendpoint. - ›App-server exposes additional fields on the Thread object.
- ›Adds
network_accessandweb_searchoptions to the TypeScript SDK. - ›WSL: normalizes Windows paths during updates.
- ›Replaces raw Cloudflare 403 HTML responses with a friendly error message.
- ›Kills shell tool process groups on timeout, improving cleanup for long-running commands.
└──▷ BREAKING ON UPGRADE- !The shell tool is removed from the available tool set when unified exec is enabled (
--unified-exec).
- rust-v0.56.0
Codex CLI gains GPT-5-Codex-Mini, model nudges, single-reasoning-effort model support, and new v2 server APIs.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.56.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.56.0
- ›Introduces GPT-5-Codex-Mini, a compact and cost-efficient variant of GPT-5-Codex.
- ›Adds model nudge suggestions for queries to guide model selection.
- ›Supports models with a single reasoning effort level.
- ›Windows Sandbox now warns when an Everyone-writable directory is detected.
- ›Sandbox widened to allow certificate operations when network is enabled.
+4 moreshow less
- ›App-server exports v2 Thread, Turn, and account login (start/completed/cancel) APIs.
- ›Session metadata is now included in listConversations responses.
- ›Allows Codex to be run from PID 1.
- ›Loads custom prompts from symlinked Markdown files.
- rust-v0.54.0
Codex CLI v0.54.0 adds Azure OpenAI proxy support, an improved compactor, and elapsed-time display after aborts.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.54.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.54.0
- ›Adds options to
responses-api-proxyto support Azure OpenAI endpoints. - ›Introduces compactor v2 (
feat: compactor 2) for improved conversation compaction, with a warning displayed on compact. - ›Shows elapsed time in the TUI after aborting a request.
- ›Follows symlinks during file search.
- ›Parses Azure OpenAI rate-limit messages for clearer error reporting.
+5 moreshow less
- ›Logs sandbox commands to
$CODEX_HOMEinstead of the current working directory. - ›Includes reasoning tokens in the context window calculation.
- ›Adds sandbox command assessment changes based on experiment feedback.
- ›Refines TUI text-area word separator handling.
- ›Ensures the trust prompt is not skipped on Windows when sandbox is enabled.
- ›Adds options to
- rust-v0.53.0
Codex CLI gains a Windows Sandbox alpha,
/exitcommand alias, and absolute-time rate-limit errors.└──▷ GET THIS VERSION$ git clone --branch rust-v0.53.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.53.0
└──▷ TRY ITExit an interactive Codex session using the new alias instead of/quit.$ /exit- ›Adds Windows Sandbox alpha support for isolated execution on Windows.
- ›Adds
/exitas a slash-command alias for/quit. - ›Rate-limit errors now report an absolute timestamp instead of a relative delay.
- ›Removes last-turn reasoning filtering, exposing full reasoning output.
└──▷ BREAKING ON UPGRADE- !The
include_view_image_toolconfig key has been removed; any config referencing it will need to be updated.
- rust-v0.52.0
Codex CLI v0.52.0 adds shell passthrough with
!<cmd>, TUI undo, configurable compaction prompt, keyring auth, and MCP OAuth scopes.└──▷ GET THIS VERSION$ git clone --branch rust-v0.52.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.52.0
└──▷ TRY ITRun a quick shell command mid-session without leaving the Codex prompt — useful for checking git status or running a build before your next instruction.$ !git status- ›Adds
!<cmd>syntax to execute shell commands directly from the Codex prompt. - ›New TUI undo operation lets users roll back the last applied change.
- ›Queued messages are now visible in the TUI during active response streaming.
- ›Compaction prompt is now configurable by the user.
- ›New auth storage abstraction with OS keyring support and configurable backend.
+15 moreshow less
- ›Adds MCP OAuth scope specification support via
mcp add. - ›MCP tool call results that include images are now rendered to the model.
- ›Environment variable values are redacted in
/mcpandmcp getoutput. - ›New
GetConversationSummaryRPC enables fetching and resuming conversation summaries by ID. - ›Item streaming events added to the app-server protocol.
- ›Sandbox policy violations now surface a model summary and risk assessment.
- ›Adds
sandbox_modesupport in user profiles. - ›MIME type verification added for attached images.
- ›Windows TUI now displays auto-mode setup guidance.
- ›Conversations annotated with
model_providerfield to enable filtering. - ›Ability to purchase credits for additional usage surfaced in the CLI.
- ›MCP startup errors for timeouts and GitHub auth now provide clearer messaging.
- ›Local tokenizer used for accurate truncation of unified exec tool outputs.
- ›Stale or missing rate-limit data now produces explicit messaging in the TUI.
- ›Returns an error when an unknown feature flag is passed to enabled/disabled feature config.
- ›Adds
- rust-v0.50.0
Codex CLI v0.50.0 adds sandbox policy risk assessments, stale rate-limit messaging, and MCP env-var redaction.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.50.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.50.0
- ›Adds model summary and risk assessment output for commands that violate sandbox policy.
- ›Adds messaging when rate limits are stale or no rate limits are cached.
- ›Introduces
codex/event/raw_itemevents in the app-server event stream. - ›Improves
/feedbackcommand diagnostics for better issue reporting.
- rust-v0.48.0
Codex CLI gains
--add-dir, MCP tool filtering, OAuth scopes, enterprise login controls, and auto-compaction at 90% context.└──▷ GET THIS VERSION$ git clone --branch rust-v0.48.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.48.0
└──▷ TRY ITGive the agent write access to a second directory (e.g. a shared library) alongside your current project.$ codex --add-dir ../shared-lib 'Refactor the auth module to use the shared validation helpers'
Restrict an MCP server to only the tools your workflow needs, reducing attack surface.# In your Codex config (e.g. ~/.codex/config.toml): [mcp_servers.my_server] enabled_tools = ["read_file", "search_code"]
Lock a team deployment to a specific login method and ChatGPT workspace via managed config.# In managed config: forced_login_method = "chatgpt" forced_chatgpt_workspace_id = "ws-abc123"
- ›Adds
--add-dirflag to specify additional writable working directories beyond the default. - ›MCP stdio servers now use the official Rust MCP SDK (rmcp) as their client backend.
- ›MCP stdio servers can specify a
cwdto set their working directory. - ›MCP servers support
enabled_toolsanddisabled_toolsconfig options to selectively allow or block individual tools. - ›Streamable HTTP MCP servers can specify OAuth
scopesduringcodex mcp login.
+10 moreshow less
- ›Adds
forced_login_methodandforced_chatgpt_workspace_idconfiguration options for enterprise managed-config control. - ›Adds experimental
codex stdio-to-udssubcommand. - ›Adds
experimental_bearer_tokenoption to model provider definitions for custom auth. - ›Auto-compacts conversation context when it reaches ~90% of the model's limit.
- ›Plan tool is now enabled by default in exec mode.
- ›Local tokenizer used for accurate context truncation in unified exec.
- ›Text cleared with Ctrl+C is preserved in input history and recoverable with the up arrow.
- ›MCP tool names are now prefixed with
mcp__for clearer namespacing. - ›Dedicated error message for GitHub MCP servers missing a personal access token.
- ›When MCP auth expires, the user is prompted to log in again interactively.
└──▷ BREAKING ON UPGRADE- !MCP tool names are now prefixed with
mcp__— any automation or configuration referencing MCP tool names by their previous unprefixed names will break.
- ›Adds
- rust-v0.47.0
Codex CLI gains agent overrides, OAuth MCP login, full-access warnings, macOS code signing, and auto-update banners.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.47.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.47.0
└──▷ TRY ITSuppress the interactive approval prompt when running codex exec in an automated pipeline — use with caution in trusted environments only.$ codex exec --dangerous-auto-approval 'run the test suite and output results'
Run a task on Codex cloud instead of locally, useful when local sandbox resources are insufficient.$ codex cloud exec 'refactor the auth module to use JWT'- ›Adds indentation mode for
read_fileto control how file content is presented. - ›Adds an agent override file to customize agent behavior without changing global config.
- ›Prompts MCP OAuth login automatically when adding a streamable HTTP server that supports OAuth.
- ›Adds a confirmation prompt (warning) when enabling full-access approval mode.
- ›Adds an auto-update banner with approval flow, including detection of Bun installs.
+10 moreshow less
- ›Adds a warning about rate limits when using high-effort mode.
- ›Adds dangerous auto-approval option for
codex exec. - ›Adds
codex cloud execsubcommand for cloud-based execution. - ›Includes parsed command data in
ExecApprovalRequestEventfor richer approval metadata. - ›Adds a
pathfield to theParsedCommand::Readvariant. - ›Passes Codex thread ID in notifier metadata for better traceability.
- ›Adds a header display for task kind in the TUI.
- ›Adds macOS code signing and notarization to release binaries.
- ›Shows a message when a stream is correctly resumed.
- ›Exposes sandbox denied errors in logs for easier diagnosis.
- ›Adds indentation mode for
- rust-v0.46.0
Codex CLI gains streamable HTTP MCP servers, new list_dir/grep_files tools, and alias creation in v0.46.0
└──▷ GET THIS VERSION$ git clone --branch rust-v0.46.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.46.0
└──▷ USE ITEnable the new MCP client stack and disable a specific server without removing it from config.# In ~/.config/codex/config.toml experimental_use_rmcp_client = true [[mcp_servers]] name = "my-server" url = "https://my-mcp-server.example.com" enabled = false
- ›Adds
list_dirbuilt-in tool, giving the agent a native directory-listing capability. - ›Adds
grep_filesbuilt-in tool for pattern-based file searching during agent sessions. - ›Supports streamable HTTP MCP servers via
codex mcp add, alongside optional bearer token or OAuth login. - ›Adds
enabledconfig field per MCP server entry so individual servers can be toggled without removing them. - ›Adds ability to explicitly specify a credentials store for MCP server authentication.
+7 moreshow less
- ›Adds auth status reporting for MCP servers.
- ›Enables new MCP stack via
experimental_use_rmcp_client = trueinconfig.toml. - ›Adds UP/ENTER keybinding support in the CLI input.
- ›Switches TUI code highlighting to tree-sitter for bash syntax.
- ›Adds animated breathing spinner on true-color terminals.
- ›Adds dynamic width for line numbers in diff views.
- ›Truncates context on compact to manage long sessions.
- ›Adds
- rust-v0.45.0
Codex CLI gains OAuth MCP auth, parallel tool calls, and gpt-5 default for Windows in v0.45.0
└──▷ GET THIS VERSION$ git clone --branch rust-v0.45.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.45.0
└──▷ TRY ITSecurely log in to Codex CLI using an API key from your environment without exposing it on the command line.$ printenv OPENAI_API_KEY | codex login --with-api-key
- ›Adds experimental OAuth authentication support for MCP servers.
- ›Removes the requirement to set
experimental_use_rmcp_clientfor streamable HTTP MCP servers that don't need OAuth. - ›Adds initial parallel tool call support.
- ›Defaults to
gpt-5for Windows users who have not configured a model. - ›Outputs only the final message to stdout for
codex exec, enabling cleaner scripting pipelines.
+1 moreshow less
- ›Adds a pulsing dot loading state indicator in the UI.
└──▷ BREAKING ON UPGRADE- !The
codex login --api-keyflag is replaced by--with-api-key, which reads the key from stdin; existing scripts passing the key directly via--api-keywill break.
- rust-v0.44.0
Codex CLI v0.44.0 adds cloud task management, streamable HTTP MCP servers, custom prompt arguments, and a refreshed TUI.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.44.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.44.0
└──▷ TRY ITManage cloud tasks from the CLI — useful for kicking off or inspecting long-running agent jobs in the cloud.$ codex cloud- ›New TUI refresh: updated chat composer, bottom pane, two-stage model picker, and upgrade nudge.
- ›Custom prompts now support named and positional (numeric) arguments via the
/prompts:prefix. - ›Adds support for streamable HTTP MCP servers.
- ›New
codex cloudsubcommand (very experimental) for managing cloud tasks. - ›Experimental reduction of repetitive approval prompts for read-only (safe) commands on Windows via PowerShell command safety classification.
+12 moreshow less
- ›Displays context window usage ratio while tasks are running.
- ›Shows 'Viewed Image' indicator when the model processes an image.
- ›Adds
/reviewcommand to main command palette. - ›Fuzzy file search is now exposed via the MCP server.
- ›OpenTelemetry events support added.
- ›Web search item wired up in the response stream.
- ›Falls back to configured instruction files when
AGENTS.mdis not available. - ›Adds Updated at time in the session resume picker.
- ›Supports
CODEX_API_KEYenvironment variable forcodex exec. - ›Separates
codex mcpinto distinctcodex mcp-serverandcodex app-serversubcommands. - ›TypeScript SDK scaffold introduced with support for model, sandbox mode, working directory, and
skipGitRepoCheckoptions. - ›Writes PID in addition to port to the server info file.
└──▷ BREAKING ON UPGRADE- !The
codex mcpcommand is split intocodex mcp-serverandcodex app-server; any scripts or configs invokingcodex mcpwill break. - !The legacy
codex exec --jsonformat is removed; callers relying on the old JSON output format will break.
- rust-v0.42.0
Codex CLI gains an experimental Rust SDK MCP client, a responses-API proxy, secure mode, and safer command execution checks.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.42.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.42.0
└──▷ TRY ITLock down process observability on a shared or production host before running Codex.$ CODEX_SECURE_MODE=1 codex <prompt>Inspect the current session status with the revamped, detail-rich output.$ /status- ›Adds experimental Rust SDK–based MCP client for model context protocol integration.
- ›New
responses-api-proxycomponent to simplify and secure response handling and proxying. - ›New
CODEX_SECURE_MODE=1environment variable to restrict process observability in sensitive environments. - ›Adds explicit
codex execevents, includingitem.started, with improved output display on success. - ›Adds dangerous command detection checks in core and a Windows-specific safe-command check before execution.
+5 moreshow less
- ›Revamped
/statuscommand with clearer presentation and details. - ›Pageless session list for browsing sessions without pagination interruptions.
- ›Approvals UI moved to
ListSelectionViewfor a more consistent selection experience. - ›Improved MCP tool call styling in the terminal UI.
- ›Hides status indicator during answer streaming to reduce visual noise.
- rust-v0.41.0
Codex CLI gains rate-limit visibility, exec output schemas, and an include-plan-tool flag in v0.41.0.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.41.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.41.0
└──▷ TRY ITEnforce a structured JSON output shape when running a non-interactive exec task, useful for piping Codex output into downstream tooling.$ codex exec --output-schema '{"type":"object","properties":{"result":{"type":"string"}}}' 'Summarize the findings in ./report.txt'
Run an exec task and include the plan tool output so you can inspect the model's reasoning steps alongside the result.$ codex exec --include-plan-tool 'Refactor the auth module in ./src/auth.rs to use async/await'
- ›Shows rate-limit reset time and current usage when a rate limit is hit, so practitioners know exactly when to retry.
- ›Adds
--output-schemaparameter toexecmode for specifying a structured output schema. - ›Adds
--include-plan-toolflag toexecmode to include and display the plan tool. - ›Vendors Ripgrep (
rg) directly into the npm release, eliminating@vscode/ripgreppostinstall failures.
- rust-v0.40.0
Codex CLI gains
/reviewcommands, usage limits in/status, MCP timeouts, and defaults to gpt-5-codex with auto-compaction.└──▷ GET THIS VERSION$ git clone --branch rust-v0.40.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.40.0
└──▷ USE ITPrevent slow MCP servers from hanging a session by setting a per-server timeout in your config.[mcp_servers.my_server] tool_timeout_sec = 120
- ›Switches default model to
gpt-5-codex. - ›Adds automatic context compaction for
gpt-5-codexwhen the session hits 220k tokens. - ›Adds usage limits display to the
/statuscommand. - ›Adds
/reviewcommand with options to review a specific commit, diff against a base branch, or apply custom review instructions. - ›Adds configurable MCP tool call timeout: defaults to 60s, overridable per-server via
tool_timeout_secinconfig.toml.
└──▷ BREAKING ON UPGRADE- !The
/limitscommand has been removed; usage limit information has moved to/status.
- ›Switches default model to
- rust-v0.39.0
OpenAI Codex CLI v0.39.0 introduces the new
/reviewcommand for in-session code review.└──▷ GET THIS VERSION$ git clone --branch rust-v0.39.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.39.0
└──▷ TRY ITTrigger an inline code review of your current session's changes without leaving the Codex TUI.$ /review- ›Adds
/reviewcommand for initiating code review directly within a Codex CLI session. - ›Adds hint for
codex resumeon TUI exit to help users continue interrupted sessions. - ›Turn notifications now include the agent's reply text for richer context.
- ›Adds
- rust-v0.37.0
OpenAI Codex CLI rust-v0.37.0 adds approval/turn-end notifications, persistent search, and review mode core updates.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.37.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.37.0
- ›Adds desktop notifications on approvals and turn end.
- ›Persists search items across sessions.
- ›Introduces review mode core updates.
- ›Restyled thinking outputs for improved readability.
- ›Adds a dev message upon review exit.
- rust-v0.36.0
Codex CLI v0.36.0 adds GPT-5-Codex, session resumption, JSON-RPC expansions, MCP interface, and experimental context compaction.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.36.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.36.0
└──▷ TRY ITMigrate from env-var auth to the new explicit login so your API key persists across sessions.$ codex login --api-key "sk-...your-key..."
- ›Adds GPT-5-Codex model support: faster on easy tasks, harder on complex tasks, with improved code quality and better AGENTS.md steerability.
- ›New
codex resumecommand lets practitioners pick up old conversations where they left off. - ›New
codex login --api-keycommand stores API credentials inCODEX_HOME/auth.jsonfor explicit, persistent authentication. - ›Adds initial MCP (Model Context Protocol) interface and documentation for integrating external tool servers.
- ›Expands JSON-RPC server with
SetDefaultModel(passing None clears the default),UserInfo, andreasoning_effortfield inNewConversationResponse.
+6 moreshow less
- ›Introduces experimental automatic context compaction to handle long sessions without manual intervention.
- ›New TUI onboarding flow with animations, consistent session headers on resume, and reasoning-level display in the header.
- ›Expands default sandbox permissions to cover a broader set of operations out of the box.
- ›Command output is now included when a timeout is sent to the model, giving it context on what ran before the cutoff.
- ›Adds Review Mode core capability for reviewing changes before applying them.
- ›Workspace roots are now injected into the environment context automatically.
└──▷ BREAKING ON UPGRADE- !
OPENAI_API_KEYis no longer read from the environment; runcodex login --api-key "your-api-key-here"once to store the key inCODEX_HOME/auth.json, or runcodex loginto use ChatGPT auth.
- rust-v0.33.0
Codex CLI 0.33.0 adds a custom Markdown renderer, image support in messages, and keyboard word-deletion.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.33.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.33.0
- ›New custom Markdown renderer replaces tui_markdown for improved in-terminal rendering.
- ›Supports images in
UserMessageEvent, enabling image attachments in chat messages. - ›Adds
alt+deletekeybinding to delete the word to the right of the cursor (delete_forward_word). - ›Sets a user-agent suffix when Codex is used as an MCP server.
- ›Introduces rollout items for staged feature delivery.
└──▷ BREAKING ON UPGRADE- !The POSIX unification and snapshot sessions feature (introduced in #3179) has been reverted; any workflows depending on that behavior will no longer work.
- rust-v0.32.0
Codex 0.32.0 adds Alt+Delete word deletion, ArchiveConversation API, rollout groundwork, and broader apply_patch OSS model compatibility.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.32.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.32.0
- ›Adds Alt+Delete keybinding in the TUI to delete the next word to the right of the cursor.
- ›Adds
ArchiveConversationrequest type to the client protocol for conversation management. - ›Includes
rollout_pathinNewConversationResponseas initial groundwork for rollout support. - ›Expands
apply_patchcompatibility to OSS models from gpt-oss providers using alternative naming conventions (e.g.openai/gpt-oss-*). - ›Sets a user-agent suffix when Codex acts as an MCP server.
+1 moreshow less
- ›Re-exports
InitialHistoryfromconversation_managerand generates additional TypeScript types, including returning conversation ID withConversationSummary.
└──▷ BREAKING ON UPGRADE- !The
config.responses_originator_header_internal_overrideconfig key is replaced by theCODEX_INTERNAL_ORIGINATOR_OVERRIDE_ENV_VARenvironment variable; any existing config using the old key will no longer work.
- rust-v0.31.0
Codex CLI 0.31.0 adds per-MCP-server startup timeouts, command preview highlighting, and richer session/status info.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.31.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.31.0
└──▷ USE ITSet a longer startup timeout for a slow-starting MCP server (e.g., on Windows) to prevent premature connection failures.# In your codex config (e.g., ~/.codex/config.toml) [mcp_servers.my_server] command = "my-mcp-server" startup_timeout_ms = 15000
- ›Adds
startup_timeout_msconfig option per MCP server declaration, fixing slow-start issues especially on Windows. - ›Shows minutes and hours in the TUI thinking timer for long-running sessions.
- ›Displays CLI version in
/statusoutput. - ›Respects model family configuration overrides from the TOML config file.
- ›Moves token usage and context information to the session level in the TUI.
+4 moreshow less
- ›Clears non-empty prompts with Ctrl+C.
- ›Highlights the Proposed Command preview in the TUI.
- ›Adds a
getUserAgentMCP method. - ›Cancels pending OAuth login to free up the localhost port when login is abandoned.
- ›Adds
- rust-v0.30.0
Codex CLI 0.30.0 adds session resume/continue flags, MCP session history, bash syntax highlighting, and Windows Full Access auto-approval.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.30.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.30.0
└──▷ TRY ITReturn to a previous Codex session interactively — useful for long-running tasks you stepped away from.$ codex --resume
Instantly re-enter the most recent session without navigating a picker, ideal for quick follow-up prompts.$ codex --continue
- ›Adds
--resumesession picker and--continuequick-resume flags to the TUI for returning to previous sessions. - ›Adds MCP session resume and history listing support, replaying event messages from response items on resume.
- ›Adds bash syntax highlighting in the TUI command display.
- ›Enables auto-approval of patches on Windows in Full Access (DangerFullAccess) mode, eliminating approval prompts on non-sandboxed platforms.
- ›Improves
@file search to include specific hidden directories such as.githuband.gitlab.
+6 moreshow less
- ›Introduces a rollout policy mechanism for controlled feature exposure.
- ›Adds a shared HTTP client for more consistent network handling.
- ›Uses macOS-native key glyphs (⌥⇧⌃) for keyboard hints on Mac.
- ›Pager now auto-scrolls (pins scroll to bottom) in the TUI.
- ›Introduces MCP sandbox call support.
- ›Prompts Codex to read
AGENTS.mdfiles for project-level agent instructions.
└──▷ BREAKING ON UPGRADE- !Project
.envfiles are no longer loaded automatically — environment variables previously sourced from a project.envon startup must now be set in the shell or passed explicitly.
- ›Adds
- rust-v0.29.0
Codex CLI 0.29.0 adds Android/Termux support, Windows ARM64 distribution, and switches to the latest search tool.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.29.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.29.0
- ›Adds Android/Termux support by gating the
arboarddependency on unsupported targets. - ›Includes Windows ARM64 executable in the npm package.
- ›Switches to the latest search tool for
@search queries. - ›Supports
cd foo && ...syntax inexecandapply_patchcommands. - ›Shows a loading state in the TUI when
@search results are pending.
+2 moreshow less
- ›Adds stable, cross-platform file locking using
std::fsAPIs. - ›Adds a rollout listing API and returns file heads via the extracted
rolloutmodule.
- ›Adds Android/Termux support by gating the
- rust-v0.26.0
Codex CLI gains custom slash-prompt libraries, agentic image viewing, and an MCP GetConfig endpoint.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.26.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.26.0
└──▷ TRY ITCreate a reusable slash command so you can invoke a custom prompt mid-session without retyping it.$ mkdir -p ~/.codex/prompts echo 'Summarize the security implications of the following code:' > ~/.codex/prompts/secreview.md # Then inside a Codex session, type: /secreview
- ›Adds custom
/promptssupport: drop prompt files into~/.codex/promptsto create reusable slash commands. - ›New 'View Image' tool lets Codex agentically load and interpret local image files during a task.
- ›New MCP
GetConfigendpoint exposes the fully resolved Codex configuration for inspection by MCP clients.
- ›Adds custom
- rust-v0.25.0
Codex CLI gains remove_conversation API, mouse wheel scrolling, Alt+Ctrl+H word deletion, and context window on task_started events.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.25.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.25.0
└──▷ TRY ITReturn queued messages to the composer when you change your mind mid-input — press ESC instead of losing them.$ # While messages are queued, press ESC to move them back to the composer for editing.- ›Adds
remove_conversationAPI toConversationManagerfor manual cleanup in long-lived servers. - ›Enables mouse wheel alternate scrolling in transcript and diff views.
- ›Adds Alt+Ctrl+H shortcut to delete the previous word (parity with Alt+Backspace).
- ›Includes context window information on
task_startedevents; model may now vary per turn. - ›ESC with queued messages returns them to the composer instead of discarding them.
+1 moreshow less
- ›Caches transcript line wraps to keep long transcripts responsive.
- ›Adds
- rust-v0.24.0
Codex CLI gains web search, transcript mode, image paste, queued messages, and long-running shell command support.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.24.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.24.0
└──▷ TRY ITReview the full session transcript with scrolling after a long agentic run to audit every command and output.$ # Inside a running codex TUI session, press Ctrl+T to open transcript mode and scroll through the history.Tune GPT-5 response verbosity to reduce noise in automated pipelines.# In your codex config file: model_verbosity = "low"
- ›Adds web search capability via the explicit
--searchoption. - ›New transcript mode (Ctrl+T) with live-updating scrollable view of the full session.
- ›Supports copy/paste and drag-and-drop of image files directly into the TUI (macOS Terminal + iTerm).
- ›Introduces queued messages, letting input be staged while the model is still responding.
- ›Adds edit/resume conversation from any previous message in history (esc-esc).
+7 moreshow less
- ›Adds long-running shell command support via new
exec_commandandwrite_stdintools. - ›New
model_verbosityconfig option for tuning GPT-5 output verbosity via the Responses API. - ›Now reads all AGENTS.md files up the directory tree to the git root for richer project context.
- ›Diff output now displayed in a pager with hunk headers for easier review.
- ›Simplifies command approval UI in the TUI.
- ›Hides chain-of-thought (CoT) output by default; surfaces headers in the status indicator instead.
- ›Improves MCP tool cache hit rate by sorting tools deterministically.
- ›Adds web search capability via the explicit
- rust-v0.23.0
Codex CLI gains
/mcp,/approvals, and/modelslash commands plus runtime reasoning effort control and ChatGPT auth auto-refresh.└──▷ GET THIS VERSION$ git clone --branch rust-v0.23.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.23.0
└──▷ TRY ITSwitch model and tune reasoning effort mid-session without restarting — useful when a task shifts from quick edits to deep reasoning.$ /modelLock down or loosen what Codex is allowed to do automatically during a sensitive refactor.$ /approvalsList or interact with connected MCP servers directly from the TUI.$ /mcp- ›Adds
/mcpslash command in the TUI to inspect and interact with MCP servers. - ›Adds
/approvalsslash command to control approval/permission settings at runtime. - ›Adds
/modelslash command to change the active model and reasoning effort without restarting. - ›Adds 'minimal' reasoning effort level for GPT-5 models.
- ›Shows login options when not signed in with ChatGPT, improving auth discovery.
+7 moreshow less
- ›Auto-refreshes ChatGPT auth tokens to maintain uninterrupted sessions.
- ›Shows a progress indicator for the
/diffcommand. - ›Adds a
/diffcommand for diffing session changes. - ›Releases zip-archived binaries for easier distribution.
- ›Adds DotSlash entry for Windows x86_64, enabling Windows distribution support.
- ›Adds Ctrl+H as an additional backspace keyboard shortcut in the TUI.
- ›Supports Ghostty terminal Ctrl-b/Ctrl-f word-navigation fallback in the TUI.
- ›Adds
- rust-v0.22.0
Codex CLI gains markdown streaming, improved diff UI, Ctrl-Z TUI suspend, and a Rust-native login server.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.22.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.22.0
└──▷ TRY ITSuspend the Codex TUI mid-session to drop to the shell, then resume withfg.$ # While Codex TUI is running, press: ctrl-z # To resume: fg- ›Supports markdown streaming in the TUI output.
- ›Improved diff display readability when using a light terminal background.
- ›Adds
ctrl-zkeybinding to suspend the TUI. - ›Login server rewritten in Rust, replacing the Python implementation.
- rust-v0.21.0
Codex CLI v0.21.0 adds diff previews for apply_patch, output truncation notices, and MCP JSON schema sanitization.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.21.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.21.0
- ›Shows a diff preview when
apply_patchis about to modify files, letting you inspect changes before they land. - ›Includes an output truncation message in tool call results so the model knows when it received incomplete command output.
- ›Adds JSON schema sanitization for MCP tools to ensure compatibility with internal JsonSchema enums.
- ›Sends a prompt cache key to improve token efficiency through better caching.
- ›Splits multiline commands in the UI for improved readability.
+2 moreshow less
- ›Parses and formats exec commands more clearly in the UI.
- ›Shows a feedback message after the
/compactcommand completes.
- ›Shows a diff preview when
- rust-v0.15.0
Codex CLI v0.15.0: gpt-5 default, new approval mode, and trust-based onboarding flow
└──▷ GET THIS VERSION$ git clone --branch rust-v0.15.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.15.0
└──▷ TRY ITLet the model self-select when to ask for approval, avoiding constant interruptions without going fully autonomous.$ codex --ask-for-approval on-request 'refactor the auth module to use JWT'
Run Codex in a trusted Git repo with the recommended onboarding defaults: workspace-scoped writes and model-driven approval prompts.$ codex --sandbox workspace-write --ask-for-approval on-request 'add unit tests for src/api.rs'
- ›Sets
gpt-5as the default model for all sessions. - ›Adds
--ask-for-approval on-requestmode, letting the model decide when to prompt for user approval — a middle ground betweenon-failureandnever. - ›Introduces a new onboarding flow that auto-configures
--sandbox workspace-writeand--ask-for-approval on-requestwhen a folder is marked as trusted, optimized for Git repo workflows.
└──▷ BREAKING ON UPGRADE- !The default model is changed to
gpt-5; any workflow that relied on the previous default model will now usegpt-5instead.
- ›Sets
- rust-v0.11.0
Codex CLI gets native terminal scrolling,
/compactcommand, experimental planning tool, and version-update notifications.└──▷ GET THIS VERSION$ git clone --branch rust-v0.11.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.11.0
└──▷ TRY ITCompact a long conversation mid-session to reduce context length and stay within token limits.$ /compact- ›New terminal UX appends output to the end of the terminal instead of running fullscreen, enabling native scrollback and copy/paste.
- ›Adds the
/compactcommand for compacting conversation context. - ›Introduces an experimental planning tool.
- ›CLI now checks for newer versions and notifies you when an update is available.
- rust-v0.10.0
Codex CLI v0.10.0 expands trusted commands by default and adds Git state capture to session logs.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.10.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.10.0
- ›Expands the set of commands trusted by default, reducing approval prompts for common operations.
- ›Records Git state (branch, commit, etc.) in the
.jsonlsession log for better auditability of AI-driven changes.
- rust-v0.8.0
Codex CLI v0.8.0 adds response streaming in TUI and
codex exec, plus a--jsonflag for JSONL output.└──▷ GET THIS VERSION$ git clone --branch rust-v0.8.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.8.0
└──▷ TRY ITCapture structured, machine-readable output from a Codex exec run for piping into downstream tooling or logging.$ codex exec --json 'summarize the security findings in REPORT.md'
- ›Streams model responses in real time in the TUI and when using
codex exec. - ›Adds
--jsonflag tocodex execto print output as JSONL to stdout. - ›Reorganizes
~/.codex/sessionsintoYYYY/MM/DDsubfolders for easier navigation and better filesystem performance. - ›
ctrl-dnow only exits the TUI when the composer is empty, preventing accidental exits mid-session.
- ›Streams model responses in real time in the TUI and when using
- rust-v0.6.0
OpenAI Codex CLI v0.6.0 adds paste summarization and an experimental
codex applycommand for Codex Web.└──▷ GET THIS VERSION$ git clone --branch rust-v0.6.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.6.0
└──▷ TRY ITInteract with Codex Web from the terminal without leaving your workflow.$ codex apply- ›New
codex applycommand (experimental) lets you interact with Codex Web directly from the CLI. - ›Adds paste summarization for large pastes, automatically condensing oversized clipboard input.
- ›New
- rust-v0.5.0
Codex CLI rust-v0.5.0 adds reasoning-summary config control and Android platform support via npm.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.5.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.5.0
└──▷ USE ITEnable reasoning summaries for a model that supports them by setting the new config flag.# In your Codex config file: model_supports_reasoning_summaries: true
- ›New
model_supports_reasoning_summariesconfig option to control reasoning summary behavior per model. - ›Running Codex installed via
npmon Android (process.platform === "android") now routes to the Rust CLI.
- ›New
- rust-v0.4.0
Codex CLI v0.4.0 adds shell completion generation, per-profile reasoning controls, and custom base URL support.
└──▷ GET THIS VERSION$ git clone --branch rust-v0.4.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.4.0
└──▷ TRY ITGenerate shell completions for your shell (e.g. to install via Homebrew or manually source them).$ codex completion bash- ›Supports
OPENAI_BASE_URLenvironment variable for the built-inopenaimodel provider, enabling use of compatible API endpoints. - ›Adds
model_reasoning_effortandmodel_reasoning_summaryfields to profile definitions for fine-grained reasoning control. - ›New
completionsubcommand enables shell tab-completion generation for package managers like Homebrew.
- ›Supports
- rust-v0.3.0
Codex CLI gains a
--sandboxflag and custom HTTP header support for model provider requests.└──▷ GET THIS VERSION$ git clone --branch rust-v0.3.0 https://github.com/openai/codex.git # already have the repo? check out this version: $ git checkout rust-v0.3.0
└──▷ TRY ITRun Codex with an explicit sandbox policy to control what the agent is allowed to do on your machine.$ codex --sandbox <sandbox-policy> "refactor the auth module"
- ›Adds
--sandboxflag to control sandbox behavior from the command line. - ›Enables configuration of custom HTTP headers when making requests to model providers.
└──▷ BREAKING ON UPGRADE- !The
config.tomlsandbox-related options have breaking changes — existing sandbox configuration will need to be updated after upgrading.
- ›Adds