为每一个 AI 编程智能体打造的最快开发工作流。
agent manager 是一个本地终端应用,直接连接你现有的订阅和工具。
 > 本文是英文 [README](README.md) 的翻译。两者不一致时,以英文版为准。 Claude Code、Codex、OpenCode、Grok、Gemini CLI、Antigravity CLI、Pi、Command Code、Hermes Agent、Muse Code、Oh My Pi 和 Cursor CLI 可以并排运行。每个工具都运行在自己的持久 tmux 会话中。 agent-manager 是你已有 CLI 之上的一层薄壳。每个会话启动的都是你本机安装的原版工具:你的登录、订阅、配置文件、MCP 服务器,以及工具自带的所有功能都原样保留,和在普通终端里运行完全一样。 不用再在一堆终端标签页里找哪个智能体做完了、哪个卡住了。所有会话都显示在同一个列表里,带实时状态,并按项目树分组,可以折叠和排序。无需进入会话就能回复任何一个:`space` 把提示词直接发到会话的面板,或在选中的分组里启动一个新智能体。已退出的会话按 `v` 就能在原来的对话上恢复。`ctrl+r` 打开智能体改动的完整文件 diff,带语法高亮。你在代码行上留下的评论,按 `C` 后会合成一条审查提示发回智能体的面板。 在会话上按 `f`,可以把它的对话分叉成一个单独命名的新会话继续。 整个管理器都支持鼠标。滚轮移动光标,单击会话即可聚焦,单击它的行或按鼠标后退键即可返回。拖动行的手柄(Advanced 模式为 `⠿`,Compatible 模式为 `=`)可以排序,或移动到另一个分组。每行末尾的 `[…]` 打开该行的操作菜单。列表和预览之间的分隔线可以拖动。只要还有未读消息,单击按键说明里的 `messages` 就能打开它。在聚焦的面板里,拖动即选中并复制文本,单击链接会在浏览器中打开。设置里有鼠标开关,方便在需要终端原生选择的地方关闭它。设置 → **symbols** 可以在 **Advanced** 几何符号(默认)和 **Compatible** ASCII 符号之间切换,并带实时预览。 ![Advanced 模式几何符号下的鼠标演示:滚轮移动光标,单击聚焦和离开会话,拖动 ⠿ 手柄排序,[…] 打开行操作](docs/demo-mouse.gif) 和智能体一起用的工具也在同一个列表里:`T` 在选中的智能体或分组下打开一个 shell,用来构建、跑 Git 和临时命令。智能体可以启动另一个智能体、给它发消息,并等待它完成:每个支持 MCP 的会话在启动时都带有这些工具。 在设置里保存命名的指令,然后在新建会话表单、快速提示、聚焦的会话、`spawn --saved`、`send --saved` 或 `create_session` 中复用。详见 [Saved prompts](docs/usage.md#saved-prompts)。 尚未支持:费用统计。 **跳转到:** [安装](#安装) · [使用](#使用) · [按键](docs/usage.md#keys) · [Diff 审查](docs/usage.md#diff-review) · [配置](docs/configuration.md) · [文档站](https://agent-manager.dev/docs/) ## 支持的工具 状态检测支持 **Claude Code**、**OpenCode**、**Codex**、**Grok Build**、**Gemini CLI**、**Antigravity CLI**、**Pi**、**Command Code**、**Hermes Agent**、**Muse Code**、**Oh My Pi** 和 **Cursor CLI**。每个工具的启动、恢复、分叉和状态规则都内置在二进制文件中(Hermes、Antigravity、Oh My Pi 和 Cursor CLI 不支持分叉),所以升级一次就能拿到所有工具的最新规则(见 [Configuration](docs/configuration.md#agent-clis))。想支持列表外的 CLI,请提交 [功能请求](https://github.com/wainmann/agent-manager/issues/new/choose)。 ## 安装 支持 macOS 和 Linux,Windows 上可通过 [psmux](docs/install.md#windows) 原生运行,也可以在 WSL2 中运行。 ### Homebrew(macOS / Linux) ```bash brew install agent-manager ``` 缺少 tmux 时会一并安装,Homebrew 本身依赖 git,所以两个依赖都已满足。这是 homebrew-core 的 formula,从源码构建。想要预编译二进制,用 `brew install --cask yoanwai/tap/agent-manager`。 ### Scoop(Windows) ```powershell scoop bucket add yoanwai https://github.com/YoanWai/scoop-bucket scoop install yoanwai/agent-manager ``` 安装的是该 bucket 中发布的版本,Scoop 会一并安装 psmux。bucket 是单独更新的,所以可能落后于最新发布。更新时先关闭 agent-manager,再运行 `scoop update`,然后运行 `scoop update agent-manager`。全局安装需要在管理员权限的 PowerShell 中为第二条命令加上 `--global`。应用内更新器会显示这些说明,不会替换 Scoop 管理的二进制文件。 ### 安装脚本(macOS / Linux) 先下载脚本,阅读后再运行。只有下载成功后才会执行 `sh install.sh`。 ```bash curl -fsSL -o install.sh https://raw.githubusercontent.com/wainmann/agent-manager/main/install.sh && sh install.sh ``` 这份是 `main` 分支上的脚本,它不在 `checksums.txt` 中。第一个附带 `install.sh` 的发布版本会把该文件列入 `checksums.txt`。之后,请下载发布附带的文件,并在 `gh` 已登录时,在运行脚本前验证它: ```bash curl -fsSL -o install.sh https://github.com/wainmann/agent-manager/releases/latest/download/install.sh && gh attestation verify install.sh --repo wainmann/agent-manager && sh install.sh ``` 在那个版本发布之前,上面的发布 URL 没有文件,所以在此之前请使用第一条命令。较早的版本请用 `--owner YoanWai --signer-repo YoanWai/agent-manager` 代替 `--repo wainmann/agent-manager` 来验证。 脚本会下载适合你平台的最新版本,按发布的校验和验证后安装到 `~/.local/bin`,然后检查 tmux 3.1+ 和 git。在 macOS 上它会提议使用 Homebrew,缺少 Homebrew 时会先提议安装它。在 Linux 上它会提议使用 apt、dnf、pacman、zypper、apk 或 Homebrew,在桌面环境中还会提议安装剪贴板和通知相关的包。你拒绝时,它会打印对应的命令。没有终端时会跳过提示,仍然安装二进制文件。设置 `AGENT_MANAGER_INSTALL_DIR` 可以换安装目录,`AGENT_MANAGER_VERSION` 可以固定版本,`AGENT_MANAGER_INSTALL_DEPS=1` 可以提前同意安装依赖(`=0` 跳过)。`AGENT_MANAGER_VERIFY_ATTESTATION=1` 会在 `gh attestation verify` 不接受下载的压缩包时拒绝安装。该检查失败时,脚本会用较早版本所需的 `--owner YoanWai --signer-repo YoanWai/agent-manager` 再试一次,两次都失败才会停止。在没有 `gh` 的机器上安装时请不要设置它。`gh` 对证明被拒、未登录和网络错误使用同一个退出码,所以脚本不会区分这几种情况。 不先下载文件阅读,直接运行: ```bash curl -fsSL https://raw.githubusercontent.com/wainmann/agent-manager/main/install.sh | sh ``` ### 经过验证的 zip(Windows) 从同一个 [发布页](https://github.com/wainmann/agent-manager/releases/latest) 下载对应架构的 Windows zip 和 `checksums.txt`。解压前,把 zip 的 SHA-256 与 `checksums.txt` 中对应的行进行比对。[手动安装 Windows 版](docs/install.md#download-and-verify-the-zip) 给出了 PowerShell 命令、可选的来源证明(provenance)验证和依赖安装方法。 ### 安装脚本(Windows) 先下载脚本,阅读后再运行。只有下载成功后才会运行安装程序。Windows PowerShell 5.1 没有 `&&`,所以用 `if ($?)` 作为判断。在发布版本附带 `install.ps1` 之前,要阅读的是 `main` 分支上的那份。那份不在 `checksums.txt` 中。 ```powershell irm https://raw.githubusercontent.com/wainmann/agent-manager/main/install.ps1 -OutFile install.ps1 if ($?) { Get-Content .\install.ps1 Unblock-File .\install.ps1 powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 } ``` 一旦发布版本附带了 `install.ps1` 并把它列入 `checksums.txt`,请改为下载那个文件。登录 `gh` 后,在下载之后、运行安装程序之前验证它。较早的版本请用 `--owner YoanWai --signer-repo YoanWai/agent-manager` 代替 `--repo wainmann/agent-manager` 来验证。缺少 `gh` 时示例会停止:否则 PowerShell 会保留上一个 `$LASTEXITCODE`,之前某条命令返回的 `0` 会看起来像验证成功。在那个版本发布之前,该发布 URL 没有文件。 ```powershell irm https://github.com/wainmann/agent-manager/releases/latest/download/install.ps1 -OutFile install.ps1 if ($?) { Get-Command gh -ErrorAction Stop | Out-Null if ($?) { gh attestation verify .\install.ps1 --repo wainmann/agent-manager if ($LASTEXITCODE -ne 0) { throw 'attestation verification failed' } if ($LASTEXITCODE -eq 0) { Get-Content .\install.ps1 Unblock-File .\install.ps1 powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 } } } ``` 在没有设置执行策略的 Windows 客户端上,实际生效的策略是 Restricted,所以所有 `.ps1` 都会被拒绝。`-ExecutionPolicy Bypass` 只对这一个进程生效,而且是在你读过文件之后。如果策略已经是 RemoteSigned,先 `Unblock-File` 再 `.\install.ps1` 就够了。RemoteSigned 会拒绝仍带有 Mark of the Web 的未签名脚本。浏览器下载会设置这个标记。`irm -OutFile` 不会(Microsoft 文档说明 `Invoke-WebRequest` 不会标记为 Internet 区域)。这种情况下 `Unblock-File` 不起作用。 脚本会把最新版本安装到 `%LOCALAPPDATA%\Programs\agent-manager`,加入你的用户 `Path`,并在缺少 psmux、git 或 PowerShell 7 时提议安装。`AGENT_MANAGER_INSTALL_DEPS=1` 表示同意,`AGENT_MANAGER_INSTALL_DEPS=0` 跳过提示。没有终端时会跳过提示,仍然安装二进制文件。`AGENT_MANAGER_VERIFY_ATTESTATION` 的行为和 shell 脚本中相同。 Arch Linux、mise、`go install`、预编译二进制、Windows(原生和 WSL2)、依赖、更新和卸载方法:[docs/install.md](docs/install.md)。 ## 使用 ```bash agent-manager ``` 会话运行在 tmux 里(`am_*` 命名空间),所以退出管理器后它们依然存活。在会话里,只要你的终端和 tmux 没有占用该键,**Ctrl+Q** 就会返回管理器;**Ctrl+\\** 是同样规则下的备用键。会话聚焦时,**Ctrl+C** 作为取消键发给智能体,所以中断提示词不会退出管理器。**Ctrl+R** 打开会话的 diff 审查,**F3** 在编辑器中打开它的目录;设置(`s`)里的 **keybindings** 行可以改动其中任何一个,或把它交还给智能体,也可以改动或关闭管理器自身列表里的任何操作,`esc` 和 `ctrl+c` 保持不变(见 [Key bindings](docs/configuration.md#key-bindings))。在全屏进入的会话中,配置了内层 tmux 前缀时,会话底栏还会显示该前缀加 `d`。嵌套在另一个 tmux 里时,先发送底栏显示的内层前缀,再按 `d`。如果两个 tmux 服务器用的是同一个前缀,请使用外层 tmux 的 `send-prefix` 绑定;如果外层 tmux 会截获内层前缀,请配置它转发该键。`agent-manager --version` 打印版本号。 智能体会话运行在名为 `agentmgr` 的独立 tmux 服务器上,所以它们不会和你自己运行的 tmux 混在一起,在你自己的 socket 上执行 `kill-server` 也不会影响它们。想从普通 shell 进入某个会话,需要指定这个服务器:先 `tmux -L agentmgr ls`,再 `tmux -L agentmgr attach -t am_
## 许可证
[Apache-2.0](LICENSE)
---