Workspaces & Panes

Workspaces

Group your terminals by project. Each workspace has its own pane layout, tabs, and context. Switch between “ACME Project” and “Production Server” without losing your place in either.

Features

• Named workspaces — organize by project, client, or however you work
• Independent layouts — each workspace has its own split pane tree
• Drag and drop — reorder workspaces in the sidebar
• Sort options — default (manual), alphabetical, or recent activity
• Tab count — optional display of tab count after workspace names
• Recent workspaces — collapsible section, toggleable in preferences
• Workspace notes — markdown notes scoped to the whole workspace
• Overlord exemption — when Overlord is on, an eye-off button on the workspace row takes every tab in it out of supervision; it stays visible while the exemption is set
• Suspend & resume — suspend inactive workspaces to free resources (PTYs are killed, memory released). Resuming brings back exactly the tabs that had a live terminal when you suspended — maiTerm respawns and auto-resumes just those (with a progress modal for larger resumes), so a 20-tab workspace that had 3 agents running comes back with those 3 live, without waking tabs you never started. Auto-suspend after configurable timeout (15/30/60 min). A suspended workspace can also be woken from your phone with Resume workspace in maiLink
• Full-session restore on relaunch — on launch, maiTerm respawns and auto-resumes every tab that was live at last shutdown, across every workspace — one at a time, with a cancellable progress modal — so an agent in another workspace is already picking up where it left off when you switch to it. A window reload reattaches to terminals that are still running instead of respawning them
• Multi-window — open additional windows with independent workspace layouts; window positions remembered per monitor configuration
• Named windows — give a window a name of its own instead of letting the titlebar follow whichever workspace is active — see Naming a window

Naming a window

The middle of the titlebar shows the active workspace, which changes under you and says nothing about the window as a whole. Double-click it to give the window its own name; press Enter to keep it or Escape to discard. Clear the name and the titlebar goes back to following the active workspace.

The name is the window’s everywhere it’s referred to: macOS uses it in Mission Control and Cmd+Tab, agents see it through listWindows, and it’s what maiLink calls the window on your phone — all of which otherwise have only an internal label like main to go by. A duplicated window keeps the name of the one it was copied from.

Panes

Panes are the containers within a workspace. Each pane holds one or more tabs (terminal, editor, or diff).

Split Panes

• Horizontal and vertical splits — create any layout you need
• Drag to resize — adjust split ratios by dragging the divider
• Recursive splits — splits within splits for complex layouts
• Terminal persistence — terminals survive split tree changes via the portal pattern
• Drag-to-split (off by default) — dragging a tab onto another pane moves it there. Dropping it on a pane’s edge to create a split is opt-in, under Preferences → Tabs → Dragging: a pane’s top edge sits directly under its own tab bar, so a few pixels of drift while clicking a tab used to split the pane. Cmd+D and the tab’s context menu split either way

Per-Tab Notes

Each tab has its own markdown notes panel. Track TODOs, paste connection strings, jot down what you’re debugging — right next to the terminal doing the work.

Your coding agent — Claude Code or Codex — shares the same panel. Ask it to write down what it just did, keep a running TODO list, or summarize a debugging session, and it edits the notes directly through MCP tools — no copy-paste. It can read, write, update, organize, merge, and clean up both tab and workspace notes, so your notes stay current while you work.

• Markdown or plain text — your choice per tab
• Agent-maintained — ask your agent to write, update, and tidy your notes via MCP tools
• Interactive checkboxes — rendered in preview mode
• Editable tables — click any table cell in preview mode to edit it in place; Tab moves between cells
• Edit and preview modes — state persisted per tab
• Configurable — font size, font family, panel width