mirror of
https://github.com/openai/codex.git
synced 2026-10-14 16:38:43 +00:00
Ian MacLeod
00c972ed5d
- Added GPT-6 Sol and Luna, including Amazon Bedrock support and migration prompts for older models. (#47332, #47347) - Enabled fullscreen transcripts by default and added Shift-click to extend text selections. (#47178, #47414) - Enabled automatic background-server startup for eligible interactive sessions, with recovery choices when server settings are incompatible. (#47179, #47318) - Added an `f` shortcut to fork conversations open in another app, preserving drafts and queued prompts. (#47185) - Made `/import` available in remote sessions and local background-server sessions. (#47317) - Improved terminal rendering with Unicode bullets, checkboxes, aligned equations, and optimization notation. (#47191, #47322) ## Bug Fixes - Preserved active voice conversations when switching threads. (#47381) - Recovered unsent question answers into the composer when turns end, without disrupting active history searches. (#47422, #47423) - Respected tmux mouse settings and restored native scrollback for Terminal.app over SSH in automatic screen mode. (#47399, #47417) - Fixed configured proxy routing for realtime connections and standalone web search, including search redirects. (#47101, #47142, #47204) - Added retries for transient file-upload failures and increased the upload timeout to five minutes. (#47122, #47393) - Enforced network restrictions across redirects and ongoing HTTP and WebSocket traffic, including cancellation when policy changes revoke access. (#47389, #47407) ## Changelog Full Changelog: https://github.com/openai/codex/compare/rust-v0.156.0...rust-v0.157.0 - #47063 Add a partial index for agent message board root posts @jif-oai - #47064 Stop redundant message-board reads when limits reach one @jif-oai - #47065 Deduplicate deprecation notices in the TUI transcript @etraut-openai - #47068 Highlight selected newlines in the transcript view @etraut-openai - #47073 Wait for thread idle in Guardian context budget tests @jif-oai - #47074 Refresh host-supplied cloud skills at turn startup @TAFOYA-OAI - #47075 Include attributed previews in agent message board notifications @jif-oai - #47077 Serialize environment updates and cancel removed pending attachments @sayan-oai - #47079 Mask daemon socket paths exposed through ancestor bind mounts @nicksteele-oai - #47081 Track cumulative MCP attribution across requests and thread history @peilin-openai - #47082 Show the voice toggle in the TUI shortcut overlay @etraut-openai - #47083 Extract per-thread enrichment into a dedicated async helper @aibrahim-oai - #47084 Avoid building a host SQLite driver for SQLx macros @aibrahim-oai - #47085 Update model catalog descriptions and GPT-5.6-Sol priority @andrewgu-oai - #47086 Format analytics credit usage with consistent decimal precision @fcoury-oai - #47088 Disable unused default dependency features @aibrahim-oai - #47089 Centralize JSON-RPC response serialization through payloads @aibrahim-oai - #47094 Restrict Unix local MCP servers to stdio descriptors @yuzhu-oai - #47095 Remove the `rust-release-prepare` workflow @andrewgu-oai - #47096 Keep TUI hints immediately above the composer @fcoury-oai - #47100 Preserve assistant answers in bounded TUI task responses @etraut-openai - #47101 Honor configured proxies for realtime WebSocket connections @celia-oai - #47106 Preserve originating turn metadata for yielded skill calls @eddie-openai - #47108 Preserve required Windows runtime variables for filesystem helpers @iceweasel-oai - #47112 Lowercase the retry hint for conversations open in another app @fcoury-oai - #47113 Persist thread creator identity in rollouts and SQLite @nornagon-openai - #47114 Preserve and expose thread item lifecycle timestamps @chiam-oai - #47116 Honor the configured product SKU in remote plugin requests @jessedu-oai - #47118 Support model-catalog overrides for Code Mode tool messages @rhan-oai - #47121 Pass thread IDs to attachment uploads @kchainani-oai - #47122 Increase OpenAI file blob upload timeout from 60 seconds to 5 minutes @wilkes-oai - #47125 Add extra policy configuration for Guardian reviews @won-openai - #47129 Preserve foreign working directories in extension tool environments @anp-oai - #47130 Remove the `ultrafast` service tier from `gpt-5.6-sol` @andrewgu-oai - #47132 Support caller-provided MITM CAs in the network proxy @viyatb-oai - #47137 Prevent horizontal transcript selection from triggering autoscroll @imac-oai - #47142 Honor system proxy settings for standalone web search @celia-oai - #47143 Extract exec-server CLI startup into a dedicated module @anp-oai - #47149 Update code mode catalog snapshot hashes @andrewgu-oai - #47155 Ignore stale thread-close notifications after resuming a thread @etraut-openai - #47158 Harden gateway OAuth credential persistence and error redaction @alexsong-oai - #47159 Expose HTTP origins in MCP server status @frantic-openai - #47162 Apply workspace routing to Guardian v2 classifier requests @acrognale-oai - #47170 Add explicit gateway login control and authentication status @alexsong-oai - #47174 Preserve empty cell metadata under pending tool-call pressure @ningyi-oai - #47178 Enable the fullscreen transcript by default @etraut-openai - #47179 Enable automatic daemon startup by default @etraut-openai - #47185 Allow forking conversations locked by another app in the TUI @fcoury-oai - #47191 Render aligned equations and optimization notation in TUI math @etraut-openai - #47199 Separate thread preparation from execution persistence @dermanyang-oai - #47204 Resolve proxy routes for standalone web search redirects @celia-oai - #47207 Add explicit gateway OAuth sign-in to app-server @alexsong-oai - #47212 Preserve MCP request trace context across transport workers @bromano-oai - #47235 Route multi-agent spawning through `SpawnRequest` @jif-oai - #47236 Suppress agent message board notifications to the post author @jif-oai - #47240 Prevent V2 agent eviction from racing with queued messages @jif-oai - #47244 Centralize agent resume handling in `LocalAgentControl` @jif-oai - #47248 Add explicit app and account targets to MCP resource reads @victor-openai - #47249 Drop descendant channel posts from retained remote compaction v2 history @jif-oai - #47252 Return agent snapshots from `close_agent` @jif-oai - #47257 Preserve explicit message-board unsubscribes when posting @jif-oai - #47258 Test spawn settings reporting after child removal @jif-oai - #47259 Subscribe authors to message-board channels created by posting @jif-oai - #47263 Expose hosted plugin extensions in app-server summaries @victor-openai - #47267 Stream agent snapshots from local status subscriptions @jif-oai - #47271 Implement `AgentControl` for `LocalAgentControl` @jif-oai - #47272 Allow Guardian sync review across compaction hash differences @felixxia-oai - #47275 Enable Guardian thread context by default @felixxia-oai - #47281 Add regression coverage for message board unsubscribe persistence @jif-oai - #47287 Update the Guardian extra-policy snapshot for retained instructions @felixxia-oai - #47292 Consolidate agent operations in the `AgentControl` implementation @jif-oai - #47301 Separate local agent runtime state from controller handles @jif-oai - #47302 Use compact display metadata for Guardian review threads @charliemarsh-oai - #47303 Clean up legacy Guardian thread metadata in SQLite @charliemarsh-oai - #47317 Enable `/import` in remote and local daemon sessions @etraut-openai - #47318 Offer explicit recovery for incompatible background servers @etraut-openai - #47319 Match agent status symbols to the selected row style @etraut-openai - #47320 Fix Escape navigation in read-only agent sessions @etraut-openai - #47321 Honor the system clock preference across more TUI timestamps @etraut-openai - #47322 Render TUI Markdown lists with Unicode bullets and checkboxes @etraut-openai - #47323 Persist resume metadata in compaction checkpoints @owenlin0 - #47325 Keep report reason tags within Sentry limits @ningyi-oai - #47326 Restrict MCP OAuth authorization endpoints to HTTP(S) @viyatb-oai - #47327 Preserve image generation request IDs on failure @chrisdong-oai - #47329 Standardize TUI menu description wording and punctuation @etraut-openai - #47330 Identify failed SQLite databases in `codex doctor` output @dkovalenko-oai - #47331 Avoid redundant spacing above the transcript composer @fcoury-oai - #47332 Add GPT-6 Sol and Luna to the model catalog @andrewgu-oai - #47338 Move the activity inspection hint into keyboard shortcut help @fcoury-oai - #47340 Add conditional turn interruption that preserves pending input @pmccrary-oai - #47342 Skip stored title lookups for ephemeral forks @keyz - #47347 Add GPT-6 Sol and Luna to Amazon Bedrock catalogs @celia-oai - #47348 Overlap subagent spawn persistence and clean up cancelled children @owenlin0 - #47349 Move plugin recommendations into developer context @adaley-openai - #47350 Reuse cloud skill catalogs across turns until invalidated @hlevy-openai - #47353 Preserve `invalid_prompt` as a distinct error classification @rennie-openai - #47355 Reserve spacing after recaps at the transcript tail @fcoury-oai - #47358 Color paths and URLs in `codex doctor` by check status @dkovalenko-oai - #47360 Preserve user prompt URL destinations across terminal widths @fcoury-oai - #47361 Restrict Windows sandbox default object access to the logon session @viyatb-oai - #47362 Bound inbound exec-server requests across client transports @viyatb-oai - #47365 Resume model context from the latest compaction boundary @owenlin0 - #47369 Overlap agent metadata reads when resuming a V2 root @vkg-oai - #47375 Add an opt-in preference for the local MXC sandbox @iceweasel-oai - #47377 Add opt-in reasoning status for realtime V3 delegations @guinness-oai - #47380 Route TUI voice controls through the app @etraut-openai - #47381 Keep voice conversations running across TUI thread navigation @etraut-openai - #47382 Show a voice badge in the agents overview @etraut-openai - #47384 Restore composer hints after clearing selection at the transcript bottom @fcoury-oai - #47389 Enforce network policy throughout HTTP and WebSocket requests @acrognale-oai - #47393 Retry transient OpenAI file blob upload failures @mtsui-oai - #47397 Refresh bundled model metadata and instructions @andrewgu-oai - #47399 Respect tmux mouse settings in fullscreen and overlays @fcoury-oai - #47407 Enforce application network policy across app-server requests @acrognale-oai - #47408 Enforce application network policy for AWS auth and telemetry @acrognale-oai - #47410 Honor network policy in remote control and recover remote execution @acrognale-oai - #47411 Apply shared network policy throughout embedded Codex startup @acrognale-oai - #47413 Cache decrypted gateway OAuth secrets per backend @charliemarsh-oai - #47414 Support Shift-click to extend transcript selections @etraut-openai - #47417 Use native scrollback for Terminal.app over SSH in auto mode @fcoury-oai - #47422 Recover unsent question drafts when TUI turns end @imac-oai - #47423 Preserve history search during background draft recovery @imac-oai - #47424 Clear pending async question notifications when turns end @imac-oai - #47428 Apply inherited environment settings at turn boundaries @sayan-oai - #47435 Allow environment selection updates during an active turn @sayan-oai - #47437 Stabilize retry timing and WebSocket tests @anp-oai
Codex CLI is a coding agent from OpenAI that runs locally on your computer.
If you want Codex in your code editor (VS Code, Cursor, Windsurf), install in your IDE.
If you want the desktop app experience, run
codex app or visit the Codex App page.
If you are looking for the cloud-based agent from OpenAI, Codex Web, go to chatgpt.com/codex.
Quickstart
Installing and running Codex CLI
Run the following on Mac or Linux to install Codex CLI:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Run the following on Windows to install Codex CLI:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
The standalone installers download from https://releases.openai.com/codex by default and fall back to GitHub Releases if a metadata or asset download is unavailable. To force GitHub Releases, set CODEX_INSTALLER_USE_RELEASES_OPENAI_COM to false (0 and no are also accepted):
curl -fsSL https://chatgpt.com/codex/install.sh | CODEX_INSTALLER_USE_RELEASES_OPENAI_COM=false sh
$env:CODEX_INSTALLER_USE_RELEASES_OPENAI_COM='false'; irm https://chatgpt.com/codex/install.ps1 | iex
Codex CLI can also be installed via the following package managers:
# Install using npm
npm install -g @openai/codex
# Install using Homebrew
brew install --cask codex
Then simply run codex to get started.
You can also go to the latest GitHub Release and download the appropriate binary for your platform.
Each GitHub Release contains many executables, but in practice, you likely want one of these:
- macOS
- Apple Silicon/arm64:
codex-aarch64-apple-darwin.tar.gz - x86_64 (older Mac hardware):
codex-x86_64-apple-darwin.tar.gz
- Apple Silicon/arm64:
- Linux
- x86_64:
codex-x86_64-unknown-linux-musl.tar.gz - arm64:
codex-aarch64-unknown-linux-musl.tar.gz
- x86_64:
Each archive contains a single entry with the platform baked into the name (e.g., codex-x86_64-unknown-linux-musl), so you likely want to rename it to codex after extracting it.
Using Codex with your ChatGPT plan
Run codex and select Sign in with ChatGPT. We recommend signing into your ChatGPT account to use Codex as part of your Plus, Pro, Business, Edu, or Enterprise plan. Learn more about what's included in your ChatGPT plan.
You can also use Codex with an API key, but this requires additional setup.
Docs
This repository is licensed under the Apache-2.0 License.