Codex CLI Turns On the TUI Workspace by Default With Document and Image Previews
Codex CLI 0.171.0 enables the TUI workspace by default, so the terminal interface now includes document previews, image previews and subagent transcripts without any opt-in setting. The workspace was introduced earlier as an opt-in side conversation pane in 0.168.0. The same release adds configurable undo and redo shortcuts to the standard prompt composer.
Key Takeaways
- The TUI workspace is now on by default in Codex CLI 0.171.0, so developers no longer need a feature flag to get it.
- The workspace brings document previews and image previews into the terminal session, so files can be checked without leaving Codex.
- Subagent transcripts are part of the default workspace, which makes it easier to follow what delegated agents did.
- The workspace first shipped as an opt-in side conversation pane in 0.168.0, so this release marks its move from experiment to default.
- Configurable undo and redo shortcuts now exist in the non-Vim prompt composer, which helps with long prompt editing.
- Fixes in the same release preserve drafts and queued follow-ups when switching sessions and fix scrolling and redraw glitches.
The TUI workspace is now the default
Codex CLI 0.171.0 turns the TUI workspace on by default. Until this release, developers had to opt in to the workspace through a feature flag, a setting first introduced in Codex CLI 0.168.0 alongside a side conversation pane next to the main chat. With 0.171.0, new and existing sessions open in the workspace layout unless it is switched off.
What the workspace includes
OpenAI describes the default workspace as including document previews, image previews and subagent transcripts. Developers can look at a document or an image that Codex is working with without leaving the terminal session, and they can read what a subagent did without piecing it together from the main conversation. For people who run longer, multi-agent tasks, this keeps the context that used to be scattered across views in one place.
Smoother composer editing
The same release adds configurable undo and redo shortcuts to the non-Vim prompt composer. Developers who write long prompts in the terminal can now step back and forward through edits, and can remap the shortcuts to suit their own keybindings. Vim-mode users already had their own editing model, so the change targets everyone else.
Related fixes in the release
Codex CLI 0.171.0 also fixes several rough edges that affect everyday use of the terminal interface:
- Drafts, queued follow-ups and interrupted input are now preserved when switching or resuming sessions.
- Permission profiles stay intact when the working directory changes.
- Stray characters during scrolling, composer caret jumps and redraws with stale terminal dimensions have been fixed.
The release can be installed with npm install -g @openai/codex@0.171.0.