cc-agy-plugin
Antigravity CLI (agy) integration for Claude Code.
Gemini CLI has ended service for individual users (announced at Google I/O 2026). This plugin is a drop-in replacement for cc-gemini-plugin, adapted for agy's headless API.
Prerequisites
npm install -g @google/antigravity-cli
agy auth login
Installation
claude plugin marketplace add sysCat64/cc-agy-plugin
claude plugin install agy
For local development, replace the URL with an absolute path to this repo.
Commands
| Command | Description |
|---|
/agy:setup | Verify agy installation and auth |
/agy:ask [--dirs path,...] [--files glob,...] <task> | Ask agy with optional file/directory context |
/agy:review [staged|head|<ref>] | Code review via git diff |
/agy:adversarial-review [staged|head|<ref>] | Red-team / adversarial code review |
/agy:rescue [--dirs path,...] [--files glob,...] <task> | Delegate a task to agy as a background job |
/agy:status [<job-id>] | Check background job status (or list all jobs) |
/agy:result <job-id> | Read job output (partial or complete) |
/agy:cancel <job-id> | Cancel a running job |
Quick Start
/agy:setup
/agy:ask --dirs src explain the architecture of this codebase
/agy:review head
/agy:rescue --dirs src,tests identify all test coverage gaps and write a report
Background Jobs
/agy:rescue spawns agy detached and writes output to ~/.cache/cc-agy-plugin/jobs/.
Jobs survive Claude Code restarts — use /agy:status and /agy:result to follow up.
/agy:rescue --dirs src write a full API migration guide from v1 to v2
→ Job ID: a3f2c1b0
/agy:status a3f2c1b0
→ Status: running (PID 48291)
/agy:result a3f2c1b0
→ (output so far...)
Known Constraints (agy v1.0.x)
| Constraint | Detail |
|---|
No --model in headless | agy v1.0.x has no --model flag; the bridge works around this by patching ~/.gemini/antigravity-cli/settings.json at runtime |
| No session IDs | --continue resumes the most recent session only |
| Default timeout | 300 s — narrow context with --files if you hit it |
No --output-format | Output is always plain text |
Migration from cc-gemini-plugin
| cc-gemini-plugin | cc-agy-plugin |
|---|
/cc-gemini-plugin:gemini <task> | /agy:ask <task> |
/cc-gemini-plugin:gemini --dirs src <task> | /agy:ask --dirs src <task> |
--model gemini-2.5-pro | not supported in headless (v1.0.x) |
--format json | not supported (always plain text) |
gemini-agent | agy-agent |
Plugin Structure
cc-agy-plugin/
├── .claude-plugin/
│ ├── plugin.json # manifest (plugin name: "agy")
│ └── marketplace.json # marketplace registration
├── commands/ # /agy:* command definitions
│ ├── setup.md
│ ├── ask.md
│ ├── review.md
│ ├── adversarial-review.md
│ ├── rescue.md
│ ├── status.md
│ ├── result.md
│ └── cancel.md
├── agents/
│ └── agy-agent.md # agy-agent subagent definition
├── scripts/
│ ├── agy-bridge.js # context ingestion + agy -p invocation
│ ├── agy-rescue.mjs # background job manager
│ ├── check-agy.js # SessionStart hook — verifies agy is installed
│ └── utils.js # structured event logging (JSONL)
├── hooks/
│ └── hooks.json # SessionStart hook registration
├── tests/
│ └── agy-bridge.test.js # unit tests (node:test, 38 tests)
└── package.json
Local Development
After editing source files, bump the version in plugin.json, marketplace.json, and package.json, then:
claude plugin update agy@cc-agy-plugin
# restart Claude Code to apply
