Panes, groups and windows
Split the stage, keep several scenes on tap, put documents and terminals beside your agents, and drive it all from the keyboard.
Splitting the stage#
The stage is a split tree, the way a terminal multiplexer is: split right, split down, and every leaf is one of four things — a session, a terminal, the workspace shell, or a document. Drag any divider to resize; double-click it to even the split out again.
- ⌘DNew pane, splitting right
- ⇧⌘DNew pane, splitting down
- ⌘WClose the focused document; when it was the last one, the tile; then the pane
- ⇧⌘⏎Zoom the focused pane to the whole stage, and back
- ⌃`Flip the focused pane between chat and its agent's terminal UI
- ⌃⇧`Open a fresh standalone terminal pane
Groups: several scenes, switched instantly#
One split tree is not enough for real work, because real work has more than one shape. Groups are complete scenes — each with its own layout — switched from the strip in the title bar. Nothing is torn down when you switch, so a group is a set of views, never a container of processes.
- A session can appear in as many groups as you like. Watch the same agent from the review scene and the debugging scene at once.
- Closing a group closes the view only. Its sessions keep running and stay in the sidebar — Mirasim says so before it closes.
- Each group tab shows what it contains, and pulses when something inside is running or waiting on you.
The stripOne tab per scene. Each holds its own layout, and each tells you what is inside it. — this control is not on the captured screen.
The buttons in this panel work — click them to look around.
- ⌘TNew group
- ⌃⇥Cycle groups (⌃⇧⇥ backwards)
- ⌥⌘→Cycle groups with the other hand (⌥⌘← backwards)
Documents and terminals on the same stage#
Files, diffs and terminals are tiles, peers of your sessions — so reading a file never hides the agent that wrote it.
A pane can hold more than one thing, switched by a tab bar in its own header — ⇧⌘T adds a tab, and drag reorders them. What makes this safe for sessions is that a tab you are not looking at keeps running: its live updates, transcript, scroll position and half-typed message are all still there, it still holds its row in the sidebar, and it still counts toward its group's badge. Switching tabs uncovers a session rather than reopening it.
Double-click a tab, or press F2, to rename it in place. Renaming a session's tab renames the session itself, so the new name follows it into the sidebar and everywhere else; a terminal or blank tab keeps its name on the tab. A terminal names itself after the first command you run in it.
When you open a document and the stage is already full, Mirasim asks rather than guessing: stack it into a document tile, or start a new group for it.
Terminals are first-class too. A session pane can flip to the agent's own terminal UI — the real TUIs of Claude, Codex and Pi GUI, preserved exactly, with their own authentication and their own rendering. A standalone terminal pane is just a shell in your workspace, for the commands you want to run yourself.
Drag a file or folder onto any terminal pane and its path is typed in for you, quoted so spaces do not break it — the same move you would make in a real terminal, and it works whether the pane holds an agent's TUI or a plain shell.
More than one window#
One stage is not always enough screen. The workspace surface — file explorer, search, source control, artifacts and terminal — opens as its own window on the desktop, so you can put code on a second display while the agents keep the first. Artifact previews can do the same.
- ⇧⌘EOpen the files and Git surface for the focused pane's workspace
- ⌘FFind within the transcript you are reading — next, previous, and a match count
The command palette#
⌘K opens one search box over three things at once: your sessions, the workbench's own commands, and the full text of every recorded transcript. It is the fastest path to almost anything, and the only navigation you need to memorize.
- Sessions — ranked by recency, opened as a pane on ⏎.
- Commands — new session, split right, split down, close pane, zoom pane, theme, language, settings, the files surface.
- Full-text matches — every transcript scanned as you type, with progress while it runs and a hit count when it finishes. Space splits terms; "quotes" match exactly.
The paletteOne box over three things at once: your sessions, the workbench's own commands, and the full text of every recorded transcript. — this control is not on the captured screen.
The buttons in this panel work — click them to look around.
- ⌘KOpen or close the palette
- ↑↓Move through results
- ⏎Open the selected result
- ⎋Close
Something wrong or missing on this page? Tell us