Tool pages / Codex CLI
OpenAI Codex CLI 0.160.1: latest version, removed flags and gotchas
Latest: Codex CLI 0.160.1, released (release notes).
The latest OpenAI Codex CLI (codex, npm @openai/codex) is 0.160.1, released 2026-10-05 18:29 UTC. Upgrade with npm i -g @openai/codex@latest, codex update or Homebrew. Its command-line surface is identical to 0.159.3 in our sandbox diff. The removals agents still trip on are older: codex exec --full-auto (gone in 0.147.0) and codex mcp-server (gone in 0.154.0).
How do I install or upgrade to Codex CLI 0.160.1?
npm:
npm i -g @openai/codex@latest
codex --version # codex-cli 0.160.1Built-in updater:
codex updateHomebrew:
brew upgrade --cask codexStandalone installer (macOS, Linux):
curl -fsSL https://chatgpt.com/codex/install.sh | shPin a version (for example the last one with `codex mcp-server`):
npm i -g @openai/codex@0.153.4Codex CLI key facts
- Latest release: 0.160.1 on 2026-10-05 18:29 UTC (GitHub tag
rust-v0.160.1; npm publish 18:33 UTC). Previous release: 0.160.0 on 2026-10-01 20:19 UTC. - 0.159.3 and 0.160.1 have the same 72 help pages, byte for byte, in our sandbox capture: no command or flag changed.
codex exec --full-autowas deprecated in 0.128.0 and removed in 0.147.0 (2026-08-07); use--sandbox workspace-write.codex mcp-serverwas removed in 0.154.0 (2026-09-09); 0.153.4 is the last version that has it.- OpenAI shipped 19 stable Codex CLI releases (
rust-vtags) in September 2026. - Apache-2.0 licence; 128,141 GitHub stars on 2026-10-07.
What changed in the last 5 Codex CLI releases?
Codex CLI 0.160.1 (2026-10-05 18:29 UTC)
- Remote stdio MCP servers keep
SYSTEMROOT,TEMPandTMPwhen launched with explicitly configured remote environment variables (Windows executor fix). (source)
Codex CLI 0.160.0 (2026-10-01 20:19 UTC)
- Start sessions outside a project with workspace defaults when policy permits; saved permissions are restored on resume. (source)
- Opt-in Guardian review can retrieve earlier user instructions and include context from agent handoffs. (source)
- Explicit provider model catalogs no longer include unsupported bundled models. (source)
- SQLite stalls during connection setup fixed; initialization errors are surfaced instead of reported as timeouts. (source)
Codex CLI 0.159.3 (2026-09-30 22:57 UTC)
- Local sessions signed in with ChatGPT can show optional reminders to complete account security setup. (source)
Codex CLI 0.159.2 (2026-09-29 23:57 UTC)
- No more console windows flashing on Windows for background processes and sandboxed commands. (source)
Codex CLI 0.159.1 (2026-09-29 20:32 UTC)
- GPT-6.1 Sol is the default model in the bundled catalog and the Amazon Bedrock catalogs (our 0.160.1 sandbox run printed
model: gpt-6.1-sol). (source)
Which Codex CLI commands and flags were added or removed?
Codex CLI 0.159.3 → 0.160.1
0 commands added, 0 removed, 0 commands with flags added or removed; 0 help pages changed in any way.
Method: bin/tool-snapshot ran --help for every codex subcommand of both versions in a throwaway Linux sandbox (72 and 72 help pages), then bin/tool-diff compared them. Hidden flags do not appear in --help.
- These are the last two minor versions (latest patch of each). Their
--helpoutput is identical, so 0.160.x changed behaviour, not the command line.
Codex CLI 0.153.4 → 0.154.0
0 commands added, 1 removed, 13 commands with flags added or removed; 13 help pages changed in any way.
Method: bin/tool-snapshot ran --help for every codex subcommand of both versions in a throwaway Linux sandbox (72 and 71 help pages), then bin/tool-diff compared them. Hidden flags do not appear in --help.
Commands removed:
codex mcp-server
| Command | Flags added | Flags removed |
|---|---|---|
codex | --worktree | none |
codex archive | --worktree | none |
codex delete | --worktree | none |
codex exec | --worktree | none |
codex exec fork | --worktree | none |
codex exec resume | --worktree | none |
codex exec review | --worktree | none |
codex exec-server | --aws-profile--aws-region--aws-service--aws-sigv4--remote-transport | none |
codex exec-server forward | --aws-profile--aws-region--aws-service--aws-sigv4--remote-transport | none |
codex fork | --worktree | none |
codex queue | --worktree | none |
codex resume | --worktree | none |
codex unarchive | --worktree | none |
codex mcp-serverdisappears from the top-level command list;--worktreearrives on 12 commands.
Codex CLI 0.146.1 → 0.147.0
0 commands added, 0 removed, 8 commands with flags added or removed; 31 help pages changed in any way.
Method: bin/tool-snapshot ran --help for every codex subcommand of both versions in a throwaway Linux sandbox (67 and 67 help pages), then bin/tool-diff compared them. Hidden flags do not appear in --help.
| Command | Flags added | Flags removed |
|---|---|---|
codex | --approve-for-me | none |
codex archive | --approve-for-me | none |
codex delete | --approve-for-me | none |
codex exec | --approve-for-me | none |
codex exec-server | --concurrent-requests--exit-on-stdin-close | none |
codex fork | --approve-for-me | none |
codex resume | --approve-for-me | none |
codex unarchive | --approve-for-me | none |
- The removal of
codex exec --full-autodoes not show here: the flag was hidden from--helpbefore it was removed. See the gotcha below for the error it now produces.
What breaks when upgrading Codex CLI, and how do I migrate?
| Version | Change | Migration |
|---|---|---|
| 0.159.0 | Removed automatic follow-up prompt suggestions and the tui.prompt_suggestions setting; removed the bundled plugin-creator skill. | Delete tui.prompt_suggestions from ~/.codex/config.toml; install the plugin-creator skill separately if you used it. |
| 0.154.0 | The deprecated codex mcp-server entry point (Codex as a stdio MCP server) and the codex-mcp-server crate were removed. | No replacement is named in the release notes or PR #42993. Pin @openai/codex@0.153.4 if an MCP client still launches codex mcp-server. |
| 0.147.0 | Removed the hidden, deprecated codex exec --full-auto flag and its implicit mapping to the workspace-write sandbox. | codex exec --full-auto → codex exec --sandbox workspace-write. 0.147.0 also added --approve-for-me (automatic review of approval requests). |
| 0.140.0 | Removed the experimental /realtime voice controls from the TUI. | Voice came back as /voice (experimental in 0.155.0, on by default with an F8 toggle in 0.156.0). |
What Codex CLI errors did we reproduce, and how do I fix them?
`codex exec --full-auto` fails with unexpected argument (Codex CLI 0.160.1)
codex exec --full-auto "say hi"error: unexpected argument '--full-auto' found
tip: to pass '--full-auto' as a value, use '-- --full-auto'
Usage: codex exec [OPTIONS] [PROMPT]
codex exec [OPTIONS] <COMMAND> [ARGS]
For more information, try '--help'.
# exit 2. In 0.146.1 the same command printed: warning: `--full-auto` is deprecated; use `--sandbox workspace-write` instead.Fix: Use codex exec --sandbox workspace-write "...". The flag was hidden from --help, so a help diff cannot show its removal; only running it does. (source)
`codex mcp-server` no longer starts an MCP server (Codex CLI 0.160.1)
codex mcp-server </dev/nullError: stdin is not a terminal
# exit 1Fix: The subcommand was removed in 0.154.0; with no subcommand of that name, our run ended in the interactive UI's terminal check instead of an unknown-command error. Pin @openai/codex@0.153.4 for MCP clients that still spawn codex mcp-server. (source)
`codex exec` refuses to run outside a Git repository (Codex CLI 0.160.1)
cd /tmp && codex exec --sandbox workspace-write "say hi"Reading additional input from stdin...
Not inside a trusted directory and --skip-git-repo-check was not specified.
# exit 1Fix: Run inside a Git repository or a trusted directory, or add --skip-git-repo-check. Reading additional input from stdin... appears whenever stdin is not a terminal; pass </dev/null in scripts. (source)
Linux sandbox warns that bubblewrap is missing (Codex CLI 0.160.1)
codex exec --skip-git-repo-check --sandbox workspace-write "say hi" # Debian 13 containerwarning: Codex could not find bubblewrap on PATH. Install bubblewrap with your OS package manager. See the sandbox prerequisites: https://developers.openai.com/codex/concepts/sandboxing#prerequisites. Codex will use the bundled bubblewrap in the meantime.Fix: apt-get install bubblewrap (or your distribution's package) before running Codex on Linux; the bundled copy is a fallback. (source)
Codex CLI release history by month
2026-10: 0.160.0 to 0.160.1 (2 releases to 2026-10-07)
- 0.160.0: projectless sessions with workspace defaults; Guardian review context. (source)
2026-09: 0.152.0 to 0.159.3 (19 releases)
- 0.154.0 (2026-09-09) removed
codex mcp-serverand added experimental--worktreesessions. (source) - 0.157.0 added GPT-6 Sol and Luna; 0.159.1 made GPT-6.1 Sol the bundled default. (source)
- 0.156.0 added
/tuifullscreen UI, voice by default and--no-daemon; 0.159.0 removedtui.prompt_suggestions. (source)
2026-08: 0.146.1 to 0.151.0 (8 releases)
2026-07: 0.142.5 to 0.146.0 (11 releases)
2026-06: 0.136.0 to 0.142.4 (11 releases)
- 0.136.0 added
codex archiveandcodex unarchive; 0.140.0 addedcodex deleteand removed/realtime. (source)
2026-05: 0.129.0 to 0.135.0 (7 releases)
- 0.129.0 added Vim editing in the composer; 0.132.0 let
codex exec resumetake--output-schema. (source)
Sources
- openai/codex releases (GitHub API) (read 2026-10-07)
- @openai/codex on the npm registry (read 2026-10-07)
- Codex CLI 0.160.1 release notes (read 2026-10-07)
- Codex CLI 0.160.0 release notes (read 2026-10-07)
- Codex CLI 0.159.0 release notes (read 2026-10-07)
- Codex CLI 0.154.0 release notes (read 2026-10-07)
- Codex CLI 0.147.0 release notes (read 2026-10-07)
- Codex CLI 0.128.0 release notes (`--full-auto` deprecated) (read 2026-10-07)
- PR #42993: remove the deprecated codex mcp-server command (read 2026-10-07)
- PR #36054: remove legacy --full-auto handling from codex exec (read 2026-10-07)
- Codex README at rust-v0.160.1 (install methods) (read 2026-10-07)
- openai/codex repository (stars, licence) (read 2026-10-07)
Last verified: 2026-10-07.