Skip to content
Back to search

claude-antigravity

MarketplaceWorks with Claude CodeGitHub

Claude Code plugin: Claude plans & reviews, Antigravity CLI (agy) executes. Quota-aware, git-checkpointed, secret-fenced, every run measured.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/redfer855--claude-antigravity/badge.svg)](/listings/redfer855--claude-antigravity)

HTML

<a href="/listings/redfer855--claude-antigravity"><img src="/api/listings/redfer855--claude-antigravity/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Requirements: **Node.js ≥ 20**, **git**, and the **Antigravity CLI (`agy`)** installed and signed in. The runtime finds `agy` on your `PATH`, at `%LOCALAPPDATA%\agy\bin\agy.exe`, or via the `AGY_BIN` environment variable.

In Claude Code:

/plugin marketplace add RedFer855/claude-antigravity
/plugin install agy@claude-antigravity

No `npm install` needed: the plugin has zero dependencies.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 21 lines
  1. {
  2. "name": "claude-antigravity",
  3. "owner": {
  4. "name": "Fernando Barahona"
  5. },
  6. "metadata": {
  7. "description": "Puente Claude Code → Antigravity CLI: Claude planea y revisa, agy ejecuta.",
  8. "version": "0.3.0"
  9. },
  10. "plugins": [
  11. {
  12. "name": "agy",
  13. "description": "Delegar ejecución a Antigravity (agy) con permisos controlados y registro de KPIs.",
  14. "version": "0.3.0",
  15. "author": {
  16. "name": "Fernando Barahona"
  17. },
  18. "source": "./agy-bridge"
  19. }
  20. ]
  21. }
