Facade Code 文档
配置 Agent

审批与 Agent 协作范围

先弄清 yolo 同时控制的两件事,再决定用哪个值。

一个开关,两件事

yolo 是配置文件里的设置,使用同一份配置文件的项目共用这个值。它同时决定 CLI 的审批方式,以及 Agent 的 Facade 工具能联系到哪些 Agent。

设置CLI 审批Agent 访问范围
true(默认)CLI 支持时跳过审批提示。通过你的 Facade home 连着的所有 Agent,包括连上来的 SSH 项目。
false使用 CLI 原生的审批和沙箱(如果它有)。这个 Agent 的家族:父级、同级、子级,以及它们的后代。

Pi 在两种模式下都没有原生审批和沙箱。OpenCode 按自己的权限设置运行,默认允许所有工具。

改后续启动的默认值

在 facade.json 顶层加上或修改 yolo(见Agent 配置):

facade.json
{
  "yolo": false
}

保存后启动新 Agent 才会用这个值。运行中的 Agent 保持启动时的设置;Resume 和 Pin 恢复的 Agent 下次启动时读当前文件。

用不同 Facade home 的项目之间不能互相联系。发现 Agent 列表里少了谁,先看两边的 home 是否相同,再看访问设置。

权限参数放对位置

审批模式用 yolo 控制。不要往内置条目的 args 里加审批、沙箱或绕过参数;这些启动选项由 Facade 管理,冲突时,Facade 会报错并指出有问题的配置项。

custom 程序在两种模式下都用自己的权限设置。Facade 不给它注入工具,也不会替它授予文件夹信任。

想看 Agent 实际怎么合作,可以试一个协作模式。

查看 Markdown ↗文档

搜索文档

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