mpmux by Mighty Painting
~/mpmux ❯ mpmux --features --verbose

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 tabCtrl+Shift+T
Split rightCtrl+Shift+O
Split downCtrl+Shift+E
Move focusCtrl+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 paletteCtrl+Shift+P
On a touch screenswipe 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 restoreCtrl+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.

CopyCtrl+Shift+C
PasteCtrl+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 promptCtrl+Shift+PageUp / PageDown
Scroll freely in the mapShift + 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 hostsystemctl --user enable --now mpmux-sessiond
Open a hosted sessionmpmux --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 closeCtrl+Alt+O
On a touch screenswipe 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.

Searchjust type
OpenEnter
Open one of the first nine1-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 overviewCtrl+Alt+O
Find and opentype, 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.

ZoomCtrl+scroll or pinch
Panscroll or drag the canvas
Jumpclick 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 tablettouch and hold
Open on a desktopCtrl+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.

Promptspie 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 picturechafa --format kitty picture.png
Look closerclick 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 filempmux-cli media show chart.png
Step through← → in the Viewer
Text sizeCtrl + / 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 backdouble-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 guestmpmux-cli media show life.wasm
Launch from a documentmpmux-cli media show README.md
Give it the keystap 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 sidebarpie menu → Todos, or /todos-sidebar
Open or close a parent→ ← or double-click
See a todoEnter

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 agentWork on in the todo's dialog
Clarify firstRefine

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 roomdrag 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 panepane=$(mpmux-cli split-pane)
Type into itmpmux-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.