配置 Agent
名字与图标
给不同的启动配置起能认出的名字、配上图标,在面板里一眼找到对的 Agent。
配置名和 Agent 名
clis 下的键,比如 Codex · review,是一套启动配置的名字。顶层的 names 列表提供每个 Agent 的建议名字:
{
"names": [
"Ada",
"Lin",
"Kai",
"Mira"
],
"clis": {
"Codex · review": {
"type": "codex",
"icon": "facade-blue",
"effort": "high"
}
}
}New Agent 和 Resume 会从列表里挑一个当前没被占用的名字;创建 Agent 时名字留空,也会按同样方式填一个。列表为空或者名字都用完了,就用 Agent ID,例如 #a1。启动和改名时都可以自己改。
这些字段在 facade.json 里改(见Agent 配置)。已经在运行的 Agent 要改名,看管理你的 Agent。
选一个图标
在 CLI 条目上设置 icon。例如 "icon": "facade-blue",用这套配置启动的 Agent 都会显示蓝色机器人,面板、CLI 选择器和终端标签页都用它。
选一个机器人颜色:
保存 facade.json 后,面板里的图标就会更新。
沿用厂商图标
icon 也可以填 claude、codex、agy、muse、opencode 或 pi。不填时,内置 type 用它自己的图标,custom 程序用 facade-pearl。
不接受文件路径、图片 URL 和 emoji。