CLI Reference

tuios [flags]
tuios [command] [flags]

tuios --theme dracula
tuios --theme nord
tuios --theme tokyonight

tuios --list-themes

tuios --preview-theme dracula

tuios --theme $(tuios --list-themes | fzf --preview 'tuios --preview-theme {}')

tuios --debug

tuios --ascii-only

tuios --show-keys

tuios --border-style thick
tuios --border-style hidden

tuios --dockbar-position top
tuios --dockbar-position hidden

tuios --hide-window-buttons

tuios --scrollback-lines 20000

tuios --no-animations

tuios --window-title-position top
tuios --window-title-position hidden

tuios --hide-clock

tuios --cpuprofile cpu.prof

tuios new [session-name] [flags]

# Create session with auto-generated name
tuios new

# Create named session
tuios new mysession

# Create session with theme
tuios new work --theme dracula

tuios attach [session-name] [flags]

# Attach to most recent session
tuios attach

# Attach to named session
tuios attach mysession

# Attach or create if doesn't exist
tuios attach mysession -c

tuios ls

tuios kill-session <session-name>

tuios kill-server

tuios daemon [flags]

tuios ssh [flags]

# Start on default port
tuios ssh

# Custom port
tuios ssh --port 8022

# Listen on all interfaces
tuios ssh --host 0.0.0.0 --port 2222

# Connect from another machine
ssh -p 2222 user@hostname

tuios config path

tuios config edit

tuios config reset

tuios keybinds list

tuios keybinds list-custom

tuios tape play <file.tape>

tuios tape validate <file.tape>

tuios tape list

tuios tape dir

tuios tape show <name>

tuios tape delete <name>

tuios tape exec <file.tape> [flags]

tuios send-keys <keys> [flags]

# Enter terminal mode
tuios send-keys i

# Send key combo
tuios send-keys "ctrl+b q"

# Send to specific session
tuios send-keys -s mysession Escape

# Send literal text to terminal (use --raw to prevent space splitting)
tuios send-keys --literal --raw "echo hello"

tuios run-command <command> [args...] [flags]

# List all available commands
tuios run-command --list

# Create a new window
tuios run-command NewWindow "my-terminal"

# Get JSON output with window ID
tuios run-command --json NewWindow "dev"

# Switch workspace
tuios run-command SwitchWorkspace 2

# Target specific session
tuios run-command -s mysession ToggleTiling

tuios set-config <path> <value> [flags]

tuios set-config dockbar_position top
tuios set-config border_style rounded
tuios set-config animations toggle

tuios list-windows [flags]

# Table format
tuios list-windows

# JSON for scripting
tuios list-windows --json

# Query specific session
tuios list-windows -s mysession --json

{
  "windows": [
    {
      "id": "a1b2c3d4",
      "display_name": "dev",
      "workspace": 1,
      "focused": true,
      "width": 120,
      "height": 40
    }
  ],
  "total": 1,
  "focused_id": "a1b2c3d4"
}

tuios get-window [id-or-name] [flags]

# Get focused window
tuios get-window --json

# Get specific window by name
tuios get-window dev --json

# Get window by ID
tuios get-window a1b2c3d4 --json

# Query specific session
tuios get-window -s mysession --json

{
  "id": "a1b2c3d4",
  "title": "Terminal a1b2c3d4",
  "custom_name": "dev",
  "display_name": "dev",
  "workspace": 1,
  "focused": true,
  "minimized": false,
  "fullscreen": false,
  "x": 0, "y": 0,
  "width": 120, "height": 40,
  "cursor_x": 5, "cursor_y": 10,
  "cursor_visible": true,
  "scrollback_lines": 1000,
  "shell_pid": 12345,
  "has_foreground_process": false
}

tuios session-info [flags]

tuios session-info --json

# Query specific session
tuios session-info -s mysession --json

{
  "current_workspace": 1,
  "total_windows": 3,
  "mode": "terminal",
  "tiling_enabled": true,
  "tiling_mode": "bsp",
  "theme": "tokyonight",
  "dockbar_position": "bottom",
  "animations_enabled": true,
  "script_mode": false,
  "workspace_windows": [2, 1, 0, 0, 0, 0, 0, 0, 0]
}

tuios completion [bash|zsh|fish|powershell]

# Bash
tuios completion bash > /etc/bash_completion.d/tuios

# Zsh
tuios completion zsh > "${fpath[1]}/_tuios"

# Fish
tuios completion fish > ~/.config/fish/completions/tuios.fish

# PowerShell
tuios completion powershell > tuios.ps1

#!/bin/bash
# Create windows and capture their IDs
EDITOR_ID=$(tuios run-command --json NewWindow "editor" | jq -r '.data.window_id')
TERM_ID=$(tuios run-command --json NewWindow "terminal" | jq -r '.data.window_id')
LOGS_ID=$(tuios run-command --json NewWindow "logs" | jq -r '.data.window_id')

# Enable tiling
tuios run-command ToggleTiling

# Send commands to each window
tuios send-keys --literal --raw "nvim ." && tuios send-keys Enter
tuios run-command FocusWindow "$TERMINAL_ID"
tuios run-command FocusWindow "$LOGS_ID"
tuios send-keys --literal --raw "tail -f /var/log/system.log" && tuios send-keys Enter

#!/bin/bash
WINDOW=$(tuios list-windows --json | \
    jq -r '.windows[] | "\(.display_name)\t\(.id)"' | \
    fzf --with-nth=1 | \
    cut -f2)

if [ -n "$WINDOW" ]; then
    tuios run-command FocusWindow "$WINDOW"
fi

#!/bin/bash
while true; do
    WINDOW_COUNT=$(tuios session-info --json | jq '.total_windows')
    if [ "$WINDOW_COUNT" -ge 3 ]; then
        echo "Ready with $WINDOW_COUNT windows"
        break
    fi
    sleep 0.5
done

export TUIOS_DEBUG_INTERNAL=1
tuios

export EDITOR=vim
tuios config edit

export XDG_CONFIG_HOME=~/.custom_config
tuios config path

export COLORTERM=truecolor

tuios --theme dracula --border-style thick

# Create a new session
tuios new work

# ... do some work, then detach with Ctrl+B d ...

# List sessions
tuios ls

# Reattach later
tuios attach work

# Kill when done
tuios kill-session work

tuios ssh --host 0.0.0.0 --port 2222

tuios tape play examples/demo.tape

tuios config edit

tuios keybinds list-custom