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

Pane commands

sp pane splits, focuses, closes, resizes, captures, checks readiness, notifies, and sends text to panes.

Split

sp pane split <direction> creates a new pane beside the current pane when run inside Supaterm. Use --in to target a tab or pane explicitly. Trailing arguments after -- are treated as a terminal startup command. --script runs shell script text as the terminal startup command.

sp pane split right
sp pane split down -- htop
sp pane split down --script 'echo hi; pwd'
sp pane split --layout keep right
sp pane split --in 1/2 left
sp pane split --in <tab-uuid> left
sp pane split --in 1/2/3 down -- tail -f /tmp/server.log

Flags:

  • --layout keep preserves the existing pane sizing
  • --layout equalize equalizes panes after splitting
  • --focus focuses the new pane
  • --no-focus leaves focus unchanged
  • --cwd <path> sets the starting working directory
  • --script <script> runs shell script text as the terminal startup command
  • --in <tab-or-pane> targets a tab selector, pane selector, or UUID

Focus And Close

sp pane focus
sp pane focus 1/2/3
sp pane focus <pane-uuid>

sp pane close
sp pane close 1/2/3
sp pane close <pane-uuid>

Send Text

sp pane send sends literal text. It accepts an optional pane target first, or stdin.

sp pane send --newline 'echo hello'
sp pane send 1/2/3 'pwd'
sp pane send <pane-uuid> 'clear'
sp pane send 1/2/3 -
printf 'pwd' | sp pane send

Use - to read the text argument from stdin.

Use --submit to paste the complete text and then press Enter as a separate input event:

sp pane send --submit <pane-uuid> - < prompt.txt

Use --newline only to append a literal newline. Do not use it to submit multiline prompts to an interactive coding agent.

Capture

sp pane capture captures visible output by default, or scrollback with --scope scrollback.

sp pane capture
sp pane capture --scope scrollback --lines 200
sp pane capture --json <pane-uuid>

Health And Readiness

sp pane health reports whether a pane is ready for input. sp pane wait-ready waits until readiness is true or the timeout expires.

sp pane health <pane-uuid> --json
sp pane wait-ready <pane-uuid> --timeout 5

Resize

sp pane resize <direction> <amount> [pane] resizes a pane by cell count.

sp pane resize right 10
sp pane resize down 5 1/2/3
sp pane resize left 8 <pane-uuid>

Layout

sp pane layout <mode> [tab] applies a layout to a tab.

Supported modes:

  • equalize
  • tile
  • main-vertical

Examples:

sp pane layout equalize
sp pane layout tile 1/2
sp pane layout main-vertical <tab-uuid>

Notify

sp pane notify sends a Supaterm notification for a pane.

sp pane notify --body "All tests passed"
sp pane notify --title "Deploy complete"
sp pane notify --subtitle "Production" --body "Deploy complete"
sp pane notify 1/2/3 --body "Deploy complete"
sp pane notify <pane-uuid> --body "Deploy complete"

Output

Mutating pane commands support the standard output flags:

sp pane split --json right
sp pane focus --plain 1/2/3
sp pane close --quiet 1/2/3