Split Panes

Creating Splits

Split your current window to run multiple terminals side by side without opening separate windows. Splits work the same way on visionOS, macOS, and iPhone.

The keyboard shortcuts in this page assume a hardware keyboard. On iPhone, attach a Bluetooth or USB keyboard to use them, or run the equivalent vsh command from the Command Palette.

Method	What it does
Cmd + D	Split vertically (new pane to the right)
Cmd + Shift + D	Split horizontally (new pane below)
vsh: `split-v`	Split vertically
vsh: `split-h`	Split horizontally
vsh: `split-left`	Split with new pane to the left
vsh: `split-up`	Split with new pane above
vsh: `split-auto`	Split in whichever direction gives the most space

Each new pane opens its own terminal session using the same connection profile as the original pane.

Navigating Between Panes

Move focus between panes using keyboard shortcuts or vsh commands.

Method	What it does
Cmd + ]	Focus next pane
Cmd + [	Focus previous pane
Ctrl + Tab	Focus next pane (alternate)
Ctrl + Shift + Tab	Focus previous pane (alternate)
Cmd + Option + Left	Focus pane to the left
Cmd + Option + Right	Focus pane to the right
Cmd + Option + Up	Focus pane above
Cmd + Option + Down	Focus pane below
vsh: `focus-left`	Focus pane to the left
vsh: `focus-right`	Focus pane to the right
vsh: `focus-up`	Focus pane above
vsh: `focus-down`	Focus pane below
vsh: `pane-next`	Focus next pane
vsh: `pane-prev`	Focus previous pane

The currently focused pane has an active cursor and receives keyboard input. You can also look at a pane to focus it on visionOS.

Resizing Panes

Adjust the size of the focused pane using keyboard shortcuts or vsh commands.

Method	What it does
Cmd + Ctrl + Left	Grow pane to the left
Cmd + Ctrl + Right	Grow pane to the right
Cmd + Ctrl + Up	Grow pane upward
Cmd + Ctrl + Down	Grow pane downward
vsh: `resize-left`	Grow pane to the left
vsh: `resize-right`	Grow pane to the right
vsh: `resize-up`	Grow pane upward
vsh: `resize-down`	Grow pane downward

Equalizing Splits

If your panes are different sizes and you want them evenly distributed:

Method	What it does
Cmd + Ctrl + =	Equalize all pane sizes
vsh: `split-equalize`	Equalize all pane sizes

This resets all panes in the window to equal dimensions.

Maximize and Restore

Temporarily maximize the focused pane to fill the entire window, then restore the previous layout.

Method	What it does
Cmd + Shift + Enter	Toggle maximize / restore
vsh: `split-max`	Toggle maximize / restore

While maximized, the other panes are hidden but their sessions continue running in the background. Toggle again to restore the split layout.

Closing a Pane

Close the focused pane without affecting other panes in the window.

Method	What it does
Cmd + Ctrl + W	Close current pane
vsh: `pane-close`	Close current pane

Closing a pane removes it from the split layout and redistributes space to the remaining panes. The underlying session can optionally be kept running -- see Managing Windows for the difference between closing and terminating.

Use Cmd + W to close the entire tab, or Cmd + Shift + W to close the window (all tabs and panes).

Keyboard Shortcuts Reference

Shortcut	Action
Cmd + D	Split vertical
Cmd + Shift + D	Split horizontal
Cmd + ]	Next pane
Cmd + [	Previous pane
Ctrl + Tab	Next pane (alternate)
Ctrl + Shift + Tab	Previous pane (alternate)
Cmd + Option + Arrow	Focus pane in direction
Cmd + Ctrl + Arrow	Resize pane in direction
Cmd + Ctrl + =	Equalize splits
Cmd + Shift + Enter	Maximize / restore pane
Cmd + Ctrl + W	Close pane