agy

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.

1. 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
   

2. 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.