Agent Manager
一个 tmux TUI,把所有 AI 编码代理集中到一个列表里统一查看状态、发送提示和审查代码变更。
- Star 数
- ★ 618
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- Go
- FA 评分
- 64/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 同时运行多个编码代理(如 Claude Code 和 Codex 并行改代码)的开发者,需要在一个界面里看到哪个完成、哪个卡住
- 不适合
- 不使用 tmux 或无法安装 tmux 3.1+ 的用户
- 在原生 Windows 上工作、不愿使用 WSL2 的开发者
- 需要成本追踪或鼠标操作列表的团队
- 源码审查
- 64/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
agent-manager 是用 Go 编写(基于 Bubble Tea)的终端界面工具,运行在 tmux 之上,用于同时管理多个 AI 编码代理 CLI。它为 Claude Code、Codex、OpenCode、Grok Build、Gemini CLI、Pi、Command Code 和 Hermes Agent 提供实时状态检测,每个工具在独立的持久 tmux 会话(am_* 命名空间、agentmgr 专用服务器)中运行。会话按项目树分组展示,可折叠和重排。核心功能包括:用空格键向任意会话直接发送提示、按 ctrl+r 查看代理修改的全文差异并对行添加注释批量发回审查意见、按 v 复活已结束的会话、按 f 将会话分叉为命名分支继续对话。代理之间可通过 MCP 工具互相派生任务、发消息并等待完成;会话还可以基于 git worktree(分支 am/<name>)隔离运行。
启动时创建一个私有 tmux 服务器(agentmgr),把用户已安装的代理 CLI 原样放入各自的 tmux 会话中,保留登录态、订阅、配置文件和 MCP 服务器。它周期性检测各会话状态(工作/等待/完成),在列表中以项目树展示。space 键将快捷提示直接写入选中会话的窗格,或在该组中派生新代理;ctrl+r 打开全文件、带语法高亮的差异视图,行注释按 c 标记、按 C 以一轮编号审查意见的形式发回代理窗格。T 键在选中代理下打开 shell 执行构建和 git 命令;alt+w 或会话表单可为新会话创建 git worktree(<repo>-worktrees/<name>,分支 am/<name>)。所有 MCP 能力会话启动时即携带代理互派工具。状态检测规则可通过配置文件中的 [tools.<name>] 块扩展到其他 CLI。
- 同时运行多个编码代理(如 Claude Code 和 Codex 并行改代码)的开发者,需要在一个界面里看到哪个完成、哪个卡住
- 需要审查代理产出的代码变更的维护者:用 ctrl+r 打开差异、逐行批注、一键把整套审查意见发回代理
- 让代理之间协作的团队:通过 MCP 让一个代理派生另一个、传消息并等待完成
- 想为不同任务使用隔离代码副本的开发者:会话可在独立 git worktree 和 am/<name> 分支上运行
- 在同一个终端工作流中还需跑构建、Git 命令的用户:按 T 在代理下打开 shell
- 误关或超时导致会话中断的用户:按 v 在原对话上复活会话,或按 R 在空上下文上重启
如何安装或部署这个 Agent?
macOS / Linux 用 Homebrew:brew install yoanwai/tap/agent-manager(会自动安装缺失的 tmux 和 git)。或用安装脚本:curl -fsSL https://raw.githubusercontent.com/YoanWai/agent-manager/main/install.sh | sh —— 下载最新版本、校验 checksums、安装到 ~/.local/bin,并检查 tmux 3.1+ 和 git。可通过 AGENT_MANAGER_INSTALL_DIR 指定目录、AGENT_MANAGER_VERSION 锁版本、AGENT_MANAGER_INSTALL_DEPS=1 自动装依赖。Windows 需在 WSL2 中运行。其他途径(Arch Linux、mise、go install、预编译二进制)见 docs/install.md。
如何使用这个 Agent?
运行 agent-manager 启动管理器。按 n 新建会话(指定名称、工具、目录、可选起始提示和分组);space 向选中会话发送快捷提示或派生新代理;enter 聚焦会话后按键直接传给代理;ctrl+r 打开差异审查(c 行注释、C 发送编号审查轮);x 杀掉会话释放内存,v 在原对话上复活,R 在空上下文上重启;T 打开 shell;? 查看当前屏幕按键表;s 打开设置(默认工具、主题、列表密度、桌面通知等)。会话在 am_* 命名空间的独立 tmux 服务器上运行,管理器退出后会话仍在;可用 tmux -L agentmgr ls 查看并 tmux -L agentmgr attach -t am_<id> 附加。keybindings 可在 config.toml 的 [keybindings.session] / [keybindings.list] 中自定义。
这个 Agent 有哪些优点和局限?
- 不封装、不代理你已有的 CLI:登录态、订阅、配置文件、MCP 服务器原样保留,行为与裸终端一致
- 结构化差异审查是差异化功能:全文件上下文、语法高亮、行级注释聚合成一轮编号审查发回代理
- 会话运行在独立 tmux 服务器(agentmgr)并跨管理器退出存活,不与你自己的 tmux 混用
- 一个工具可带起主流代理:Claude Code、Codex、OpenCode、Grok Build、Gemini CLI、Pi、Command Code、Hermes Agent 默认支持状态检测,其他 CLI 可通过 [tools.<name>] 配置接入
- 强依赖 tmux 3.1+ 和 git,运行边界限于 macOS、Linux 和 Windows WSL2,原生 Windows 不支持
- 尚未支持成本追踪和鼠标驱动的列表导航(README 明确列为 not here yet)
- 它是管理工具而非代理本身:没有已安装的代理 CLI 就没有可管理的对象
- →/← 的步骤式进出导航仍处于 beta,需要在 Settings 中确认是否启用
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Agent Manager 当前 | 64 · 存在缺口 | 命令行工具免费 | ★ 618 | 今天 | Go | Codex · Claude Code |
| Agent Deck | 76 · 表现良好 | 命令行工具免费 + 模型费 | ★ 1.1k | 5 天前 | Go | Codex · Claude Code |
| Diri | 59 · 缺口较多 | 桌面应用免费 + 模型费 | ★ 457 | 2 天前 | Rust | Codex · Claude Code |
| OpenRig | 79 · 表现良好 | 命令行工具免费 + 模型费 | ★ 8.1k | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README声明使用私有tmux服务器(agentmgr)、install.sh校验发布校验和,权限面看起来克制,但快照中没有任何Go源码可证实实际行为,故仅给基本分。install.sh有依赖安装确认提示(AGENT_MANAGER_INSTALL_DEPS可预设),用户确认部分有据但未见过交互代码,给1。数据流透明度较好:会话命名空间am_*、独立socket、可从外部tmux访问均有说明,给2。敏感数据处理无任何文档(代理会话含登录态与订阅凭证,但项目未声明如何隔离),给1。依赖安全方面CI运行govulncheck、gitleaks、shellcheck且第三方Action按SHA钉死,证据充分,给2(未见dependabot/renovate与依赖更新策略,不满分)。外部效应明确:可生成worktree、分支am/<name>、MCP工具互相派生代理,均有文档,给2。回滚手段薄弱:仅brew uninstall与版本钉住变量,无会话/配置回滚说明,给1。来源归属:发布者未经验证,README用品牌徽章与外部链接但无NOTICE或版权行,给1。
README内部自洽,按键表、安装说明、命名规范(am_*、agentmgr socket)互相一致,给2。依赖可用性覆盖好:tmux 3.1+、git、多包管理器、WSL2、版本钉住变量均有交代,给2。失败消息仅在安装脚本处提到'printing the exact command when you decline',运行时错误处理无源码可证,给1。
受众与场景非常清晰:多AI编码代理并行管理的开发者,支持的CLI逐一点名,给3。能力边界有明示('Not here yet'列出成本跟踪与鼠标导航,beta功能标注In beta),给2。触发精度:按键绑定时点精确到焦点/全屏/嵌套tmux三种上下文并可重映射,文档细致但属描述而非可验证规则,给2。环境契合充分:macOS/Linux/WSL2、嵌套tmux处理、OS主题跟随,给3。
信息架构优秀:README→docs/usage.md→docs/configuration.md→docs/install.md分层,含文档站点,给3。安装说明覆盖Homebrew、curl脚本、Arch、mise、go install、预编译、WSL2并含卸载/升级,给3。命名稳定:模块路径、am_*前缀、agentmgr服务器名一致,给2。示例与FAQ有键位表与使用示例但无FAQ章节,给2。已知限制明示(beta、未实现功能),给2。LICENSE全文为Apache-2.0且README/徽章一致,给3。版本与变更日志:有--version命令与release流程,但快照中无CHANGELOG文件,给1。维护责任:CONTRIBUTING.md、SECURITY.md私有漏洞报告、Discussions均有路径,给2。
输出可用性:diff评审支持语法高亮、逐行评论、编号评审轮次并跟踪'open/handled'状态,描述充分,给2(未经执行验证)。边际价值高:聚合状态/快速提示/worktree/diff评审于单一TUI,直接解决多代理切换痛点,给3。成本收益:薄层设计复用现有CLI与订阅,依赖仅tmux+git,成本合理,但RAM占用与代理自身成本未量化,给2。
主张可追溯:徽章数据由badges工作流生成并推送badges分支,install.sh行为逐条说明,docs链接明确,给2。跨源佐证弱:快照内只有README、LICENSE、go.mod与CI文件,无源码、测试文件或文档正文可交叉验证README的性能与功能主张,星标/Trendshift徽章不可核实,给1。事实与推断区分尚可:README将beta状态、未实现功能与成熟功能明确分层,给2。
- 本评审为静态审查,快照中不含任何Go源码或测试文件,README的全部功能与安全主张(私有tmux服务器、校验和验证、会话隔离)均未经代码核实,请勿视为已验证。
- 代理会话携带用户登录态、订阅与MCP服务器配置,项目未提供任何敏感数据隔离或数据流说明;在不可信仓库中运行代理前请自行评估。
- 安装脚本采用curl|sh模式,即便有校验和验证,也建议先下载审阅脚本再执行。
- 无CHANGELOG,升级引入行为变化的风险需自行通过release notes评估。
- MCP能力允许代理互相派生与发消息,形成代理链,请确认每层代理的权限边界。
- 发布者身份未经注册表验证,属于未知而非可疑,但企业环境引入前应完成独立的供应链审查。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Run every AI coding agent from one terminal. Claude Code, Codex, OpenCode, Grok Build, Gemini CLI, Antigravity CLI, Pi, Command Code, Hermes Agent, Muse Code, Oh My Pi, and Cursor CLI run side by side, each in its own tmux session, with live status, a project tree, quick prompt mode, and full-file diff review. Runs on macOS, Linux and Windows (with psmux), and inside WSL2. [See it running](https://github.com/YoanWai/agent-manager#agent-manager). What's Changed * docs(feed): announce sessions on other machines in v0.43.0 by @YoanWai in https://github.com/YoanWai/agent-manager/pull/848 …在 GitHub 查看 ↗ -
发布说明摘录
Run every AI coding agent from one terminal. Claude Code, Codex, OpenCode, Grok Build, Gemini CLI, Antigravity CLI, Pi, Command Code, Hermes Agent, Muse Code, Oh My Pi, and Cursor CLI run side by side, each in its own tmux session, with live status, a project tree, quick prompt mode, and full-file diff review. Runs on macOS, Linux and Windows (with psmux), and inside WSL2. [See it running](https://github.com/YoanWai/agent-manager#agent-manager). v0.43.0 Run agents on your other machines over SSH. Press C and another Linux or macOS machine's sessions show up in this …在 GitHub 查看 ↗ -
发布说明摘录
Run every AI coding agent from one terminal. Claude Code, Codex, OpenCode, Grok Build, Gemini CLI, Antigravity CLI, Pi, Command Code, Hermes Agent, Muse Code, and Oh My Pi run side by side, each in its own tmux session, with live status, a project tree, quick prompt mode, and full-file diff review. Runs on macOS, Linux and Windows (with psmux), and inside WSL2. [See it running](https://github.com/YoanWai/agent-manager#agent-manager). v0.42.0 Windows runs natively. Agent Manager now runs on Windows itself, with psmux 3.4 or newer in place …在 GitHub 查看 ↗