Documentation
Using Terminals
Terminals are the core of Vibe Terminal: each tab hosts one or more terminal sessions, can be split into panes, or dragged out into its own window. Terminals reach the local server as well as remote and shared servers through a relay.
Creating terminals
- Click the
+button in the title bar to open a tab with the default profile; - Click the chevron next to
+for the profile menu: terminal profiles grouped per server (local, connected, shared servers) — expand a group and pick a profile to open a terminal on that server; - Drag a local folder onto the title bar and drop it to open a new tab with that working directory (local server only; the dropped item must be a folder).
Mouse capture and the context menu
- Right-click inside a terminal opens its context menu: paste, split panes, quick commands, environment collections, copy-all-text, MCP setup lines and more, depending on the session;
- Applications that capture the mouse (opencode, pi, vim, tmux, htop, …) receive the pointer events instead — hold
Shiftto keep the regular operations available while such an app runs:- Copy text: hold
Shiftand select the text, then click somewhere else withShiftstill held to deselect; the selection is copied to the clipboard; - Context menu:
Shift+ right-click opens the context menu; - Links:
Shift+ click follows links normally.
- Copy text: hold
- To use regular terminal mouse behavior instead, choose
Disable Mousein the context menu or pressCtrl+Shift+Mwhile the terminal is focused. This client-side per-terminal switch stops mouse reports to the app while preserving selection, links, scrolling and the context menu. ChooseEnable Mouseor press the shortcut again to restore reporting.
Splits and drag organization
-
Split: right-click inside a terminal →
Split→Left/Right/Top/Bottomdivides the tab into panes, each an independent terminal; -
Merge by drag: drag a tab onto another terminal and dock zones appear (left/right/top/bottom); drop to merge the tab into the target tab as a new pane;
-
Detach to a window: drag a tab out of the tab strip (or onto another window) and the whole tab leaves its window as a new one. Sessions always run on the server — splits, merges, and drags never interrupt a running command.
Tabs and tab groups
- Tab — one terminal tab, possibly with several split panes;
- Tab group — a container organizing tabs. By default groups follow servers: the local server’s tabs live in
Ungrouped, and each shared server gets aName (Server)group; custom groups are supported; - Groups and windows — each window shows one active group through the title-bar group selector (or
All);Move Group to New Windowtears a whole group off into its own window, dedicating a window or monitor to one machine; - Groups and servers — a group remembers its server, so switching groups refocuses a server’s workspace; the profile menu follows the active group and only shows relevant servers’ profiles.