Skip to content

Add Google Antigravity support - #145

Open
mjeanhudson-dev wants to merge 1 commit into
haydenschmitty:mainfrom
mjeanhudson-dev:feat/antigravity-support
Open

mjeanhudson-dev wants to merge 1 commit into
haydenschmitty:mainfrom
mjeanhudson-dev:feat/antigravity-support

Conversation

@mjeanhudson-dev

Copy link
Copy Markdown

What this changes

Adds native Google Antigravity plugin, map-building, and CLI Ask support alongside Claude Code and Codex. Builds on the goal of #74 — happy to credit @JulioJCLF or coordinate if you prefer to supersede or merge with #74.

floorplan/
├── .antigravity-plugin/plugin.json         # Native Antigravity manifest (v0.11.0, logo link)
├── CHANGELOG.md                            # Unreleased entry crediting contributor
├── docs/
│   ├── README.md, antigravity.md           # Install, editor links, agy Ask, Windows daemon tip
│   ├── development.md, is-it-safe.md       # Multi-agent testing, release checklist, safety table
├── skills/floorplan/
│   ├── SKILL.md                            # Trimmed under Antigravity's 24 KB body cap (21.2 KB)
│   ├── references/framework-notes.md       # Split out from SKILL.md for Firebase/Laravel/Shopify/Serverless
│   ├── scripts/
│   │   ├── lib/agent.mjs                   # Detects ANTIGRAVITY_AGENT / ANTIGRAVITY_CONVERSATION_ID
│   │   ├── build.mjs                       # Records agent without touching CLAUDE.local.md
│   │   └── open.mjs                        # --antigravity / --agy path override & label
│   └── assets/
│       ├── serve.mjs                       # ENGINES.antigravity (agy --sandbox --print + --conversation)
│       ├── page-safety.mjs                 # Allows antigravity:// and antigravity-ide:// schemes
│       ├── viewer.html, ui/50-cloud.js, 60-export.js  # Antigravity Ask badge, Fix/Build prompts, export hints
├── tools/checksums.mjs                     # Includes .antigravity-plugin in release checksums
└── tests/
    ├── fixtures/fake-cli/fake-agy.mjs      # Stand-in CLI fixture matching agy stream-json + --conversation
    └── 12 updated suites                   # agents, ask, blueprint*, editor-links, export, release, supply-chain, etc.

Design & Security Notes for Maintainers

  • Ask read-only boundary (agy CLI): agy runs with --sandbox --disable-slash-commands --output-format stream-json --json-schema <file> --print=..., which currently enforces read-only behavior via --sandbox plus prompt guardrails rather than strict CLI-level tool whitelisting (unlike claude -p or codex exec --sandbox read-only). Documented plainly in docs/antigravity.md and docs/is-it-safe.md per docs/development.md, with --engine claude / --engine codex available if a stricter boundary is needed. If you'd prefer agy Ask to stay opt-in or keep third-agent support in a downstream fork to avoid maintenance overhead in core, happy to go either way.
  • 24 KB skill body refactor: Antigravity's plugin loader caps SKILL.md bodies at 24,000 bytes. Moving the detailed framework-matching prose into skills/floorplan/references/framework-notes.md keeps SKILL.md at ~21.2 KB with zero functionality lost for Claude Code or Codex.
  • CHECKSUMS.txt left untouched: Kept CHECKSUMS.txt at upstream 0.11.0 (tools/checksums.mjs includes .antigravity-plugin for the next release bump, matching tests/supply-chain.test.mjs).

How I tested it

Tested end-to-end on a real multi-language local project (19 code files across Python, JavaScript, TypeScript, HTML, CSS, and SQL):

  • Full workflow: Ran scan.mjs, authored architecture.json and all descriptions (files 19/19, modules 9/9, 0% unassigned), recent.mjs, refresh.mjs, floorplan/query.mjs (overview, find), and floorplan/serve.mjs --export (standalone HTML verified with "root": null and floorplan/ git-ignored, zero tracked files touched).
  • Live agy CLI Ask & follow-ups: Verified POST /api/ask turn 1 + --conversation follow-up turn 2 against live agy (1.5.9 / 1.5.13) streaming progress events and structured JSON answers.
  • Browser UI: Verified rendered SVG ELK graph (0 console JS/CSP errors), #ask-engine displaying Antigravity (engine ok), Open in editor antigravity://file/... links, Health → Fix with Antigravity modal prompts, Recent work, and Flows.

Evidence

  • Test suite:
    • Before: Antigravity sessions fell back to generic/VS Code defaults with no .antigravity-plugin/plugin.json or agy engine.
    • After (node --test --test-concurrency=4): 491 passed, 0 failed (exit 0). (Note: under unconstrained Windows npm test parallelism, pre-existing tests/aspnet.test.mjs:456 exceeded its < 2000 ms CPU timing assertion at 2080 ms / 2354 ms, and passed 20/20 cleanly when run alone alongside release and supply-chain: 38 passed, 0 failed.)
  • Un-env agent/ask regression: Unsetting ANTIGRAVITY_AGENT and ANTIGRAVITY_CONVERSATION_ID and running node --test tests/agents.test.mjs tests/ask.test.mjs passed 16/16.
  • Plugin validators:
    • claude plugin validate . → Validation passed (exit 0)
    • claude plugin validate . --profile directory → Validation passed (exit 0)
    • agy plugin validate . --strict --json → 0 findings (skills: 1, exit 0)

Merge Danger

Door: Two-way (purely additive Antigravity support + extracting framework prose from SKILL.md into references/framework-notes.md; clean revert if undesired).

Blast Radius: Low — Claude Code and Codex code paths, --agent / --engine detection, CLAUDE.local.md handling, and CHECKSUMS.txt remain isolated and verified across existing regression suites.

Checklist

  • No new dependencies
  • Anything the map shows people is in plain language
  • No secret values stored or printed
  • No details of a real private project in code, comments, docs or screenshots
  • npm test passes (491/491 with node --test --test-concurrency=4; tests/aspnet.test.mjs:456 exceeded < 2000 ms under unconstrained Windows parallelism and passed 20/20 solo)
  • claude plugin validate . passes (plus --profile directory and agy plugin validate . --strict)
  • CHANGELOG.md updated, if people will notice the change

Add .antigravity-plugin manifest, Antigravity agent detection, native agy CLI Ask/Flow/Blueprint engine, antigravity:// and antigravity-ide:// editor links, framework-notes reference, changelog, docs, and tests.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant