appearance.alt_drag | bool | true | Alt plus left-drag moves a pane |
appearance.animation_speed | int | 100 | Percent window animations run at: 100 as shipped, 200 twice as fast, 50 half as fast Range: 25 to 400. |
appearance.animations_enabled | bool | true | Animate UI transitions instead of applying them instantly Deprecated: folded into appearance.motion on load (false is none); set appearance.motion |
appearance.auto_enter_terminal_on_focus | string | off | Type in a pane when a keyboard focus command moves to it: off, targeted (select and arrows), or all (including Tab) Values: off, targeted, all. |
appearance.background | string | off | Background painted on every surface not set on its own (panes, desktop, window chrome, dock, rail): off (your terminal shows through), theme, or a colour (#rrggbb, 0-255, a slot name or a role name) |
appearance.border_focused_color | string | empty | Colour overriding the focused pane's border in both modes: #89b4fa, a slot name such as bright_cyan, or a role such as accent |
appearance.border_focused_color_terminal | string | empty | Colour of the focused pane's border in terminal mode. It wins over border_focused_color |
appearance.border_focused_color_window | string | empty | Colour of the focused pane's border in window mode. It wins over border_focused_color |
appearance.border_focused_gradient | string | empty | Two or more colours, separated by spaces or commas, that the focused pane's border steps through. Empty draws one colour |
appearance.border_gradient_angle | int | 45 | Direction of the focused border's gradient in degrees: 0 runs left to right, 90 top to bottom, 45 from the top left corner to the bottom right one Range: 0 to 359. |
appearance.border_style | string | rounded | Border style drawn around every pane Values: rounded, normal, thick, double, block, outer-half-block, inner-half-block, ascii, hidden, glyphs. --border-style sets it for one run. |
appearance.border_unfocused_color | string | empty | Colour overriding an unfocused pane's border: #585b70, a slot name such as bright_black, or a role such as muted |
appearance.calm | bool | false | Calm mode: nothing moves or blinks, and only messages that need you show in the dock |
appearance.cell_frames | string | all | Which clients write their frames as diffed cells instead of through Bubble Tea's renderer, which turns each frame into text and back. served: clients over SSH and the web. all: this terminal as well. off: none. TUIOS_CELL_FRAME=1 means all and 0 means off Values: served, all, off. |
appearance.chord_timeout_ms | int | 500 | Milliseconds the first key of a two-key chord (gg in copy mode and the scrollback browser) waits for the second Range: 100 to 3000. |
appearance.click_to_type | string | double | What a click on a pane's content does in window-management mode Values: single, double, off. |
appearance.confirm_close | string | never | When closing a pane by hand (a key, its menu or its close control) asks first: never, busy (the pane runs something besides its shell) or always Values: never, busy, always. |
appearance.confirm_quit | bool | false | Always confirm on quit, not only when processes are running --confirm-quit sets it for one run. |
appearance.copy_on_select | bool | true | Copy a mouse selection to the clipboard on release |
appearance.copy_search_max_matches | int | 1000 | Matches one copy mode search keeps. The renderer walks every match on every frame, so a very high value slows a one-letter query over a long scrollback. A search that stops at the limit shows 1000+. Range: 100 to 100000. |
appearance.desktop_background | string | empty | Background behind and between panes: the gaps between tiled panes, the space around floating ones, and an empty workspace with its welcome splash. off, theme, or a colour (#rrggbb, 0-255, a slot name or a role name); empty follows appearance.background |
appearance.dim_foreground | bool | true | Let dim_unfocused dim a pane's text too, not only its background |
appearance.dim_multifocus | bool | false | Dim the panes in the multifocus set like other panes you are not in |
appearance.dim_unfocused | int | 0 | How much tuios fades a pane you are not in, as a percent. 0 is off. Range: 0 to 90. |
appearance.drop_preview | string | outline | What a BSP drag shows where the pane would land: a frame with a tint inside, the frame only, or nothing Values: fill, outline, off. |
appearance.drop_preview_delay | string | 120ms | How long the pointer rests on a drop zone before it shows: a duration such as 120ms, or 0 for at once. A zone you leave before the delay is never drawn |
appearance.focus_follows_mouse | bool | false | Focus the pane under the cursor as the mouse moves |
appearance.focus_follows_mouse_pause | string | off | Hold this key to keep the focus on the current pane as the mouse moves: off, ctrl, alt Values: off, ctrl, alt. |
appearance.focus_wrap | bool | false | A focus key at the edge of a tiled layout moves to the pane on the far side |
appearance.frame_panels | bool | false | Frame the larger overlay panels, such as the command palette, in the border style |
appearance.gap | int | 0 | Cells of empty ground kept between two neighbouring tiled panes Range: 0 to 8. |
appearance.global_session | bool | true | Offer a session in the rail that holds panes from several machines, once a second one is reachable |
appearance.glyphs | string | default | Chrome glyph set: the characters the border, controls, rules and rail marks are drawn with |
appearance.hide_scrollbar | bool | false | Hide the scrollbar thumb on the pane border --hide-scrollbar sets it for one run. |
appearance.hide_window_buttons | bool | false | Hide the minimize, maximize and close buttons --hide-window-buttons sets it for one run. |
appearance.host_title | string | empty | Title of the terminal tuios runs in, from the focused pane: accepts {title}, {index}, {cwd}, {session} and {workspace}. Empty sets no title |
appearance.idle_fps | int | 10 | Polls per second while nothing is moving. Lower saves power; higher notices background work sooner. appearance.max_fps sets the rate while something moves. Range: 1 to 60. |
appearance.image_symbols | string | auto | Draw pane images as block glyphs when the terminal has no graphics: auto, octant, sextant, quadrant, half, off Values: auto, octant, sextant, quadrant, half, off. |
appearance.kitty_placeholders | string | auto | Draw images an app positions with kitty Unicode placeholders: auto, on, off Values: auto, on, off. |
appearance.link_click | string | both | The click that opens a link: ctrl or shift, ctrl only, shift only, or none. Ctrl+click also works on macOS in Ghostty, kitty, WezTerm and Terminal.app. Cmd+click does not open a link there Values: both, ctrl, shift, off. |
appearance.link_hover | string | safe | The hover highlight: safe skips a pane whose guest tracks the mouse, always draws it everywhere Values: safe, always. |
appearance.link_opener | string | empty | The command that opens a web link. tuios puts the URL where %s is, or at the end. If this is empty, tuios uses $BROWSER, then the system opener. |
appearance.links | string | all | Links the pointer picks up: off, only marked links (OSC 8), or plain URLs too Values: off, marked, all. |
appearance.master_count | int | 1 | How many panes are master panes in the master-stack layout Range: 1 to 9. |
appearance.master_grid | bool | true | With one master on the left, show four or more panes as a grid |
appearance.master_position | string | left | Side the master panes take in the master-stack layout. With center, the stack panes go to the right and the left in turn. Values: left, right, top, bottom, center. |
appearance.master_ratio | int | 50 | Width of the master pane in the master-stack layout, as a percent of the screen Range: 10 to 90. |
appearance.max_fps | int | 0 | Highest frame rate tuios draws at. Your terminal and monitor can show fewer frames. A value above what they can show does not make tuios smoother. 0 uses 60. auto uses the refresh rate of your display. The range is 10 to 240. Range: 0 to 240. |
appearance.modal_dim | int | 30 | How much the screen behind a modal panel is darkened, as a percent. 0 is off. Range: 0 to 90. |
appearance.motion | string | full | How much moves: none, basic (window slides, workspace slides and the copy sweep), or full (also overlay fades and the working-agent shimmer) Values: none, basic, full. |
appearance.multi_copy_dim | int | 45 | Percent a pane is dimmed when multi copy mode's search found nothing in it. 0 leaves it undimmed. Range: 0 to 90. |
appearance.new_window_follow_ssh | bool | false | A split or new window of a pane that runs ssh runs the same ssh |
appearance.new_window_inherit_cwd | bool | true | A new window starts in the focused pane's working directory |
appearance.niri_click_reveals | bool | true | In the scrolling layout, clicking a column that is partly off the edge brings all of it on screen |
appearance.niri_hover_reveals | bool | true | In the scrolling layout with focus-follows-mouse on, hovering a column that is partly off the edge brings all of it on screen |
appearance.niri_reverse_scroll | bool | false | Reverse the wheel direction in niri scrolling mode |
appearance.niri_scroll_cells | int | 8 | Cells the scrolling layout's strip moves per mouse wheel event Range: 1 to 200. |
appearance.niri_scroll_snap | bool | false | Snap the strip to the nearest column when a scroll stops |
appearance.nvim_navigation | bool | false | Let the Neovim navigator plugin hand terminal focus keys back to TUIOS |
appearance.overlay_border_color | string | empty | Colour of every overlay's frame: #89b4fa, a slot name such as bright_cyan, or a role such as accent. Empty keeps the overlay's own, or the focused pane's border under pane_overlays |
appearance.pane_background | string | empty | Background behind pane content, the thin scrollbar over it and the scrollback browser: off, theme, or a colour (#rrggbb, 0-255, a slot name or a role name); empty follows appearance.background |
appearance.pane_overlays | bool | false | Draw dialogs and panels like pane windows: framed in the focused pane's border colour, on the pane's background |
appearance.panel_padding | int | 2 | Columns of padding each side of an overlay panel's content Range: 1 to 6. |
appearance.paste_preview | bool | true | Show a pasted image in a card at the cursor for a few seconds |
appearance.paste_preview_ms | int | 6000 | Milliseconds the paste card stays up with nothing pressed Range: 500 to 60000. |
appearance.popup_dim | int | 0 | How much the screen behind a focused plain popup is darkened, as a percent. 0 is off; popup --dim overrides it. Range: 0 to 90. |
appearance.preferred_shell | string | empty | Shell that new panes run. Empty picks one for your platform. |
appearance.prefix_repeat_time | int | 500 | Milliseconds the prefix stays armed after a repeatable command. 0 turns it off. Range: 0 to 5000. |
appearance.right_click_opens_menu | bool | false | A plain right-click on a pane in terminal mode opens the pane menu, for pasting without selecting first |
appearance.scroll_column_max | int | 90 | Highest a column's width may be set to in the scrolling layout, as a percent. 100 lets a column fill the screen, at the cost of the next one peeking in at the edge. Range: 20 to 100. |
appearance.scroll_column_width | int | 55 | Width of a column in the scrolling layout, as a percent of the screen Range: 20 to 100. |
appearance.scroll_lines | int | 3 | Lines scrolled per mouse wheel notch Range: 1 to 50. |
appearance.scrollback_lines | int | 10000 | Lines each pane keeps in its scrollback. A pane takes the value when it is made. The daemon reads it when it starts Range: 100 to 1000000. --scrollback-lines sets it for one run. |
appearance.session_border | bool | false | Carry the session's colour on every pane border, not only on the rail |
appearance.session_colors | bool | true | Give each session its own colour on the rail and in the switcher |
appearance.shared_borders | bool | false | Draw one border between neighbouring tiled panes, in every layout --shared-borders sets it for one run. |
appearance.sidebar_enabled | bool | false | Show the session rail Deprecated: folded into [appearance.sidebar] on load; set appearance.sidebar.enabled |
appearance.sidebar_position | string | empty | Edge the session rail sits on Values: left, right, hidden. Deprecated: folded into [appearance.sidebar] on load; set appearance.sidebar.position |
appearance.sidebar_show_counts | bool | true | Show the window count on each session row Deprecated: folded into [appearance.sidebar] on load; set appearance.sidebar.show_counts |
appearance.sidebar_show_glyphs | bool | true | Show the agent-state glyph on each rail row Deprecated: folded into [appearance.sidebar] on load; set appearance.sidebar.show_glyphs |
appearance.sidebar_show_windows | bool | true | Show the terminals section on the rail Deprecated: folded into [appearance.sidebar] on load; set appearance.sidebar.show_windows |
appearance.sidebar_width | int | 0 | Preferred rail width in columns Deprecated: folded into [appearance.sidebar] on load; set appearance.sidebar.width |
appearance.theme | string | empty | Colour theme name. Empty follows Omarchy when it is installed, else keeps your terminal's colours. none always keeps them. |
appearance.theme_light | string | empty | Theme to use while the terminal is light. Empty uses theme for both. theme is then the dark theme |
appearance.theme_transition | string | none | How tuios shows a theme change: none, circle (the new theme grows from the middle of the screen) or fade Values: none, circle, fade. |
appearance.theme_transition_duration | int | 450 | Milliseconds a theme transition takes at animation speed 100 Range: 100 to 2000. |
appearance.tiling_scheme | string | spiral | BSP scheme a workspace inserts new windows with the first time it is tiled. A workspace already tiled keeps its own scheme. Values: spiral, longest_side, alternate, smart_split. |
appearance.tooltip_delay_ms | int | 350 | Milliseconds the pointer rests on a control before its tooltip shows. 0 shows it at once. Range: 0 to 5000. |
appearance.whichkey_delay_ms | int | 500 | Milliseconds after the leader key before the which-key panel opens. 0 opens it at once. Range: 0 to 5000. |
appearance.whichkey_enabled | bool | true | Show the which-key popup after the leader key |
appearance.whichkey_position | string | empty | Corner the which-key popup opens in (empty: bottom-right) Values: bottom-right, bottom-left, top-right, top-left, center. |
appearance.window_button_position | string | left | Which end of the title bar the window controls sit on Values: right, left. --window-button-position sets it for one run. |
appearance.window_button_style | string | dots | Window controls as a filled pill or as macOS traffic lights Values: pill, dots. --window-button-style sets it for one run. |
appearance.window_button_zoom | bool | true | Carry the third title bar control on a tiled pane, where it toggles the zoom |
appearance.window_chrome_background | string | empty | Background under pane borders and title bars, the lines between shared-border panes and the capture marquee: off, theme, or a colour (#rrggbb, 0-255, a slot name or a role name); empty follows appearance.background |
appearance.window_title_align | string | auto | Where a pane's title sits on its row. auto is the end away from the window buttons on the top row, and the middle on the bottom row. left, center and right are that place in the room the buttons leave Values: auto, left, center, right. |
appearance.window_title_format | string | empty | Title template accepting {title}, {index} and {cwd} |
appearance.window_title_position | string | top | Edge of the pane the title is drawn on Values: bottom, top, hidden. --window-title-position sets it for one run. |
appearance.window_title_style | string | pill | Shape of a pane's title: pill is the name on a fill in the border's colour, with rounded caps; tab is the fill with no caps; plain is the name in the border's colour, with no fill Values: pill, tab, plain. |
appearance.word_characters | string | @-./_~?&=%+# | Punctuation that counts as part of a word for double-click selection |
appearance.workspace_transition | string | empty | Old name of motion.workspace Deprecated: folded into motion.workspace on load; set motion.workspace |
appearance.workspace_transition_ms | int | empty | Old name of motion.workspace_ms Range: 0 to 1000. Deprecated: folded into motion.workspace_ms on load; set motion.workspace_ms |
appearance.wrap_lists | bool | true | Up on a list's first row goes to its last, and down on the last goes to the first |
appearance.zen_mode | string | disabled | When window borders are hidden: never, always, or while the mouse is idle Values: disabled, always, mouse. |
appearance.zen_reveal_ms | int | 2000 | Milliseconds the pointer sits still before zen mode (mouse) hides the borders again Range: 200 to 30000. |
appearance.zoom_animation | bool | empty | Old name of motion.zoom Deprecated: folded into motion.zoom on load; set motion.zoom |
appearance.zoom_borderless | bool | false | Show a zoomed pane on the whole pane region with no border or title bar. Zoom size and zoom max width do not apply. |
appearance.zoom_follows_focus | bool | true | Hand the zoom to the pane the focus lands on, so moving focus while zoomed shows the pane you moved to |
appearance.zoom_max_width | int | 0 | Width in cells of a zoomed pane. 0 fills the screen. --zoom-max-width sets it for one run. |
appearance.zoom_size | int | 95 | How much of the screen a zoomed pane takes, as a percent. Below 100 the layout around it stays visible at the edges. Range: 50 to 100. |
shell.integration | string | auto | Turn on prompt marks in the bash and zsh shells that new panes start. Your files do not change. off starts each shell as it is Values: auto, off. |
shell.login | bool | false | Start the shell of each new pane as a login shell, so it reads .zprofile, .bash_profile or .profile, as a terminal on macOS does |