Create your first space

Organize a project with a space, tab groups, pinned work, and split panes.

A space is the top-level container for one area of work. Use separate spaces for projects or contexts that should not share a tab list.

Create and name the space

Click the + button at the bottom of the sidebar, or open the command palette and choose Create Space. Give it a short name such as Supaterm.

You can also create and focus one from a terminal. These examples use jq to retain the IDs returned by sp:

space_id="$(sp space new --json Supaterm | jq -r '.target.spaceID')"

Creating the space displays it in this window, but the shell that ran the command keeps its original pane context. Retain the new ID for the next commands.

Right-click a space to rename or delete it. Supaterm always keeps at least one space.

Add a project group and tab

Create a group, then create a tab in the new space and move it into that group:

sp group new Project --in "$space_id" --color blue
tab="$(sp tab new --json --in "$space_id" --focus --cwd ~/code/supaterm)"
pane_id="$(printf '%s' "$tab" | jq -r '.paneID')"
sp tab move "$(printf '%s' "$tab" | jq -r '.tabID')" --group Project

You can also create groups from the sidebar, drag tabs into them, or drop one root tab onto another to create a group. Right-click a group to rename, color, collapse, pin, ungroup, or close it. Pinning a tab inside a group extracts it as a pinned root tab.

Split the tab

Press Command-D to split right or Command-Shift-D to split down. From the CLI:

sp pane split --in "$pane_id" right

The new pane inherits the current working directory unless you provide another one. See spaces, tabs, and panes for navigation and layout controls.