Skip to main content

​
The difference

The workspace is the project: a folder, a color, a group, a spot in the sidebar. The tab is a view inside it.
The interface calls a workspace a “session”. Rename session, Session options, Search sessions… — all of that acts on the workspace. See the interface tour.

​
Tabs

​
Creating

The + button at the end of the bar, or:
⌘T

​
Closing

The X that appears when you hover the tab.
⌘W / Ctrl+Shift+W closes the pane, not the tab. The tab closes along with it when it was the last pane — see split panes.

​
Switching

By clicking, or:
Each tab’s tooltip is its numeric shortcut.

​
The tab name is derived

You don’t choose it. TYBA resolves it in this order:
  1. The view’s name, if it’s a special view.
  2. The folder of the tab’s first session — that’s the normal case.
  3. The session title.
  4. shell.
Change folders in the shell and the label follows.

​
Workspaces

​
Switching workspaces

With many workspaces open, the sessions palette beats cycling.

​
The context menu

Right-click a workspace in the sidebar — or the ⋯ that appears on hover (Session options):
Kill session doesn’t ask anything. There’s no confirmation dialog and no undo.
The Settings workspace has no context menu and no preview.

​
Color and group

Color and group belong to the workspace only — the tab neither inherits nor has its own. The color shows as a dot in the sidebar and in the preview. The group becomes a foldable header, with a + to open another session already inside it. Creating a group means typing a name that doesn’t exist yet in New group…. An empty name removes it from the group.

​
The side view

A pane that lives beside the tab column — not inside a tab. Today it serves one purpose: a session’s diff. It opens from:
  • The View changes button in the header.
  • Review diff in the workspace context menu.
  • The Uncommitted changes and Review worktree diff chips.
Drag the divider to change the proportion — clamped between 10% and 90%, same as panes. The expand button (Expand diff) hides the terminal column; Back to split brings it back. While it’s open, the workspace gets a child row in the sidebar with the session title and an X (Close diff). The diff’s own X is Close review.
It’s one per workspace. Opening another session’s diff replaces what’s there.

​
Special views

Some tabs have no panes and no terminal — they take up the whole tab: In the Settings view and the Connections view, the tab bar disappears.
Containers lives in a workspace of its own, of type docker — it doesn’t mix with yours.

​
SSH workspaces

Connecting to a host creates one workspace, which inherits the host’s alias (already locked), color and group.
Opening a whole Host Group doesn’t make one workspace per host. It makes a single one, with the hosts in side-by-side panes — which is what makes broadcast make sense: type once and check the N outputs together.
See hosts and groups.

​
What doesn’t exist

Want a name of your own? Rename the workspace. It’s the only layer that takes your name.

​
See also

Interface tour

The whole mental map.

Split panes

The layer below the tab.

Command palette

The fast way to switch workspaces.

Shortcuts

The whole list, and how to remap.