supaterm（supaterm 搜索）

Use this skill when you need to control Supaterm from a terminal that is already running inside Supaterm.

Terminology

• Space: the top-level container that contains multiple tabs, users might use this to separate work / life profile.
• Tab: a terminal tab inside a space
• Pane: a split terminal region inside a tab

Fast Start

Discover selectors and UUIDs:

sp ls --json

Creation commands use typed JSON keys instead of a generic id:

sp tab new --json -- git status
# => { "spaceID": "...", "tabID": "...", "paneID": "...", ... }

sp pane split --json right
# => { "spaceID": "...", "tabID": "...", "paneID": "...", ... }

Create and focus spaces:

sp space new Work
sp space new --focus Build
sp space focus 1

Create, focus, and pin tabs:

sp tab new --focus -- git status
sp tab focus 1/2
sp tab pin 1/2
sp tab unpin 1/2

Trailing arguments after -- are treated as a terminal startup command.

--script runs shell script text as the terminal startup command. End setup scripts with exec "${SHELL:-/bin/zsh}" -l when the tab or pane should stay open.

sp tab new --script 'make worktree-create WORKTREE=exploration && exec wt exec exploration -- "${SHELL:-/bin/zsh}" -l'

Split panes and send commands:

sp pane split down -- htop
sp pane split --layout keep right
sp pane send --newline 'echo hello'

Trailing arguments after -- are treated as a terminal startup command.

--script runs shell script text as the terminal startup command. End setup scripts with exec "${SHELL:-/bin/zsh}" -l when the pane should stay open.

Deep-Dive References

• Targeting and selectors
• Space commands
• Tab commands
• Pane commands
• Agent commands