mirror of
https://github.com/openai/codex.git
synced 2026-09-16 12:13:30 +00:00
b4e230f8de
- Added a network sandbox proxy with policy enforcement to better control outbound network access. (#8442) - Introduced the first phase of connectors support via the app server and MCP integration, including new config/docs updates. (#9667) - Shipped collaboration mode as beta in the TUI, with a clearer plan → execute handoff and simplified mode selection (Coding vs Plan). (#9690, #9712, #9802, #9834) - Added ephemeral threads and improved collaboration tool provenance metadata for spawned threads. (#9765, #9769) - WebSocket connections now support proxy configuration. (#9719) ## Bug Fixes - Fixed exec policy parsing for multiline quoted arguments. (#9565) - `--yolo` now skips the git repository check instead of failing outside a repo. (#9590) - Improved resume reliability by handling out-of-order events and prompting for the working directory when it differs. (#9512, #9731) - Backspace no longer deletes a text element when the cursor is at the element’s left edge. (#9630) - Config loading errors are clearer and more actionable across surfaces. (#9746) - Default model selection now respects filtered presets to avoid invalid defaults. (#9782) ## Documentation - Corrected a typo in the experimental collaboration prompt template. (#9716) - Added documentation for the new connectors configuration surface. (#9667) ## Chores - Refreshed the bundled model catalog/presets. (#9726) - Updated GitHub Actions for Node 24 compatibility. (#9722) ## Changelog Full Changelog: https://github.com/openai/codex/compare/rust-v0.89.0...rust-v0.90.0 - #9715 feat: fix formatting of `codex features list` @bolinfest - #9716 Fix typo in experimental_prompt.md @iudizm - #9719 feat: support proxy for ws connection @apanasenko-oai - #9712 TUI: prompt to implement plan and switch to Execute @charley-oai - #9713 use machine scope instead of user scope for dpapi. @iceweasel-oai - #9726 Update models.json @github-actions - #9667 [connectors] Support connectors part 1 - App server & MCP @mzeng-openai - #9674 feat(app-server) Expose `personality` @dylan-hurd-oai - #9733 Change the prompt for planning and reasoning effort @aibrahim-oai - #9730 Hide mode cycle hint while a task is running @charley-oai - #9720 feat: add session source as otel metadata tag @alexsong-oai - #9565 Fix execpolicy parsing for multiline quoted args @jdsalasca - #9745 chore: use some raw strings to reduce quoting @bolinfest - #9753 nit: exclude PWD for rc sourcing @jif-oai - #9690 feat: tui beta for collab @jif-oai - #9116 Persist text element ranges and attached images across history/resume @charley-oai - #9777 plan mode prompt change @aibrahim-oai - #9590 fix(exec): skip git repo check when --yolo flag is used @zerone0x - #9722 Upgrade GitHub Actions for Node 24 compatibility @salmanmkc - #9611 Print warning if we skip config loading @gt-oai - #9782 Select default model from filtered presets @aibrahim-oai - #9512 Fix resume picker when user event appears after head @jdsalasca - #9787 Remove stale TODO comment from defs.bzl @jcoens-openai - #9700 still load skills @gt-oai - #9791 Load untrusted rules @gt-oai - #9707 bundle sandbox helper binaries in main zip, for winget. @iceweasel-oai - #9792 Chore: remove mode from header @aibrahim-oai - #9793 change collaboration mode to struct @aibrahim-oai - #8442 feat: introducing a network sandbox proxy @viyatb-oai - #9802 Have a coding mode and only show coding and plan @aibrahim-oai - #9746 Another round of improvements for config error messages @etraut-openai - #9812 Remove batman reference from experimental prompt @charley-oai - #9769 feat: add thread spawn source for collab tools @jif-oai - #9765 feat: ephemeral threads @jif-oai - #9819 fix: libcc link @jif-oai - #9820 fix: musl build @jif-oai - #9316 fix(windows-sandbox): remove request files after read @MaxMiksa - #9630 Prevent backspace from removing a text element when the cursor is at the element’s left edge @charley-oai - #9840 Revert "fix: musl build" @aibrahim-oai - #9778 Raise welcome animation breakpoint to 37 rows @mzeng-openai - #9731 Ask for cwd choice when resuming session from different cwd @charley-oai - #9841 Revert "fix: libcc link" @aibrahim-oai - #9806 Use collaboration mode masks without mutating base settings @aibrahim-oai - #9834 Mark collab as beta @pakrym-oai - #9847 Revert "Revert "fix: musl build"" @jif-oai - #9855 feat: cap number of agents @jif-oai
npm i -g @openai/codex
or brew install --cask codex
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 are looking for the cloud-based agent from OpenAI, Codex Web, go to chatgpt.com/codex.
Quickstart
Installing and running Codex CLI
Install globally with your preferred package manager:
# 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, Team, 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.