Skip to main content
reopt Handbook
reopt Handbook
Codex Command MasterLabels and command selectionHow to read a detail guideComplete command listTerminal CLI Commands and Options

Task guides

Core Command GroupSession Command GroupCustom Command GuideMCP Command and Integration GuideDesign Workflows

Conversation and context

Cmd. /archiveCmd. /copyCmd. /importCmd. /cd

Planning and execution

Cmd. /goalCmd. /app

Models and settings

Cmd. /model

Permissions and integrations

Cmd. /pluginsCmd. /hooksCmd. /mcp

Display and input

Cmd. /voiceCmd. /statuslineCmd. /tuiCmd. /worktree

Account and usage

Cmd. /usage

Verification and history

Current verification scopeHandbook updatesRelease coverage historyEarlier verification recordsCommand change history
Handbook›Codex Command Master›Cmd. /tui
한국어KOEnglishEN

Cmd. /tui

Choose the fullscreen UI for your next launch; fullscreen transcripts are the default from 0.157.0.

Written and reviewed by Eric Han · Co-founder & CTO, reopt

Key takeaways

  • Choose the fullscreen UI for your next launch; fullscreen transcripts are the default from 0.157.0.
  • The chosen mode applies from the next launch; tune fullscreen copy, paste, and scrolling with tui.copy_on_select, tui.right_click_paste, and tui.mouse_scroll_speed.

Purpose

Choose the fullscreen UI for your next launch; fullscreen transcripts are the default from 0.157.0.

/tui

Availability

FieldValue
Input surfaceRunning CLI prompt
KindBuilt-in
StatusCurrent reference
Aliases—
Documented minimumNot specified
Reviewed against2026-11-14 · Codex CLI 0.169.0
Release evidencev0.156.0

Listed in the reference reviewed on 2026-11-14. Selects the next launch mode; check server and terminal support.

Examples

/tui

/tui was added in Codex CLI 0.156.0 to choose the screen mode. The choice applies from the next launch, not the current session.

  1. Run /tui.
  2. Choose whether to use the fullscreen UI.
  3. Relaunch Codex and confirm the screen mode.

Fullscreen adds transcript search, mouse selection, and right-click copy. From 0.157.0 the fullscreen transcript is the default, and Shift-click extends a text selection.

From 0.158.0, config.toml controls fullscreen copy and paste. tui.copy_on_select (auto by default, always, or never) decides whether a mouse selection in the transcript is copied on release, and tui.right_click_paste (auto by default, on, or off) controls right-click paste. For right_click_paste, auto enables it only on Windows and Linux, and no value applies in SSH sessions or VS Code terminals. From 0.159.0, copy_on_select = "auto" copies on selection except in terminals known to forward their native copy shortcut. 0.160.0 adds middle-click paste in local Linux X11 sessions.

[tui]
copy_on_select = "never"
right_click_paste = "off"

0.162.0 adds tui.mouse_scroll_speed, a multiplier for transcript mouse-wheel scrolling. According to the pull-request description, the default movement drops from three rows to one row per wheel event, so set mouse_scroll_speed = 3.0 if you want the earlier speed.

