agent-manager

文档 · 安装

安装

本页由英文版翻译而来。两者不一致时，以英文版为准。

支持 macOS 和 Linux，amd64 和 arm64。你需要 tmux 3.1+，因为整个工具都构建在它之上。Windows 上以 psmux 3.4+ 原生运行，面板 shell 为 PowerShell 7.3 或更高版本，也依然可以在 WSL2 中运行。

依赖

工具用途随哪种方式安装
tmux 3.1+macOS、Linux 和 WSL2 上的所有智能体会话。Homebrew、AUR、安装脚本。
psmux 3.4+原生 Windows 上的所有智能体会话。Scoop、Windows 安装脚本，或 winget install --id marlocarlo.psmux -e。
gitdiff 审查和 worktree 会话。Homebrew、AUR、安装脚本。
wl-clipboard 或 xclip在 Linux 上向提示词粘贴图片。Linux 桌面上的安装脚本，或你的包管理器。
notify-sendLinux 上的桌面通知。Linux 桌面上的安装脚本（apt 用 libnotify-bin，zypper 用 libnotify-tools，其他用 libnotify），或你的包管理器。

mise、go install 和预编译二进制这几种方式只安装二进制文件本身，所以请用你的包管理器安装 tmux 和 git。管理器启动时找不到 tmux，或 diff 视图找不到 git 时，会给出它检测到的安装命令。

智能体 CLI 由你自己安装，管理器会帮忙。要启动的 CLI 不在 PATH 上时，会弹出一个给出该 CLI 安装程序的对话框：i 在 shell 标签页中运行它，c 复制它。对于通过 npm 安装的 CLI，没有可用的 npm 时会先安装 Node LTS，全局 npm 前缀不可写时则安装到你的主目录下。

Homebrew

macOS 和 Linux。如果你没有 tmux 会一并安装，Homebrew 本身依赖 git。

Terminal
brew install agent-manager

Homebrew cask

macOS 和 Linux。安装已发布的二进制而不是从源码构建，并会拉取 tmux。上面的 formula 在 homebrew-core 中，从源码构建；这个 cask 是预编译方式，agent-manager update 知道自己运行在哪一种之下。

Terminal
brew install --cask yoanwai/tap/agent-manager

安装脚本

macOS 和 Linux。下载发布版中的 install.sh，阅读后再运行。该文件附在发布版中，并列在 checksums.txt 里。sh install.sh 只在下载成功后才会运行。

Terminal
curl -fsSL -o install.sh https://github.com/YoanWai/agent-manager/releases/latest/download/install.sh && sh install.sh

gh 已登录时，gh attestation verify install.sh --repo YoanWai/agent-manager 可以校验该文件的构建来源。同一条命令也可以校验 install.ps1 或发布版的压缩包。

脚本会下载适合你平台的发布版，用公布的校验和验证，然后安装到 ~/.local/bin。接着检查 tmux 3.1+ 和 git。在 macOS 上它会提议用 Homebrew 安装，缺少 Homebrew 时先安装 Homebrew。在 Linux 上它会提议用 apt、dnf、pacman、zypper、apk 或 Homebrew 安装，在桌面环境下还会加上剪贴板和通知相关的包。在 WSL 下会跳过这些，因为粘贴和通知都走 Windows。你拒绝时它会打印出命令，没有终端的运行会跳过提问，仍然安装二进制。AGENT_MANAGER_VERIFY_ATTESTATION=1 会在 gh attestation verify 不接受下载的压缩包时拒绝安装。y、yes 和 true 效果相同，不区分大小写。不设置该变量时，脚本安装时不会调用 gh。gh 对证明被拒、未登录和网络错误使用同一个退出状态，所以设置了该变量时，其中任何一种都会被视为安装失败。

简短形式直接运行 main 上的版本，不保存文件供你阅读。

Terminal
curl -fsSL https://raw.githubusercontent.com/YoanWai/agent-manager/main/install.sh | sh
变量作用
AGENT_MANAGER_INSTALL_DIR安装到 ~/.local/bin 以外的位置。
AGENT_MANAGER_VERSION固定某个版本，而不是取最新版。
AGENT_MANAGER_INSTALL_DEPS1 预先回答依赖安装的提问，0 跳过它。
AGENT_MANAGER_VERIFY_ATTESTATION1、y、yes 或 true 会用 gh attestation verify 校验下载的压缩包。

Arch Linux

agent-manager-bin 安装已发布的二进制，并拉取 tmux 和 git。

Terminal
yay -S agent-manager-bin

mise

直接读取 GitHub 发布版，无需在 registry 中登记。请用你的包管理器安装 tmux 和 git。

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

Go

需要 Go 1.27.3+、tmux 3.1+（Windows 上为 psmux 3.4+）和 git。安装到 $(go env GOPATH)/bin。

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

预编译二进制

macOS、Linux 和 Windows，amd64 和 arm64，直接从 Releases 下载。在 Windows 上，请用你的包管理器安装 psmux 和 git。每个发布版都为压缩包、install.sh 和 install.ps1 公布 checksums.txt。gh 已登录时，gh attestation verify <file> --repo YoanWai/agent-manager 可以校验下载文件的构建来源。

Scoop

Windows。安装 yoanwai bucket 中发布的版本，Scoop 会一并安装 psmux。该 bucket 独立更新，因此可能落后于最新发布版。Windows 安装脚本安装的是当前发布版。缺少 git 和 PowerShell 7 时，用 scoop install git pwsh 安装。

PowerShell
scoop bucket add yoanwai https://github.com/YoanWai/scoop-bucket
scoop install yoanwai/agent-manager

Windows

