Struct UiConfig 

pub struct UiConfig {

    pub tool_output_mode: ToolOutputMode,
    pub tool_output_max_lines: usize,
    pub tool_output_spool_bytes: usize,
    pub tool_output_spool_dir: Option<String>,
    pub allow_tool_ansi: bool,
    pub inline_viewport_rows: u16,
    pub reasoning_display_mode: ReasoningDisplayMode,
    pub reasoning_visible_default: bool,
    pub vim_mode: bool,
    pub status_line: StatusLineConfig,
    pub terminal_title: TerminalTitleConfig,
    pub keyboard_protocol: KeyboardProtocolConfig,
    pub layout_mode: LayoutModeOverride,
    pub display_mode: UiDisplayMode,
    pub show_sidebar: bool,
    pub dim_completed_todos: bool,
    pub message_block_spacing: bool,
    pub show_turn_timer: bool,
    pub show_diagnostics_in_transcript: bool,
    pub minimum_contrast: f32,
    pub bold_is_bright: bool,
    pub safe_colors_only: bool,
    pub color_scheme_mode: ColorSchemeMode,
    pub notifications: UiNotificationsConfig,
    pub fullscreen: UiFullscreenConfig,
    pub screen_reader_mode: bool,
    pub reduce_motion_mode: bool,
    pub reduce_motion_keep_progress_animation: bool,
    pub hide_header: bool,
}

Fields

tool_output_mode: ToolOutputMode

Tool output display mode (“compact” or “full”)

tool_output_max_lines: usize

Maximum number of lines to display in tool output (prevents transcript flooding)

tool_output_spool_bytes: usize

Maximum bytes of output to display before auto-spooling to disk

tool_output_spool_dir: Option<String>

Optional custom directory for spooled tool output logs

allow_tool_ansi: bool

Allow ANSI escape sequences in tool output (enables colors but may cause layout issues)

inline_viewport_rows: u16

Number of rows to allocate for inline UI viewport

reasoning_display_mode: ReasoningDisplayMode

Reasoning display mode for chat UI (“always”, “toggle”, or “hidden”)

reasoning_visible_default: bool

Default visibility for reasoning when display mode is “toggle”

vim_mode: bool

Enable Vim-style prompt editing in the interactive terminal UI.

status_line: StatusLineConfig

Status line configuration settings

terminal_title: TerminalTitleConfig

Terminal title configuration settings

keyboard_protocol: KeyboardProtocolConfig

Keyboard protocol enhancements for modern terminals (e.g. Kitty protocol)

layout_mode: LayoutModeOverride

Override the responsive layout mode

display_mode: UiDisplayMode

UI display mode preset (full, minimal, focused)

show_sidebar: bool

Show the right sidebar (queue, context, tools)

dim_completed_todos: bool

Dim completed todo items (- [x]) in agent output

message_block_spacing: bool

Add spacing between message blocks

show_turn_timer: bool

Show per-turn elapsed timer line after completed turns

show_diagnostics_in_transcript: bool

Show warning/error/fatal diagnostic lines in the TUI transcript and log panel. Also controls whether ERROR-level tracing logs appear in the TUI session log. Errors are always captured in the session archive JSON regardless of this setting.

minimum_contrast: f32

Minimum contrast ratio for text against background (WCAG 2.1 standard)

• 4.5: WCAG AA (default, suitable for most users)
• 7.0: WCAG AAA (enhanced, for low-vision users)
• 3.0: Large text minimum
• 1.0: Disable contrast enforcement

bold_is_bright: bool

Compatibility mode for legacy terminals that map bold to bright colors. When enabled, avoids using bold styling on text that would become bright colors, preventing visibility issues in terminals with “bold is bright” behavior.

safe_colors_only: bool

Restrict color palette to the 11 “safe” ANSI colors portable across common themes. Safe colors: red, green, yellow, blue, magenta, cyan + brred, brgreen, brmagenta, brcyan Problematic colors avoided: brblack (invisible in Solarized Dark), bryellow (light themes), white/brwhite (light themes), brblue (Basic Dark). See: https://blog.xoria.org/terminal-colors/

color_scheme_mode: ColorSchemeMode

Color scheme mode for automatic light/dark theme switching.

• “auto”: Detect from terminal (via OSC 11 or COLORFGBG env var)
• “light”: Force light mode theme selection
• “dark”: Force dark mode theme selection

notifications: UiNotificationsConfig

Notification preferences for attention events.

fullscreen: UiFullscreenConfig

Fullscreen interaction settings for alternate-screen rendering.

screen_reader_mode: bool

Screen reader mode: disables animations, uses plain text indicators, and optimizes output for assistive technology compatibility. Can also be enabled via VTCODE_SCREEN_READER=1 environment variable.

reduce_motion_mode: bool

Reduce motion mode: minimizes shimmer/flashing animations. Can also be enabled via VTCODE_REDUCE_MOTION=1 environment variable.

reduce_motion_keep_progress_animation: bool

Keep animated progress indicators while reduce_motion_mode is enabled.

hide_header: bool

Hide the full TUI header, showing only version info in a compact line.

Trait Implementations

impl Clone for UiConfig

fn clone(&self) -> UiConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UiConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for UiConfig

fn default() -> UiConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for UiConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<UiConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for UiConfig

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for UiConfig

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.