文档 · 配置

配置

所有可以修改的选项都在设置（s）里：按键、o 打开的编辑器、主题以及其他各行。离开设置时修改会被保存，并在那一刻生效。只有你修改过的行会被写入，所以其间另一个管理器或 CLI 做出的修改会被保留。每个 CLI 的启动命令、恢复和分叉命令、MCP 注册以及状态规则都内置在二进制文件中，所以一次升级就会把它们全部更新到最新版本。

管理器把每项选择保存在 state.db 中，这是位于操作系统用户配置目录下的一个 SQLite 文件：

editor 行决定 o 用哪个命令打开目录。←→ 依次切换 auto、在你的 PATH 上找到的每个 GUI 编辑器、$VISUAL 和 $EDITOR 指定的编辑器，以及 custom，在 custom 上按 ↵ 会打开一个输入框，填写你自己的命令。auto 依次解析为 $AGENT_MANAGER_EDITOR、PATH 上的 GUI 编辑器、$VISUAL / $EDITOR。在 Linux 上，如果你设置了 $BROWSER，链接会用它打开，多个值用冒号分隔，%s 代表 URL，否则退回到 xdg-open。macOS 把链接交给 open。面板每两秒轮询一次，用于更新状态、预览和统计数据。

从 shell 修改设置#

agent-manager settings 无需打开管理器就能读取和修改同样的设置。settings list 打印每个键及其当前值和可选值。settings get 打印一个键的值，没有保存时打印默认值，settings set 写入一个值。超出该键可选范围的值会被拒绝，拒绝信息会列出可选值。

agent-manager settings set theme "tokyo night"
agent-manager settings set notifications off
agent-manager settings get list_density

运行中的管理器会立即应用 notifications、coordination 和 notify_command。其余设置会在下次打开设置时显示，并从那时起生效。notify_command 没有对应的设置行。状态一页介绍了它。

已保存的提示词#

设置中的 saved prompts 行保存你反复使用的命名指令。n 新建一条，enter 编辑，d 删除。tab 在名称和正文之间切换，ctrl+s 保存，esc 退出。名称必须唯一，最多 60 个字符，不能包含括号，正文最多 64 KiB。同一个列表供以下各处使用：n 表单、快速提示模式、聚焦的会话、spawn --saved、send --saved，以及 saved 参数（用于 create_session 和 send_session）。快速提示一页说明了每条提示词会去往哪里。

agent-manager prompts list
agent-manager prompts add reviewer "Review the parser changes"
agent-manager prompts rm reviewer

修改或删除一条提示词，不会影响已经启动的会话。

从 config.toml 升级#

v0.40.0 之前的版本会读取该目录中的 config.toml。升级后第一次启动时，会把其中的 editor 行以及 [keybindings.session] 和 [keybindings.list] 表迁移到设置中，所以你改过的每个按键都留在原位。迁移只发生一次。此后设置是管理器唯一读取的地方，这个文件可以由你自行删除。如果管理器无法读取该文件，会在消息（M）中指出该文件及原因，按键则从默认值开始。

轮询间隔固定为两秒，所以该文件中的 poll_interval 行不起作用。[tools.<name>] 块同样不起作用，因为每个 CLI 的命令和状态规则都内置在二进制文件中。

CLI#

Claude Code、OpenCode、Codex、Grok Build、Gemini CLI、Antigravity CLI、Pi、Command Code、Hermes Agent、Muse Code、Oh My Pi 和 Cursor CLI 均已内置，另外还有 T 打开的 shell。每个 CLI 的启动命令、恢复和分叉命令、MCP 注册、状态规则，以及会话的模型、推理强度和 profile 在启动时使用的参数，都随二进制文件发布。Hermes、Antigravity、Oh My Pi 和 Cursor CLI 不支持分叉，Pi 和 Oh My Pi 没有 MCP 注册。设置（s）中有一个 CLIs 行，用来选择 n 表单和快速提示模式提供哪些 CLI，它的最后一项 request CLI support 会为列表之外的 CLI 打开一个预先填好的 issue。支持的智能体一页列出了每个 CLI 获得的支持。

Agent Manager 支持每个 CLI 的当前版本。CLI 也可以声明它仍能配合使用的最低版本。如果你的版本更旧，启动、恢复或打开其模型列表时会弹出一个对话框，列出你的版本、所需的版本，以及用来更新它的官方安装程序。i 运行该安装程序，c 复制它。位于 /nix/store 下的 CLI 没有安装程序，对话框会提示你按原来的安装方式更新。Pi 需要 0.84.3 或更高版本。其他 CLI 目前还没有最低版本要求。

状态显示不对时#

规则由我们来修，修好了所有人受益。用会话 id 替换 SESSION_ID，像轮询器那样读取面板，然后附上这段文本和 CLI 的版本提交一个 issue：

tmux -L agentmgr capture-pane -p -t am_SESSION_ID

按键绑定#

设置中的 keybindings 行打开一个包含两张表的选择器：管理器在会话内部保留的按键，以及它自己列表的按键。每个操作可以绑定一个或多个按键，也可以关闭。在同一张表内，一个按键只对应一个操作。

