Build Notes
Codex CLI 0.171.0: How to Use the Default Terminal Workspace
Codex CLI 0.171.0 enabled the terminal workspace by default. OpenAI published the release on November 20, 2026 at 00:44:47 UTC. The workspace can show searchable documents, supported images and subagent transcripts alongside the main conversation. This helps when you want to check a source without losing your place in the task.
Update and open your project
If you installed Codex through npm, use the release’s versioned command from a terminal with Node.js and npm available. For a different installation method, follow the official CLI installation guide.
npm install -g @openai/codex@0.171.0
codex --version
Open an interactive codex session in a project you can access. The workspace is on by default in this release. If the version check shows an older build, check which installation your terminal is launching. If the workspace is missing, check whether your configuration disables it.
Read a document beside the conversation
Open a local file link from the transcript. With the workspace enabled, Codex can open the file as a read-only sidebar preview. Search within the preview for a heading or term. In the preview, Tab and Shift+Tab move between links, Enter opens the selected link, and Esc can close the document preview.
For a small example, use an existing README in a project you can access:
Read README.md and tell me which heading covers setup.
Include a clickable reference to README.md. Do not edit any files.
Open the file reference, search for the heading Codex named, and check whether the surrounding text supports the answer. The preview lets you verify the source while keeping the original prompt visible.
Review an image or a subagent transcript
Open a PNG, JPEG, GIF or WebP file link to preview it in the sidebar. Rendering depends on the terminal’s graphics support. Codex provides a fallback when it cannot display an image in the terminal.
If an existing task has subagents, select one from the sidebar to inspect its transcript beside the parent conversation. Parent-owned subagents open in a read-only view with search. Press Esc from that view to return to the list.
Model selection and scope
The bundled model catalog adds GPT-6.2 Astra and Sol and selects Sol by default. Available models can depend on your account and provider. See our Astra and Sol guide for selection steps and prompts.
We verified the release notes and implementation descriptions. The README exercise is an example to try, and we have not run it or captured the 0.171.0 interface.
Sources: OpenAI release notes, CLI installation, document previews, preview search and links, image previews and subagent transcripts. See Codex Update history for dated releases.