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, andtui.mouse_scroll_speed.
Purpose
Choose the fullscreen UI for your next launch; fullscreen transcripts are the default from 0.157.0.
/tuiAvailability
| Field | Value |
|---|---|
| Input surface | Running CLI prompt |
| Kind | Built-in |
| Status | Current reference |
| Aliases | — |
| Documented minimum | Not specified |
| Reviewed against | 2026-11-14 · Codex CLI 0.169.0 |
| Release evidence | v0.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.
- Run
/tui. - Choose whether to use the fullscreen UI.
- 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_v2as removed. The transcript preference istui.fullscreen_transcript, which/tuisaves. - 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
+Nfor 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
/petsin fullscreen when RGB is supported and tmuxallow-passthroughisall. - Keyboard selection: from 0.166.0,
leader [(tui.keymap.global.select_transcript) selects transcript text from the keyboard; see /keymap for the keys. The/presetsmenu opens withleader 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.
Esccancels. - Collapsed turn details: 0.169.0 adds
tui.collapse_turn_details(defaultfalse), 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 onlyauto | 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| Action | Key or setting |
|---|---|
| Zoom or restore the focused pane | leader z |
| Hide a pane | leader - (tui.keymap.global.hide_pane) |
| Focus the main composer or side content | leader c · leader s |
| Focus the left or right pane | leader left/leader h · leader right/leader l |
| Minimize, maximize, or equalize widths | leader , · leader . · leader = |
| Keyboard resize mode | leader r (Enter or Esc saves) |
| Move the divider from the side pane | leader shift-h · leader shift-l |
| Saved pane width | tui.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
mouseoption first. - If you need native terminal scrollback, launch with
--no-alt-screento 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, andtui.fullscreen_transcriptare 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.0leader 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-leveltui.default_hosts. - 0.159.0 removed automatic follow-up prompt suggestions together with the
tui.prompt_suggestionssetting. Delete it fromconfig.tomlif it is still there.
Official sources
Complete command list · Verification scope · History for this command