• Tech Dev NotesTech Dev Notes
Apps
  • Lookup
  • Compare
Market movement
  • Charts
  • Rankings
Visual proof
  • Screens
  • Store listings
  • Icons
Stacks and releases
  • Tech stacks
  • Tool releases
  • Developers
More
  • X feature flags
  • Grokipedia
  • Grok companions
  • Blog
  • Follow on X
Skip to content

© 2026 Tech Dev Notes

RSSAboutAPIPrivacyTermsSitemap@techdevnotes
Codex CLI

OpenAI · CLI

Codex CLI 0.146.0-alpha.1

0.145.0→0.146.0-alpha.1·July 22, 2026 at 6:17 AM UTC

0.146.0-alpha.1 is the first alpha toward 0.146 — mainly internal groundwork for the HTTP client, MCP connections, and thread history, with early support for broader config requirements, TUI chrome options, and the o1 model id.

Changelog

  • [new] Recognizes the o1 model identifier.
  • [new] Optional rounded TUI chrome via CODEX_TUI_ROUNDED.
  • [changed] Configuration requirements cover a wider set of managed settings (including hooks, Windows-related requirements, and shell environment policy).
  • [changed] Local thread history gains segment paging, with richer thread resume parameters and rollout lineage tracking.
  • [changed] MCP connection management can handle required servers, tool catalogs, and binding clients more explicitly.
  • [changed] External-agent config detect/import and session migration paths carry additional context.
  • [changed] Remote network proxy configuration accepts a fuller set of options.
  • [new] Emits collab_waiting_end when a collaboration wait finishes.
  • [removed] CODEX_PERMISSION_PROFILE is no longer a supported environment knob.

Under the hood

  • HTTP stack reworked around an explicit client builder and route-aware client pool (replacing the previous default-client path), including shared use from plugin startup sync.
  • Rollout reference indexing landed to make rollout lookups more direct.
  • Skills path includes work on dynamic skill selection (lexical RRF-style ranking).
  • TUI adds a dedicated thread-events path and token-chart palette support.
  • Filesystem sandbox / exec path shapes and several tool/approval payloads were tightened (including patch approval and user-input tool responses).
  • Protocol cleanup: assorted client-message ack events and older payload variants dropped or renamed; OTEL exporter kinds and web-search action variants adjusted.
  • Dependency trim: wildmatch removed; exec-server noise-channel code path removed.

Upgrade notes

  • This is an alpha build (channel: alpha). Prefer stable 0.145.0 unless you intend to test upcoming 0.146 work.
  • Drop any use of CODEX_PERMISSION_PROFILE; configure permissions through supported config surfaces instead.
  • Expect further churn in MCP connection setup, config-requirements shape, and thread resume/history APIs before the stable 0.146 release.

content/

Browse captured content/

Same tree as codex-cli/latest/content for this version. Open the full browser for sidebar navigation between docs and other files.

Open content/ browser →

33 listed · 34 in tree · 18 under docs/

content/ browserNavigate docs, prompts, and root filesFolder index plus per-file pages with prev/next and a full file sidebar.
README.mdDocs2.7 KBCHANGELOG.mdDocs93 BAGENTS.mdDocs22 KBconfig.mdDocs351 Bdocs/agents_md.mdDocs126 Bdocs/authentication.mdDocs134 Bdocs/CLA.mdDocs2 KBdocs/codex-rs/bazel.mdDocs7.4 KBdocs/codex-rs/codex_mcp_interface.mdDocs6.8 KBdocs/codex-rs/protocol_v1.mdDocs9.5 KBdocs/config.mdDocs726 Bdocs/contributing.mdDocs6.2 KBView all 33 files in content/ browser →
Older release← 0.145.0Newer release→ 0.146.0-alpha.2
All Codex CLI releases →