[DOCS] Fullscreen rendering docs missing `/tui` command and `tui` setting

Resolved 💬 2 comments Opened Apr 16, 2026 by coygeek Closed Apr 29, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/fullscreen

Section/Topic

Fullscreen rendering enablement and the related command/settings references for switching TUI modes

Current Documentation

The docs currently describe fullscreen rendering as an environment-variable-based feature:

Set the CLAUDE_CODE_NO_FLICKER environment variable when starting Claude Code: ``bash CLAUDE_CODE_NO_FLICKER=1 claude ` To enable it for every session, export the variable in your shell profile such as ~/.zshrc or ~/.bashrc: `bash export CLAUDE_CODE_NO_FLICKER=1 ``

The terminal configuration guide also says:

If you see flicker during long sessions, or your terminal scroll position jumps to the top while Claude is working, try fullscreen rendering. It uses an alternate rendering path that keeps memory flat and adds mouse support. Enable it with CLAUDE_CODE_NO_FLICKER=1.

The commands reference says:

The table below lists all the commands included in Claude Code.

But there is no /tui entry in that table, and the settings reference does not document a tui key.

What's Wrong or Missing?

Claude Code v2.1.110 added a new user-facing way to switch rendering modes in an existing session: /tui fullscreen. The same release also added a tui setting.

Those surfaces are not documented in the main docs. Current fullscreen guidance only explains enabling flicker-free rendering through CLAUDE_CODE_NO_FLICKER=1, which implies users must decide before launch or restart Claude Code to change modes.

As a result, the docs miss two important behaviors users need to know about:

  1. You can switch to fullscreen rendering in the same conversation with /tui fullscreen.
  2. There is a tui setting for configuring this behavior persistently.

Suggested Improvement

Update the docs to cover the new runtime and persistent configuration paths for fullscreen rendering:

  1. Add /tui to the commands reference with at least one example:
  • /tui fullscreen switches to flicker-free rendering in the current conversation without restarting.
  1. Add tui to the settings reference, including the accepted values and how it interacts with CLAUDE_CODE_NO_FLICKER.
  2. Update the fullscreen guide and terminal configuration guidance to explain that users can either:
  • enable fullscreen rendering before launch with CLAUDE_CODE_NO_FLICKER=1, or
  • switch during an active session with /tui fullscreen.
  1. Cross-link the command, setting, and fullscreen guide so users can discover the feature from any of those entry points.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/fullscreen | 31-43 | Documents fullscreen enablement only through CLAUDE_CODE_NO_FLICKER=1 |
| https://code.claude.com/docs/en/terminal-config | 101-103 | Recommends fullscreen rendering via env var only |
| https://code.claude.com/docs/en/commands | 9-17 | Says the table lists included commands, but /tui is not documented |
| https://code.claude.com/docs/en/settings | 153-215 | Lists available settings, but does not document a tui setting |
| https://code.claude.com/docs/en/env-vars | 107 | Documents CLAUDE_CODE_NO_FLICKER but not the newer command/setting alternatives |

Total scope: 5 pages affected

Source: Changelog v2.1.110

Exact changelog entry:

Added /tui command and tui setting - run /tui fullscreen to switch to flicker-free rendering in the same conversation

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