Muxie Get Muxie
Concepts Explanation

Workspaces & panes

The layout model — workspaces (Groups), the left rail and flyout, panes and splits, pane-tabs, and the browser pane.

Muxie is a workspace, not a flat tab strip. Understanding its few layout primitives makes everything else easier to navigate.

Workspaces (Groups)

A workspace — also called a Group — is a named collection of sessions. Use one per project, task, or context. Workspaces live in the left rail; create, rename, reorder, and drag sessions between them to keep unrelated work apart.

Toggle the rail with Ctrl+B. When the rail is collapsed, the collapsedGroupStyle setting controls whether you see individual session glyphs (dividers) or folded group menus (folders).

The rail and the flyout

Each workspace shows as a card in the rail. Hover a card to open its flyout: a quick list of every session in that workspace, each row showing live status — connection state, git branch, listening ports, a pull-request badge, and the agent status chip. You choose which of these appear under Settings → Sidebar.

Panes and splits

A pane is a rectangular view in the workspace grid. Split the focused pane to work side by side:

  • Ctrl+Shift+O — split right
  • Ctrl+Shift+E — split down
  • Alt + arrows — move focus between panes
  • Ctrl+Shift+Enter — zoom the focused pane (toggle)
  • Ctrl+Shift+= — equalize split sizes
  • Ctrl+W — close the focused pane

Pane-tabs

A single pane can hold multiple pane-tabs — stacked terminal or browser surfaces, with one visible at a time. They’re shown in a tab strip at the top of the pane. Cycle them with Ctrl+Shift+] and Ctrl+Shift+[. This keeps related shells together in one slot of the grid instead of spreading them across splits.

Top-level tabs and sessions

Across the top you have your sessions. Move between them with Ctrl+Tab / Ctrl+Shift+Tab, or jump directly with Ctrl+1 through Ctrl+9. Ctrl+Shift+T reopens the last closed tab. New tabs insert at the end or after the current one, per the newTabPlacement setting.

Note: Closing a pane that still has a running process (a command, dev server, or coding agent) asks for confirmation first when confirmBeforeCloseTab is on, so you don’t end work by accident — including remote sprite and SSH panes, where the daemon reports the foreground process.

Browser panes

A pane can also be a browser — a Chromium view for previewing a web app or reading docs without leaving Muxie. It has an address bar with a configurable search engine, back/forward, and reload. Browser panes can be driven by agents for automated previews. See Use a browser pane.

Files and panels

The right side of the window hosts dockable panels: the Files explorer (toggle with Ctrl+Shift+B), plus feature panels like Agents, Sprites, and SSH. Panels can be moved between the dock and the grid, and pinned to a specific workspace.