---
title: "Installation"
description: "Homebrew, the install script, the AUR, mise, go install, or a prebuilt binary. macOS and Linux, amd64 and arm64; Windows via WSL2."
canonical: "https://agent-manager.dev/docs/install/"
last-updated: "2026-09-14"
section: "Documentation"
source: "agent-manager"
---

# Installation

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

## Dependencies

| Tool | What it powers | Comes with |
| --- | --- | --- |
| tmux 3.1+ | Every agent session. | Homebrew, AUR, install script. |
| git | Diff review and worktree sessions. | Homebrew, AUR, install script. |
| wl-clipboard, xclip, or xsel | Pasting images into a prompt on Linux. | Your package manager. |
| notify-send | Desktop notifications on Linux. | Your desktop's notification package. |

The mise, `go install`, and prebuilt-binary routes install the binary alone, so install tmux and git with your package manager. When the manager starts without tmux, or the diff view cannot find git, it names the install command it detected.

## Homebrew

macOS and Linux. Installs tmux with it if you do not have it, and Homebrew runs on git.

```bash
brew install agent-manager
```

## Homebrew cask

macOS and Linux. Installs the released binary rather than building it, and pulls in tmux. The formula above is in homebrew-core and builds from source; this cask is the prebuilt route, and `agent-manager update` knows which one it is running under.

```bash
brew install --cask yoanwai/tap/agent-manager
```

## Install script

macOS and Linux. Downloads the release for your platform, verifies it against the published checksums, and installs it to `~/.local/bin`. Then it checks for tmux 3.1+ and git and offers to install whichever is missing through the package manager it finds.

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

| Variable | Effect |
| --- | --- |
| AGENT_MANAGER_INSTALL_DIR | Install somewhere other than `~/.local/bin`. |
| AGENT_MANAGER_VERSION | Pin a version instead of taking the latest. |
| AGENT_MANAGER_INSTALL_DEPS | `1` answers the dependency prompt up front, `0` skips it. |

## Arch Linux

[agent-manager-bin](https://aur.archlinux.org/packages/agent-manager-bin) installs the released binary and pulls in tmux and git.

```bash
yay -S agent-manager-bin
```

## mise

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

```bash
mise use -g ubi:YoanWai/agent-manager
```

## Go

Needs Go 1.26.5+, tmux 3.1+, and git. Lands in `$(go env GOPATH)/bin`.

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

## Prebuilt binary

macOS and Linux, amd64 and arm64, straight from [Releases](https://github.com/YoanWai/agent-manager/releases).

## Windows

agent-manager lives on tmux, a Linux and macOS tool, so it runs inside [WSL2](https://learn.microsoft.com/windows/wsl/install). 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.

```bash
agent-manager
```

| Key | What it does |
| --- | --- |
| space | Prompt the selected session without attaching, or spawn an agent on a group row. |
| ctrl+r | Review that session's changes. `c` comments a line, `C` sends every comment back. |
| v | Relaunch a dead session on its original conversation. |
| enter | Focus 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 every ten minutes and shows a `↑ vX.Y.Z available` badge in the header when a newer version is out. Press `u` on the update message, or `enter` on the version row in Settings, and what happens next follows the install. A Homebrew, mise or AUR install hands the terminal to that package manager's own upgrade command, so its progress and any password prompt behave as they would in a shell. An install-script, `go install` or manual download is updated in place, by downloading the release and swapping the binary. Either way the manager restarts into the new build with every session still running.

> **One case updates by hand** A pacman-owned install needs an AUR helper, `yay` or `paru`, on `PATH`. Without one the manager runs nothing and prints the command to use instead: `yay -S agent-manager-bin`.

From a shell, `agent-manager update` does the same thing without opening the manager: it works out what installed the binary, hands the upgrade to that package manager, and swaps the binary itself when nothing owns it. Add `--json` to get the result as a machine-readable record. The per-installer commands still work directly:

```bash
agent-manager update                                                                     # any install
brew upgrade agent-manager                                                                # Homebrew formula
brew upgrade --cask yoanwai/tap/agent-manager                                             # Homebrew cask
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
```