All documentation / Workspace guide

Workspace guide

Workspaces and terminal use

Build a persistent working layout and move through live terminal sessions without multiplying windows.

Tabs, Splits & Workspaces

Tabs

Create a tab with Cmd+T, select tabs 1–9 with Cmd+1 through Cmd+9, and close the active pane with Cmd+W. Closing the last pane also closes its tab.

Splits

Split right with Cmd+D or down with Cmd+Shift+D. Move between panes using previous/next or directional focus commands. Splits form a resizable binary tree inside each tab.

Workspaces

Workspaces group tabs under a required, case-insensitively unique name. Only one is visible, but processes in the others remain active. Select workspaces 1–9 with Cmd+Opt+1 through Cmd+Opt+9.

QuickTTY can restore workspace descriptions, tabs, split layout, current working directories, and focus after restart. It starts new processes; it does not preserve live processes across application termination.

Quake Mode

Press Cmd+Opt+P to switch the existing window between Normal and Quake presentations. QuickTTY reuses the same panes and live processes; no shell is restarted.

While Quake presentation is active, F12 globally shows or hides it on the display under the pointer.

Configure startup mode, global chord, height, animation duration, padding, focus-loss behavior, and screen pinning with quicktty-presentation-mode, quicktty-global-toggle, and the related quicktty-quake-* keys.

Focus behaviorQuake mode hides after focus loss by default, except while a menu, sheet, or system dialog is active.

Broadcast Input

Toggle broadcast for the active tab with Cmd+B. The tab and workspace chrome show when it is active.

QuickTTY routes the original logical keyboard event to every pane in that tab, allowing each terminal to encode it for its own keyboard mode. Paste asks for confirmation once and then targets those panes. Mouse events, scrolling, resizing, and interface commands are never broadcast.

Broadcast automatically turns off when you change tab or workspace, restore the app, or encounter a target surface error.