在原生 Windows 上，终端复用器是 psmux 3.4.0 或更高版本，面板 shell 是 PowerShell。从发布版下载 install.ps1，阅读后再运行。该文件附在发布版中，并列在 checksums.txt 里。Windows PowerShell 5.1 没有 &&，所以用 if ($?) 作为判断。

PowerShell
irm https://github.com/YoanWai/agent-manager/releases/latest/download/install.ps1 -OutFile install.ps1
if ($?) {
  Get-Content .\install.ps1
  Unblock-File .\install.ps1
  powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1
}

gh 已登录时，gh attestation verify .\install.ps1 --repo YoanWai/agent-manager 可以校验该文件的构建来源。在执行策略为 Restricted 的机器上，-ExecutionPolicy Bypass 只作用于该进程，且是在你阅读文件之后。

脚本把 agent-manager.exe 安装到 %LOCALAPPDATA%\Programs\agent-manager，设置了 $env:AGENT_MANAGER_INSTALL_DIR 时则安装到该目录，并把这个目录加入你的用户 Path。它会提议安装缺少的组件，某个依赖安装失败不会导致二进制安装失败。AGENT_MANAGER_INSTALL_DEPS=1 表示同意，0 跳过提问，没有终端的运行也会跳过提问。AGENT_MANAGER_VERIFY_ATTESTATION 的行为与 shell 脚本中相同。

简短形式直接运行 main 上的版本，不保存文件供你阅读。

PowerShell
irm https://raw.githubusercontent.com/YoanWai/agent-manager/main/install.ps1 | iex
工具安装方式
psmux 3.4.0+winget install --id marlocarlo.psmux -e，或 cargo install psmux。管理器会拒绝更旧的版本。
gitwinget install --id Git.Git -e
PowerShell 7.3+（pwsh）winget install --id Microsoft.PowerShell -e。Windows PowerShell 5.1 和 7.3 之前的 PowerShell 会被拒绝，因为它们会把包含 " 的提示词拆成多个参数。

每个会话运行在自己的 psmux 服务器上，预览通过轮询面板获得。Command Code 与 cmd.exe 同名，所以工具选择器不列出它，请求它的会话会被拒绝。只以 .cmd 或 .bat 文件形式安装的 CLI，出于同样的引号拆分原因也会被拒绝。npm 安装没问题，因为 npm 会在每个 .cmd 旁边添加一个 .ps1。安装对话框用 npm 安装的 CLI 位于 %APPDATA%\npm。如果管理器启动前该目录不在 Path 上，请先重启管理器，再启动该 CLI 的会话。

WSL2 依然可用。在 WSL shell 中，使用安装脚本、Homebrew 或 Linux 二进制，基于 tmux 运行。智能体 CLI 应安装在发行版内。启动会话时如果只找到某个 CLI 的 Windows 版本，会停下并给出在 WSL 中安装它的命令。

运行

不需要先写配置，也不需要启动守护进程。

Terminal
agent-manager

不带参数启动时，如果标准输入或标准输出不是终端，它会在标准输出打印用法并以 0 退出。标准错误输出为 agent-manager: no terminal attached; run it in a terminal to open the manager。

按键作用
space不进入会话就向选中的会话发送提示词，在分组行上则启动一个智能体。
ctrl+r审查该会话的改动。c 评论某一行，C 把所有评论发回去。
v在原来的对话上重新启动已结束的会话。
enter就地聚焦会话，按键直达智能体，列表保持可见。A 全屏进入（attach）。
?随时打开按键一览。

更新

管理器每十分钟检查一次 GitHub Releases，有新版本时在顶部栏显示 ↑ vX.Y.Z available 徽标。隐藏顶部栏时，同样的徽标显示在边框顶边上。在更新消息上按 u，或在设置的版本行上按 enter，接下来的行为取决于安装方式。Homebrew、mise 或 AUR 安装会把终端交给该包管理器自己的升级命令，所以进度显示和密码提示与在 shell 中一样。安装脚本、go install 或手动下载的安装会就地更新，即下载发布版并替换二进制。无论哪种方式，管理器都会重启到新版本，所有会话保持运行。

Scoop 拒绝在应用的二进制运行时更新它。管理器会显示命令，并保留二进制不动。关闭 agent-manager，运行 scoop update agent-manager，然后重新启动。全局安装需要在管理员 PowerShell 中使用 scoop update agent-manager --global。管理器关闭期间，智能体会话继续运行。

两种情况需要手动更新 由 pacman 管理的安装需要 PATH 上有 AUR 助手（yay 或 paru）。没有的话管理器什么都不运行，而是打印应使用的命令：yay -S agent-manager-bin。Nix 安装位于只读的 store 中，所以管理器会让你通过 Nix 更新，例如 nix profile upgrade agent-manager，或修改你的 flake 或 NixOS 配置。

在 shell 中，agent-manager update 不打开管理器就能完成同样的事。它把 Homebrew、mise 或 AUR 安装交给对应的包管理器，对安装脚本、go install 或手动下载的安装则替换二进制。Scoop 安装会打印命令并保留二进制不动。加上 --json 可以得到机器可读的结果。各安装方式自己的命令仍可直接使用。

Terminal
agent-manager update                                # any install
brew upgrade agent-manager                          # Homebrew formula
brew upgrade --cask yoanwai/tap/agent-manager       # Homebrew cask
scoop update agent-manager                          # Scoop, after closing agent-manager
curl -fsSL -o install.sh https://github.com/YoanWai/agent-manager/releases/latest/download/install.sh && sh install.sh  # install script
mise upgrade --bump ubi:YoanWai/agent-manager       # mise
go install github.com/YoanWai/agent-manager@latest  # Go