用途：把 Google 的 Antigravity CLI（agy）以无头方式运行，并通过 agy -p "<task>" 将其作为编排的子智能体调用，运行在 Google 的 harness（Gemini 3.5 Flash）上。适合在脚本、CI 或沙箱容器中运行 Antigravity 智能体，或作为 Claude 之外的第二意见来源。交互式本地使用不适用此技能，直接运行 agy 会打开浏览器。
安装：curl -fsSL https://antigravity.google/cli/install.sh | bash，幂等，约 3 秒，安装到 ~/.local/bin/agy。
认证（一次，需人工参与）：在运行 agy 的每个 shell 中导出 SSH_CONNECTION、SSH_CLIENT、SSH_TTY，使令牌写入文件而非 OS keyring。运行 python3 scripts/agy_auth_broker.py & 启动 broker 并捕获 OAuth URL，sleep 15 && cat /tmp/agybroker/url 供人工打开授权，再用 printf '<code>' > /tmp/agybroker/code 回填授权码。令牌写入 ~/.gemini/antigravity-cli/antigravity-oauth-token，之后 agy -p 调用静默运行。需在几分钟内完成登录，容器空闲暂停会终止 broker 的 agy 进程。
编排：agy --dangerously-skip-permissions -p "<task>"。所有标志须放在 -p 之前，因为 -p 会把下一个参数当作提示词。可按需添加 --add-dir <path>、--print-timeout 10m 或 --conversation <id>。
在新容器复用认证：保存 ~/.gemini/antigravity-cli/antigravity-oauth-token 并写回（同时设置 SSH 变量），其 refresh_token 持久有效，无需重复 OAuth。该文件是个人 Google 凭据，须避免进入 git 和日志。
限制：认证需人工介入；令牌为个人凭据需妥善保管；其余细节（如超时、keyring 回退、令牌格式、网络主机、故障排查）见 references/auth-internals.md。