agy-plugin-cc
A Claude Code plugin that integrates Google's Antigravity (agy) CLI and Antigravity IDE developer tools into Claude Code.
This companion extension (also known as Google Agy Plugin or Antigravity Plugin) follows the same design patterns as codex-plugin-cc, providing full job tracking, background execution, code review, and a session-aware stop-time review gate for Google Antigravity workflows.
Prerequisites
The Antigravity CLI must be installed and authenticated before using this plugin.
-
Install agy CLI:
Mac/Linux:
curl -fsSL https://antigravity.google/cli/install.sh | bash
Windows PowerShell:
irm https://antigravity.google/cli/install.ps1 | iex
Windows CMD:
curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd
-
Authenticate with your Google account:
agy auth
Installation
Install the plugin from within Claude Code:
/plugin install agy@agy-plugin-cc
/reload-plugins
Or install/update the marketplace through npm:
npx -y @vit129/agy-plugin-cc@latest install
Opt in to automatic npm updates:
npx -y @vit129/agy-plugin-cc@latest install --auto-update
With auto-update enabled, /agy:setup checks npm at most once every 24 hours. If a newer version exists, it reinstalls the marketplace package and asks you to run /reload-plugins. Without auto-update, /agy:setup only prints the update command.
Commands & Usage
/agy:setup
Check whether agy is installed and optionally toggle the stop-time review gate.
/agy:setup
/agy:setup --enable-review-gate
/agy:setup --disable-review-gate
/agy:agy [prompt]
Run a one-shot agy task directly.
/agy:agy "Explain how the authentication flow works in this repo"
/agy:agy --resume "Keep going"
/agy:agy --sandbox "What files changed in the last commit?"
/agy:rescue [task]
Delegate investigation, fixes, or follow-up work to agy. Checks for a resumable previous session before starting.
/agy:rescue "Fix the memory leak in the WebSocket connection handler"
/agy:rescue "Triage the slow query logs" --background
/agy:rescue "Keep going" --resume
/agy:rescue "Start over from scratch" --fresh
/agy:rescue "Read-only audit of the auth module" --sandbox
Flags:
| Flag | Description |
|---|
--background | Run in the background; check progress with /agy:status |
--resume | Continue the most recent agy conversation |
--fresh | Force a new conversation, ignoring previous context |
--sandbox | Run agy with terminal restrictions (read-only mode) |
/agy:review
Run a code review — agy examines the current git changes and reports findings.
/agy:review
/agy:review --wait
/agy:review --background
/agy:review --scope branch
/agy:review --base main
Scopes: auto (default), working-tree, branch
/agy:adversarial-review [focus]
Run an adversarial review — agy tries to find the strongest reasons the change should not ship.
/agy:adversarial-review
/agy:adversarial-review "focus on the auth boundary"
/agy:adversarial-review --base main --wait
/agy:status [job-id]
Show active and recent agy jobs for this repository.
/agy:status
/agy:status task-abc123
/agy:status task-abc123 --wait
/agy:status --all
/agy:result [job-id]
Show the stored output for a finished job.
/agy:result
/agy:result task-abc123
/agy:cancel [job-id]
Cancel an active background job.
/agy:cancel
/agy:cancel task-abc123
Stop-Time Review Gate
When enabled, agy runs a review before each session ends and blocks if it finds issues.
/agy:setup --enable-review-gate # turn on
/agy:setup --disable-review-gate # turn off
When a session ends with the gate enabled:
agy reviews the previous Claude response- If it responds
ALLOW: — the session closes normally
- If it responds
BLOCK: — the session is blocked with the reason
Architecture
plugins/agy/
├── .claude-plugin/plugin.json # plugin metadata (v1.1.0)
├── agents/agy-rescue.md # agy:agy-rescue subagent
├── commands/ # slash commands
│ ├── agy.md # /agy:agy
│ ├── rescue.md # /agy:rescue
│ ├── setup.md # /agy:setup
│ ├── review.md # /agy:review
│ ├── adversarial-review.md # /agy:adversarial-review
│ ├── status.md # /agy:status
│ ├── result.md # /agy:result
│ └── cancel.md # /agy:cancel
├── hooks/hooks.json # SessionStart / SessionEnd / Stop
├── prompts/ # prompt templates
│ ├── review.md
│ ├── adversarial-review.md
│ └── stop-review-gate.md
├── scripts/
│ ├── agy-companion.mjs # main runtime (9 subcommands)
│ ├── session-lifecycle-hook.mjs # SessionStart / SessionEnd handler
│ ├── stop-review-gate-hook.mjs # Stop hook handler
│ └── lib/ # modular library
│ ├── agy.mjs # agy CLI wrapper
│ ├── args.mjs # argument parsing
│ ├── fs.mjs # file utilities
│ ├── git.mjs # git review target resolution
│ ├── job-control.mjs # job queries & enrichment
│ ├── process.mjs # process utilities
│ ├── render.mjs # output rendering
│ ├── state.mjs # persistent job state
│ ├── tracked-jobs.mjs # job lifecycle tracking
│ └── workspace.mjs # git root resolution
└── skills/
├── agy-cli-runtime/SKILL.md # internal runtime contract
├── agy-result-handling/SKILL.md # result presentation guidance
└── gemini-3-prompting/SKILL.md # prompt composition guidance
Changelog
v1.2.0 (2026-05-30)
- Added npm package metadata and
agy-plugin-cc installer CLI.
- Added
npx -y @vit129/agy-plugin-cc@latest install for repeatable install/update.
- Added opt-in auto-update with
install --auto-update or /agy:setup --enable-auto-update.
/agy:setup now checks npm for newer plugin versions and notifies by default.
v1.1.0 (2026-05-28)
- Background execution — all task and review commands support
--background; track progress with /agy:status
- Job tracking — persistent job state (queued / running / completed / failed / cancelled) per repository
/agy:status — list active and recent jobs; --wait polls until done; --all shows full history/agy:result — retrieve stored output for any finished job/agy:cancel — cancel a running background job/agy:review — agy reads the repo and reports findings on working-tree or branch changes (--scope, --base, --wait, --background)/agy:adversarial-review — adversarial review mode; agy argues the strongest case against shipping the change- Stop-time review gate — optional Stop hook that blocks session end when agy finds issues (
/agy:setup --enable-review-gate)
- Session lifecycle hooks — SessionStart injects session ID; SessionEnd cleans up orphaned jobs
--resume / --fresh flags on /agy:rescue and /agy:agy — resume most-recent conversation or force a new one--sandbox flag — run agy in read-only restricted mode on any command- Modular library:
agy.mjs, args.mjs, fs.mjs, git.mjs, job-control.mjs, process.mjs, render.mjs, state.mjs, tracked-jobs.mjs, workspace.mjs
v1.0.0
- Initial release:
/agy:agy, /agy:rescue, /agy:setup — basic task delegation and resume
License
MIT — see LICENSE. This is an original, independently authored
project (not a fork). You're welcome to fork it, modify it, and redistribute
it, provided the copyright notice in LICENSE is preserved.
