Managing Windows

Opening a New Window

Press Cmd + N to open a new window. The new window automatically clones the connection profile and working directory from your currently focused window, so you're ready to work on the same server right away.

You can also open a new window from the toolbar menu or the Command Palette.

Window Arrangement

vmux automatically places new windows around your existing layout:

2nd window — to the right
3rd window — to the left
4th window — above
5th window — below
6th–9th windows — fill the remaining corners
10+ windows — stack above the last window

Each window is independent with its own SSH session, so you can connect to different servers or run different tasks side by side.

Switching Between Windows

Pane Cycling

Use keyboard shortcuts to quickly move between open windows:

Shortcut	Action
Cmd + ]	Next window
Cmd + [	Previous window

Windows cycle in the order they were created.

Command Palette

Open the Command Palette and select a specific window by name to jump directly to it.

Hosts and Sessions Windows

The Hosts Window gives you saved hosts, pinned commands, recent commands, and SSH key tools.

The Sessions window shows all active and detached sessions in one flat list, sorted by recent activity. Tap a session to switch to it (or reopen it if detached).

Each window has a collapsible toolbar in the top-right corner. Tap Menu to expand it and access quick actions like opening Hosts, Sessions, the keyboard, the Command Palette, or Settings. The toolbar auto-collapses after a moment so it stays out of your way.

You can toggle the toolbar on or off through the Command Palette ("Toggle Toolbar").

System UI

By default, vmux hides the visionOS system window controls (the close button, grab bar, and resize handles) for a cleaner look. You can toggle them back on through the Command Palette ("Toggle System UI").

When system UI is visible, the standard visionOS window controls appear so you can reposition or resize the window with your hands.

Closing vs Terminating

Use Close Window (Keep Session Running) to detach only the UI. The underlying session stays running so reopen is an immediate reattach from the Sessions window.

To fully end a session, use the stop icon in the Sessions list.