↵ 绑定你接下来按下的键，a 为操作添加第二个按键，d 关闭该操作，r 先列出将要变动的内容并询问你，然后把所有操作恢复为出厂按键。某张表无法使用的按键会在那里被拒绝并说明原因。离开选择器时，会保存你修改过的每张表，并立即启用这些按键。只有你改过的按键才会被保存，所以保持出厂默认的操作，会在新版本修改默认值时跟着更新。

会话操作有 detach（默认 ctrl+q 和 ctrl+\）、review（默认 ctrl+r）、editor（默认 f3）、saved_prompt（默认 f4）和 tmux_prefix（默认关闭）。会话按键只能是 ctrl+ 加字母、alt+ 加字母或数字，或者 f1 到 f12，因为单个字符会把这个键从智能体那里抢走。detach 始终至少保留一个按键。tmux_prefix 为受管理的会话设置独立的 tmux 前缀键，可以是一个或两个按键，这样你自己的 tmux.conf 用作前缀的那个键就能腾出来作为会话按键，比如用作 detach。

列表操作有 up、down、open、attach、step_in、step_out、reorder_up、reorder_down、new_session、terminal、new_group、fork、prompt、copy_reply、review、mark_idle、rename、move、editor、restart、kill、kill_all、revive、revive_all、archive、cancel_end、restore、delete、search、filter、archived、empty_groups、fold_all、resize、settings、messages、help、quit 和 new_connection。列表按键可以是普通字符、按键名（如 space 或 pgup）、shift+ 加方向键或 tab，或者上面提到的修饰键形式。esc 和 ctrl+c 保持不变。esc 在任何地方都是取消。ctrl+c 即使在 quit 被关闭时也会退出管理器，在聚焦的会话中则会发送给智能体。settings 始终至少保留一个按键。

同样的按键表也作用于全屏进入（attach）和聚焦模式，从 agent-manager CLI 或由智能体通过 MCP 服务器创建的会话同样使用它们。底栏、? 按键表和会话底栏都读取这些表，所以改过的按键会在它的新位置被标出。

主题#

s 打开设置，在其中用 ↑↓ 或滚轮在字段之间移动，←→ 修改当前字段。单击某一行会移动到该行，再次单击会修改或执行它。save and close 和其他底栏按键一样：esc 执行它，在没有自身操作的行上 enter 也会执行它，单击它同样如此。内置十八套配色。十一套深色：classic、solarized dark、catppuccin mocha、tokyo night、gruvbox dark、nord、dracula、rosé pine、monochrome、kanagawa wave 和 onedark。七套浅色：solarized light、catppuccin latte、tokyo night day、gruvbox light、rosé pine dawn、paper 和 kanagawa lotus。

名称旁的色块条预览该配色，并且在选择器中切换时主题会立即应用，所以整个界面都是实时预览。管理器还会把终端自身的文字和背景颜色设为该配色的颜色，让窗口和界面之间没有接缝，并在退出时恢复。智能体面板在主题自己的背景和文字颜色上渲染，面板也会把这两种颜色告诉其中的智能体，这样会自动检测配色的智能体就会和管理器落在同一边（深色或浅色）。

theme follows OS（主题跟随系统）在启动时根据环境的浅色/深色偏好确定配色：在 macOS 和 Linux 桌面上读取操作系统设置，在其他环境（包括 SSH）中读取终端自身的背景。已经处于检测结果那一边的主题保持不变，只有不匹配时才会切换。同时有浅色和深色版本的配色会切换到另一半，所以 catppuccin mocha 会变成 latte，反之亦然，其他配色则切换到 classic 或 solarized light。你手动选择的主题会单独保存，所以关闭这个开关后会回到它。

background（背景）决定用什么填充界面后面的单元格。theme 是默认值，用配色的颜色绘制这些单元格，所以在忽略颜色请求的终端上也能保持一致。terminal 让它们保留终端自身的颜色，适合半透明或模糊背景的窗口。

符号#

symbols 在 Advanced（默认）和 Compatible 之间切换，后者是为无法显示几何符号的字体准备的纯 ASCII 标记。Compatible 涵盖状态标记、加载动画、收件箱、拖动手柄、分组折叠、终端行、worktree 和分叉标记、提示词和回复前缀、搜索、对话框标题、通知、待执行的归档和结束，以及 diff 结果。切换该行时会预览这些标记，选择会立即生效。不会检测字体。边框、仪表、箭头、按键提示和智能体输出保持不变。状态一页列出了两套标记。

图 5s · 设置

从右到左的文字#

希伯来语和阿拉伯语的行按它们所占的单元格绘制，在每个宿主上都一样。自带双向排版的终端，例如 iTerm2 的从右到左支持或 WezTerm 的 bidi_enabled，会自行重新排列这些行；关闭该支持，即可按 Agent Manager 绘制的列来阅读界面。

状态数据#

设置、排序、分组、归档、会话布局和分栏比例都保存在 state.db 中，下次运行时会恢复。