Session Management

Commands for creating, attaching to, and managing TUIOS sessions

tuios new

Create a new persistent TUIOS session and attach to it.

tuios new [session-name]

This starts a new session in the daemon (starting the daemon if needed) and immediately attaches you to it.

Sessions persist even when you detach, allowing you to reconnect later with tuios attach.

Arguments

Argument	Required	Description
session-name	No	Name for the new session (auto-generated if omitted)

Aliases

• n

Examples

Auto-Generated Name

# Create a new session with auto-generated name
tuios new

---

tuios attach

Attach to an existing TUIOS session.

tuios attach [session-name] [flags]

If no session name is provided, attaches to the most recent session. The session must already exist (use tuios new to create one).

This requires the TUIOS daemon to be running.

Arguments

Argument	Required	Description
session-name	No	Name of the session to attach to (most recent if omitted)

Flags

Flag	Short	Type	Default	Description
--create	-c	boolean	false	Create session if it doesn’t exist

Aliases

• a

Examples

Recent Session

# Attach to the most recent session
tuios attach
tuios a

---

tuios ls

List all active TUIOS sessions.

tuios ls

Shows session names, window counts, and whether clients are attached.

Aliases

• list-sessions

Examples

List Sessions

# List all active sessions
tuios ls
tuios list-sessions

Example Output

SESSION NAME    WINDOWS  ATTACHED
mysession       3        yes
development     5        no
server          1        yes

---

tuios kill-session

Terminate a TUIOS session and all its windows.

tuios kill-session <session-name>

This will close all windows in the session and disconnect any attached clients.

Arguments

Argument	Required	Description
session-name	Yes	Name of the session to terminate

Examples

Kill Session

# Terminate a specific session
tuios kill-session mysession
tuios kill-session development

This command will permanently close all windows in the session. Make sure to save any important work before terminating a session.

---

tuios kill-server

Stop the TUIOS daemon.

tuios kill-server

This will terminate all sessions and disconnect all clients.

Examples

Stop Daemon

# Stop the TUIOS daemon
tuios kill-server

This command will terminate all active sessions and close all windows. Use with caution.

---

tuios start-server

Start the TUIOS daemon in the background.

tuios start-server

The daemon manages persistent sessions. It starts automatically when you create or attach to a session, so you typically don’t need to run this command manually.

Examples

Start Daemon

# Manually start the daemon
tuios start-server

This command is hidden from help output because the daemon starts automatically. You rarely need to use it directly.