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

Tab commands

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

Create

sp tab new creates a tab in the space this window displays when run inside Supaterm. Use --in to target another space in the same window; the space opens its saved tabs first when this window has not displayed it yet, and --focus also switches the window to that space.

sp tab new -- ping 1.1.1.1
sp tab new --script 'echo hi; pwd'
sp tab new --focus
sp tab new --group Build
sp tab new --group <group-uuid>
sp tab new --root
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 raw code in the login shell
  • --in <space> targets a space inside this window
  • --group <group> creates the tab in a targeted group
  • --root creates the tab at the space root

Do not combine --group and --root. When both are omitted, a new tab joins the current tab’s group. If the current tab is ungrouped, Supaterm creates a group containing the current and new tabs.

A tab with no command starts the account login shell.

Free mode allows five open tabs across every window and space. At the limit, sp tab new exits nonzero with the license_required error. Do not retry it. Close a tab or follow the license playbook. The user must handle payment and paste the key into the hidden sp license activate prompt.

Pass an executable and its arguments after -- to launch it directly. Supaterm resolves the executable with the caller’s PATH, preserves each argument exactly, skips shell startup files, and closes the tab when the executable exits. Use --script for builtins, aliases, or raw shell code. Supaterm enters the text visibly in the account login shell and returns to that same shell when the script ends. Use sp skills get coding-agents for multiline coding-agent prompts.

Move

sp tab move [tab] moves a tab into a group or to the space root. --index is a 1-based index within the destination.

sp tab move --group Build
sp tab move 1/2 --group <group-uuid> --index 1
sp tab move --root
sp tab move <tab-uuid> --root --pin --index 1

Provide exactly one of --group or --root. --pin is valid only with --root.

Focus

sp tab focus [tab] selects a tab. It switches the window to the tab’s space when the tab sits in another one.

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

Title

sp tab title [tab] prints a tab title. It uses the current tab when the target is omitted inside Supaterm.

sp tab title
sp tab title 1/2
sp tab title <tab-uuid> --json

Rename

sp tab rename <title> [tab] locks a tab title. Pass an empty title to clear the lock and restore the live terminal title.

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

Pin

sp tab pin [tab] pins a tab. Pinning a grouped tab extracts it to the pinned space root.

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, inside the window the command runs in. The optional value is a space target.

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
sp tab focus --plain 1/2
sp tab close --quiet 1/2