mirror of
https://github.com/openai/codex.git
synced 2026-10-20 18:57:36 +00:00
rhan-oai
316795b3cf
- Vim mode supports `/` and `?` searches within drafts, highlighted matches, and repeat navigation with `n` and `N`. (#41586) - Rate-limit banners offer actions for checking usage, managing credits, resetting limits, and managing plans. (#41742) - The terminal UI and `codex exec` show credential-refresh progress, including Amazon Bedrock reauthentication. (#41239) - MCP server names can contain `:`, `@`, `/`, and `.`, supporting package-style names throughout CLI commands and authentication. (#41700) - Individual MCP tools support an `output_token_limit` setting, with consistent truncation across session resumes. (#41421) - App-server clients can configure `thread/shellCommand` timeouts, including deadlines longer than one hour. (#41384) ## Bug Fixes - Automatic approval reviews preserve user instructions, answers, and valid authorizations across history compaction. (#41660, #41846, #41852) - Resumed threads restore their saved working directory when none is supplied, and client metadata updates preserve filesystem permissions. (#41567, #41464) - MCP tools remain available through cache refreshes and remote plugin changes; authentication retries use refreshed helper-provided headers. (#41336, #41344, #41396, #41400) - Opening the model picker refreshes available models without losing the highlighted choice. (#41467) - Fixed Windows sandbox execution with Microsoft Store PowerShell, subprocess hangs on terminal queries, and cursor-related display corruption in older JediTerm terminals. (#41227, #41436, #41673) - Cloud task requests reject untrusted backend URLs and disable redirects to protect saved credentials. (#41403) ## Chores - The planning tool is disabled by default; enable it with `tools.update_plan.enabled = true`. (#41744) - Plugin recommendations begin loading during startup, reducing delays before the first turn. (#41375) ## Changelog Full Changelog: https://github.com/openai/codex/compare/rust-v0.151.0...rust-v0.152.0 - #41210 Enable clock tools from model metadata @copyberry - #41215 Roll over Guardian context before follow-up reviews @copyberry - #41218 Share linked tool mention parsing in the TUI @copyberry - #41219 Retry confirmed remote registration conflicts @copyberry - #41221 Honor turn token budgets in Guardian review rollover @copyberry - #41223 Add recency sorting to `project/list` @copyberry - #41226 Move Guardian review session tests to a separate file @copyberry - #41227 Use compatible PowerShell for elevated Windows sandbox commands @copyberry - #41230 Apply app routing policy to unauthenticated plugin reads @copyberry - #41231 Instrument the loaded plugin cache @copyberry - #41232 Expose the PowerShell version in environment context @copyberry - #41235 Sanitize history notes backend errors @copyberry - #41239 Surface model provider authentication recovery progress @copyberry - #41243 Add configurable gating for the sleep tool @copyberry - #41250 Include thread source in realtime connection metadata @copyberry - #41260 Let the history backend enforce tool output budgets @copyberry - #41285 Drive keymap conflict checks from the action registry @copyberry - #41292 Forward history note images to the model @copyberry - #41308 Make subagents follow the root service tier @copyberry - #41309 Honor required reviews when reusing Guardian scores @copyberry - #41313 Decouple HTTP retry backoff from overload integration testing @copyberry - #41322 Isolate required-model Guardian approval coverage @copyberry - #41328 Review terminal input against retained permissions @copyberry - #41331 Classify clock tools as built-in control tools @copyberry - #41336 Preserve cached MCP tools during binding capture @copyberry - #41344 Use refreshed MCP tool caches during binding capture @copyberry - #41349 Assign stable IDs to generated Responses input items @copyberry - #41354 Reject NUL bytes in reviewed terminal input @copyberry - #41357 Support compression for shared rollout lineages @copyberry - #41360 Measure Codex home usage at app-server startup @copyberry - #41364 Test resuming compressed shared rollouts @copyberry - #41365 Restrict async user messages to questions @copyberry - #41368 Match Windows shell guidance to the executor platform @copyberry - #41375 Preload plugin recommendations during session startup @copyberry - #41380 Clarify proactive multi-agent delegation guidance @copyberry - #41384 Support configurable timeouts for thread shell commands @copyberry - #41385 Give Guardian classifications distinct turn identities @copyberry - #41392 Add shared Guardian context primitives @copyberry - #41393 Preserve one-shot exec when unified exec is disabled @copyberry - #41396 Refresh runtimes for remote plugin state changes @copyberry - #41400 Refresh MCP HTTP helper headers after authorization failures @copyberry - #41403 Restrict cloud task credentials to trusted origins @copyberry - #41413 Optimize history item lookups @copyberry - #41416 Add app-server notification media filtering @copyberry - #41421 Support per-tool MCP output limits @copyberry - #41422 Add shared Guardian transcript collection @copyberry - #41424 Preserve context baselines across nested agent forks @copyberry - #41427 Filter media from function call output notifications @copyberry - #41429 Retain the last selected step context for each turn @copyberry - #41432 Run executor hooks for interrupted turns @copyberry - #41435 Allow bundled browser cleanup hooks on subagent stop @copyberry - #41436 Respond to terminal queries from TTY subprocesses @copyberry - #41447 Support `openai/elicitation` form requests @copyberry - #41448 Clarify question handling in Default collaboration mode @copyberry - #41449 Rename the read-only Seatbelt platform defaults policy @copyberry - #41452 Report code mode host request durations @copyberry - #41454 Block goals after repeated execution host failures @copyberry - #41456 Support app targets in executor plugin hooks @copyberry - #41457 Source proactive multi-agent instructions from the model catalog @copyberry - #41461 Source async user message descriptions from the model catalog @copyberry - #41464 Preserve permissions when updating session metadata @copyberry - #41467 Refresh the TUI model picker from the app server @copyberry - #41476 Use rules_rs platforms for release binaries @copyberry - #41477 Organize bundled Rust resources under asset directories @copyberry - #41562 Preserve turn lineage across goal continuations @copyberry - #41567 Restore thread cwd from owned settings snapshots @copyberry - #41569 Harden diagnostic report uploads @copyberry - #41570 Fix proactive multi-agent instruction grammar @copyberry - #41586 Add Vim search motions to the composer @copyberry - #41613 Move Vim history tests into the history search module @copyberry - #41630 Update tests for default-enabled update_plan @copyberry - #41660 Preserve Guardian authorization across history compaction @copyberry - #41666 Approve the first Node REPL execution without a Guardian wait @copyberry - #41673 Repair cursor-style rendering on older JediTerm terminals @copyberry - #41683 Set working directories for environment MCP tests @copyberry - #41700 Support package-style MCP server names @copyberry - #41742 Show actionable rate-limit banners in the TUI @copyberry - #41743 Mark history ingestion requests in turn metadata @copyberry - #41744 Make the update_plan tool opt-in @copyberry - #41803 Allow models to enable token budgeting by default @copyberry - #41840 Use the async stack budget for approval reviews @copyberry - #41846 Preserve Guardian review evidence across compaction @copyberry - #41852 Preserve Guardian user answers across compaction @copyberry - #41853 Box the session startup future at its API boundary @copyberry - #41857 Preserve Guardian user answers from current history @copyberry - #41858 Preserve user text when Guardian history drops oversized images @copyberry - #41861 Keep history extension tools out of Guardian reviews @copyberry
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.