/add-dir
为当前活动工作区添加一个额外目录。
/add-dir <路径> 属于 Antigravity CLI 斜杠命令中的 Utilities(工具)类别,用于给当前活跃的工作区(workspace)增加一个额外目录。默认情况下,代理只能看到会话的起始目录;使用 /add-dir 后,代理还会获得对另一个文件夹的读写权限,比如第二个代码仓库或文件系统中的一个同级目录。
该命令接受一个路径作为必填参数,输入时支持类似 shell 的路径自动补全。新增加的目录会立即被纳入文件搜索和自动补全范围,无需重启会话。此外,/add-dir 还会对新加入的文件夹进行定制内容发现(customization discovery):其中存放的技能、规则和钩子会被自动识别,并像主目录中的一样供代理使用。
需要区分的是:/add-dir 会把某个目录长期纳入本次对话的剩余部分,并授予对其全部内容的访问权限。如果只是想临时引用单个文件,使用提示词中的 @ 提及即可,无需长期扩展工作区。
✅ 什么时候用?
把第二个代码仓库或文件夹中的代码纳入进来
/add-dir ../shared-lib
把单体仓库(monorepo)中的某个子项目额外加入会话
/add-dir packages/api
⛔ 什么时候不该用?
只是想临时引用一次某个文件
/add-dir 会把整个目录长期纳入工作区,对于一次性的引用来说这样做没有必要、也过于繁重。
更好的选择: 直接在提示词中使用 @<路径>
目录中包含敏感数据,不希望代理长期拥有访问权限
/add-dir 会授予对整个文件夹内容的读写权限,并在本次对话剩余部分中纳入其中的技能/规则/钩子——这比单纯引用一个文件所需的权限要大得多。
更好的选择: 只通过 @<路径> 引用实际需要的那个文件,而不是开放整个文件夹
来源
- Antigravity CLI 文档:命令参考 ↗ antigravity.google
更多命令 · Antigravity CLI