Quickstart

This is the fast path: install, set up a workspace, split it into panels, save an alias, and see your session restored when you reopen the app.

1. Install and launch

Install Gridmux for your OS (see Installation). On first launch it opens with a single workspace and one terminal using your platform’s default shell.

2. Create a workspace

A workspace groups terminals together. Create another one with Ctrl+T, or from the menu bar via File → New Workspace — you get an empty workspace with one terminal.

3. Open terminals and split into panels

Open more shells from File → New Terminal, or with the per-shell shortcuts:

• PowerShell — Ctrl+Shift+P
• CMD — Ctrl+Shift+C
• PowerShell 7 — Ctrl+Shift+7
• Git Bash — Ctrl+Shift+G
• WSL — Ctrl+Shift+W

New terminals open as tabs in the active workspace. To split the view into resizable panels, drag a terminal’s tab to the side or bottom of the area and drop it there.

Splitting is drag-based

There is no split keyboard shortcut yet — panels are arranged by drag-and-drop, handled by the layout engine. TODO: confirm the exact drop-zone affordance by trying it in the app.

4. Save an alias

Requires Extended

Aliases need the Extended edition (one-time or subscription). On the free Base edition the Aliases menu shows an upgrade prompt. See Activating your license.

Open the Aliases menu from the menu bar (or Ctrl+Shift+A), click + Group to make a group, then right-click the group → New Alias. Give it a name, enter one command per line, and click Create. Click the alias to run its commands in the active terminal. Full details in the Aliases guide.

5. Reopen and see it restored

Close Gridmux and open it again. Your workspaces, panels, and working directories come back automatically — the last-used session is restored on launch.

Help & shortcuts

Press F1 at any time to open the Quick Reference overlay — a built-in cheat sheet of shortcuts and gestures — or Shift+F1 for the About panel. The full list lives in Keyboard shortcuts.