Docs · Install

One binary, then agent-manager.

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

01 Homebrew macOS · Linux

Installs tmux with it if missing. The tap ships a cask, so an install from the older formula switches over with brew uninstall agent-manager first.

brew install yoanwai/tap/agent-manager

02 Install script macOS · Linux

Downloads the release for your platform, verifies it against the published checksums, and installs to ~/.local/bin. AGENT_MANAGER_INSTALL_DIR changes where, AGENT_MANAGER_VERSION pins a version.

curl -fsSL https://raw.githubusercontent.com/YoanWai/agent-manager/main/install.sh | sh

03 Arch Linux AUR

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

yay -S agent-manager-bin

04 mise

Reads the GitHub release directly, so it needs no registry entry. Install tmux with your own package manager.

mise use -g ubi:YoanWai/agent-manager

05 Go

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

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

06 Prebuilt binary amd64 · arm64

Straight from Releases, for macOS and Linux.

07 Windows WSL2

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.

08 Then run it

No config to write first and no daemon to start. The config file appears on the first run.

agent-manager

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:

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

The first five keys

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.