{/* This page is auto-generated from the skill's SKILL.md by website/scripts/generate-skill-docs.py. Edit the source SKILL.md, not this page. */}

Antigravity Cli

操作 Antigravity CLI（agy）：插件、认证、沙箱。

Skill 元数据
来源可选——用 hermes skills install official/autonomous-ai-agents/antigravity-cli 安装
路径optional-skills/autonomous-ai-agents/antigravity-cli
版本0.2.0
作者Tony Simons（asimons81）、Hermes Agent
许可证MIT
平台linux, macos, windows
标签Coding-Agent, Antigravity, CLI, Auth, Plugins, Sandbox
相关 skillgrok、codex、claude-code、hermes-agent

参考：完整 SKILL.md

INFO

以下是 Hermes 在触发该 skill 时加载的完整 skill 定义。这是 agent 在 skill 激活时所看到的指令内容。

Antigravity CLI（agy）

以 agy 调用的 Antigravity CLI 操作指南。所有 agy 命令经 Hermes terminal 工具运行；用 read_file 检查其配置和日志。本 skill 是参考 + 流程——它不包装网络 API，因此 Hermes 本身无东西要认证。

何时使用

  • 安装、更新或冒烟测试 agy 二进制
  • 驱动非交互 agy --print / agy -p 一次性
  • 调试 Antigravity 认证、沙箱、权限或插件状态
  • 读 Antigravity 设置、键绑定、会话或日志

心智模型

Antigravity 有两层——区分开，否则指引会错：

  1. shell 包装命令——agy help、agy install、agy plugin、agy update、agy changelog。经 terminal 工具跑。
  2. 交互式会话内斜杠命令——/config、/permissions、/skills、/agents 等。这些只存在于运行中的 agy TUI 会话内，不在 shell 包装上。

agy help 显示 shell 包装表面，不是会话内斜杠命令。

前置条件

  • PATH 上的 agy 二进制。经 terminal 工具验证：command -v agy && agy --version。
  • 本 skill 不需要环境变量或 API 密钥——Antigravity 经 OS keyring/浏览器登录管理自己的认证（见下方认证）。

运行方式

每个 agy 命令经 terminal 工具调用。示例：

terminal(command="agy --version")
terminal(command="agy help")
terminal(command="agy plugin list")
terminal(command="agy --print 'Summarize the repo in 3 bullets'", workdir="/path/to/project")

交互式多轮 TUI 会话，用 pty=true 启动 agy（配 tmux 做捕获/监控），即 codex / claude-code skill 用的同一模式。一次性冒烟测试和脚本 prompt，优先 agy --print（非交互）。

检查 Antigravity 自己的文件，对下方核心路径用 read_file——不要经 terminal cat。

委派模式

agy 是与 codex / claude-code 同家族的编码 agent 后端，因此同一委派形态适用。把真实工作（特性、修复、评审、第二意见）交给 Antigravity 而非仅冒烟测试时用这些。

一次性（脚本 prompt 和第二意见首选）

terminal(command="agy -p 'Review this diff for bugs and security issues' --model 'Gemini 3.1 Pro (High)'", workdir="/path/to/repo", timeout=300)

-p 非交互：跑 prompt 退出。用 --model 选引擎（跑 agy models 拿确切显示串，如 'Gemini 3.1 Pro (High)'、'Claude Opus 4.6 (Thinking)'）。用可重复 --add-dir 加额外上下文根。

长/有界运行（测试、构建、多文件变更）

后台跑，完成时通知，同 codex skill：

terminal(command="agy -p 'Implement the change described in TASK.md and run the tests' --dangerously-skip-permissions", workdir="/path/to/repo", background=true, notify_on_complete=true)
# 然后：process(action="poll"/"log"/"wait", session_id=<id>)

交互式多轮（PTY + tmux）

会话式会话，在 pty=true 下用 tmux 为 capture-pane / send-keys 启动 agy -i（或裸 agy），即 codex / claude-code skill 记录的模式。之后用 --continue / -c 或特定 --conversation <id> 恢复。

并行实例（批量子问题/worktree 扇出）

每任务一个 git worktree，在每个里启动独立 agy -p（后台），然后收集结果——即 codex skill 批量修 issue 用的同一 worktree 扇出。把并发限到机器和你的评审容量能吸收的。

输出 + 有界注意（与 Claude Code 不同）

  • agy -p 返回纯文本——无 --output-format json，也无带 session_id / 成本 / 轮次计数的结果信封。直接解析 stdout；别期待 JSON 对象。
  • 无 --max-turns。print 运行由 --print-timeout（默认 5m）限定。长任务提高：--print-timeout 20m。配 terminal timeout= 使外层调用不提前切断运行。

