mirror of
https://github.com/openai/codex.git
synced 2026-10-13 16:28:37 +00:00
andrewgu-oai
a956835d02
- Browse older tasks in the agent command center with a keyboard-accessible “Show more” action. (#49106) - Select transcript text and paste with middle-click in fullscreen mode on supported local Linux X11 terminals. (#49112) - Start sessions outside a project with workspace defaults when policy permits, and restore saved permissions when resuming. (#49160) - Added opt-in Guardian review capabilities to retrieve earlier user instructions and include context from agent handoffs. (#49036, #49057) ## Bug Fixes - Unsent queued messages now resume after reconnection once uncertain submissions are resolved, avoiding duplicate sends. (#49105) - The terminal UI now preserves server provider, reasoning-summary, and verbosity settings and shows the correct sessions in resume and fork history. (#49144, #49161, #49171) - Fixed Windows sandbox PowerShell fallbacks and long-path permission repairs, and suppressed unwanted console windows from background helpers. (#49019, #49058, #49098, #49164, #49386) - Subagents now retain environments that are still starting and receive their configuration or preparation failure. (#49075) - Prevented SQLite stalls during connection setup and logging, and surfaced initialization errors instead of masking them as timeouts. (#49032, #49102) - Explicit provider model catalogs no longer include unsupported bundled models or reuse stale entries after refresh failures. (#49135) ## Documentation - Clarified how provider credentials use the configured storage backend and how `env_key` identifies the API-key environment variable. (#49118) ## Chores - Reduced repeated plugin-loading work by caching parsed manifests and reusing HTTP connections for remote plugin requests. (#49099, #49100) - Added background reclamation of unused log database space to reduce disk usage. (#49069) ## Changelog Full Changelog: https://github.com/openai/codex/compare/rust-v0.159.0...rust-v0.160.0 - #48983 Avoid full metadata rewrites for thread timestamp updates @jif-oai - #49000 Isolate the memory startup metadata test from Git enrichment @jif-oai - #49019 Use a compatible PowerShell fallback for the Windows MXC sandbox @iceweasel-oai - #49028 Use the numeric ioctl value in the macOS sandbox policy @aionescu-oai - #49031 Clarify ChatGPT sign-in success copy @bc-openai - #49032 Avoid SQLite stalls from connection setup and stderr span logging @jif-oai - #49036 Add opt-in conversation history retrieval to Guardian reviews @felixxia-oai - #49037 Show the Plan mode cycling hint in the fullscreen status line @fcoury-oai - #49038 Preserve encrypted agent messages in Guardian reviews @felixxia-oai - #49041 Copy selections within inline code as plain text @fcoury-oai - #49043 Update Pro plan display names in the TUI @etraut-openai - #49057 Add handoff-aware root context for Guardian reviews @jif-oai - #49058 Fix Windows sandbox ACL repair for long runtime paths @darius-oai - #49060 Update Guardian messaging snapshots for native agent messages @dkovalenko-oai - #49065 Update Guardian handoff snapshot for separate agent messages @cassirer-openai - #49067 Keep configuration values out of Windows sandbox policy events @zm-oai - #49069 Reclaim unused SQLite log database pages in the background @dkovalenko-oai - #49073 Surface realtime voice catalog failures in the TUI @etraut-openai - #49074 Propagate Cargo package versions to Bazel Rust targets @tamird - #49075 Preserve pending environments when spawning subagents @sayan-oai - #49076 Avoid collecting unused Git metadata in skill analytics @tamird - #49079 Update and centralize TUI subscription labels @etraut-openai - #49082 Skip remote Git discovery for Guardian diff paths @jif-oai - #49084 Track app-server running turns incrementally @tamird - #49089 Render follow-up directive labels in the TUI and copied responses @etraut-openai - #49093 Simplify startup promotions to platform-specific desktop app tips @etraut-openai - #49096 Update `h2` from 0.4.16 to 0.4.19 in Cargo and Bazel lockfiles @cassirer-openai - #49097 Notify lifecycle extensions of compaction usage limits @xli-oai - #49098 Resolve Windows sandbox PowerShell fallbacks on the exec server @zm-oai - #49099 Cache parsed plugin manifests across plugin workflows @dkovalenko-oai - #49100 Reuse the HTTP connection pool for remote plugin requests @dkovalenko-oai - #49102 Preserve SQLite vacuum modes and surface pool initialization errors @bc-openai - #49103 Balance Windows Bazel test shards using duration estimates @jgershen-oai - #49105 Resume unsent TUI input after reconnecting @etraut-openai - #49106 Add history pagination to the agent command center @bc-openai - #49112 Add X11 primary selection and middle-click paste support @fcoury-oai - #49114 Point remote compaction tests at the mock ChatGPT server @OLI-OAI - #49117 Attribute analytics requests to each thread's product SKU @papayo-oai - #49118 Correct provider authentication storage documentation @celia-oai - #49119 Add recovery guidance to content-filter retries @won-openai - #49127 Deduplicate cloud and executor skill listings before budgeting @TAFOYA-OAI - #49130 Move content-filter guidance into the shared Responses retry handler @won-openai - #49135 Treat explicit provider model catalogs as authoritative @andrewgu-oai - #49136 Remove the plus separator after Option symbols in TUI key hints @bc-openai - #49138 Expose original error details to turn lifecycle contributors @bryanashley - #49144 Preserve server reasoning summary and verbosity settings in the TUI @etraut-openai - #49145 Hide reasoning summary settings in `/status` for server connections @etraut-openai - #49147 Simplify cloud task base URL normalization @akira-oai - #49153 Omit blockquote markers when copying quoted selections in the TUI @bc-openai - #49160 Support projectless TUI sessions with workspace defaults @etraut-openai - #49161 Honor app-server provider defaults in the TUI @etraut-openai - #49164 Suppress Windows console windows for background subprocesses @etraut-openai - #49171 Fix model provider lookup for TUI history @etraut-openai - #49386 [0.160] Backport remaining Windows console fix to frozen alpha.6 @andrewgu-oai - #49763 [0.160] Backport maintenance-line catalog and security reminder updates @andrewgu-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.