Skip to content
  • 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
ChartsRankingsMoversCompareLookupScreensTech stacksReleases

© 2026 Tech Dev Notes

RSSAboutAPIStatusSecurityPrivacyTermsSitemap@techdevnotes
Codex CLI

OpenAI · CLI

Codex CLI 0.157.0-alpha.3

0.157.0-alpha.2→0.157.0-alpha.3·September 22, 2026 at 2:17 AM UTC

Alpha pre-release (0.157.0-alpha.3) with refinements to code-mode waits, agent/plugin tooling, config surfaces, and client event streaming.

Changelog

  • [changed] Code-mode wait handling is reworked around an explicit wait spec instead of the previous wait-args shape.
  • [new] Agent list and register flows gain typed request/response support (list args and a register response).
  • [new] Follow-up task arguments are modeled for multi-step task continuation.
  • [new] Recommended plugin install arguments are available for guided plugin setup.
  • [new] API key turn-cost responses are represented in the data model for cost reporting.
  • [changed] Auto-review and config-requirements TOML layouts are expanded with additional fields.
  • [changed] Thread item entries carry a richer set of fields.
  • [new] Client message chunk events support streamed client message delivery (replacing the prior ack-style client event).
  • [new] A mitm_hook_denied notification surfaces when a MITM hook blocks an action.
  • [changed] Response stream disconnect errors are clarified (stream disconnected vs. a generic connection failure).
  • [new] Amazon Bedrock login can use access-key parameters alongside existing auth paths.
  • [changed] MCP handshake rejection can report no compatible protocol version; MCP protocol version env handling is updated.
  • [changed] Session identity env handling is tightened around CODEX_SESSION_ID.
  • [new] A secrets request payload supports structured secret retrieval.
  • [changed] WSL worktree path payloads better express include/glob-style worktree paths.
  • [changed] Dynamic tool output can include input-audio content items; filesystem path enums distinguish glob patterns and project-roots special paths more clearly.
  • [changed] Hook configuration recognizes Agent and MCP-tool handlers more cleanly.
  • [changed] Tool-call summaries can represent wait-agent work; permissions snapshots expose a current snapshot variant.
  • [removed] Older argument-info, request-user-input tool args, and several superseded enum variants/payloads from the prior alpha are dropped.

Under the hood

  • Code-mode protocol description bits were removed in favor of the newer wait-spec and related tool wiring.
  • Default config and related internal payloads were added to support the expanded requirements and review config surfaces.
  • Process identity handling for Linux and macOS remote-control connection states was cleaned up.
  • Credential output distinguishes STS authorization more explicitly.
  • Trace/event payloads adjust inference-started and related tool-trace response shapes.
  • Dependency hygiene: color_quant is no longer pulled in.
  • Workspace lockfile and version metadata bump to 0.157.0-alpha.3.

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 →

31 listed · 32 in tree · 17 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.mdDocs21.9 KBconfig.mdDocs351 Bdocs/agents_md.mdDocs126 Bdocs/authentication.mdDocs134 Bdocs/CLA.mdDocs2 KBdocs/codex-rs/bazel.mdDocs7.4 KBdocs/codex-rs/protocol_v1.mdDocs9.2 KBdocs/config.mdDocs726 Bdocs/contributing.mdDocs2.6 KBdocs/example-config.mdDocs134 BView all 31 files in content/ browser →
Older release← 0.157.0-alpha.2Newer release→ 0.157.0-alpha.4
All Codex CLI releases →