0.48.0

Highlights

• --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
  • 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
  • Improved startup error messages
  • Better instruction following for calling tools
• Configuration options for forced_login_method and forced_chatgpt_workspace_id which can be paired with managed configs to give enterprises more control over Codex usage.

Full list of merged PRs:

• Support graceful agent interruption by @pakrym-oai in https://github.com/openai/codex/pull/5287
• Fix nix build by @Mic92 in https://github.com/openai/codex/pull/4048
• [MCP] Render full MCP errors to the model by @gpeal in https://github.com/openai/codex/pull/5298
• Fix link to MCP Servers config section by @lopopolo-openai in https://github.com/openai/codex/pull/5301
• [MCP] When MCP auth expires, prompt the user to log in again. by @gpeal in https://github.com/openai/codex/pull/5300
• 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
• docs(changelog): update install command to @openai/codex@ by @truls27a in https://github.com/openai/codex/pull/2073
• 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
• 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
• 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
• 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
• docs: align sandbox defaults, dedupe sections and improve getting started guide by @tibo-openai in https://github.com/openai/codex/pull/5357
• [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
• Add forced_chatgpt_workspace_id and forced_login_method configuration options by @gpeal in https://github.com/openai/codex/pull/5303
• 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
• Update Homebrew install instructions to use cask by @shijie-oai in https://github.com/openai/codex/pull/5377
• 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
• fix: warn when --add-dir would be ignored by @tibo-openai in https://github.com/openai/codex/pull/5351
• 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
• Add ItemStarted/ItemCompleted events for UserInputItem by @pakrym-oai in https://github.com/openai/codex/pull/5306
• 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
• fix terminal corruption that could happen when onboarding and update banner by @nornagon-openai in https://github.com/openai/codex/pull/5269
• Reduce symbol size for tests by @pakrym-oai in https://github.com/openai/codex/pull/5389
• 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
• [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
• 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
• [MCP] Dedicated error message for GitHub MCPs missing a personal access token by @gpeal in https://github.com/openai/codex/pull/5393
• chore(ci): Speed up macOS builds by using larger runner by @JaviSoto in https://github.com/openai/codex/pull/5234
• feat: include cwd in notify payload by @tibo-openai in https://github.com/openai/codex/pull/5415
• fix(tui): Update WSL instructions by @dylan-hurd-oai in https://github.com/openai/codex/pull/5307
• [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
• Fix flaky auth tests by @gpeal in https://github.com/openai/codex/pull/5461
• 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
• fix: fix UI issue when 0 omitted lines by @jif-oai in https://github.com/openai/codex/pull/5451
• [app-server] model/list API by @owenlin0 in https://github.com/openai/codex/pull/5382
• Add a baseline test for resume initial messages by @pakrym-oai in https://github.com/openai/codex/pull/5466
• [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
• docs: Add --cask option to brew command to suggest by @yanskun in https://github.com/openai/codex/pull/5432
• 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
• Add new thread items and rewire event parsing to use them by @pakrym-oai in https://github.com/openai/codex/pull/5418
• chore: clean spec tests by @jif-oai in https://github.com/openai/codex/pull/5517
• docs: fix agents fallback example by @tibo-openai in https://github.com/openai/codex/pull/5396
• [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
• Fix IME submissions dropping leading digits by @genki in https://github.com/openai/codex/pull/4359
• [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
• fix: approval issue by @jif-oai in https://github.com/openai/codex/pull/5525
• 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
• fix: resume lookup for gitignored CODEX_HOME by @tibo-openai in https://github.com/openai/codex/pull/5311
• feat: end events on unified exec by @jif-oai in https://github.com/openai/codex/pull/5551

New Contributors

• @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

Full Changelog: https://github.com/openai/codex/compare/rust-v0.47.0...rust-v0.48.0