Build Notes
Codex CLI 0.170.0: Windows Fixes, Safer Permissions and Clearer Search
Codex CLI 0.170.0, announced on November 18, 2026, includes fixes for Windows writes, sandbox restrictions and task search. It also improves recovery after connection loss. For existing terminal users, these reliability changes are a practical reason to review the release.
What changes in everyday use?
- Windows: fixes cover replacing files, preserving permissions during repeated sandbox setup and recovering runtime registration.
- Permissions: updates address cases where permission changes or child threads could lose existing sandbox restrictions.
- Search: overlapping roots no longer produce duplicate file results, and thread-search snippets handle queries containing whitespace.
- Connections: oversized WebSocket requests can fall back to HTTP without unnecessary retries. Cloud conversation reconnection and preservation of active recovery turns also improve.
The release further addresses MCP OAuth credential races. It lists WebRTC negotiation for realtime TUI voice calls and refreshed authentication headers for OpenTelemetry HTTP exporters. Same-named MCP servers across environments remain experimental. The voice negotiation entry alone does not establish a universally available voice interface or an activation command.
Update an npm installation
Use your existing installation method. For an npm-managed installation, OpenAI’s release page specifies:
npm install -g @openai/codex@0.170.0
Run it from your normal terminal with Node.js and npm available. After installation, open Codex from a project you are authorized to use. The startup banner should identify the expected version; an older banner can indicate that another installation is earlier on your command path. Check that before assuming the update failed.
Keep the project’s existing permission rules when evaluating the release. A reliability fix is not a reason to grant broader access.
A small search check
Our 0.169.0 task-search walkthrough shows the existing command-center interface. In your current task-search UI, look for a known task using a multiword phrase from its content. Inspect the matching snippet for understandable context. This is a suggested check for the whitespace fix, not a new search shortcut.
For example, an existing demonstration conversation might contain this prompt:
Explain quoted commas and blank CSV rows.
Do not read or change files.
Searching a distinctive phrase such as blank CSV rows gives you a concrete snippet to inspect, provided that conversation is included in the search scope. No match alone does not prove a regression: first check scope and whether the task actually contains the phrase.
Check a real task after updating
On the next ordinary coding task, inspect the resulting diff and run the relevant project checks. If you previously encountered a Windows replacement or reconnection failure, compare the same workflow and record the error and installed version. Do not deliberately interrupt important work to demonstrate recovery.
Testing scope: this is a documentation-based release guide. We have not reproduced the listed failures or verified their fixes in 0.170.0, and the example above is not a recorded test result.
Official sources: November 18 changelog, 0.170.0 release notes, and CLI installation documentation. The GitHub release was published at 03:40:48 UTC on November 18, 2026. Desktop app builds have their own numbering and release dates.
See Codex Update history for linked announcements and our desktop chat recovery guide for the separate app changes.