Skip to content

CLI Commands Overview

sbsh provides three main commands through a single binary using hard links (busybox-style):

Command Purpose Launches Attached
sbsh Interactive terminal Supervisor + Terminal Yes
sbsh terminal Background terminal Terminal only No (detached)
sb Management client Nothing (client only) N/A

All three are the same binary; behavior is determined by the executable name at runtime.

Command Comparison

sbsh - Interactive Supervisor + Terminal

Launches a supervisor attached to a terminal. Designed for interactive use:

sbsh
sbsh -p profile-name

Features:

  • Supervisor stays attached
  • Press Ctrl-] twice to detach
  • Terminal continues running after detach

sbsh terminal - Terminal Only

Launches a terminal in the background with no attached supervisor:

sbsh terminal --name my-terminal
sbsh terminal --name my-terminal -p profile-name

Features:

  • Terminal runs independently
  • No supervisor attached initially
  • Attach later with sb attach <name>
  • Perfect for automation and background tasks

sb - Client Management Tool

Pure client tool for managing existing supervisors and terminals:

sb get terminals
sb attach <name>
sb detach
sb get profiles

Features:

  • No process spawning
  • Works from any machine with socket access
  • Query and manage existing terminals

Common Workflows

Start and Detach

# Start interactive terminal
sbsh -p my-profile

# Detach (press Ctrl-] twice)
# Terminal keeps running

# Reattach later
sb attach my-terminal

Background Terminal

# Start background terminal
sbsh terminal --name background-task -p my-profile

# Attach when needed
sb attach background-task

List and Manage

# List terminals
sb get terminals

# List profiles
sb get profiles

# Get terminal details
sb get terminal my-terminal

See Also