跳到主要内容

Antigravity Cli

操作 Antigravity CLI (agy)：插件、认证、沙箱。

技能元数据​

来源可选 — 使用 hermes skills install official/autonomous-ai-agents/antigravity-cli 安装
路径optional-skills/autonomous-ai-agents/antigravity-cli
版本0.1.0
作者Tony Simons (asimons81), Hermes Agent
许可证MIT
平台linux, macos, windows
标签Coding-Agent, Antigravity, CLI, Auth, Plugins, Sandbox
相关技能grok, codex, claude-code, hermes-agent

参考：完整 SKILL.md​

信息

以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理看到的指令。

Antigravity CLI (agy)

Antigravity CLI 的操作指南，调用方式为 agy。通过 Hermes terminal 工具运行所有 agy 命令；使用 read_file 检查其配置和日志。此技能提供参考和流程 — 它不封装网络 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。
  • 此技能不需要环境变量或 API 密钥 — Antigravity 通过操作系统密钥环/浏览器登录管理其自身的认证（参见下方的认证部分）。

如何运行​

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

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（以及用于捕获/监控的 tmux）启动 agy，这与 codex / claude-code 技能使用的模式相同。对于一次性冒烟测试和脚本化提示，首选 agy --print（非交互式）。

要检查 Antigravity 自身的文件，请使用 read_file 读取下方核心路径下的路径 — 不要通过终端使用 cat 命令。

核心路径​

  • 二进制文件/入口点：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
  • 提示助手： @ 路径自动补全，esc esc 清除提示（当未流式传输时），! 直接运行终端命令，? 打开帮助

设置和权限​

常见设置键 (settings.json)​

  • allowNonWorkspaceAccess
  • colorScheme
  • permissions.allow
  • trustedWorkspaces

权限模式​

request-review, always-proceed, strict, proceed-in-sandbox.

沙盒行为​

  • enableTerminalSandbox 是 settings.json 中的一个布尔值；默认值为 false。
  • 启动时覆盖选项（--sandbox、--dangerously-skip-permissions）可以取代当前会话的持久化设置。

认证行为​

  • CLI 首先尝试使用操作系统的安全密钥环。
  • 如果没有保存的会话，它将回退到基于浏览器的 Google 登录。
  • 在本地环境中，它会打开默认浏览器；通过 SSH 连接时，它会打印一个授权 URL，并期望用户粘贴返回授权码。
  • /logout 会移除已保存的凭据。

插件​

  • 插件暂存于 ~/.gemini/antigravity-cli/plugins/<plugin_name>/ 目录下。
  • 它们可以打包技能（skills）、代理（agents）、规则、MCP 服务器和钩子（hooks）。
  • 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 上，令牌存储是基于文件的，因此认证问题通常是本地文件/会话状态问题，而不仅仅是浏览器问题。
  • 工作区身份可能取决于启动目录和 .antigravitycli 项目标记文件。

验证​

确认安装是真实且可用的，全部通过 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. 对 ~/.gemini/antigravity-cli/settings.json 执行 read_file
  6. 对最新的 ~/.gemini/antigravity-cli/log/cli-*.log 执行 read_file
  7. 如有需要，对 ~/.gemini/antigravity-cli/keybindings.json 执行 read_file

支持文件​

  • references/cli-docs.md — 来自入门指南、用法和功能文档的浓缩笔记。