mpmux user guide#
mpmux is a fast terminal multiplexer. Its sessions keep running on a server and follow you to your desktop, tablet, and phone.
Read the chapters in order. Each chapter gives you something you can use at once, so you can stop after any chapter.
| # | Chapter | You learn to |
|---|---|---|
| 1 | First run | Install mpmux and use it as your terminal |
| 2 | Tabs, splits, and focus | Arrange your work without the mouse |
| 3 | Sessions that stay | Close the window and come back to the same shell |
| 4 | The overview | See every session and open one with a tap |
| 5 | Touch and tablets | Pair a tablet and work with the pie menu |
| 6 | Agents | Run and steer coding agents from any device |
| 7 | Files and images | Move files, show pictures in the terminal, and charts, tables, documents and pages in the Viewer |
| 8 | Across machines | Run the session host on a server, pair your devices |
| 9 | Make it yours | Change shortcuts, colors, and behavior |
| 10 | Automate | Drive mpmux from scripts and agents |
| 11 | Wasm canvases | Run small interactive programs in the Viewer (experimental) |
| 12 | Todos | Plan and share the work with your agent |
Look things up in the reference: every key, every setting, every mpmux-cli command, and the command-line options.
More:
- Getting started for agents: what coding agents can do inside mpmux.
- Run your own relay server: an Iroh relay for your devices.
Short videos show each feature. Their names (for example c03-tabs-splits)
refer to the clips in media/clips/.
Shortcuts in this guide are for Linux. On macOS, use Cmd where the guide says Ctrl for the mpmux shortcuts.