agy-cli-runtime

name	agy-cli-runtime
description	Internal helper contract for invoking Antigravity CLI from Claude Code and Codex plugin adapters
user-invocable	false

AGY Runtime

Use the shared companion from plugin adapters:

node "<plugin-root>/scripts/agy-companion.mjs" <command> "<raw arguments>"

Safety rules:

• Call agy through Node spawn argv arrays, not shell-interpolated strings.
• Omit --print for non-interactive runs and pipe the prompt through child stdin; AGY 1.1.1 detects non-TTY stdin automatically.
• Do not pass the prompt in argv or command logs.
• Treat print mode as a CLI transport, not Codex app-server parity. If a timed-out job captured stdout, report it as partial output instead of hiding it behind a generic failure.
• Use setup --smoke when flag availability is not enough and you need to verify that the local AGY session can complete print mode.
• Add --dangerously-skip-permissions only when explicitly requested.
• Keep logs and state under CLAUDE_PLUGIN_DATA when available; otherwise use the runtime fallback outside the source checkout.
• Keep host adapters thin and share process execution behavior through the companion/runtime.