supaterm
Installation
SKILL.md
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
Related skills