跳到主要内容

Antigravity Cli

操作 Antigravity CLI(agy):plugin(插件)、认证、sandbox(沙箱)。

Skill 元数据​

SourceOptional(可选)— 使用 kopi skills install official/autonomous-ai-agents/antigravity-cli 安装
Pathoptional-skills/autonomous-ai-agents/antigravity-cli
Version0.1.0
AuthorTony Simons (asimons81), KOPI AI AGENT
LicenseMIT
Platformslinux, macos, windows
TagsCoding-Agent, Antigravity, CLI, Auth, Plugins, Sandbox
Related skillsgrok, codex, claude-code, kopi-ai-agent

参考:完整 SKILL.md​

信息

以下是此 skill 被触发时 Kopi Agent 加载的完整 skill 定义。这就是 skill 处于激活状态时 agent 所看到的指令。

Antigravity CLI (agy)

Antigravity CLI 的操作指南,通过 agy 调用。所有 agy 命令都要通过 Kopi Agent 的 terminal 工具运行;使用 read_file 检查其 config 和日志。本 skill 是参考 + 流程 — 它不封装网络 API,因此无需从 Kopi Agent 本身进行任何认证。

何时使用​

  • 安装、更新或对 agy 二进制文件进行冒烟测试
  • 驱动非交互式的 agy --print / agy -p 一次性调用
  • 调试 Antigravity 的认证、sandbox、权限或 plugin 状态
  • 读取 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 key — 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 采用的模式相同。对于一次性冒烟测试和脚本化提示,优先使用 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
  • Plugin 暂存区:~/.gemini/antigravity-cli/plugins/<plugin_name>/

快速参考​

封装命令​

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

常用 flags​

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

Plugin 子命令 (agy plugin --help)​

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

安装 flags (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。

Sandbox 行为​

  • enableTerminalSandbox 是 settings.json 中的布尔值;默认为 false。
  • 启动时的覆盖项(--sandbox, --dangerously-skip-permissions)可在当前会话中 取代持久化设置。

认证行为​

  • CLI 首先尝试 OS 安全 keyring。
  • 没有已保存的会话时,它会回退到基于浏览器的 Google 登录。
  • 在本地会打开默认浏览器;通过 SSH 时会打印授权 URL, 并要求将认证代码粘贴回来。
  • /logout 会移除已保存的凭据。

Plugin​

  • Plugin 会暂存到 ~/.gemini/antigravity-cli/plugins/<plugin_name>/ 下。
  • 它们可以打包 skill、agent、rules、MCP server 和 hook。
  • agy plugin list 返回未导入任何 plugin 是有效的空状态。

注意事项​

  • 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 项目标记。

验证​

确认安装真实且可用,全部通过 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 —— 来自入门指南、用法说明和功能文档的 精简笔记。