Antigravity CLI (agy) 命令行深度剖析与自动化实战

#!/usr/bin/env bash
set -euo pipefail

echo "==> [AGY-CI] Initializing Antigravity Automation Runner..."
agy --version || { echo "Error: agy CLI not found in PATH"; exit 1; }

echo "==> [AGY-CI] Running environment preflight checks..."
agy doctor --json > /tmp/agy-doctor.json

echo "==> [AGY-CI] Executing non-interactive agentic validation..."
agy run "执行单元测试，如有失败自动定位并输出修复方案" \
  --non-interactive \
  --timeout 300 \
  --max-turns 15

echo "==> [AGY-CI] Workflow completed with exit code 0."

认识 agy CLI

agy 是与 Antigravity 智能体系统交互的核心终端命令。它既可以作为独立终端开发者伴侣在日常编码中随时唤起，也可以通过无头模式（Headless Mode）集成到 GitHub Actions、GitLab CI 等自动化流水线中，完成代码审查、端到端测试与漏洞自愈。

---

常用命令矩阵与参数速查

命令分类	完整命令	参数说明	典型使用场景
基础诊断	agy doctor	--verbose, --json	检查 MCP 服务连通性、Node/Python 依赖与环境配置
任务执行	agy run [prompt]	--non-interactive, --timeout, -m	在终端启动单次自主任务执行
交互会话	agy session	--resume [id], --list	启动或挂起长生命周期多轮协同会话
环境初始化	agy init	--template [web|api]	在当前目录快速创建 .agents 智能体规范模板
配置管理	agy config get/set	--global, --workspace	查询或设置 API Endpoint、模型路由策略与工具权限

---

核心命令深度实战

1. agy doctor: 诊断与健康检查

在开始任何复杂任务前，agy doctor 能快速检查本地宿主与各种 Sidecar MCP 插件的状态：

# 执行完整自检并格式化输出
agy doctor

# 输出 JSON 格式，适合 CI/CD 脚本前置校验
agy doctor --json | jq '.mcp_servers'

输出通常包含：

• Python / Node 运行时与活跃虚拟环境
• Eager 操作系统级工具权限（终端、文件差分读写）
• Lazy MCP 服务连接池（ActKite, Cua-Driver, DevTools）

2. agy run: 无头自主任务执行

agy run 允许你直接向 Antigravity 派发一个结构化目标任务。结合 --non-interactive 参数，智能体将在无人类干预的情况下完成分析、代码编写、静态检查与本地测试：

# 自动修复 TypeScript 类型错误并验证构建
agy run "修复当前项目中所有的 TypeScript lint 警告，并确保 npm run build 通过" \
  --max-turns 10 \
  --timeout 180

[!TIP] 参数建议：对于 CI/CD 场景，建议始终配置 --max-turns（防止发散死循环）与 --timeout（限制最长执行秒数）。

3. 会话恢复与断点续做 (agy session)

Antigravity 2.0 原生记录所有对话状态与操作快照（Transcript）。如果你在执行复杂任务中需要中断或切换设备，可以轻松找回状态：

# 列出最近的 5 次历史会话
agy session --list --limit 5

# 恢复指定 ID 的会话继续未完成的工作
agy session --resume <session-id>

---

与 CI/CD 流水线深度集成

你可以将上方的可复制脚本保存为 scripts/run-agy-ci.sh，并在 GitHub Actions 中这样配置：

name: Antigravity Agentic PR Review
on: [pull_request]

jobs:
  agent-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 22
      - name: Run Antigravity Autonomous Test
        env:
          GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
        run: |
          chmod +x ./scripts/run-agy-ci.sh
          ./scripts/run-agy-ci.sh