Skip to content
Supaterm
Esc
↑↓navigate↵open⌘Jpreview
On this page

Tab commands

sp tab creates, selects, pins, unpins, renames, closes, and navigates tabs.

Create

sp tab new creates a tab in the current space when run inside Supaterm. Use --in to target a specific space. Trailing arguments after -- are treated as a terminal startup command. --script runs shell script text as the terminal startup command.

sp tab new -- ping 1.1.1.1
sp tab new --script 'echo hi; pwd'
sp tab new --script 'printf "ready\n"; exec "${SHELL:-/bin/zsh}" -l'
sp tab new --focus -- git status
sp tab new --in 1 --cwd ~/tmp -- ping 1.1.1.1
sp tab new --in <space-uuid> --cwd ~/tmp -- ping 1.1.1.1

Flags:

  • --focus focuses the new tab
  • --no-focus leaves focus unchanged
  • --cwd <path> sets the starting working directory
  • --script <script> runs shell script text as the terminal startup command
  • --in <space> targets a space selector or UUID

Pass commands as trailing arguments after -- so sp preserves each argument. Use sp skills get coding-agents for multiline coding-agent prompts.

Focus

sp tab focus [tab] selects a tab.

sp tab focus
sp tab focus 1/2
sp tab focus <tab-uuid>

Rename

sp tab rename <title> [tab] locks a tab title.

sp tab rename Build
sp tab rename Logs 1/2
sp tab rename Deploy <tab-uuid>

Pin

sp tab pin [tab] pins a tab.

sp tab pin
sp tab pin 1/2
sp tab pin <tab-uuid>

Unpin

sp tab unpin [tab] unpins a tab.

sp tab unpin
sp tab unpin 1/2
sp tab unpin <tab-uuid>

Close

sp tab close [tab] closes a tab.

sp tab close
sp tab close 1/2
sp tab close <tab-uuid>

Use these commands to move between tabs in a space. The optional target is a space selector or UUID.

sp tab next
sp tab prev 1
sp tab last <space-uuid>

Output

Mutating tab commands support the standard output flags:

sp tab new --json --focus -- git status
sp tab focus --plain 1/2
sp tab close --quiet 1/2