agy — Antigravity CLI plugin for Claude Code

Wraps Google's Antigravity CLI (agy, Gemini 3) so Claude Code can ask it for code reviews, multi-persona strategic analyses, and free-form second opinions without tripping over the stdin-piping foot-guns that hang agy --print on long prompts.

What you get

Slash command	Purpose
/agy-review [PR# | ref | free-form focus]	Single-pass code review on the current diff (uncommitted, a PR, or a commit range). Verdict + P0/P1/P2/P3 findings.
/agy-personas <topic>	Three personas (Product PM / Senior Backend / Tech Lead) review the topic, each ≤120 words, then a synthesis. Optional diff injection.
/agy-ask <prompt>	Free-form one-shot Q&A through Gemini 3. No scaffolding. The lowest-friction way to grab a second opinion.

All three go through a single shell wrapper (scripts/agy-pipe.sh) that:

• Buffers the prompt to a temp file so we can detect empty input early.
• Feeds the prompt via stdin (not --print "$(cat …)" — that's the hang foot-gun).
• Wraps agy --print in gtimeout / timeout with a hard wall-clock kill, so a stuck call exits with code 124 instead of hanging the parent session.
• Sets --print-timeout on agy itself so internal errors are surfaced cleanly when the wall-clock timer isn't needed.

Install

From this repo (after it's on GitHub)

# Once the marketplace is hooked up:
claude plugin install future-agi/agy-claude-plugin

# Or directly from a local clone for development:
claude plugin install ~/code/agy-claude-plugin

Prerequisites

• agy CLI on PATH — install via the Antigravity docs. Verify with agy --version.
• (Recommended) GNU coreutils for gtimeout — brew install coreutils. The wrapper falls back to BSD timeout if gtimeout is missing, and to plain agy --print-timeout if neither is installed.

Why a wrapper?

agy --print "<huge prompt>" hangs indefinitely when the prompt is large enough — observed during multi-persona reviews of a 50KB+ diff. Piping the same prompt via stdin (agy --print < file) returns in seconds. The wrapper standardises on the working invocation and adds a hard timeout so a stuck call can never freeze the parent session.

Development

# Smoke test the wrapper
echo "hi reply with one word: pong" | ./scripts/agy-pipe.sh 30
# Expected output: pong

# Try the slash commands locally
claude plugin install $(pwd)
# Then in a Claude Code session:
#   /agy-ask what is 2+2
#   /agy-review HEAD~1
#   /agy-personas should we ship the CH25 migration with 267 skipped tests

Layout

agy-claude-plugin/
├── .claude-plugin/plugin.json    # Plugin metadata
├── commands/
│   ├── agy-ask.md                # /agy-ask  — free-form Q&A
│   ├── agy-review.md             # /agy-review — diff/PR review
│   └── agy-personas.md           # /agy-personas — multi-persona review
├── scripts/
│   └── agy-pipe.sh               # The stdin-piping wrapper with timeouts
├── README.md
└── LICENSE

License

MIT — see LICENSE.