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.

Updated Jul 29, 2026 · Francisco

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:

The two things people ask first

  • Compact session list. amux ls gets long fast. Use amux ls -c for a one-screen grid, or amux ls | less -R to page it.
  • Attaching a remote session. Over the API, start and attach are different: amux-remote <box> start <name> starts the session on the other machine but does not connect you — follow it with amux-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.