AG
Gemini & Antigravity v2.6 GenAI 智能体工程指南
Antigravity 架构 v2.6 核心工具 实机验证: 2026-10

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

全面掌握 Antigravity 2.6 CLI 核心命令集:跨端会话同步 agy sync、Gemini 4 模型路由、agy run、agy test 与系统诊断,打造无缝结合 CI/CD 的工业级智能体流水线。

维护团队: AGY 智能体架构组 • Google GenAI & Antigravity 2.6 平台工程规范

Antigravity 2.6 CI 自动化脚本

scripts/run-agy-ci.sh

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

echo "==> [AGY-CI] Initializing Antigravity 2.6 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 via Gemini 4..."
agy run "执行全量单元测试与安全审计,如有失败自动定位并输出修复方案" \
  --model gemini-4-argon \
  --non-interactive \
  --timeout 300 \
  --max-turns 15

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

认识 agy CLI 2.6

agy 是与 Antigravity 智能体系统交互的核心终端命令。在全新的 Antigravity 2.6 中,agy 带来了两项突破性能力:

  1. 跨端会话实时漫游(agy sync):随时将终端执行进度与独立桌面端或 VS Code / Cursor IDE 双向同步;
  2. 原生驱动 Gemini 4 双旗舰(Argon & Carbon):命令行支持通过 --model 自由切换全球第一的 Carbon 模型或高吞吐的 Argon 模型。

2.6 常用命令矩阵与参数速查

命令分类完整命令参数说明典型使用场景
跨端同步 (v2.6)agy sync--surface [ide|desktop], --follow实时漫游桌面端与 IDE 历史会话
基础诊断agy doctor--verbose, --json检查 MCP 连通性、Node 26、配置及 Gemini 4 授权
任务执行agy run [prompt]--model gemini-4-argon, --timeout在终端启动单次自主任务执行
交互会话agy session--resume [id], --list启动或挂起长生命周期多轮协同会话
环境初始化agy init--template [web|api|fullstack]快速生成 .agents 智能体规范与 MCP 模板
配置管理agy configget/set, --global读写 ~/.gemini/config.json 核心凭证与配置

核心命令深度实战

1. agy sync: 跨端会话漫游 (Antigravity 2.6 特性)

# 1. 开启实时同步模式,将当前终端任务广播至 IDE 侧边栏
agy sync --surface ide --follow

# 2. 列出跨端活跃会话并一键附着
agy sync --list
agy sync --attach <session-id>

2. agy run: 指定 Gemini 4 执行复杂重构

# 调度全球第一的 Gemini 4 Carbon 执行深度安全审计与漏洞修补
agy run "审查当前项目的 JWT 鉴权与 SQL 查询,修复重放漏洞并产出单元测试" \
  --model gemini-4-carbon \
  --timeout 600

# 调度高性价比的 Gemini 4 Argon 执行常规功能开发
agy run "基于 Tailwind v4 实现响应式用户个人资料卡片" \
  --model gemini-4-argon

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

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

# 输出 JSON 格式报告供 CI 门禁消费
agy doctor --json > /tmp/agy-health.json

凭证配置规范更新:~/.gemini/config.json

在 Antigravity 2.6 中,所有凭据与模型路由规范统一收敛至标准路径 ~/.gemini/config.json:

{
  "activeModel": "gemini-4-argon",
  "fallbackModel": "gemini-3-flash",
  "telemetry": true,
  "mcpDirectory": "~/.gemini/antigravity/mcp",
  "auth": {
    "provider": "google-ai-studio",
    "expires_in": 3599
  }
}