Every feature, in a short video
Each clip is recorded from mpmux itself, frame by frame, in a clean demo shell. Below each one: what it does and the keys to use. Or watch the whole tour, or read the guide.
❯ panes and focus
Tabs and splits
Every tab is its own work area and every split its own shell. Split right or down with one shortcut and move the focus with Ctrl+Alt and the arrow keys; nothing needs the mouse.
Splits nest as deep as you need, and dragging the line between two panes resizes them.
| New tab | Ctrl+Shift+T |
| Split right | Ctrl+Shift+O |
| Split down | Ctrl+Shift+E |
| Move focus | Ctrl+Alt+Arrow |
Command palette
Every action has a name. Open the palette, type a few letters, press Enter. It is the fastest way to find a feature you have not learned a shortcut for yet, and it works the same on a tablet.
| Command palette | Ctrl+Shift+P |
| On a touch screen | swipe with two fingers |
Maximize and restore
Zoom into one pane to concentrate on it. The other panes keep running where they are and the split layout comes back exactly when you restore. The transition shows where the pane lives, so you never lose your bearings.
| Maximize or restore | Ctrl+Shift+Return |
Select and copy
Drag to select text, then copy it; paste it into any pane. Selections work in long output too: drag past the edge and the pane scrolls.
On a tablet, use Select in the pie menu's keyboard entry.
| Copy | Ctrl+Shift+C |
| Paste | Ctrl+Shift+V |
Scroll map
Scroll a pane and an outline of its scrollback appears: every command you ran at its place, failed commands in red, agent answers marked. Drag in it to move block by block, or jump from prompt to prompt with the keyboard.
The marks come from your shell's prompt integration (OSC 133); fish sends them on its own, bash and zsh need three lines in their configuration. Agents can set their own marks.
| Previous / next prompt | Ctrl+Shift+PageUp / PageDown |
| Scroll freely in the map | Shift + drag |
❯ sessions that stay
Close the window, keep the shell
With the session host, shells run in mpmux-sessiond instead of the window. Close mpmux, lose the connection, or switch devices: the shell keeps running, and mpmux reattaches exactly where it is.
Here a long build keeps going while the window is closed; after reopening, the output has moved on.
| Start the session host | systemctl --user enable --now mpmux-sessiond |
| Open a hosted session | mpmux --sessiond-socket … --create-session |
❯ the overview
Every session at a glance
The overview shows every session as a live card, from all tabs. Cards update while programs run, so you see at once which agent is still working and which one waits for you.
| Open or close | Ctrl+Alt+O |
| On a touch screen | swipe up with three fingers |
Find a session
Type to search: the overview matches session names, titles, and the text on each screen. Enter opens the match. If it is part of a split, mpmux shows the split first and then grows the pane.
| Search | just type |
| Open | Enter |
| Open one of the first nine | 1-9 |
Agents that need you
Run several agents side by side, in splits and tabs. When one finishes or rings the bell in a tab you are not looking at, its card in the overview is marked, so you see at once who is waiting for an answer.
Type a few letters to find that agent and press Enter to go there. The marks clear when you look at the pane.
| Open the overview | Ctrl+Alt+O |
| Find and open | type, then Enter |
Zoom and pan
The overview is a canvas. Zoom in to read a card, pan freely, and use the minimap to jump across a large arrangement. Reset view brings everything back.
| Zoom | Ctrl+scroll or pinch |
| Pan | scroll or drag the canvas |
| Jump | click or drag in the minimap |
Arrange your sessions
In auto layout, drag a card left or right to change the order; a line shows where it lands. Turn auto layout off to place cards anywhere. mpmux remembers your arrangement.
❯ touch and tablets
Pie menu
Touch and hold a pane and the common actions open in a ring under your thumb: panes, prompts for agents, upload, the keyboard, and more. Slide to an entry and lift. On a desktop the same menu opens with a shortcut.
| Open on a tablet | touch and hold |
| Open on a desktop | Ctrl+Alt+X |
Prompts for agents
Typing long prompts on glass is slow. Under Prompts, the pie menu holds ready-made ones: Plan, Review, Test, Commit, Summarize, Continue, and more. Pick one and mpmux types it into the active pane and presses Enter.
The agent in this recording is a stand-in that answers with canned text; with Claude Code, Codex, or Pi the prompts work the same way.
| Prompts | pie menu, down left |
❯ images
Images in the terminal
mpmux speaks the Kitty graphics protocol, so programs draw real pictures in the terminal: plots, screenshots, previews. Click an image to see it large; Escape closes it.
Images work in hosted sessions and on the tablet too. chafa --format kitty is a good way to show any picture.
| Show a picture | chafa --format kitty picture.png |
| Look closer | click the image |
❯ the viewer
Charts, tables and documents
The Viewer is a panel beside the terminal. One command shows a picture, a table or a document there, and it stays while the output scrolls on. Showing a file again updates it in place, so a script can redraw its chart.
Agents use it to show their results, also from a hosted session on a server: the chart appears on the tablet.
| Show a file | mpmux-cli media show chart.png |
| Step through | ← → in the Viewer |
| Text size | Ctrl + / Ctrl − |
Full screen and back
Double-click a picture, document or table in the Viewer and it takes the whole window; double-click again and the terminal comes back.
When something brought the Viewer up for you, like a todo's Show in the Viewer, closing it returns the side panel to where you were.
| Full screen, and back | double-click or double-tap |
| Close and go back | ✕ in the Viewer |
Wasm canvases
Small interactive programs an agent writes, run by mpmux itself on the desktop and on Android, without a browser: a simulation, a plot to scrub, a game.
A README that links to them is a launcher: tap a name and the guest runs in its place; Back returns.
| Run a guest | mpmux-cli media show life.wasm |
| Launch from a document | mpmux-cli media show README.md |
| Give it the keys | tap the canvas |
❯ todos
The todo list
The agent keeps its plan as todos in your project, and the sidebar shows them beside the terminal: what was worked on recently first, steps under their parent.
Filter by text or #tag, open and close a parent, and open a todo to see its notes and act on it.
| Open the sidebar | pie menu → Todos, or /todos-sidebar |
| Open or close a parent | → ← or double-click |
| See a todo | Enter |
Work on a todo
Pick the next todo and choose Work on: mpmux types the prompt into the agent pane. The agent claims the todo, does the work, writes what it did into it and closes it; the sidebar follows.
Refine instead makes the agent ask you about the todo first.
| Send it to the agent | Work on in the todo's dialog |
| Clarify first | Refine |
Two panels at once
Each script's side panel is a panel of its own: the todos, the agent's run, a document in the Viewer. Split Panel in the panel's menu shows two of them at once, the run below the todos, both live while the agent works.
Drag the bar between them to share the room, pinch or Ctrl +/- to scale one, and fold the lower one away when you are done.
| Split the side panel | ☰ → Split Panel |
| Share the room | drag the bar |
| Fold it away | ⌄ on the lower panel |
❯ automate
Scripting
A running mpmux listens on a local socket. mpmux-cli builds layouts, types into panes, reads their screen, and shows messages and dialogs, so scripts and coding agents can drive the terminal they run in.
| Split and get the new pane | pane=$(mpmux-cli split-pane) |
| Type into it | mpmux-cli send-text --pane-id $pane … |
Your own tools
Scripts and agents can add their own interface inside mpmux: sidebars with lists, details, and actions, and dialogs with fields and buttons, all over the same control socket. The todos sidebar for agents is built this way.
Here a build script reports its steps to a checklist sidebar and asks before publishing.