Facade Code 文档
配置 Agent

名字与图标

给不同的启动配置起能认出的名字、配上图标,在面板里一眼找到对的 Agent。

配置名和 Agent 名

clis 下的键,比如 Codex · review,是一套启动配置的名字。顶层的 names 列表提供每个 Agent 的建议名字:

facade.json
{
  "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。

查看 Markdown ↗文档

搜索文档

搜索本文档。↑ ↓ 选择,Enter 打开,Esc 关闭。