• 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
ChartsRankingsMoversCompareLookupScreensTech stacksReleases

© 2026 Tech Dev Notes

RSSAboutAPIPrivacyTermsSitemap@techdevnotes
Codex CLI

OpenAI · CLI

Codex CLI 0.148.0-alpha.4

0.148.0-alpha.2→0.148.0-alpha.4·August 8, 2026 at 2:17 AM UTC

Alpha prerelease (0.148.0-alpha.2 → 0.148.0-alpha.4): skills support is reworked and folded into the main skills/config paths, a diagnostics subsystem lands, and the o1 model id is added, plus env-var and config cleanups.

Changelog

  • [changed] Skills support is reworked: the separate core-skills crate is removed and skill loading, host merge, host prompts/outcomes, and skills config now live under the shared skills and config codepaths.
  • [new] A diagnostics subsystem is included for server/client diagnostic requests and related tooling.
  • [new] o1 is available as a model identifier.
  • [new] RMCP client support for an event-notification transport.
  • [changed] Config requirements and lockfile schema are expanded (including auto-review requirements, base-instruction metadata, and richer model defaults).
  • [new] Additional thread list/load response payloads and account token-usage daily buckets for history and usage surfaces.
  • [new] Plugin-related metadata for hook summaries, share principals, and remote plugin pagination.
  • [new] Guardian warning notifications and external-agent config migration items in the data model.
  • [changed] TUI/input handling gains a delete_to_line_end event; repository failure is surfaced as its own notification.
  • [removed] CODEX_PERMISSION_PROFILE is no longer recognized.
  • [changed] Cloud-tasks and exec-server env knobs are renamed for clarity/correctness: CODEX_CLOUD_TASKS_FORCE_INTERNALSOCKS5 replaces CODEX_CLOUD_TASKS_FORCE_INTERNAL, and CODEX_EXEC_SERVER_EXIT_ON_STDIN_CLOSE replaces the misspelled CODEX_EXEC_SERVER_EXIT_ON_STDIN_CLOSEC.

Under the hood

  • Workspace layout drops core-skills and adds diagnostics; skills host-merge/prompt/outcome modules and config skills settings replace the old injection/loader stack.
  • Exec path no longer carries the JSONL event processor or the exec-server relay proto stubs; TUI turn runtime code is trimmed accordingly.
  • Hook handler configuration distinguishes agent-hooks vs prompt handlers more clearly; several internal request/error and marketplace source enums are tightened.
  • Dependency and version locks are bumped for 0.148.0-alpha.4.

Upgrade notes

  • If you relied on CODEX_PERMISSION_PROFILE, remove or replace that configuration; it is no longer read.
  • Rename any use of CODEX_CLOUD_TASKS_FORCE_INTERNAL to CODEX_CLOUD_TASKS_FORCE_INTERNALSOCKS5, and CODEX_EXEC_SERVER_EXIT_ON_STDIN_CLOSEC to CODEX_EXEC_SERVER_EXIT_ON_STDIN_CLOSE.
  • Custom integrations that parsed the old core-skills layout or the previous config-requirements shape should follow the new skills/config types (field sets have grown and a few legacy requirement stubs were dropped).

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.mdDocs3.3 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.148.0-alpha.2Newer release→ 0.148.0-alpha.5
All Codex CLI releases →