Skip to main content

​
Splitting

Also via right-click in the terminal → Split right / Split down.
There’s no split item in the command palette. Shortcut or context menu only.

​
Every split is a new session

A split doesn’t divide the shell that’s there — it opens a new shell.
If you came from iTerm, tmux or Windows Terminal, this is the difference that will get you. Splitting isn’t “show the same shell in two places”: the new pane is born with a session of its own, with its own history and its own process. If the workspace is tied to an SSH host, the new pane is born on that host — the split inherits the connection instead of coming back to your machine.

​
Nesting

Splits are a tree: every pane can be split again, and the result can be split once more. There’s no limit in the code — the limit is your screen.
Two ways, and the second is the good one:
Directional navigation is geometric: TYBA computes where each pane sits on screen and goes to the real neighbor in that direction. It isn’t “the next one in the list” — with four nested panes, ⌘⌥→ goes to whoever is actually on the right. The cycle wraps: from the last one back to the first.

​
Resizing

With the mouse: drag the divider. With the keyboard, in 5% steps:
These four are not remappable — they’re fixed.
No pane disappears: the proportion is clamped between 10% and 90%. You can’t crush a pane to zero by accident.

​
Closing

⌘W closes the active pane.
Closing the last pane closes the tab along with it. The neighboring panes rearrange to take up the space.

​
The layout is remembered

The pane tree, the proportions and the active pane are saved on every change. Close and reopen TYBA and the layout comes back. What comes back inside the panes depends on Settings → Code → On app start:
SSH panes are the only ones that bring work back: the remote shell never stopped, and the reattach hands you back whatever was running. See session persistence.
Agent sessions never restart on their own, under any of the options. An agent coming back out of nowhere, unasked, would do work you didn’t ask for.

​
What doesn’t exist

​
See also

Tabs and workspaces

The layer above the panes.

Shortcuts

The whole list, and how to remap.