YoanWai/agent-manager
GitHub: YoanWai/agent-manager
一个终端 UI 工具,用于在 tmux 中统一管理多个 AI 编码 agent 会话,提供实时状态监控、diff 审查和批量交互能力。
Stars: 236 | Forks: 8
适用于每个 AI 编码 agent 的最快工作流。

Claude Code、Codex、OpenCode、Grok 和 Gemini CLI 并排运行,每个都在各自的 tmux 会话中,因此当你退出管理器时,它们仍会继续工作。
你无需再费力翻找终端标签页来查看哪个 agent 完成了任务、哪个卡住了,每个会话都会显示在一个列表中并带有实时状态,它们被分组到一个可以折叠和重新排序的项目树中。你可以在无需进入会话的情况下回复它们中的任何一个:`space` 会将一个 prompt 直接发送到某个会话的面板,或者在选定的组中生成一个新的 agent。使用 `v` 可以让一个挂掉的会话在其原有的对话上下文中恢复。而 `ctrl+r` 会打开 agent 所做更改的全文件 diff,并带有语法高亮;当你在代码行上留下评论并按下 `C` 时,这些评论会作为一个整体的 review prompt 发送回 agent 的面板。
尚未实现的功能:worktree 创建、成本追踪、鼠标驱动的导航,以及 agent 之间的相互通信。
**跳转至:** [安装](#install) · [使用说明](#usage) · [快捷键](docs/usage.md#keys) · [Diff 审查](docs/usage.md#diff-review) · [配置](docs/configuration.md)
## 支持的工具
状态检测目前开箱即用地支持 **Claude Code**、**OpenCode**、**Codex**、**Grok Build** 和 **Gemini CLI**。任何其他 CLI 工具都可以作为会话运行;只需添加一个带有状态规则的 `[tools.
]` 块即可为其获取实时状态(参见[配置](docs/configuration.md))。
## 安装
### Homebrew (macOS / Linux)
```
brew install yoanwai/tap/agent-manager
```
如果缺少 tmux,它会连同 tmux 一起安装。该 tap 提供了一个 cask,因此若要从旧版 formula 切换过来,需执行 `brew uninstall agent-manager`,然后再运行上述命令。
### 安装脚本 (macOS / Linux)
```
curl -fsSL https://raw.githubusercontent.com/YoanWai/agent-manager/main/install.sh | sh
```
下载适合你平台的最新发布版本,根据发布的校验和进行验证,并将其安装到 `~/.local/bin`。设置 `AGENT_MANAGER_INSTALL_DIR` 可以指定其他目录,设置 `AGENT_MANAGER_VERSION` 则可以固定版本。请使用你自己的包管理器安装 tmux。
Arch Linux、mise、`go install`、预编译二进制文件、Windows (WSL2) 以及更新说明:[docs/install.md](docs/install.md)。
## 使用说明
```
agent-manager
```
会话在 tmux(`am_*` 命名空间)内运行,因此即使管理器退出它们也能存活。在会话内,**Ctrl+Q** 会分离并返回管理器,**Ctrl+R** 会打开其 diff 审查。`agent-manager --version` 会打印版本号。
Agent 会话存在于一个名为 `agentmgr` 的私有 tmux 服务器上,因此它们永远不会与你自己运行的 tmux 混在一起,对你自己的 socket 执行 `kill-server` 也不会影响它们。要从普通的 shell 中访问某个会话,请指定该服务器名称:`tmux -L agentmgr ls`,然后执行 `tmux -L agentmgr attach -t am_`。
完整的参考文档,包括每个快捷键、快速 prompt、终止与恢复、diff 审查、分组、状态检测、统计和主题,都在 [docs/usage.md](docs/usage.md) 中。以下是简短版本:
| 快捷键 | 操作 |
|-----|--------|
| `n` | 新建会话(名称、工具、目录、可选的起始 prompt、组) |
| `space` | 快速 prompt:回复选定的会话,或在选定的组中生成一个 agent |
| `enter` | 原地聚焦会话;快捷键会发送给 agent,同时列表保持显示 |
| `ctrl+r` | 以全文件 diff 的形式审查会话的更改;`c` 评论某一行,`C` 将评论发送给 agent |
| `x` / `v` | 终止会话以释放其 RAM / 在其原有的对话中恢复它 |
| `s` | 设置(默认工具、主题、列表密度、审查布局) |
| `?` | 包含所有绑定的帮助信息 |


配置(添加你自己的工具、状态规则、恢复命令)位于 [docs/configuration.md](docs/configuration.md)。
## 开发
```
go run .
env -u TMUX TMUX_TMPDIR=/tmp/amtest go test ./... # end-to-end tests drive a real tmux server
```
请参阅 [CONTRIBUTING.md](.github/CONTRIBUTING.md) 了解 CI 运行的检查,如果你将编码 agent 指向此仓库,请参阅 [AGENTS.md](AGENTS.md)。
## 贡献
欢迎提交 Bug 报告、功能建议和 Pull Request。有关环境设置和 CI 运行的检查,请参阅 [CONTRIBUTING.md](.github/CONTRIBUTING.md)。值得分享的问题和配置请在 [讨论区](https://github.com/YoanWai/agent-manager/discussions) 进行。安全报告请通过[私人安全公告](https://github.com/YoanWai/agent-manager/security/advisories/new)提交;参见 [SECURITY.md](.github/SECURITY.md)。
## 许可证
[MIT](LICENSE)标签:AI 编程助手, EVTX分析, SOC Prime, tmux, 任务管理, 会话管理, 开发工具, 日志审计, 终端 UI