INK-Q/agy-fast
Developer ToolsAn MCP plugin that batches tool calls and injects a startup snapshot to cut Antigravity's LLM turns, token use and latency.
What agy-fast Does
agy-fast is a plugin for Google Antigravity (CLI, Desktop 2.0 and IDE) built on the standard plugin interfaces: a local Stdio MCP server, one SessionStart hook, and routing rules. It does not patch the client. The goal is to reduce wall-clock time in coding sessions by cutting the number of LLM round trips and keeping tool output compact.
The project's analysis of 55 sessions found that per-turn time to first token dominated latency, that many tool calls were repeated same-file edits or shell-based searches, and that session start was spent exploring the repo. agy-fast responds with four composite MCP tools and a small startup snapshot.
Core Components
batch_searchruns up to 20 text, regex, glob and read-only git queries per call, using ripgrep when available and falling back to Node.js.apply_editsapplies multiple non-contiguous edits atomically, preserving CRLF and permissions, with optionaldryRunand inlineverify.read_slicesreturns symbol outlines and exact line ranges across many files under a byte budget.run_checksruns build, typecheck, lint and test commands concurrently with per-command timeouts and compact summaries.- The
SessionStarthook injects a ≤1.5 KB snapshot of git state, a two-level tree and detected scripts.
Quick Start
Requires Node.js 20 or newer. Pre-built zero-dependency bundles ship in the repo, so no npm install is needed. ripgrep is optional and improves search speed.
- Install into the global plugins directory with the one-command script for macOS/Linux or Windows PowerShell, or clone and run
node scripts/install.mjs install. - If Antigravity CLI is installed, the installer validates the manifest, enables the plugin and runs a live MCP and hook health check.
- In Desktop/IDE, open Customizations → Installed, confirm
agy-fastis enabled, then start a new session so theSessionStarthook and MCP tools take effect. - Run
./install.sh doctor(or theinstall.mjs doctorscript) to verify the MCP handshake and startup latency;uninstallremoves the global install.
A per-repository install is also supported with --project /path/to/repo, writing to <repo>/.agents/plugins/agy-fast.
Measuring Results
The bundled offline benchmark reads local Antigravity transcript.jsonl files without sending data off the machine:
node dist/benchmark.mjs analyze --local --split-usage
node dist/benchmark.mjs compare --before ./run-before/transcript.jsonl --after ./run-after/transcript.jsonl
The project reports savings across 10 days of sanitized transcripts: about 33.7% fewer LLM turns per 10 actions, 31.5% lower estimated billable quota, and 39.7% less tool-return upload. These are the authors' measurements on their own transcripts; your results depend on the kind of work you do.
Constraints
- Only Antigravity CLI (
agy), Desktop 2.0 and IDE on macOS, Linux and Windows are supported; Node.js 20+ is required. - The plugin relies on documented Antigravity extension interfaces and does not touch the diff viewer, modified-files list, checkpoints or safety checks. It registers no per-step hooks and fails open on
SessionStart. - Saved quota estimates use a stated token weighting (1.0× uncached input, 0.1× cache read, 5.0× output); actual billing depends on Antigravity's own accounting.
- The background auto-updater checks GitHub every 12 hours, stages new releases and runs an MCP smoke test before replacing files;
notifyandoffmodes and environment overrides are available. Manual updates can pin thereleaseormainchannel. - Development requires
npm installand uses strict TypeScript, esbuild and the project's test suite. The license is MIT.
HotRepo's take
agy-fast appeared on HotRepo's new-project list on 2026-11-20, gaining 20 stars and 2 forks in a roughly 1.5-hour measurement window and reaching 122 stars. That is a short, fresh record, not a long ranking history: the repository has no recorded rank on the all-language daily list. The interesting part is not the star count but the reproducible detail—a sanitized analysis report, shipped benchmark CLI and a plugin built only on Antigravity's documented extension points. Anyone evaluating it should start with the local analyze --local --split-usage command rather than the headline percentages.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- QwenLM/qwen-codeA terminal AI coding agent that can read, edit, run and review code, with editor, desktop, web and chat interfaces.
- sksarvesh007/antiglaudeLocal gateway that translates Anthropic and OpenAI API calls to Google Gemini and Cloud Code backends.
- rtk-ai/rtkA Rust CLI proxy that compresses command output before AI coding agents read it, cutting token use on common dev commands.
- ATtacK030130/antigrative-dashboardA local widget for Antigravity that shows token throughput, cache hits, context usage and quota windows next to the model selector.
- samber/cc-skills-golangGo-specific agent skills that keep coding assistants aligned with idiomatic conventions, testing and debugging practice.