Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

INK-Q/agy-fast

Developer Tools

An MCP plugin that batches tool calls and injects a startup snapshot to cut Antigravity's LLM turns, token use and latency.

141
12
TypeScript
MIT
1 day old

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_search runs up to 20 text, regex, glob and read-only git queries per call, using ripgrep when available and falling back to Node.js.
  • apply_edits applies multiple non-contiguous edits atomically, preserving CRLF and permissions, with optional dryRun and inline verify.
  • read_slices returns symbol outlines and exact line ranges across many files under a byte budget.
  • run_checks runs build, typecheck, lint and test commands concurrently with per-command timeouts and compact summaries.
  • The SessionStart hook 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.

  1. 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.
  2. If Antigravity CLI is installed, the installer validates the manifest, enables the plugin and runs a live MCP and hook health check.
  3. In Desktop/IDE, open Customizations → Installed, confirm agy-fast is enabled, then start a new session so the SessionStart hook and MCP tools take effect.
  4. Run ./install.sh doctor (or the install.mjs doctor script) to verify the MCP handshake and startup latency; uninstall removes 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; notify and off modes and environment overrides are available. Manual updates can pin the release or main channel.
  • Development requires npm install and 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

  1. QwenLM/qwen-codeA terminal AI coding agent that can read, edit, run and review code, with editor, desktop, web and chat interfaces.TypeScript28,828
  2. sksarvesh007/antiglaudeLocal gateway that translates Anthropic and OpenAI API calls to Google Gemini and Cloud Code backends.Python105
  3. rtk-ai/rtkA Rust CLI proxy that compresses command output before AI coding agents read it, cutting token use on common dev commands.Rust86,426
  4. ATtacK030130/antigrative-dashboardA local widget for Antigravity that shows token throughput, cache hits, context usage and quota windows next to the model selector.JavaScript106
  5. samber/cc-skills-golangGo-specific agent skills that keep coding assistants aligned with idiomatic conventions, testing and debugging practice.Go3,688