Option Explorer

Agents, the Inbox, mail and approvals. Turn off to keep only the multiplexer.

default true · true, false

Fold the Working group of the agents view. F folds or opens a group, and the view keeps that choice.

default false · true, false

The width of the agents view's list: a number of cells, such as 52, or a share of the view, such as 30%. Empty follows the screen. The < and > keys and a drag on the edge of the list change it, and the view keeps that choice.

default ""

How the agents view shows its list on a wide screen: a column beside the focus, a strip of chips above it, or a strip for two agents or fewer. The \ key switches it, and the view keeps that choice.

default column · column, strip, auto

Move task cards on their own when tuios sees their work move: a plan held and then approved, a fan check, a pull request. Off leaves every stage to you.

default true · true, false

How many agents may work on this machine before Any machine starts a new one on another machine. Agents that work, agents that start, and picks not yet started count. 0 is no cap.

default 0 · 0 to 1024

Alt plus left-drag moves a pane

default true · true, false

Percent window animations run at: 100 as shipped, 200 twice as fast, 50 half as fast

default 100 · 25 to 400

Type in a pane when a keyboard focus command moves to it: off, targeted (select and arrows), or all (including Tab)

default off · off, targeted, all

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)

default off · off, theme

Colour overriding the focused pane's border: #89b4fa, a slot name such as bright_cyan, or a role such as accent

default ""

Colour of the focused pane's border in terminal mode. It wins over border_focused_color

default ""

Colour of the focused pane's border in window mode. It wins over border_focused_color

default ""

Two or more colours, separated by spaces, that the focused pane's border steps through. Empty draws one colour

default ""

Direction of the focused border's gradient in degrees: 0 runs left to right, 90 top to bottom

default 45 · 0 to 359

Border style drawn around every pane

default rounded · rounded, normal, thick, double, block, outer-half-block, inner-half-block, ascii, hidden, glyphs

Colour overriding an unfocused pane's border: #585b70, a slot name such as bright_black, or a role such as muted

default ""

Calm mode: nothing moves or blinks, and only messages that need you show in the dock

default false · true, false

What a click on a pane's content does in window-management mode

default double · single, double, off

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

default never · never, busy, always

Always confirm on quit, not only when processes are running

default false · true, false

Copy a mouse selection to the clipboard on release

default true · true, false

