Codex CLI OpenAI · CLI
Codex CLI 0.147.0-alpha.6 0.147.0-alpha.4 → 0.147.0-alpha.6 · August 3, 2026 at 10:17 PM UTC
Alpha release with a new --approve-for-me approval mode, plugin search and thread-section APIs, plus TUI keymap chords and exec-server hardening.
[new] Added --approve-for-me to route approval requests through automatic review under the workspace-write sandbox. Available on the main CLI and on exec, resume, fork, archive, delete, and unarchive (shell completions updated).
[new] Plugin search support in the app-server / plugins path, including remote search handling.
[new] Thread sections: create, update, and delete APIs for organizing thread content.
[new] TUI keymap chords for multi-key bindings.
[new] Client messaging events (Ack, ClientMessage, ClientMessageChunk) for richer bidirectional client communication.
[changed] Request-user-input tooling reworked onto updated wire/tool argument shapes (previous dedicated handler/spec path removed).
[changed] Token usage and rate-limit reporting expanded (richer usage profiles, daily buckets, and credits reset details).
[changed] Realtime thread start parameters and account-login notifications carry additional fields.
[changed] MCP server config model extended (including migration helpers and broader raw server config).
[fixed] Corrected misspelled environment variables: CODEX_EXEC_SERVER_EXIT_ON_STDIN_CLOSE and CODEX_MCP_PROTOC (previous …CLOSEC / …PROTOCC names dropped).
[changed] CI/workspace proxy configuration now uses the CODEX_CIWS family (CODEX_CIWS_PROXY); the older CODEX_CI name is removed.
Under the hood
Exec-server gains clearer request dispatch and noise-relay message framing, improving how framed traffic is handled on the wire.
Shared git process helpers land in git-utils for more consistent subprocess handling.
Thread-section state is wired through app-server, runtime state, and local thread-store layers.
Collaboration lifecycle signaling includes collab_waiting_end.
Hook configuration moves toward an agent-hooks handler model; in-memory thread-store option is dropped in favor of the local store path.
Dependencies include wildmatch and color_quant for matching and image-related support paths.
Internal cleanup removes unused apply-patch and JSONL event-processor modules in favor of current code paths.
Upgrade notes
If you relied on CODEX_EXEC_SERVER_EXIT_ON_STDIN_CLOSEC or CODEX_MCP_PROTOCC, switch to CODEX_EXEC_SERVER_EXIT_ON_STDIN_CLOSE and CODEX_MCP_PROTOC.
Replace any CODEX_CI usage with the CODEX_CIWS / CODEX_CIWS_PROXY configuration.
--approve-for-me is mutually exclusive with the usual sandbox / ask-for-approval / full bypass flags—pick one approval posture per invocation.
Integrations that spoke the old request-user-input payload shapes should adopt the updated wire/tool argument types.
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.
33 listed · 34 in tree · 18 under docs/
Older release ← 0.147.0-alpha.4 Newer release → 0.147.0-alpha.7