| name | agent-manager |
| description | Run a fleet of AI coding agents as live tmux sessions with agent-manager. Use when a developer is running more than one coding agent, needs to see which one is working or blocked, wants to spawn another on an independent task, or wants to review an agent's diff without leaving the terminal. |
| license | Apache-2.0 |
| homepage | https://agent-manager.dev |
| repository | https://github.com/YoanWai/agent-manager |
Run a fleet of coding agents with agent-manager
agent-manager is a single Go binary on top of tmux. Every row in its list is a real tmux
session running a real coding CLI: the developer's own installation, login, config and MCP
servers. It never wraps or re-implements an agent; it reads the same pane a human would and
colours the row by what that pane is doing.
When to use this
- The developer is running more than one coding agent and cannot tell which is blocked.
- They want to spawn an agent on an independent task without losing the one already running.
- They want an agent's conversation to survive a crash, a reboot, or a closed terminal.
- They want to review a diff and send line comments back into the agent's prompt.
Do not reach for it to replace a coding CLI. It starts the CLIs that are already installed.
Install
macOS and Linux, amd64 and arm64. Windows runs it inside WSL2. Needs tmux 3.1+ and git.
brew install yoanwai/tap/agent-manager
Other routes: the install script, the AUR (yay -S agent-manager-bin), mise use -g ubi:YoanWai/agent-manager, go install github.com/YoanWai/agent-manager@latest, or a
prebuilt binary from the releases page.
The keys that matter
| Key | What it does |
|---|
space | Docks a prompt bar. On a group row it spawns a new agent with that prompt; on a session row it answers the agent already running there. |
tab | Cycles which CLI the next spawn starts. |
alt+w | Spawns the agent into a fresh git worktree and branch. |
ctrl+r | Opens a full-screen whole-file diff whose line comments go back to the agent as one review prompt. |
v | Revives a dead session on the conversation it held. |
Status colours
A row is coloured working, waiting, finished, idle or errored. Claude Code reports
through hook events; every other CLI is read from its pane with regexes. Seven CLIs ship with
working profiles: Claude Code, Codex, OpenCode, Grok, Gemini, Pi and Hermes. Any other CLI
becomes a managed session with one [tools.<name>] block in config.toml.
Driving it from inside an agent
Sessions of MCP-capable CLIs carry agent-manager's own MCP server over stdio, so an agent can
create_session to spawn a peer, send_session to message one, wait_for_session to block
on one, task to claim shared work, and reserve_files to declare what it is editing.
Reference
