Help / Guides / Running parallel agent sessions (amux)
Guides
Running parallel agent sessions (amux)
How we run many agent CLI sessions in parallel with amux — and where the full command reference lives.
We run many long-lived agent sessions (Claude Code and similar) in parallel
using amux — a lightweight manager that keeps each session in its own
persistent tmux window, with a web dashboard and remote control. You register
a session against a working directory, start it, and attach or detach whenever
you like; the agent keeps running in between.
The full, generic command reference — lifecycle, listing, attaching, remote control, and the behavior gotchas — lives on the Agentic AI handbook, so there’s one place to maintain it:
- amux — parallel agent sessions in tmux (opens in new tab) — the complete reference.
- amux quick reference (opens in new tab) — every command on one page.
The two things people ask first
- Compact session list.
amux lsgets long fast. Useamux ls -cfor a one-screen grid, oramux ls | less -Rto page it. - Attaching a remote session. Over the API,
startandattachare different:amux-remote <box> start <name>starts the session on the other machine but does not connect you — follow it withamux-remote <box> attach <name>.
For anything deeper, follow the handbook links above.
Source: content/guides/parallel-agent-sessions.md · maintained in the lab docs repository.