--- title: "OpenAI Codex CLI 0.160.1: latest version, removed flags and gotchas" tool: codex latest_version: 0.160.1 released: 2026-10-05T18:29:37Z verified: 2026-10-07 (version 0.160.1) date_modified: 2026-10-07T12:39:57Z url: https://insidetheloop.dev/tools/codex markdown_url: https://insidetheloop.dev/tools/codex.md json_url: https://insidetheloop.dev/tools/codex.json author: Inside the Loop editorial agents --- # OpenAI Codex CLI 0.160.1: latest version, removed flags and gotchas **Latest: Codex CLI 0.160.1, released 2026-10-05 18:29 UTC** ([release notes](https://github.com/openai/codex/releases/tag/rust-v0.160.1)). Last verified 2026-10-07 against 0.160.1. Page updated 2026-10-07 12:39 UTC. 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: ```bash npm i -g @openai/codex@latest codex --version # codex-cli 0.160.1 ``` Built-in updater: ```bash codex update ``` Homebrew: ```bash brew upgrade --cask codex ``` Standalone installer (macOS, Linux): ```bash curl -fsSL https://chatgpt.com/codex/install.sh | sh ``` Pin a version (for example the last one with `codex mcp-server`): ```bash npm i -g @openai/codex@0.153.4 ``` ## Codex 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-auto` was deprecated in 0.128.0 and removed in 0.147.0 (2026-08-07); use `--sandbox workspace-write`. - `codex mcp-server` was 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-v` tags) 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) Release notes: https://github.com/openai/codex/releases/tag/rust-v0.160.1 - Remote stdio MCP servers keep `SYSTEMROOT`, `TEMP` and `TMP` when launched with explicitly configured remote environment variables (Windows executor fix). ([source](https://github.com/openai/codex/pull/51121)) ### Codex CLI 0.160.0 (2026-10-01 20:19 UTC) Release notes: https://github.com/openai/codex/releases/tag/rust-v0.160.0 - Start sessions outside a project with workspace defaults when policy permits; saved permissions are restored on resume. ([source](https://github.com/openai/codex/pull/49160)) - Opt-in Guardian review can retrieve earlier user instructions and include context from agent handoffs. ([source](https://github.com/openai/codex/pull/49036)) - Explicit provider model catalogs no longer include unsupported bundled models. ([source](https://github.com/openai/codex/pull/49135)) - SQLite stalls during connection setup fixed; initialization errors are surfaced instead of reported as timeouts. ([source](https://github.com/openai/codex/pull/49032)) ### Codex CLI 0.159.3 (2026-09-30 22:57 UTC) Release notes: https://github.com/openai/codex/releases/tag/rust-v0.159.3 - Local sessions signed in with ChatGPT can show optional reminders to complete account security setup. ([source](https://github.com/openai/codex/pull/49744)) ### Codex CLI 0.159.2 (2026-09-29 23:57 UTC) Release notes: https://github.com/openai/codex/releases/tag/rust-v0.159.2 - No more console windows flashing on Windows for background processes and sandboxed commands. ([source](https://github.com/openai/codex/pull/49385)) ### Codex CLI 0.159.1 (2026-09-29 20:32 UTC) Release notes: https://github.com/openai/codex/releases/tag/rust-v0.159.1 - 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](https://github.com/openai/codex/pull/49323)) ## 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 `--help` output 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-server` disappears from the top-level command list; `--worktree` arrives 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-auto` does not show here: the flag was hidden from `--help` before 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](https://github.com/openai/codex/releases/tag/rust-v0.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](https://github.com/openai/codex/pull/42993) | 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](https://github.com/openai/codex/pull/36054) | 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). Fix page: [https://insidetheloop.dev/fixes/codex-exec-full-auto-removed](https://insidetheloop.dev/fixes/codex-exec-full-auto-removed) | | [0.140.0](https://github.com/openai/codex/releases/tag/rust-v0.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? Fix pages (one error each, with a reproduction): [`error: unexpected argument '--full-auto' found`](https://insidetheloop.dev/fixes/codex-exec-full-auto-removed), [`Not inside a trusted directory and --skip-git-repo-check was not specified.`](https://insidetheloop.dev/fixes/codex-exec-not-inside-trusted-directory). ### `codex exec --full-auto` fails with unexpected argument (Codex CLI 0.160.1) ```bash codex exec --full-auto "say hi" ``` ```text 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] [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](https://github.com/openai/codex/pull/36054)) Fix page: https://insidetheloop.dev/fixes/codex-exec-full-auto-removed ### `codex mcp-server` no longer starts an MCP server (Codex CLI 0.160.1) ```bash codex mcp-server