用途：Antigravity CLI（命令名 agy）的操作参考与流程指南，用于安装、更新、冒烟测试 agy，驱动非交互式 agy --print / agy -p 一次性提示，调试认证、沙箱、权限或插件状态，以及读取设置、快捷键、会话与日志。该技能不封装网络 API，无需从 Hermes 侧认证。
主要能力：分两层——Shell 包装命令（agy help、agy install、agy plugin、agy update、agy changelog）与运行中 TUI 内的斜杠命令（/config、/permissions、/skills、/agents 等）。agy help 只显示包装命令，不含会话内斜杠命令。常用标志包括 --add-dir、--continue/-c、--conversation、--dangerously-skip-permissions、--print/-p、--print-timeout、--prompt、--prompt-interactive/-i、--sandbox、--log-file、--version。插件子命令有 list、import、install、uninstall、enable、disable、validate、link、help。
使用方式：所有 agy 命令通过终端工具执行，例如 terminal(command="agy --version")、terminal(command="agy plugin list")、terminal(command="agy --print '...'", workdir="/path/to/project")。交互式多轮会话用 pty=true（配合 tmux）；脚本化提示用 agy --print。检查 Antigravity 自身文件用 read_file 读取 ~/.gemini/antigravity-cli/ 下的路径。认证优先使用操作系统密钥环，无会话时回退到浏览器 Google 登录；SSH 下打印授权 URL 并要求粘贴授权码；/logout 清除凭据。
适用场景：安装与验证、一次性提示与二次意见、长任务后台运行、交互式多轮、并行 worktree 分发，以及作为编码代理后端或第三方评审。
限制：agy -p 仅输出纯文本，没有 --output-format json，也没有含 session_id/成本/轮次的结果封装；没有 --max-turns，打印运行由 --print-timeout 限制（默认 5 分钟）。沙箱由 settings.json 中 enableTerminalSandbox 控制，默认 false。Antigravity 是执行后端而非一等编排原语。WSL 下令牌存储基于文件。工作区身份可能依赖启动目录与 .antigravitycli 项目标记。故障排查首选 ~/.gemini/antigravity-cli/log/cli-*.log。