agent-manager

文档 · 概览

概览

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

agent-manager 是一个运行在 tmux 之上的 Go TUI。你启动的每个智能体都是一个真实的 tmux 会话,所以管理器只是观察它们的窗口,而不是它们栖身的容器。退出管理器,它们照样继续工作。

图 1会话列表
会话列表:二十多个智能体会话按 backend(含 api 子分组)、frontend 和 infra 分组,每个都带有按颜色区分的实时状态,右侧预览中是一份真实的 Claude Code 对话记录,左下角是机器资源仪表。
二十三个会话,四个项目,一个嵌套子分组。预览中是一个真实的 Claude Code 面板。

首次运行

不需要写配置,也不需要启动守护进程。安装之后运行:

Terminal
agent-manager

所有可以修改的选项都在设置(s)里:按键、编辑器、主题以及其他选项。Claude Code、OpenCode、Codex、Grok Build、Gemini CLI、Antigravity CLI、Pi、Command Code、Hermes Agent、Muse Code、Oh My Pi 和 Cursor CLI 均已内置,规则也一并内置,所以第一次启动智能体之前不需要额外定义任何东西。

按键作用
n新建会话:名称、工具、该工具提供的模型、推理强度和 profile、目录、可选的已保存提示词和起始提示词,以及分组。
g新建分组。
space向选中的智能体发送提示词,或在选中的分组中启动一个智能体。
C添加 SSH 连接,让另一台机器上的会话加入列表。
?查看所有按键,无需离开应用。

鼠标在每个界面都可用。单击聚焦会话,双击折叠分组,滚轮移动光标,拖动 ⠿ 手柄可以移动行,[…] 打开该行的操作菜单,列表和预览之间的分隔线也可以拖动。全屏布局下单击选中、双击聚焦。

会话在哪里运行

智能体会话运行在一个名为 agentmgr 的私有 tmux 服务器上,位于 am_* 命名空间中,所以它们不会和你自己运行的 tmux 混在一起,在你自己的 socket 上执行 kill-server 也不会影响它们。要从普通 shell 访问某个会话,需要指定这个服务器:

Terminal
tmux -L agentmgr ls
tmux -L agentmgr attach -t am_<id>
在会话内部 当终端没有占用 ctrl+q 时,按它可以退出(detach)回到管理器;ctrl+\ 是备用键。聚焦会话时 ctrl+c 会发送给智能体,管理器保持运行。ctrl+r 打开审查,F3 在编辑器中打开会话的目录。这些绑定只作用于受管理的会话,在其他地方会原样透传。

接下来看什么

页面内容
安装Homebrew、Scoop、安装脚本、AUR、mise、Go 或二进制文件。
状态某一行为什么是橙色,以及这个判断从何而来。
快速提示无需进入(attach)即可回复被阻塞的智能体。
审查模式整文件 diff,行评论会发回给智能体。
会话worktree、shell、结束与恢复、其他机器、全屏。
按键和 ? 浮层显示的按键相同。
MCP智能体能做什么,以及如何从脚本启动。
配置设置、按键表、十二个内置 CLI、已保存的提示词和主题。
社区在 Agent Manager Community Discord 上,#help 频道解答问题和配置求助,#workflows 频道分享配置。Bug 和功能请求请提交到 GitHub issues。