Remote Control Commands

Control running TUIOS sessions remotely via CLI

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 <keys> [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
keys	Yes	Keys to send (see format below)

Flags

Flag	Short	Type	Default	Description
--session	-s	string	""	Target session (default: most recently active)
--literal	-l	boolean	false	Send keys directly to terminal PTY (bypass TUIOS)
--raw	-r	boolean	false	Treat each character as a separate key (no splitting on space/comma)

Key Format

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, meta

Special keys: Enter, Return, Space, Tab, Escape, Esc, Backspace, Delete, Up, Down, Left, Right, Home, End, PageUp, PageDown, F1-F12

Examples

Enter Terminal Mode

# 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 <command> [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
command	Yes (unless --list)	Tape command name to execute
args	No	Arguments for the command

Flags

Flag	Short	Type	Default	Description
--session	-s	string	""	Target session (default: most recently active)
--list		boolean	false	List all available commands
--json		boolean	false	Output result as JSON (for scripting)

Examples

List Commands

# 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 <path> <value> [flags]

Arguments

Argument	Required	Description
path	Yes	Configuration path (see supported paths below)
value	Yes	New value for the configuration

Flags

Flag	Short	Type	Default	Description
--session	-s	string	""	Target session (default: most recently active)

Supported Configuration Paths

Path	Valid Values	Description
dockbar_position	top, bottom, left, right	Dockbar position
border_style	rounded, normal, thick, double, hidden, block, ascii	Window border style
animations	true, false, toggle	Enable/disable animations
hide_window_buttons	true, false	Show/hide window control buttons

Examples

Dockbar Position

# 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	-s	string	""	Target session (default: most recently active)
--json		boolean	false	Output as JSON

Examples

Table Format

# 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-name	No	Window ID or name (focused window if omitted)

Flags

Flag	Short	Type	Default	Description
--session	-s	string	""	Target session (default: most recently active)
--json		boolean	false	Output as JSON

Examples

Focused Window

# 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	-s	string	""	Target session (default: most recently active)
--json		boolean	false	Output as JSON

Examples

Table Format

# Get session info (table format)
tuios session-info

---

tuios logs

View daemon logs.

tuios logs [flags]

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	-n	int	50	Number of log entries to show (0 or --all for all)
--clear		boolean	false	Clear logs after viewing
--follow	-f	boolean	false	Follow logs (continuously show new entries)
--all		boolean	false	Show all log entries

Examples

Recent Logs

# 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.