用途：让每次无头 AGY 运行都产出可持久检查的证据产物，供下游校验；AGY 的无头入口是 agy -p / agy --print（与 gemini-cli 不同，没有 gemini -p）。一次性运行会在打印后退出（--print-timeout 默认 5 分钟）；-c/--continue 恢复最近会话，--conversation <id> 按 id 恢复。agentapi sidecar 是 AGY 的长期无头服务器，定时 tick 经它驱动运行，适合需要常驻大脑与热会话状态的循环。--add-dir 可重复，限定可触碰的仓库，配合限定范围的 git worktree。
主要能力与用法：按角色决定权限姿态。作者写入用 --add-dir 到单个 worktree 加 --dangerously-skip-permissions（dcg 仍开启）；校验者只读，不加跳过权限；研究者只读上下文。运行后立即 echo "$?" > exit-code，并将 stdout 重定向到 events.jsonl，stderr 到 stderr.log。每次运行建立独立带 UTC 时间戳的目录，写入 command.txt 记录 argv、cwd、模式（oneshot|sidecar）、模型与 --add-dir 范围，可选 changed-files.txt、scope.txt、model.txt、verdict.md。JSONL 为事实来源，优先于人类可读输出。最终把判定镜像到 ~/.gemini/antigravity-cli/brain/<conversation-id>/ 下的 userFacing 产物。
适用场景：自动化 AGY 循环、跨厂商作者与判定分离（不同 --model、不同会话）、sidecar 定时校验、只读校验任务。
限制：仅限 AGY 通道，禁止用 claude -p / claude --print 代替；dcg 的 BeforeTool 钩子必须保留在 ~/.gemini/settings.json；未捕获的输出视为未发生；不记录 conversation id 将无法恢复 tick 状态。收费、价格与平台等资料暂未提供。