Codex
OpenAI's Rust-based CLI for interacting with the Codex model.
🔒 Security Updates
>Configuration options for `forced_login_method` and `forced_chatgpt_workspace_id` which can be paired with [managed configs](https://developers.openai.com/codex/security#managed-configuration) to give enterprises more control over Codex usage.
SECURITY
✨ New Features
>Add forced_chatgpt_workspace_id and forced_login_method configuration options by @gpeal in https://github.com/openai/codex/pull/5303
>Add ItemStarted/ItemCompleted events for UserInputItem by @pakrym-oai in https://github.com/openai/codex/pull/5306
>Add a baseline test for resume initial messages by @pakrym-oai in https://github.com/openai/codex/pull/5466
>Add new thread items and rewire event parsing to use them by @pakrym-oai in https://github.com/openai/codex/pull/5418
🚀 Improvements
>Improved startup error messages
>Update Homebrew install instructions to use cask by @shijie-oai in https://github.com/openai/codex/pull/5377
⚡ Performance
>chore(ci): Speed up macOS builds by using larger runner by @JaviSoto in https://github.com/openai/codex/pull/5234
🐛 Bug Fixes
>Fix nix build by @Mic92 in https://github.com/openai/codex/pull/4048
>Fix link to MCP Servers config section by @lopopolo-openai in https://github.com/openai/codex/pull/5301
>fix: switch rate limit reset handling to timestamps by @tibo-openai in https://github.com/openai/codex/pull/5304
>fix: diff_buffers clear-to-end when deleting wide graphemes by @MomentDerek in https://github.com/openai/codex/pull/4921
>fix: handle missing resume session id gracefully by @tibo-openai in https://github.com/openai/codex/pull/5329
>fix: improve custom prompt documentation and actually use prompt descriptions by @tibo-openai in https://github.com/openai/codex/pull/5332
>fix: config.md docs inaccuracies by @tibo-openai in https://github.com/openai/codex/pull/5355
>fix: update CLI usage order for codex -h by @tibo-openai in https://github.com/openai/codex/pull/5356
>fix: warn when --add-dir would be ignored by @tibo-openai in https://github.com/openai/codex/pull/5351
>fix terminal corruption that could happen when onboarding and update banner by @nornagon-openai in https://github.com/openai/codex/pull/5269
>fix(tui): Update WSL instructions by @dylan-hurd-oai in https://github.com/openai/codex/pull/5307
>Fix flaky auth tests by @gpeal in https://github.com/openai/codex/pull/5461
>fix: fix UI issue when 0 omitted lines by @jif-oai in https://github.com/openai/codex/pull/5451
>Fix IME submissions dropping leading digits by @genki in https://github.com/openai/codex/pull/4359
>fix: approval issue by @jif-oai in https://github.com/openai/codex/pull/5525
>fix: resume lookup for gitignored CODEX_HOME by @tibo-openai in https://github.com/openai/codex/pull/5311
📚 Documentation
>docs(changelog): update install command to @openai/codex@<version> by @truls27a in https://github.com/openai/codex/pull/2073
>docs: add AGENTS.md discovery guide by @tibo-openai in https://github.com/openai/codex/pull/5353
>docs: improve overall documentation by @tibo-openai in https://github.com/openai/codex/pull/5354
>docs: align sandbox defaults, dedupe sections and improve getting started guide by @tibo-openai in https://github.com/openai/codex/pull/5357
>docs: update advanced guide details by @tibo-openai in https://github.com/openai/codex/pull/5395
>docs: clarify responses proxy metadata by @tibo-openai in https://github.com/openai/codex/pull/5406
>docs: clarify prompt metadata behavior by @tibo-openai in https://github.com/openai/codex/pull/5403
>docs: remove stale contribution reference by @tibo-openai in https://github.com/openai/codex/pull/5400
>docs: document exec json events by @tibo-openai in https://github.com/openai/codex/pull/5399
>docs: correct getting-started behaviors by @tibo-openai in https://github.com/openai/codex/pull/5407
>docs: Add `--cask` option to brew command to suggest by @yanskun in https://github.com/openai/codex/pull/5432
>docs: fix agents fallback example by @tibo-openai in https://github.com/openai/codex/pull/5396
📦 Other Changes
>`--add-dir` to add an additional working directory.
>Many MCP improvements:
>stdio servers now use a new client backed by the official [rust MCP sdk](https://github.com/modelcontextprotocol/rust-sdk)
>stdio servers can specify a `cwd`
>All servers can specify `enabled_tools` or `disabled_tools`
>Streamable HTTP servers can specify `scopes` during `codex mcp login`
>Better instruction following for calling tools
>Support graceful agent interruption by @pakrym-oai in https://github.com/openai/codex/pull/5287
>[MCP] Render full MCP errors to the model by @gpeal in https://github.com/openai/codex/pull/5298
>[MCP] When MCP auth expires, prompt the user to log in again. by @gpeal in https://github.com/openai/codex/pull/5300
>Move rust analyzer target dir by @pakrym-oai in https://github.com/openai/codex/pull/5328
>Create independent TurnContexts by @pakrym-oai in https://github.com/openai/codex/pull/5308
>feat: add --add-dir flag for extra writable roots by @tibo-openai in https://github.com/openai/codex/pull/5335
>[MCP] Prefix MCP tools names with `mcp__` by @gpeal in https://github.com/openai/codex/pull/5309
>feat: experimental `codex stdio-to-uds` subcommand by @bolinfest in https://github.com/openai/codex/pull/5350
>Expand approvals integration coverage by @pakrym-oai in https://github.com/openai/codex/pull/5358
>feat: add images support to the Codex Typescript SDK by @needs in https://github.com/openai/codex/pull/5281
>Strip zsh -lc wrapper from TUI command headers by @hxreborn in https://github.com/openai/codex/pull/5374
>Always enable plan tool in exec by @pakrym-oai in https://github.com/openai/codex/pull/5380
>Auto compact at ~90% by @aibrahim-oai in https://github.com/openai/codex/pull/5292
>Generate JSON schema for app-server protocol by @rasmusrygaard in https://github.com/openai/codex/pull/5063
>Use int timestamps for rate limit reset_at by @owenlin0 in https://github.com/openai/codex/pull/5383
>chore: rework tools execution workflow by @jif-oai in https://github.com/openai/codex/pull/5278
>tui: drop citation rendering by @nornagon-openai in https://github.com/openai/codex/pull/4855
>[app-server] read rate limits API by @owenlin0 in https://github.com/openai/codex/pull/5302
>Reduce symbol size for tests by @pakrym-oai in https://github.com/openai/codex/pull/5389
>[MCP] Add configuration options to enable or disable specific tools by @gpeal in https://github.com/openai/codex/pull/5367
>Treat `zsh -lc` like `bash -lc` by @gpeal in https://github.com/openai/codex/pull/5411
>[MCP] Dedicated error message for GitHub MCPs missing a personal access token by @gpeal in https://github.com/openai/codex/pull/5393
>feat: include cwd in notify payload by @tibo-openai in https://github.com/openai/codex/pull/5415
>[MCP] Bump rmcp to 0.8.2 by @gpeal in https://github.com/openai/codex/pull/5423
>Pass TurnContext around instead of sub_id by @pakrym-oai in https://github.com/openai/codex/pull/5421
>chore: drop env var flag by @jif-oai in https://github.com/openai/codex/pull/5462
>Enable plan tool by default by @pakrym-oai in https://github.com/openai/codex/pull/5384
>feat: emit events for unified_exec by @jif-oai in https://github.com/openai/codex/pull/5448
>[app-server] model/list API by @owenlin0 in https://github.com/openai/codex/pull/5382
>[otel] init otel for app-server by @apanasenko-oai in https://github.com/openai/codex/pull/5469
>feat: add experimental_bearer_token option to model provider definition by @bolinfest in https://github.com/openai/codex/pull/5467
>Log HTTP Version by @pakrym-oai in https://github.com/openai/codex/pull/5475
>feat: add text cleared with ctrl+c to the history so it can be recovered with up arrow by @JaviSoto in https://github.com/openai/codex/pull/5470
>chore: align unified_exec by @jif-oai in https://github.com/openai/codex/pull/5442
>feat: local tokenizer by @jif-oai in https://github.com/openai/codex/pull/5508
>chore: drop approve all by @jif-oai in https://github.com/openai/codex/pull/5503
>[MCP] Add support for specifying scopes for MCP oauth by @gpeal in https://github.com/openai/codex/pull/5487
>chore: clean spec tests by @jif-oai in https://github.com/openai/codex/pull/5517
>[MCP] Remove the legacy stdio client in favor of rmcp by @gpeal in https://github.com/openai/codex/pull/5529
>Move changing turn input functionalities to `ConversationHistory` by @aibrahim-oai in https://github.com/openai/codex/pull/5473
>[app-server] send account/rateLimits/updated notifications by @owenlin0 in https://github.com/openai/codex/pull/5477
>[app-server] add new account method API stubs by @owenlin0 in https://github.com/openai/codex/pull/5527
>chore: clean `handle_container_exec_with_params` by @jif-oai in https://github.com/openai/codex/pull/5516
>tui: show aggregated output in display by @nornagon-openai in https://github.com/openai/codex/pull/5539
>Handle cancelling/aborting while processing a turn by @aibrahim-oai in https://github.com/openai/codex/pull/5543
>chore: testing on apply_path by @jif-oai in https://github.com/openai/codex/pull/5557
>feat: use actual tokenizer for unified_exec truncation by @jif-oai in https://github.com/openai/codex/pull/5514
>feat: end events on unified exec by @jif-oai in https://github.com/openai/codex/pull/5551
>@Mic92 made their first contribution in https://github.com/openai/codex/pull/4048
>@lopopolo-openai made their first contribution in https://github.com/openai/codex/pull/5301
>@MomentDerek made their first contribution in https://github.com/openai/codex/pull/4921
>@truls27a made their first contribution in https://github.com/openai/codex/pull/2073
>@needs made their first contribution in https://github.com/openai/codex/pull/5281
>@hxreborn made their first contribution in https://github.com/openai/codex/pull/5374
>@owenlin0 made their first contribution in https://github.com/openai/codex/pull/5383
>@yanskun made their first contribution in https://github.com/openai/codex/pull/5432
>@genki made their first contribution in https://github.com/openai/codex/pull/4359