Documentation Index Fetch the complete documentation index at: https://mintlify.com/Gaurav-Gosain/tuios/llms.txt
Use this file to discover all available pages before exploring further.
Overview These commands allow you to control and inspect running TUIOS sessions from the command line, enabling scripting, automation, and remote management.
tuios send-keys Send keystrokes to a running TUIOS session.
tuios send-keys < key s > [flags]
By default, keys are sent to TUIOS itself (for window management, mode switching, etc). Use --literal to send keys directly to the focused terminal PTY. Use --raw to send each character as a separate key (no splitting on spaces).
Arguments Argument Required Description keysYes Keys to send (see format below)
Flags Flag Short Type Default Description --session-sstring ""Target session (default: most recently active) --literal-lboolean falseSend keys directly to terminal PTY (bypass TUIOS) --raw-rboolean falseTreat each character as a separate key (no splitting on space/comma)
Default mode (TUIOS control):
Single keys: "i", "n", "Enter", "Escape", "Space"
Key combos: "ctrl+b", "alt+1", "shift+Enter" (case-insensitive)
Sequences: space or comma separated, e.g. "ctrl+b q" or "ctrl+b,q"
Special tokens:
$PREFIX or PREFIX: expands to configured leader key (default: ctrl+b)
Modifiers: ctrl, alt, shift, super, metaSpecial keys: Enter, Return, Space, Tab, Escape, Esc, Backspace, Delete, Up, Down, Left, Right, Home, End, PageUp, PageDown, F1-F12Examples Enter Terminal Mode
Press Enter
Prefix Key Sequences
Send Control Keys
Literal Text to Terminal
Raw Text with Spaces
Target Specific Session
# Press 'i' to enter terminal mode tuios send-keys i
tuios run-command Execute a tape command in a running TUIOS session.
tuios run-command < comman d > [args...] [flags]
This allows you to control TUIOS remotely by executing tape commands. Use --list to see all available commands. Use --json to get machine-readable output for scripting.
Arguments Argument Required Description commandYes (unless --list) Tape command name to execute argsNo Arguments for the command
Flags Flag Short Type Default Description --session-sstring ""Target session (default: most recently active) --listboolean falseList all available commands --jsonboolean falseOutput result as JSON (for scripting)
Examples List Commands
Window Management
Workspace Control
Tiling Mode
UI Configuration
Target Specific Session
# List all available commands tuios run-command --list
Use --json flag when scripting to get structured output that’s easy to parse with tools like jq.
tuios set-config Set a configuration option in a running TUIOS session at runtime.
tuios set-config < pat h > < valu e > [flags]
Arguments Argument Required Description pathYes Configuration path (see supported paths below) valueYes New value for the configuration
Flags Flag Short Type Default Description --session-sstring ""Target session (default: most recently active)
Supported Configuration Paths Path Valid Values Description dockbar_positiontop, bottom, left, rightDockbar position border_stylerounded, normal, thick, double, hidden, block, asciiWindow border style animationstrue, false, toggleEnable/disable animations hide_window_buttonstrue, falseShow/hide window control buttons
Examples Dockbar Position
Border Style
Animations
Window Buttons
Target Specific Session
# Change dockbar position tuios set-config dockbar_position top tuios set-config dockbar_position bottom tuios set-config dockbar_position left tuios set-config dockbar_position right
tuios list-windows List all windows in the session.
tuios list-windows [flags]
Shows window ID, title, workspace, focused state, and more. Use --json for machine-readable output that can be used for scripting.
Flags Flag Short Type Default Description --session-sstring ""Target session (default: most recently active) --jsonboolean falseOutput as JSON
Examples Table Format
JSON Format
Target Specific Session
# List all windows (table format) tuios list-windows
tuios get-window Get detailed info about a window.
tuios get-window [id-or-name] [flags]
If no ID or name is provided, returns info about the focused window. Use --json for machine-readable output.
Arguments Argument Required Description id-or-nameNo Window ID or name (focused window if omitted)
Flags Flag Short Type Default Description --session-sstring ""Target session (default: most recently active) --jsonboolean falseOutput as JSON
Examples Focused Window
By Name
By ID
Target Specific Session
# Get focused window info tuios get-window tuios get-window --json
tuios session-info Get current session information.
tuios session-info [flags]
Shows mode, workspace, tiling state, theme, and more. Use --json for machine-readable output.
Flags Flag Short Type Default Description --session-sstring ""Target session (default: most recently active) --jsonboolean falseOutput as JSON
Examples Table Format
JSON Format
Target Specific Session
# Get session info (table format) tuios session-info
tuios logs View daemon logs.
This is useful for debugging issues with remote commands, sessions, and PTY handling. Logs are stored in a ring buffer (1000 entries by default).
Flags Flag Short Type Default Description --lines-nint 50Number of log entries to show (0 or --all for all) --clearboolean falseClear logs after viewing --follow-fboolean falseFollow logs (continuously show new entries) --allboolean falseShow all log entries
Examples Recent Logs
All Logs
Clear Logs
Follow Mode
# View last 50 log entries (default) tuios logs # View last 100 log entries tuios logs -n 100 tuios logs --lines 100
Use tuios logs -f to monitor daemon activity in real-time, similar to tail -f.