---
name: reference_antigravity_agy_not_headless
description: UPDATE 2026-07-03 — agy.exe NOW works headless (v1.0.6+ --print/-p returns clean stdout). Use it as the Antigravity/Gemini second-model path. Older claim (DOA headless) is obsolete.
metadata:
  type: reference
---

**CORRECTION 2026-07-03 (GURU-BEAST-ROG):** `agy.exe` (Google Antigravity CLI,
`%LOCALAPPDATA%\agy\bin\agy.exe`) **now has a working headless print mode.** `agy -p "<prompt>"
--dangerously-skip-permissions` returns clean stdout and exits 0 (smoke-tested: returned "READY";
also drove a full multi-file spec critique reading files via `--add-dir <dir>`). Flags: `-p/--print`
(single non-interactive prompt), `--print-timeout` (default 5m), `--add-dir` (add a workspace dir so
it can read files), `--model`, `--dangerously-skip-permissions` (auto-approve tools). Subcommands:
`models`, `install`, `update`, `plugin`. Re-wire came from GURU-5070 fleet sync + a newer agy build.
So agy IS now a usable Antigravity/**Gemini second-model** path, especially when `gemini-cli` OAuth
fails (e.g. BEAST-ROG's `throwIneligibleOrProjectIdError`). NOTE: after install the binary is added to
User PATH registry but NOT the active shell PATH until terminal restart — call it by full path
`/c/Users/guru/AppData/Local/agy/bin/agy.exe` from the Bash tool.

**Historical (pre-2026-07-03, now OBSOLETE):** earlier agy.exe builds (~June 2026) produced ZERO
stdout in `-p` mode and hung when driven headless (wrote only to a SQLite conversation store), so the
`agy` SKILL was pointed at `@google/gemini-cli` instead. The gemini-cli path still exists
(`ask-gemini.sh`) but on machines where its OAuth is ineligible, prefer **agy -p** now. Related:
[[reference_cdp_chrome_driver]], [[feedback_agy_review_not_readonly]].
