跳到主要內容

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 — 來自入門指南、用法和功能文檔的濃縮筆記。