agent-manager

Docs · Installation

Installation

macOS and Linux, amd64 and arm64. You need tmux 3.0+, since the whole thing is built on it. Windows runs it inside WSL2.

Homebrew

macOS and Linux. Installs tmux with it if you do not have it.

Terminal
brew install yoanwai/tap/agent-manager
Coming from the formula The tap ships a cask now, so an install from the older formula switches over with brew uninstall agent-manager first.

Install script

macOS and Linux. Downloads the release for your platform, verifies it against the published checksums, and installs it to ~/.local/bin. Install tmux with your own package manager.

Terminal
curl -fsSL https://raw.githubusercontent.com/YoanWai/agent-manager/main/install.sh | sh
VariableEffect
AGENT_MANAGER_INSTALL_DIRInstall somewhere other than ~/.local/bin.
AGENT_MANAGER_VERSIONPin a version instead of taking the latest.

Arch Linux

agent-manager-bin installs the released binary and pulls in tmux and git.

Terminal
yay -S agent-manager-bin

mise

Reads the GitHub release directly, so it needs no registry entry. Install tmux yourself.

Terminal
mise use -g ubi:YoanWai/agent-manager

Go

Needs Go 1.26+ and tmux 3.1+. Lands in $(go env GOPATH)/bin.

Terminal
go install github.com/YoanWai/agent-manager@latest

Prebuilt binary

macOS and Linux, amd64 and arm64, straight from Releases.

Windows

agent-manager lives on tmux, a Linux and macOS tool, so it runs inside WSL2. In a WSL shell, use the install script, Homebrew, or the Linux binary.

Run it

No config to write first and no daemon to start.

Terminal
agent-manager
KeyWhat it does
spacePrompt the selected session without attaching, or spawn an agent on a group row.
ctrl+rReview that session's changes. c comments a line, C sends every comment back.
vRelaunch a dead session on its original conversation.
enterFocus the session in place, so your keys reach the agent and the list stays. A attaches it full screen.
?The keys overlay, any time.

Updating

The manager checks GitHub Releases once a day and shows a ↑ vX.Y.Z available badge in the header when a newer version is out. Pull it in the way you installed:

Terminal
brew upgrade yoanwai/tap/agent-manager                                                    # Homebrew
curl -fsSL https://raw.githubusercontent.com/YoanWai/agent-manager/main/install.sh | sh   # Install script
mise upgrade --bump ubi:YoanWai/agent-manager                                             # mise
go install github.com/YoanWai/agent-manager@latest                                        # Go