AGY harness（Antigravity / Gemini CLI）是一项用于从宿主智能体驱动 Antigravity（Gemini）CLI 的技能，面向的对象是 agy / agy.exe。核心建议是：优先从宿主智能体使用 agy --print，不要使用 TUI；只有当存在真实 PTY 时才使用 TUI。资料基于 agy 1.1.13（Google.AntigravityCLI）验证，若参数看起来过时，应重新查看 agy --help。二进制位置为 %LOCALAPPDATA%\agy\bin\agy.exe。不要臆造 terminal() / process() 这类 API；从 Grok 或 PowerShell 调用 agy.exe。
安装（Windows）
winget install --id Google.AntigravityCLI --accept-source-agreements --accept-package-agreements
安装后需在当前进程中刷新 PATH（安装前启动的会话看不到 agy）：
$env:Path = [System.Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [System.Environment]::GetEnvironmentVariable('Path','User') where.exe agy agy --version
需注意 Google.Antigravity 是桌面 IDE，不是这个 CLI。安装后可以运行 agy install 在 shell profile 中追加 PATH 与别名。
认证
首次启动可能使用企业 Google 账号。也支持可选的直接 API 方式：使用 GEMINI_API_KEY，并在 ~/.gemini/antigravity-cli/settings.json 中设置 "modelProvider": "gemini"（见 agy changelog）。设置文件位于：~/.gemini/antigravity-cli/settings.json。
无头 --print 的限制
--print 无法进行交互提示。需要确认的工具会被软拒绝（stderr 输出 jetski: … auto-denied，退出码 0，stdout 为空）。工作区读取本应被自动允许；但实践中 ListDir / read_file 仍会询问，因此除非 permissions.allow 中存在相应规则，print 模式会失败。
建议在 settings 中保留以下只读允许列表（dispatcher 也会合并它）：
{ "allowNonWorkspaceAccess": true, "permissions": { "allow": [ "read_file()", "command()" ] } }
其中 command() 是必需的，因为 print 模式的 AGY 偏好 Bash（Get-Location、(Get-Location).Path 等），而前缀允许规则无法覆盖下一个表达式。不要添加 write_file()——写入仍应留在 --dangerously-skip-permissions / -AllowTools 之后。
从宿主驱动（一次性）
--print 会把下一个参数当作提示词。把消息紧跟在 --print / -p / --prompt 之后。--print 之后的标志会变成提示词文本，Gemini 只会跟你打招呼。
示例：
agy --model gemini-3.7-flash-medium --print "Your question or task"
标志说明：
-p / --print / --prompt：非交互；stdout 为回复 --model：例如 gemini-3.7-flash-medium --effort：low | medium | high --mode：accept-edits | plan --agent：本次会话使用的 Agent -c / --continue：当前工作区中最后一次对话 --conversation <id>：恢复指定对话 --print-timeout：默认 5 分钟 --output-format：text | json | stream-json --disable-slash-commands：print 模式下禁用 skill/slash 展开 --sandbox：限制终端工具 --dangerously-skip-permissions：自动批准工具（危险） --add-dir：额外工作区目录（可重复）
历史记录以当前工作目录为范围。如需同一线程，先 cd 到该目录；-c 表示该目录中的最后一次对话。
agy --continue --print "Follow-up in the same thread" agy --conversation <uuid> --print "Same thread, pinned id"
--output-format json 会包含 conversation_id——保存它并可传给 --conversation。--json-schema <file.json> 配合 --output-format json 会填充 structured_output（已验证）。
--mode plan 会在 ~/.gemini/antigravity-cli/brain/<id>/ 下写入计划产物，不会在当前工作目录创建计划中的文件（已验证：空文件夹保持为空）。--sandbox 存在；该宿主默认已对终端工具进行沙箱限制。--effort low|medium|high 在 print 运行时被接受。
烟雾测试：
agy --print "Respond with exactly: AGY_SMOKE_OK"
成功即 stdout 包含 AGY_SMOKE_OK。
模型
agy models
在 1.1.13 上可见：gemini-3.7-flash-{high,medium,low}、gemini-3.6-flash-、gemini-3.5-flash-、gemini-3.1-pro-{high,low}、claude-sonnet-4-6、claude-opus-4-6-thinking、gpt-oss-120b-medium。
agy agents / agy agent 列出自定义 agent（可能为空）。
TUI（人工或 PTY）
agy agy --continue agy --conversation <uuid>
? 或 /help —— 斜杠命令列表（Esc 关闭选择器） Esc Esc —— 清空提示词（不在流式输出时） ! —— 运行 shell 命令 @ —— 路径自动补全 /artifact 或 Ctrl+R —— Artifact Picker /resume —— 对话选择器（CLI 与 Antigravity 桌面导入） /fork（/branch）—— 克隆线程（不是 git） /config 或 /settings —— 覆盖层 Ctrl+D 两次 —— 干净退出（提示 agy -c / --conversation= 可恢复） /exit 可能打开面板 —— 优先使用 Ctrl+D 两次
Artifact picker：↑/↓、h/l、p 预览、y/n、Shift+A / Shift+R、Enter、Esc。
需要真实 PTY。无 TTY 的无头 run_terminal_command 不是驱动 TUI 的正确方式；应使用 --print。
其他命令
agy changelog agy plugin list agy update agy install # PATH / 别名
常见陷阱
直接运行 agy、agy help 或 agy version（不带 --）可能打开 TUI，并让非 PTY shell 挂起。应使用 agy --help 和 agy --version。
--print --model foo "hi" 会把 --model 当作提示词。标志应放在 --print 之前。
winget 安装后 PATH 可能过时——需刷新 Machine+User Path。
--dangerously-skip-permissions 会跳过工具提示；仅在任务可信时使用。
--print 中反复出现 jetski / read_file / command 自动拒绝：原因是 ~/.gemini/antigravity-cli/settings.json 缺少 permissions.allow。添加 read_file() 和 command()。不要通过总是传入 --dangerously-skip-permissions 来“修复”（它也会自动批准写入）。
如果 print 模式停滞，可回退到 opencode run 进行确定性的一次性执行。
宿主为 PowerShell：不要在双引号字符串中放 Linux 的 2>/dev/null（见 wsl-containers）。
产品文档：opencode/ 是另一个 harness。本技能仅针对 agy。
共享任务形态：harness-offload。
分类：本技能用于从智能体驱动 CLI 工具，属于“智能体与模型”类别。