yuting0624/antigravity-for-claude-code

What it solves

This project enables a hybrid AI workflow where Claude Code acts as a high-level "conductor" for judgment and verification, while the Antigravity CLI (powered by Gemini) acts as an "executor" for token-heavy, repetitive, or bulk tasks. This solves the problem of high costs and context window saturation when using frontier models for scaffolding, large-scale reading, and implementation, while maintaining the quality of a top-tier model for final review.

How it works

It functions as a plugin for Claude Code that routes specific tasks to the Antigravity CLI (agy). Claude directs the work, and Gemini executes it. The system uses a "cost-aware" routing policy to determine when to delegate. Key mechanisms include:

• Digest-only replies: Instead of returning full raw output, Gemini provides a timestamped digest to keep Claude's context lean.
• Cross-model verification: Claude reviews the output produced by Gemini to ensure accuracy.
• Sub-agent fan-out: Gemini can spawn its own cheaper sub-agents to handle complex tasks, with trajectories auditable via agy-trace.
• Session hooks: A SessionStart hook automatically injects routing policies into the session.

Who it’s for

• Developers using Claude Code who want to reduce API costs without sacrificing quality.
• Teams needing to integrate Google/web search or Vertex AI Search into their coding workflow.
• Users who need to process large multimodal files (audio/video) without setting up local transcription stacks.

Highlights

• Cost Efficiency: Reduces frontier model costs (up to 64% in some tests) by offloading bulk work to cheaper models.
• Multimodal Capabilities: Native audio and video perception via Gemini, providing digests without filling Claude's context.
• Integrated Tooling: Adds live web search, Vertex AI Search, and Cloud Run debugging to Claude Code.
• Migration Tools: Includes /antigravity:migrate to move existing Claude Code configurations (skills, MCP servers, memory) to Antigravity.
• Background Execution: Supports firing long-running delegations as background jobs to be collected later.