README.md · README · 161 lines
  1. # claude-antigravity
  2. **Claude plans and reviews. Antigravity executes. Everything is measured.**
  3. A Claude Code plugin that hands the heavy, well-specified work (multi-file changes, refactors, Word/PDF documents) to the Antigravity CLI (`agy`, Gemini models) and gives you back one compact JSON verdict instead of a wall of narration.
  4. [![CI](https://github.com/RedFer855/claude-antigravity/actions/workflows/ci.yml/badge.svg)](https://github.com/RedFer855/claude-antigravity/actions/workflows/ci.yml)
  5. [![Release](https://img.shields.io/github/v/release/RedFer855/claude-antigravity?include_prereleases)](https://github.com/RedFer855/claude-antigravity/releases)
  6. [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
  7. ![Node >= 20](https://img.shields.io/badge/node-%3E%3D20-339933)
  8. ![Claude Code plugin](https://img.shields.io/badge/Claude%20Code-plugin-d97757)
  9. ![Zero dependencies](https://img.shields.io/badge/dependencies-0-blue)
  10. > 🇪🇸 [Léeme en español](README.es.md)
  11. ---
  12. ## Why
  13. Every turn Claude takes re-reads the whole conversation, and that is the expensive part. A task that needs 10 turns of edit → run → fix costs 10 full contexts. This plugin lets Claude write **one short brief**, lets `agy` do the reading, editing and iterating on a separate quota, and lets Claude look at **one result**.
  14. It only delegates when it actually saves turns, and it never trusts blindly: every delegation is checkpointed, fenced and verified.
  15. ## How it works
  16. ```
  17. you ──► Claude ──► brief (short, English, paths not contents)
  18. │
  19. ▼
  20. ┌────────────────────────┐
  21. │ agy-run.mjs (runtime) │
  22. │ 1. check quota │
  23. │ 2. git checkpoint │
  24. │ 3. run agy │
  25. │ 4. diff + guard │
  26. │ 5. verify (your cmd) │
  27. │ 6. log KPIs │
  28. └───────────┬────────────┘
  29. ▼
  30. Claude reads ONE compact JSON ──► approve / continue / undo
  31. ```
  32. ## Features
  33. - **Quota-aware.** Reads `agy`'s usage before spending anything; refuses to start if the model's quota group is under 10% (configurable with `--min-cuota`). `/agy:cuota` shows all groups, no tokens spent.
  34. - **Safe checkpoints.** Before and after every run it takes a git snapshot as a hidden ref (`refs/agy/<id>-antes` / `-despues`) built with a temporary index, so **your working tree, index and uncommitted changes are never touched**. The diff is measured between the two snapshots.
  35. - **Safe one-command undo.** `deshacer --id <id>` reverts only the files `agy` wrote with its file tools. Anything you or Claude edited in parallel is reported separately (`cambios.otros`) and left alone, and a file edited after the run is never overwritten unless you pass `--forzar`.
  36. - **Secret fence.** Contents of `.env*` (except `.env.example`-style templates) and `settings.local.json` are saved before the run and restored afterwards if the agent touched, deleted or created them. You are told which paths were reverted, and a copy of whatever the fence replaces is kept first, so an edit of yours made during the run is never lost.
  37. - **Permission control.** A conservative base allow/deny list (read-only commands and `git status/diff/log` allowed; `rm -r`, `Remove-Item`, `git push`, `git reset --hard`, `git clean`… denied) plus per-project rules managed with `/agy:permisos`. Command rules are exact-match; anything not matching is denied in headless mode instead of hanging. `--comando "npm test"` allows a command for one delegation only and always removes it afterwards, even if the run fails or is killed.
  38. - **Verification built in.** `--verificar "npm test"` runs your command after `agy` finishes and returns the tail of the output. A failed check becomes `verificacion_fallida`, ready for a one-shot correction turn.
  39. - **Questions mode.** `--preguntas` makes `agy` read the brief and reply with up to 5 blocking questions (or `READY`) **without modifying anything**, so big tasks and documents are not redone because of a misunderstanding.
  40. - **`/goal` mode** for long autonomous tasks, plus `--conversation <id>` to continue a session by sending only the delta.
  41. - **Compact output.** A long reply is cut to ~3000 chars for Claude's context keeping the start and the end, and the JSON points to the full reply on disk (`respuesta_completa`); brief and reply are saved there too.
  42. - **KPIs.** One JSON line per delegation (`tareas.jsonl`): model, mode, duration, turns, tokens, denied actions, files/lines changed, verification result, and whether you overrode Claude's recommendation. Measure what each model level really costs before changing defaults.
  43. - **Parallel work.** Split a task so Claude and `agy` touch different files, run `agy` in the background and keep going.
  44. - **Optional notification** when a delegation finishes (Windows, via a local PowerShell script if you have one; silently does nothing otherwise).
  45. ## Install
  46. Requirements: **Node.js ≥ 20**, **git**, and the **Antigravity CLI (`agy`)** installed and signed in. The runtime finds `agy` on your `PATH`, at `%LOCALAPPDATA%\agy\bin\agy.exe`, or via the `AGY_BIN` environment variable.
  47. In Claude Code:
  48. ```text
  49. /plugin marketplace add RedFer855/claude-antigravity
  50. /plugin install agy@claude-antigravity
  51. ```
  52. No `npm install` needed: the plugin has zero dependencies.
  53. ## Updating
  54. ```bash
  55. claude plugin marketplace update claude-antigravity
  56. claude plugin update agy@claude-antigravity
  57. ```
  58. Restart Claude Code to apply it. What changed in each version is in the [CHANGELOG](CHANGELOG.md) and on the [Releases](https://github.com/RedFer855/claude-antigravity/releases) page.
  59. Your KPI log, per-project permissions and saved briefs are written to Claude Code's plugin data directory (`CLAUDE_PLUGIN_DATA`), outside the plugin folder, so updating does not wipe them. Versions follow [SemVer](https://semver.org): `0.x.y` for fixes, `0.x.0` for new features, and `1.0.0` once the command and data-file contract is stable. Any change to the data file formats ships with a migration.
  60. ## Usage
  61. | Command | What it does |
  62. | :-- | :-- |
  63. | `/agy:delegar <task>` | Force a delegation. Claude writes the brief, `agy` executes, Claude reviews. Flags: `--model <slug>`, `--goal`, `--preguntas`, `--continuar <id>` |
  64. | `/agy:cuota` | Remaining quota per model group (5 h and weekly windows) and when it resets |
  65. | `/agy:permisos` | See, add or remove what `agy` may write and run in the current project. Always asks you before adding a rule |
  66. The `delegacion` skill also triggers on its own: before a task that would take Claude more than ~6 turns, when you ask for a Word/PDF document, or when you say "use agy". It recommends a model in a single question (Delegate with X / Another model / I'll do it).
  67. You can also call the runtime directly:
  68. ```bash
  69. node agy-bridge/scripts/agy-run.mjs --cwd /path/to/project \
  70. --model gemini-4-hydrogen-high \
  71. --verificar "npm test" --tipo feature <<'BRIEF'
  72. Add input validation to src/api/users.ts. Done when `npm test` passes.
  73. Only modify files under src/api/.
  74. BRIEF
  75. ```
  76. ```bash
  77. node agy-bridge/scripts/agy-run.mjs cuota # quota, no tokens spent
  78. node agy-bridge/scripts/agy-run.mjs deshacer --id d1234 --cwd . # revert one delegation
  79. ```
  80. ### Verdicts
  81. `estado` is one of `ok`, `parcial`, `verificacion_fallida`, `permiso_denegado` (with the exact denied command), `sin_cuota`, `vacio`, `error` or `timeout`. Exit code is `0` only for `ok`. The skill caps corrections at two continuations, then Claude takes over or asks you.
  82. ### Which model?
  83. Default is `gemini-4-hydrogen-high`; `medium` for mechanical single-file work, `xhigh` before switching models, `gemini-4-neon-high` for security-sensitive reviews, and Claude models *inside* `agy` (billed to your Google quota, separate from your Claude one) for hard, well-specified tasks. The full table lives in [`skills/delegacion/SKILL.md`](agy-bridge/skills/delegacion/SKILL.md).
  84. ## Project layout
  85. ```
  86. .claude-plugin/marketplace.json marketplace entry
  87. agy-bridge/
  88. .claude-plugin/plugin.json plugin manifest (name: agy)
  89. commands/ /agy:delegar /agy:cuota /agy:permisos
  90. skills/delegacion/ when and how to delegate, model choice, review loop
  91. skills/gemini-prompting/ how to write a brief that makes agy do the work
  92. permisos/base.json global allow/deny list
  93. scripts/agy-run.mjs the runtime
  94. scripts/lib/ quota, git snapshots, stream parser, guard, KPIs…
  95. tests/ node:test suite
  96. scripts/ repo tooling: verificar.mjs, release.mjs (not shipped)
  97. .github/workflows/ ci.yml, release.yml
  98. CHANGELOG.md release notes source
  99. ```
  100. ## Development
  101. ```bash
  102. npm test # repo scripts + plugin tests (what CI runs)
  103. npm run verificar # versions, CHANGELOG, manifests, frontmatter
  104. npm run release -- minor # bump version + CHANGELOG on a release/vX branch
  105. npm run etiquetar # from an up-to-date main: tag it; CI publishes the GitHub Release
  106. ```
  107. Runtime data (KPI log, per-project permissions, saved briefs and replies) goes to `CLAUDE_PLUGIN_DATA` when installed, so plugin updates never wipe it.
  108. ## Notes
  109. - Built and tested on **Windows 11**. The core is plain Node + git, but macOS/Linux are untested; the finish notification is Windows-only.
  110. - The skill and command prompts are written in **Spanish** (the briefs sent to `agy` are written in English to save tokens). PRs with translations are welcome.
  111. - This is an independent community project. It is not affiliated with or endorsed by Anthropic or Google.
  112. ## Contributing
  113. Issues and pull requests are welcome, especially for macOS/Linux support and translations. Keep the zero-dependency rule, add a test for new runtime behaviour and note the change under `[Unreleased]` in the CHANGELOG. Everything lands on `main` through a PR with the `CI completo` check green; see [AGENTS.md](AGENTS.md).
  114. ## License
  115. [MIT](LICENSE) © 2026 Fernando Barahona
  116. ---
  117. If this saved you some turns (or some quota), a ⭐ helps other people find it.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.