Display changes in 0.164.0–0.169.0

  • Transcript setting key: 0.164.0 marks the no-op features.transcript_v2 as removed. The transcript preference is tui.fullscreen_transcript, which /tui saves.
  • Image previews: from 0.164.0, terminals with Kitty or Sixel graphics show thumbnails of viewed and generated images in the fullscreen transcript. Remote workspaces, unsupported terminals, and missing or oversized files keep text-only entries. From 0.167.0, local workspaces also show thumbnails of images attached in the composer (with +N for overflow), and viewed image paths in the transcript are clickable; links are off over SSH and in remote workspaces.
  • Images and pets in tmux: from 0.168.0, tmux on Ghostty or Kitty shows image previews and /pets in fullscreen when RGB is supported and tmux allow-passthrough is all.
  • Keyboard selection: from 0.166.0, leader [ (tui.keymap.global.select_transcript) selects transcript text from the keyboard; see /keymap for the keys. The /presets menu opens with leader p (0.164.0).
  • Chord guide: from 0.169.0, after a chord prefix such as the leader, the available completions appear in a floating guide after 350 ms instead of the footer. Esc cancels.
  • Collapsed turn details: 0.169.0 adds tui.collapse_turn_details (default false), also toggled as Collapse turn details in the fullscreen settings panel. It folds completed commentary, reasoning, and tool activity beneath each prompt while answers stay visible and folded tool output stays searchable.
  • Notifications: from 0.168.0, tui.notification_method = "osc777" is accepted and passes through tmux. Approval notifications no longer cut commands at 30 graphemes and distinguish terminal input from network access requests. The official config reference still lists only auto | osc9 | bel.

Side-pane workspace (under development)

features.tui_workspace (0.168.0) is off by default and under development. When enabled on a terminal at least 100 columns wide, it shows the main conversation beside a side conversation, and only the focused composer accepts input.

[features]
tui_workspace = true
ActionKey or setting
Zoom or restore the focused paneleader z
Hide a paneleader - (tui.keymap.global.hide_pane)
Focus the main composer or side contentleader c · leader s
Focus the left or right paneleader left/leader h · leader right/leader l
Minimize, maximize, or equalize widthsleader , · leader . · leader =
Keyboard resize modeleader r (Enter or Esc saves)
Move the divider from the side paneleader shift-h · leader shift-l
Saved pane widthtui.sidebar_width_percent (default one third of the terminal; dragging the divider also saves it)

From 0.169.0, the workspace opens side chats as tabs. /side <prompt> starts a new side chat and /side without arguments reopens the selected one. Switch tabs with the keyboard or mouse, close one with Ctrl-X W, and reopen saved local side chats after a restart. The feature is under development, so keys and behavior can change.

Effects and persistence

Saves the screen mode for the next launch. Fullscreen adds transcript search, mouse selection, and right-click copy; from 0.158.0, tui.copy_on_select and tui.right_click_paste control copy-on-select and right-click paste. Per the 0.162.0 release notes, tui.mouse_scroll_speed tunes mouse-wheel scrolling.

Cautions

  • Inside tmux, 0.157.0 respects tmux mouse settings. If mouse selection behaves unexpectedly, check the tmux mouse option first.
  • If you need native terminal scrollback, launch with --no-alt-screen to disable the alternate screen.
  • The command is now listed in the official slash table (2026-10-23), so confirm it appears in the installed / menu.
  • tui.copy_on_select, tui.right_click_paste, tui.mouse_scroll_speed, and tui.fullscreen_transcript are confirmed from release notes and pull-request descriptions and are not yet in the official config reference.
  • With the under-development multi-backend feature (tui_multi_backend) enabled, from 0.168.0 leader b (tui.keymap.global.change_host) switches the connection before the first message of a new conversation, and the choice is saved per project and user in the user-level tui.default_hosts.
  • 0.159.0 removed automatic follow-up prompt suggestions together with the tui.prompt_suggestions setting. Delete it from config.toml if it is still there.

Official sources

  • Changelog
  • Rust V0.156.0
  • Rust V0.157.0
  • Rust V0.158.0
  • Rust V0.159.0
  • Rust V0.160.0
  • Rust V0.162.0

Complete command list · Verification scope · History for this command

Related docs

Cmd. /copy

Pick a whole Codex response, code block, or blockquote and copy it as Markdown.

Slash Commands

Advanced Codex Usage · Use Codex slash commands as an operating surface for sessions, review, models, and status.

Cmd. /focus

Claude Code Command Master · Changes the visible focus area in fullscreen rendering.

Config

Advanced Codex Usage · Design Codex configuration layers, profiles, and safe defaults for team usage.

Handbook updates

Codex CLI: Recent handbook structure improvements with links to dated release coverage and audit records.

Cmd. /statusline

Configure TUI footer status-line fields.

Cmd. /worktree

Run new or forked sessions in isolated Git checkouts, enabled by default from 0.156.0

On this page

PurposeAvailabilityExamplesDisplay changes in 0.164.0–0.169.0Side-pane workspace (under development)Effects and persistenceCautionsOfficial sources