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 带来了两项突破性能力:
- 跨端会话实时漫游(
agy sync):随时将终端执行进度与独立桌面端或 VS Code / Cursor IDE 双向同步; - 原生驱动 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 config | get/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
}
}