编排边界

Antigravity 是worker 执行后端或第三意见评审者——运行任务的 agent/profile 拥有的执行细节，不是一等编排原语。不要把 agy 放上看板当自己的卡，也不要当协调层；经正常任务图路由工作，让指派的 worker 选 agy（vs codex/claude-code/直接工具）作为方法。仅当用户要求、worker 配置包装它、或你想对另一 agent 计划或 diff 做 Gemini 家族交叉核对时才显式用它。

核心路径

  • 二进制/入口：agy
  • 应用数据目录：~/.gemini/antigravity-cli/
  • 设置文件：~/.gemini/antigravity-cli/settings.json
  • 键绑定文件：~/.gemini/antigravity-cli/keybindings.json
  • 日志：~/.gemini/antigravity-cli/log/cli-*.log
  • 会话：~/.gemini/antigravity-cli/conversations/
  • Brain 工件：~/.gemini/antigravity-cli/brain/
  • 历史：~/.gemini/antigravity-cli/history.jsonl
  • 插件暂存：~/.gemini/antigravity-cli/plugins/<plugin_name>/

快速参考

包装命令

  • agy changelog
  • agy help
  • agy install
  • agy plugin / agy plugins
  • agy update

有用标志

  • --add-dir
  • --continue / -c
  • --conversation
  • --dangerously-skip-permissions
  • --print / -p
  • --print-timeout
  • --prompt
  • --prompt-interactive / -i
  • --sandbox
  • --log-file
  • --version

插件子命令（agy plugin --help）

  • list、import [source]、install <target>、uninstall <name>、 enable <name>、disable <name>、validate [path]、link <mp> <target>、 help

安装标志（agy install --help）

  • --dir、--skip-aliases、--skip-path

会话内斜杠命令

  • 会话控制： /resume（/switch）、/rewind（/undo）、 /rename <name>、/clear、/fork、/reset、/new
  • 设置与工具： /config、/settings、/permissions、/model、 /keybindings、/statusline、/tasks、/skills、/mcp、/open <path>、 /usage、/logout、/agents
  • prompt 助手： @ 路径自动补全、esc esc 清 prompt（非流式时）、! 直接跑 terminal 命令、? 开帮助

设置与权限

常见设置键（settings.json）

  • allowNonWorkspaceAccess
  • colorScheme
  • permissions.allow
  • trustedWorkspaces

权限模式

request-review、always-proceed、strict、proceed-in-sandbox。

沙箱行为

  • enableTerminalSandbox 是 settings.json 中布尔；默认 false。
  • 启动时覆盖（--sandbox、--dangerously-skip-permissions）可对当前会话取代持久设置。

认证行为

  • CLI 先试 OS 安全 keyring。
  • 无保存会话时，回退基于浏览器的 Google 登录。
  • 本地它开默认浏览器；SSH 上它打印授权 URL，期待贴回 auth code。
  • /logout 移除保存凭据。

插件

  • 插件暂存于 ~/.gemini/antigravity-cli/plugins/<plugin_name>/。
  • 它们可捆绑 skill、agent、规则、MCP 服务器和钩子。
  • agy plugin list 返回无导入插件是有效空态。

常见陷阱

  • agy help 显示包装命令，非交互斜杠命令。
  • agy --version 是安全非交互版本检查；agy version 交互式，无真 TTY 会失败。
  • 失败第一查看处：~/.gemini/antigravity-cli/log/cli-*.log（用 read_file）。
  • 别把持久 JSON 设置与启动时覆盖混淆。
  • ~/.gemini/antigravity-cli/bin/agentapi 是 agy agentapi 的薄包装。
  • WSL 上 token 存储基于文件，因此认证问题通常是本地文件/会话状态问题，而非仅浏览器问题。
  • 工作区身份可能依赖启动目录和 .antigravitycli 项目标记。
  • agy -p 仅打印纯文本——无 --output-format json、无结果信封。别试图从中解析 JSON 对象（不像 claude-code）。
  • 用 --print-timeout（默认 5m）限定 print 运行，而非 --max-turns（agy 上不存在）。

验证

确认安装真实可用，全部经 terminal 工具（文件用 read_file 读）：

  1. terminal(command="command -v agy")
  2. terminal(command="agy --version")
  3. terminal(command="agy help")
  4. terminal(command="agy plugin list")
  5. read_file 读 ~/.gemini/antigravity-cli/settings.json
  6. read_file 读最新 ~/.gemini/antigravity-cli/log/cli-*.log
  7. 需要时 read_file 读 ~/.gemini/antigravity-cli/keybindings.json

支持文件

  • references/cli-docs.md——来自入门、用法和特性文档的精简笔记。