npx -y cc-safety-net@latest install --agy-cli。它会在 ~/.gemini/config/hooks.json 中添加一个托管的 PreToolUse hook,对每次工具调用运行 npx -y cc-safety-net hook --agy-cli。该 hook 检查 run_command 中的 shell 命令,以及通过 manage_task 发送给正在运行任务的输入。然后运行 npx cc-safety-net doctor,确认 hook 已生效。
在 Antigravity CLI 中安装 CC Safety Net
1
运行安装程序
2
确认 hook 已生效
doctor 输出中 Antigravity CLI 一行显示 Detected 和 Configured。如果 hook 定义带有 enabled: false,则显示 Detected 和 Not configured。
要在 Antigravity CLI 中使用 /cc-safety-net 技能,需要另行添加。见 /cc-safety-net 技能。
Antigravity CLI 安装会改动什么
Antigravity 与 Gemini 共用.gemini 目录,因此安装程序写入的是 ~/.gemini/config/hooks.json。托管条目名为 cc-safety-net,它注册一个 PreToolUse 命令 hook,以 30 秒超时运行 npx -y cc-safety-net hook --agy-cli。文件不存在时,安装会新建该文件;托管条目被禁用时,安装会重新启用它。
Antigravity CLI hook 检查什么
- hook 把
run_command调用作为 shell 命令分析。 Action为send_input且Input为非空字符串的manage_task调用,hook 也会分析。这段文本会发送给已在运行的任务。hook 把Input作为 shell 命令分析,并检测其 shell 方言。- 其他
manage_task操作被视为不运行命令的工具调用。
Antigravity CLI 检查失败时会怎样
hook 失败时,Antigravity CLI 会阻止该工具调用。崩溃或非零退出、超时(30 秒)、缺少npx,以及输出不是有效 JSON,都会让调用停止。这是本项目 2026 年 10 月在 macOS 上的 Antigravity CLI 1.4.5 中观察到的行为,Antigravity 并未把它作为约定公布。
从 Antigravity CLI 卸载 CC Safety Net
~/.gemini/config/hooks.json 中的其他内容保持不变。
Antigravity CLI 故障排除
doctor报告Error (Antigravity CLI): Failed to parse Antigravity hooks config <path>: <reason>。~/.gemini/config/hooks.json不是有效的 JSON,因此doctor把 Antigravity CLI 计为未配置,并以1退出。修正 JSON 后重新安装。见 hook 配置解析错误。- 你手动编辑过托管条目。
doctor不对 Antigravity CLI 运行漂移检查,因此条目被改动时不会发出警告。安装也会让已启用的托管条目保持原样。要恢复默认条目,先运行uninstall --agy-cli,再重新安装。