Antigravity Cli
操作 Antigravity CLI(agy):plugin(插件)、认证、sandbox(沙箱)。
Skill 元数据
| Source | Optional(可选)— 使用 kopi skills install official/autonomous-ai-agents/antigravity-cli 安装 |
| Path | optional-skills/autonomous-ai-agents/antigravity-cli |
| Version | 0.1.0 |
| Author | Tony Simons (asimons81), KOPI AI AGENT |
| License | MIT |
| Platforms | linux, macos, windows |
| Tags | Coding-Agent, Antigravity, CLI, Auth, Plugins, Sandbox |
| Related skills | grok, 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 有两层 — 必须将它们区分开,否则指引会出错:
- Shell 封装命令 —
agy help、agy install、agy plugin、agy update、agy changelog。通过terminal工具运行这些命令。 - 交互式会话内斜杠命令 —
/config、/permissions、/skills、/agents等。它们只存在于运行中的agyTUI 会话内,而不在 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 changelogagy helpagy installagy plugin/agy pluginsagy 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)
allowNonWorkspaceAccesscolorSchemepermissions.allowtrustedWorkspaces
权限模式
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
读取文件):
terminal(command="command -v agy")terminal(command="agy --version")terminal(command="agy help")terminal(command="agy plugin list")read_file在~/.gemini/antigravity-cli/settings.json上read_file在最新的~/.gemini/antigravity-cli/log/cli-*.log上- 如有需要,
read_file在~/.gemini/antigravity-cli/keybindings.json上
支持文件
references/cli-docs.md—— 来自入门指南、用法说明和功能文档的 精简笔记。