Background behind and between panes, including gaps and an empty workspace: off, theme, or a colour (#rrggbb, 0-255, a slot name or a role name); empty follows appearance.background

default "" · off, theme

Let dim_unfocused dim a pane's text too, not only its background

default true · true, false

Dim the panes in the multifocus set like other panes you are not in

default false · true, false

How much tuios fades a pane you are not in, as a percent. 0 is off.

default 0 · 0 to 90

What a BSP drag shows where the pane would land: a frame with a tint inside, the frame only, or nothing

default outline · fill, outline, off

How long the pointer rests on a drop zone before it shows: a duration such as 120ms, or 0 for at once

default 120ms

Focus the pane under the cursor as the mouse moves

default false · true, false

Hold this key to keep the focus on the current pane as the mouse moves: off, ctrl, alt

default off · off, ctrl, alt

A focus key at the edge of a tiled layout moves to the pane on the far side

default false · true, false

Frame the larger overlay panels, such as the command palette, in the border style

default false · true, false

Cells of empty ground kept between two neighbouring tiled panes

default 0 · 0 to 8

Offer a session in the rail that holds panes from several machines, once a second one is reachable

default true · true, false

Chrome glyph set: the characters the border, controls, rules and rail marks are drawn with

default default

Hide the scrollbar thumb on the pane border

default false · true, false

Hide the minimize, maximize and close buttons

default false · true, false

Title of the terminal tuios runs in, from the focused pane: accepts {title}, {index}, {cwd}, {session} and {workspace}. Empty sets no title

default ""

Draw pane images as block glyphs when the terminal has no graphics: auto, octant, sextant, quadrant, half, off

default auto · auto, octant, sextant, quadrant, half, off

Draw images an app positions with kitty Unicode placeholders: auto, on, off

default auto · auto, on, off

The click that opens a link: ctrl or shift, ctrl only, shift only, or none

default both · both, ctrl, shift, off

The hover highlight: safe skips a pane whose guest tracks the mouse, always draws it everywhere

default safe · safe, always

The command that opens a web link. If this is empty, tuios uses $BROWSER, then the system opener.

default ""

Links the pointer picks up: off, only marked links, or plain URLs too

default all · off, marked, all

How many panes are master panes in the master-stack layout

default 1 · 1 to 9

With one master on the left, show four or more panes as a grid

default true · true, false

Side the master panes take in the master-stack layout. Center puts the stack on both sides.

default left · left, right, top, bottom, center

Width of the master pane in the master-stack layout, as a percent of the screen

default 50 · 10 to 90

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.

default 0 · 0 to 240, or auto

How much the screen behind a modal panel is darkened, as a percent. 0 is off.

default 30 · 0 to 90

How much moves: none, basic (window slides, workspace slides and the copy sweep), or full (also overlay fades and the working-agent shimmer)

default full · none, basic, full

A split or new window of a pane that runs ssh runs the same ssh

default false · true, false

A new window starts in the focused pane's working directory

default true · true, false

In the scrolling layout, clicking a column that is partly off the edge brings all of it on screen

default true · true, false

In the scrolling layout with focus-follows-mouse on, hovering a column that is partly off the edge brings all of it on screen

default true · true, false

Reverse the wheel direction in niri scrolling mode

default false · true, false

Cells the scrolling layout's strip moves per mouse wheel event

default 8 · 1 to 200

Snap the strip to the nearest column when a scroll stops

default false · true, false

Let the Neovim navigator plugin hand terminal focus keys back to TUIOS

default false · true, false

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

default ""

Background behind pane content: off, theme, or a colour (#rrggbb, 0-255, a slot name or a role name); empty follows appearance.background

default "" · off, theme

Draw dialogs and panels like pane windows: framed in the focused pane's border colour, on the pane's background

default false · true, false

Columns of padding each side of an overlay panel's content

default 2 · 1 to 6

Show a pasted image in a card at the cursor for a few seconds

default true · true, false

How much the screen behind a focused plain popup is darkened, as a percent. 0 is off; popup --dim overrides it.

default 0 · 0 to 90

Shell that new panes run. Empty picks one for your platform.

default ""

Milliseconds the prefix stays armed after a repeatable command. 0 turns it off.

default 500 · 0 to 5000

A plain right-click on a pane in terminal mode opens the pane menu, for pasting without selecting first

default false · true, false

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.

default 90 · 20 to 100

Width of a column in the scrolling layout, as a percent of the screen

default 55 · 20 to 100

Lines scrolled per mouse wheel notch

default 3 · 1 to 50

Lines each pane keeps in its scrollback. A pane takes the value when it is made. The daemon reads it when it starts

default 10000 · 100 to 1000000

Carry the session's colour on every pane border, not only on the rail

default false · true, false

Give each session its own colour on the rail and in the switcher

default true · true, false

Draw one border between neighbouring tiled panes, in every layout

default false · true, false

Colour theme name. Empty follows Omarchy when it is installed, else keeps your terminal's colours. none always keeps them.

default ""

Theme to use while the terminal is light. Empty uses theme for both. theme is then the dark theme

default ""

How tuios shows a theme change: none, circle (the new theme grows from the middle of the screen) or fade

default none · none, circle, fade

Milliseconds a theme transition takes at animation speed 100

default 450 · 100 to 2000

BSP scheme a workspace inserts new windows with the first time it is tiled. A workspace already tiled keeps its own scheme.

default spiral · spiral, longest_side, alternate, smart_split

Show the which-key popup after the leader key

default true · true, false

Corner the which-key popup opens in (empty: bottom-right)

default "" · bottom-right, bottom-left, top-right, top-left, center

Which end of the title bar the window controls sit on

default left · right, left

Window controls as a filled pill or as macOS traffic lights

default dots · pill, dots

Carry the third title bar control on a tiled pane, where it toggles the zoom

default true · true, false

Background under pane borders, title bars and the lines between shared-border panes: off, theme, or a colour (#rrggbb, 0-255, a slot name or a role name); empty follows appearance.background

default "" · off, theme

Where a pane's title sits on its row. auto keeps it away from the window buttons

default auto · auto, left, center, right

Title template accepting {title}, {index} and {cwd}

default ""

Edge of the pane the title is drawn on

default top · bottom, top, hidden

Shape of a pane's title: pill has rounded caps, tab is a plain fill, plain is the text on the border

default pill · pill, tab, plain

Punctuation that counts as part of a word for double-click selection

default @-./_~?&=%+#

Up on a list's first row goes to its last, and down on the last goes to the first

default true · true, false

When window borders are hidden: never, always, or while the mouse is idle

default disabled · disabled, always, mouse

Show a zoomed pane on the whole pane region with no border or title bar. Zoom size and zoom max width do not apply.

default false · true, false

Hand the zoom to the pane the focus lands on, so moving focus while zoomed shows the pane you moved to

default true · true, false

Width in cells of a zoomed pane. 0 fills the screen.

default 0

How much of the screen a zoomed pane takes, as a percent. Below 100 the layout around it stays visible at the edges.

default 95 · 50 to 100

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

default auto · auto, off

Detect a pane's foreground agent CLI and set its state glyph

default true · true, false

Seconds between checks. 0 uses 2. A negative number turns checks off.

default 0

Keep the machine from sleeping: while an agent works on this machine, while the daemon runs, or never. The display can still lock.

default off · off, agents, on

How much the daemon logs

default off · off, errors, basic, messages, verbose, trace

Save each pane's history and show it again after a daemon restart. A change applies when the daemon next starts.

default true · true, false

Most KiB one pane's saved history takes on disk. 0 uses 2048. A change applies when the daemon next starts.

default 0 · 0 to 1048576

Most history lines one pane saves. 0 uses 1000. A change applies when the daemon next starts.

default 0 · 0 to 1000000

After a daemon restart, ask to resume each pane's agent conversation, resume it, or do neither

default ask · ask, auto, off

The size of a session with more than one client: the client that last had input, the smallest client, or the largest client

default latest · smallest, largest, latest

Show the on-screen keycast of recent keypresses

default false · true, false

Go time layout the clock is drawn with, e.g. 15:04 or Mon 3:04PM

default 15:04

Background under the dock: off, theme, or a colour (#rrggbb, 0-255, a slot name or a role name); empty follows appearance.background

default "" · off, theme

Draw the dock as one row with no rule. The panes get one more row

default false · true, false

Icon in the mode pill in terminal mode. An empty value shows no icon. default uses the icon of the glyph set

default default

Icon in the mode pill while tiling is on. An empty value shows no icon. default uses the icon of the glyph set

default default

Icon in the mode pill in window mode. An empty value shows no icon. default uses the icon of the glyph set

default default

What the mode pill shows while tiling is on: tiling shows the tiling icon, input shows the terminal or window icon

default tiling · tiling, input

Show V or H after the tiling icon in the mode pill. The letter is the direction of the next split

default true · true, false

Draw rounded caps on every dock pill: the mode chip, the workspace tabs and the minimized windows. Off draws flat pills

default true · true, false

Where the dock shows an armed leader key: pill colours the mode pill, badge draws a separate badge

default pill · pill, badge

Cells a workspace pill's label may span before the pill cuts it (0 draws the whole name and scrolls the strip instead)

default 12 · 0 to 200

Workspace tab template accepting {index}, {name}, {icon} and {zoom} (empty: {name})

default ""

Show the clickable workspace strip in the dock

default true · true, false

Show the workspace name on hover when the pill cuts the name or does not show it

default true · true, false

Edge the dock sits on, or hidden

default top · bottom, top, hidden

Show the clock overlay

default false · true, false

Show the CPU graph in the dock

default false · true, false

Show RAM usage in the dock

default false · true, false

Go time layout the clock renders in (empty means 15:04); a layout without seconds refreshes once a minute

default ""

Above this size in MiB, o on a file of another machine shows the size and asks again before it copies the file here. 0 uses 200

default 200 · 0 to 1048576

Days a copy of a far file stays when nobody opens it again. 0 uses 7, and -1 keeps every copy

default 7 · -1 to 3650

Above this size in MiB, o on a file of another machine does not copy it here. 0 uses 4096

default 4096 · 0 to 1048576

The hints key labels every pane on the workspace, not only the focused pane

default false · true, false

Letters the hint labels are made of, easiest first

default asdfghjkl

Built-in patterns hints mode looks for: all, none, or names such as url,path,sha

default all

Percent of its light the text around the hints loses

default 60 · 10 to 90

Ctrl and a label opens the URL or path. It does not open on a remote client

default true · true, false

Command that starts a graphical desktop entry instead of a pane. The entry's argv is added to it. Use a command that takes an argv, such as "tuios-wayland launch --" or "niri msg action spawn --". Do not use one that joins its arguments into a shell line, such as "swaymsg exec --" or "hyprctl dispatch exec".

default ""

Keep the pane of a program the launcher started after the program exits. A line under the output shows the exit status. Needs a daemon session.

default false · true, false

Background of a tuios mermaid picture: theme for the theme's colour, or none for the terminal's own background

default theme · theme, none

Colours of tuios mermaid: tuios for the colours of your theme, or a named theme such as flexoki, nord or rose-pine

default tuios

The confetti burst: on or off

default on · on, off

A sweep crosses the cells a copy took: on or off

default on · on, off

Panes slide when they open, close, split, swap, snap, minimize or restore: on or off

default on · on, off

Milliseconds the layout motion takes at animation speed 100. 0 is a cut.

default 300 · 0 to 1000

A palette or dialog fades in as it opens: on or off

default on · on, off

Milliseconds the overlays motion takes at animation speed 100. 0 is a cut.

default 120 · 0 to 1000

The scrolling layout slides when the view moves: on or off

default on · on, off

Milliseconds the scroll motion takes at animation speed 100. 0 is a cut.

default 300 · 0 to 1000

The shimmer on a working agent row of the sidebar: on or off

default on · on, off

How tuios shows a workspace switch: slide, fade or none

default slide · slide, fade, none

Milliseconds the workspace motion takes at animation speed 100. 0 is a cut.

default 200 · 0 to 1000

A pane slides between its tile and the zoom box: on or off

default on · on, off

Milliseconds the zoom motion takes at animation speed 100. 0 is a cut.

default 200 · 0 to 1000

Shell command to run on an alert. Empty runs nothing.

default ""

Show the alert in the dock. Click it to go to the pane.

default true · true, false

Turn every agent alert on or off

default true · true, false

Send a desktop notification to the attached terminal

default true · true, false

Hours when nothing alerts. Write it as HH:MM-HH:MM.

default ""

Seconds to wait. tuios drops the alert if the pane changes state.

default 2 · 0 to 3600

Make an alert audible

default false · true, false

Shortest gap between two sounds, in seconds. 0 uses 3.

default 3 · 0 to 3600

How an alert sounds: a cue, a BEL, or both

default "" · audio, bell, both

Alert when an agent reports it finished

default true · true, false

Alert when an agent stops on an error

default true · true, false

Alert when an agent goes quiet

default false · true, false

Alert when an agent waits for you

default true · true, false

Alert when an agent starts work

default false · true, false

No alert for the focused pane while the terminal has focus

default true · true, false

What a pane's bell does: a dock message, a bell in your terminal, both, or nothing

default toast · toast, forward, both, off

Seconds an info message stays up. 0 uses the default, 2.

default 0 · 0 to 3600

Seconds an error stays up when error_sticky is false. 0 uses the default, 15.

default 0 · 0 to 3600

Make errors wait for esc instead of expiring

default true · true, false

The least severe tuios message the dock shows: info shows every message, warning only warnings and errors, error only errors. Agent and pane alerts do not use this level

default info · info, warning, error

Put messages below notifications.level in the log viewer. When off, they go nowhere. Warnings and errors always go to the log

default true · true, false

Offer to add a machine when a pane logs in to it with ssh or mosh and no [hosts] entry reaches it

default true · true, false

Alert on a message from one agent to another agent too.

default false · true, false

Show a mail alert in the dock. Unset follows notifications.agent.dock.

default "" · true, false

Turn mail alerts on or off. Unset follows notifications.agent.enabled.

default "" · true, false

Send a desktop notification for mail. Unset follows notifications.agent.notify.

default "" · true, false

Make a mail alert audible. Unset follows notifications.agent.sound.

default "" · true, false

How a dock message looks: full shows a side bar and a countdown line, plain shows the icon and the text only

default full · full, plain

Seconds a warning stays up. 0 uses the default, 8.

default 0 · 0 to 3600

Drag and drop between panes over the kitty drag and drop protocol (OSC 72)

default false · true, false

Bridge drags to and from the desktop through a terminal that speaks the protocol (kitty)

default false · true, false

Keys the pane labels are made of, first pane first. Letters a to z and digits

default 1234567890

How the pane navigator lists the panes when it opens

default tree · tree, flat, cards

Open the pane navigator ready to type a search

default false · true, false

The path picker lists hidden files. Alt+h in the picker shows or hides them

default false · true, false

Corner the picture-in-picture view goes to first. It moves to another corner when the cursor enters it

default bottom-right · bottom-right, bottom-left, top-right, top-left

Height of the picture-in-picture view, border included, in cells

default 12 · 3 to 100

Width of the picture-in-picture view, border included, in cells

default 40 · 12 to 200

Which side of the review overlay has the keys when a review opens: the diff or the file list

default diff · diff, files

What a review shows when it opens: the changes since the base, or only the uncommitted changes. u switches between them

default base · base, uncommitted

Height of the scratch terminal, in cells (20) or percent (80%)

default 80%

Width of the scratch terminal, in cells (60) or percent (80%)

default 80%

Which effect runs, or random for a different one each time

default random · random, binarypath, blackhole, bouncyballs, bubbles, burn, crumble, decrypt, errorcorrect, expand, fireworks, highlight, laseretch, matrix, middleout, orbittingvolley, overflow, pour, print, rain, randomsequence, rings, scattered, slice, slide, smoke, spotlights, spray, swarm, sweep, synthgrid, thunderstorm, tuffbaby, unstable, vhstape, waves, wipe

Animate the screen after a spell with no input

default false · true, false

Minutes of quiet before the screen saver starts

default 10 · 1 to 240

Start even when a pane is running a command or an agent

default false · true, false

Wash behind the card: auto derives it from the theme; none, a hex color, or hex..hex work too

default auto

Window control marks: the macOS lights, your glyph set, or none

default auto · auto, macos, glyphs, none

Try to copy the capture to the clipboard

default true · true, false

Draw the cursor cell in the capture

default false · true, false

Folder where capture files are saved

default ~/Pictures/tuios

Font to draw the capture in when your terminal does not say which it uses

default JetBrains Mono, monospace

Font file to draw PNG with, also embedded in SVG and HTML. It wins over every other font choice.

default ""

Default output format for captures

default png · png, svg, ansi, html, txt

Dressing around the capture: a window card, a plain card, or nothing

default window · window, plain, none

Space around the card in pixels

default 48 · 0 to 128

Open the preview panel after a capture

default true · true, false

Card corner radius in pixels

default 10 · 0 to 32

PNG size multiplier

default 2 · 1 to 4

Draw a soft shadow under the card

default true · true, false

Title bar text, with {title}, {index} and {cwd} tokens

default {title}

Hairline thumb over the content column, or a full-height track

default track · thin, track

One-cell glyph for the thumb. Empty uses the style's own.

default ""

Bar colour: quiet, border, muted, or a colour (#rrggbb, 0-255, a slot name or a role name)

default quiet · quiet, border, muted

One-cell glyph for the track, or none. Empty uses the style's own.

default ""

Background behind selected text

default #45475A

Draw selected text bold as well as tinted

default false · true, false

A command that gets each copy mode yank on stdin. Its output goes to the clipboard. If this is empty, tuios copies the selection as it is.

default ""

Where copy mode puts its cursor: on the terminal cursor or in the center

default cursor · cursor, center

Background of the copy mode cursor block

default #39C5CF

Text colour under the copy mode cursor. Empty keeps it.

default #08222B

Selected text colour. Empty keeps the colour it already has.

default ""

Sweep a band of light over text that was just copied. Set motion to none to turn it off.

default true · true, false

The light the copy sweep is made of

default ""

Milliseconds one copy sweep takes

default 420 · 80 to 3000

The shape the copy sweep takes

default diagonal · diagonal, diagonal-reverse, horizontal, vertical

Background behind the match the cursor is on

default #E5A93D

Text colour of the match the cursor is on. Empty keeps it.

default #1C1B19

The format multi copy mode yanks in: plain, markdown or json

default plain · plain, markdown, json

What happens when a program in a pane sets the clipboard: off, ask, focused (the focused pane only, others ask) or on

default focused · off, ask, focused, on

Background behind every search match

default #8A6D2F

Text colour of a search match. Empty keeps the colour it has.

default #F5E7C8

How many yanks to keep to paste again. When it is full, the oldest goes. 0 keeps none.

default 20 · 0 to 1000

Most KiB all paste buffers hold together, at most 262144 (256 MiB). When it is full, the oldest go. 0 uses 16384.

default 16384 · 0 to 262144

Count staged, changed and untracked paths in the rail's git section. The only part of it that costs a walk of the working tree.

default true · true, false

How long an agent row rests (idle, unknown, or done and seen) before the rail folds it into one line: a duration such as 1h, or off

default 1h

Background under the rail: off, theme, or a colour (#rrggbb, 0-255, a slot name or a role name); empty follows appearance.background

default "" · off, theme

Background of the row under the cursor while the rail has the keyboard: a colour (#rrggbb, 0-255, a slot name or a role name); empty keeps the theme's

default ""

Space between the rail's sections: normal, or roomy for a blank row in front of each section after the first

default normal · normal, roomy

The terminal editor that opens a text file. If this is empty, tuios uses $EDITOR, then $VISUAL, then vi.

default ""

Show the session rail

default true · true, false

Let the files section create, rename, delete, copy and paste

default true · true, false

Where a delete sends the file: the trash, or nowhere

default trash · trash, permanent

Drag a row of the files section into a pane to paste its path

default true · true, false

Draw each file icon in its file type's own colour

default true · true, false

Draw a nerd font icon per file type in the files section

default true · true, false

How the files section draws: list shows one folder at a time, tree opens folders in place under one root

default list · list, tree

What a click on a folder row does

default navigate · navigate, cd, both

Give each repository a row of its own, with the main checkout under it. When off, the main checkout's row is the repository's row

default false · true, false

How the rail's section headers read: lowercase keeps the quiet furniture look, uppercase draws them as headings

default lowercase · lowercase, uppercase

How a rail section header is drawn: auto, plain, rule, pill, or icon with the section's icon

default auto · auto, plain, rule, pill, icon

Scroll a hovered row's overflowing title

default true · true, false

Show a session's panes in the terminals section while the pointer or the rail cursor is on its row

default true · true, false

Each session keeps its own shown or hidden rail. Off, showing or hiding the rail applies to every session

default false · true, false

Edge the rail sits on, or hidden

default right · left, right, hidden

How the rail marks the row you are on: bar in the gutter, marker glyph, underline, or pill

default bar · bar, marker, underline, pill

Section names in the order the rail stacks them, each with an optional percent share. A name left out is a section the rail does not draw, and "spacer" is an empty block you may repeat. The files control can still open a files section that the list leaves out.

default sessions:25,terminals,files:25,agents:34

Show the window count on each session row

default true · true, false

Show the agent-state glyph on each row

default true · true, false

Show the switch number ahead of each session name

default false · true, false

A heading line over each agent's subagents that opens and shuts their rows: off, or on and expanded or collapsed at the start

default off · off, expanded, collapsed

What each subagent row shows, a comma list of mark, name, type, time and note

default mark,name,time,note

How long a finished subagent's row stays after it ends: a duration such as 30s, or off to keep it until the daemon drops it

default off

The most lines one agent's subagents take, the +N more line included. 0 is no limit.

default 0 · 0 to 16

How an agent row shows its subagents: a row for each under it, the rows on tree lines, or the count alone

default rows · rows, tree, count

Label the collapsed strip on hover

default true · true, false

Preferred rail width in columns on a wide screen

default 24

Percent of its light an unlit cell loses

default 75 · 10 to 95

Cut the beam at its edge, or fade it out. A fade sends about three times the bytes each time the beam moves

default hard · hard, soft

Light one part of the screen and dim the rest

default false · true, false

What the beam follows: the mouse, or the focused pane's cursor. The cursor sends fewer bytes to a remote client

default mouse · cursor, mouse

Half the beam's height, in rows

default 10 · 2 to 200

Move the mouse left and right fast to turn the beam on and off. A shake does not move the beam. The follow setting decides where it goes

default false · true, false

Make a bare "tuios" attach to a daemon-backed session instead of running standalone. TUIOS_NO_DAEMON=1 or --standalone overrides it. False when the config file has no [startup] table.

default true · true, false

Tiling scheme a new session starts in. An existing session keeps its own.

default bsp · bsp, master-stack, scrolling

Open one terminal automatically when a session starts empty

default false · true, false

Session a bare "tuios" attaches to. tuios makes it when it is gone. Empty attaches to the most recent session.

default ""

Start focused in terminal mode, when a window is present

default false · true, false

Start a new session tiled instead of floating. False when the config file has no [startup] table.

default true · true, false

Pane, by name or id, that a bare "tuios" focuses in startup.session. When no pane has that name, the focus does not change.

default ""

Open the review dialog on detection instead of only badging it

default false · true, false

What happens on entering a directory with a project tape

default ask · off, ask, auto

Show the RUNNING pill and a message while a tape plays

default true · true, false

When you switch to a workspace with no panes, open a new pane there. It starts in the folder of the pane you came from

default false · true, false

When the last pane on the workspace on screen closes, show the workspace you came from. Off shows the splash screen

default true · true, false

Where new worktrees go, as a template of {{ repo_path }}, {{ repo }} and {{ branch }}, with | slug to make one folder name. A relative path starts at repo_path. Empty puts them under $XDG_DATA_HOME/tuios/worktrees

default ""

A shell command to run in every new worktree before the agent starts, such as pnpm i. Empty runs nothing

default ""

Start the agent at once while the setup runs. A failed setup then keeps the worktree and the branch

default false · true, false