antigravity-claude-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arjun Thilak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,136 @@
+# antigravity-claude-mcp
+
+> **Give Claude Code a second brain.** Ask Google Antigravity — Gemini 3 Pro, Claude, or GPT-OSS — for an independent code review or second opinion, right from inside Claude Code. One command. Zero dependencies.
+
+[![npm](https://img.shields.io/npm/v/antigravity-claude-mcp.svg)](https://www.npmjs.com/package/antigravity-claude-mcp)
+[![node](https://img.shields.io/node/v/antigravity-claude-mcp.svg)](https://nodejs.org)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+
+```bash
+claude mcp add antigravity -- npx -y antigravity-claude-mcp
+```
+
+That's it. Restart Claude Code, and Claude can now call **`ask_antigravity`** to get a second model's take on any plan or diff.
+
+---
+
+## Why
+
+Claude reviewing its own code is Claude reviewing its own code. You don't catch your own blind spots by thinking harder — you catch them with a **different mind**.
+
+This bridges [Claude Code](https://docs.anthropic.com/en/docs/claude-code) to [Google Antigravity's CLI](https://antigravity.google) (`agy`), so Claude can hand a plan or a diff to a **different model family** (Gemini 3 Pro by default) and get an independent verdict — *before* you do. Two models check the work; you make the call.
+
+It's the wiring behind a simple loop:
+
+```
+You ── prompt ──▶ Claude validates ──▶ asks Antigravity (Gemini) ──▶ they agree on ONE plan
+                                                                          │
+        you approve ◀── Antigravity reviews the diff ◀── Claude writes the code
+```
+
+See [`examples/CLAUDE_ANTIGRAVITY_LOOP.md`](./examples/CLAUDE_ANTIGRAVITY_LOOP.md) for the full working agreement you can drop into any project.
+
+---
+
+## Quickstart (2 minutes)
+
+**1. Install the Antigravity CLI** (if you don't have it) and sign in once:
+
+```bash
+curl -fsSL https://antigravity.google/cli/install.sh | bash
+~/.local/bin/agy -p "ping" --print-timeout 5m   # opens a Google login the first time
+```
+
+**2. Add the MCP server to Claude Code:**
+
+```bash
+claude mcp add antigravity -- npx -y antigravity-claude-mcp
+```
+
+**3. Check it's healthy** (optional):
+
+```bash
+npx antigravity-claude-mcp doctor
+```
+
+**4. Restart Claude Code**, run `/mcp` to approve the tool, and ask:
+
+> "Use ask_antigravity to review my changes in `src/auth.ts` for edge cases."
+
+---
+
+## How it works
+
+```
+┌────────────┐   MCP (stdio,    ┌─────────────────────────┐   agy -p     ┌──────────────────┐
+│ Claude Code│   JSON-RPC 2.0)  │ antigravity-claude-mcp   │  --model …   │ Antigravity CLI  │
+│  (Claude)  │ ───────────────▶ │  ask_antigravity tool    │ ───────────▶ │ Gemini 3 Pro /   │
+│            │ ◀─────────────── │  (this package)          │ ◀─────────── │ Claude / GPT-OSS │
+└────────────┘   tool result    └─────────────────────────┘   stdout     └──────────────────┘
+```
+
+The package is a tiny stdio MCP server that shells out to `agy -p` (Antigravity's headless print mode), optionally adding files/folders as context with `--add-dir`, and returns the model's text back to Claude.
+
+### The `ask_antigravity` tool
+
+| Param   | Type       | Required | Description |
+|---------|------------|----------|-------------|
+| `prompt`| string     | ✅        | The question, proposed approach, or review request. |
+| `paths` | string[]   |          | Absolute file/folder paths. Antigravity reads them **in full** as context. |
+| `model` | string     |          | Override the model (see below). Default: `Gemini 3.1 Pro (High)`. |
+
+---
+
+## Models
+
+Whatever your Antigravity account exposes via `agy models`, for example:
+
+- `Gemini 3.1 Pro (High)` ← **default** (strong, and a different family from Claude)
+- `Gemini 3.5 Flash (Low|Medium|High)` (fast/cheap)
+- `Claude Sonnet 4.6 (Thinking)`, `Claude Opus 4.6 (Thinking)`
+- `GPT-OSS 120B (Medium)`
+
+> **Why default to Gemini, not Claude?** The whole point is an *independent* reviewer. Using a Claude model to review Claude's work defeats the cross-check. Override per call with `model` if you want a specific one.
+
+---
+
+## Configuration
+
+Set as environment variables on the MCP server (e.g. via `claude mcp add ... -e KEY=VAL`):
+
+| Variable      | Default                 | Purpose |
+|---------------|-------------------------|---------|
+| `AGY_BIN`     | auto-detected           | Absolute path to the `agy` binary. |
+| `AGY_MODEL`   | `Gemini 3.1 Pro (High)` | Default model for every call. |
+| `AGY_TIMEOUT` | `5m`                    | Headless print timeout. |
+
+---
+
+## Troubleshooting
+
+**`agy` runs but prints "passed to Electron/Chromium" warnings.**
+You have the Antigravity **IDE** installed, and plain `agy` on your `PATH` is a symlink into `Antigravity.app` — that's the editor, not the CLI. This package auto-detects and skips it, preferring the real CLI at `~/.local/bin/agy`. If you call `agy` by hand, use the full path or set `AGY_BIN`.
+
+**"Authentication required."**
+Sign in once interactively: `~/.local/bin/agy -p "ping" --print-timeout 5m`, open the printed Google link, approve, and paste the code back into that prompt.
+
+**Tool doesn't appear in Claude Code.**
+Restart Claude Code after `claude mcp add`, then run `/mcp` and approve `ask_antigravity`. `claude mcp list` should show `antigravity ✔ Connected`.
+
+---
+
+## vs. a proxy
+
+Some projects route Claude Code's *own* traffic through Antigravity via an Anthropic-compatible proxy (i.e. Claude Code is "powered by" Antigravity). This is the opposite and complementary: Claude Code stays Claude, and Antigravity becomes a **tool Claude can consult** — so you get two genuinely different models in one loop instead of swapping one out for the other.
+
+---
+
+## Requirements
+
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI
+- [Antigravity CLI](https://antigravity.google) (`agy`), signed in
+- Node.js ≥ 18
+
+## License
+
+MIT © Arjun Thilak

package/bin/cli.mjs

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+// antigravity-claude-mcp CLI
+// --------------------------
+// No args (how MCP clients launch it): run the MCP server on stdio.
+// `install`   : register this server with Claude Code (claude mcp add).
+// `uninstall` : remove it from Claude Code.
+// `doctor`    : check that the Antigravity CLI is found and authenticated.
+
+import { spawnSync } from 'node:child_process';
+import { startServer, detectAgy } from '../src/server.mjs';
+
+const [, , cmd] = process.argv;
+
+function run(command, args) {
+  return spawnSync(command, args, { stdio: 'inherit', encoding: 'utf8' });
+}
+
+if (!cmd) {
+  // Launched by an MCP client over stdio — be a server, print nothing else.
+  startServer();
+} else if (cmd === 'install') {
+  // npx-based registration: Claude Code will re-launch us via npx on demand.
+  const r = run('claude', ['mcp', 'add', 'antigravity', '-s', 'user', '--', 'npx', '-y', 'antigravity-claude-mcp']);
+  if (r.status === 0) {
+    console.log('\n✅ Registered "antigravity" with Claude Code (user scope).');
+    console.log('   Restart Claude Code, then run /mcp to approve the ask_antigravity tool.');
+  } else {
+    console.error('\n❌ Could not run `claude mcp add`. Is the Claude Code CLI installed and on PATH?');
+    process.exit(1);
+  }
+} else if (cmd === 'uninstall') {
+  run('claude', ['mcp', 'remove', 'antigravity', '-s', 'user']);
+} else if (cmd === 'doctor') {
+  const agy = detectAgy();
+  if (!agy) {
+    console.error('❌ Antigravity CLI (agy) not found.');
+    console.error('   Install:  curl -fsSL https://antigravity.google/cli/install.sh | bash');
+    process.exit(1);
+  }
+  console.log(`✓ Found agy: ${agy}`);
+  console.log('… testing headless auth (this calls the model, may take ~30s)');
+  const r = spawnSync(agy, ['-p', 'Reply with exactly one word: PONG', '--print-timeout', '90s'], { encoding: 'utf8' });
+  const out = (r.stdout || '').trim();
+  if (out.includes('PONG')) {
+    console.log('✅ Authenticated and responding. You are good to go.');
+  } else {
+    console.error('⚠️  agy did not return a clean response. Sign in once with:');
+    console.error(`     ${agy} -p "ping" --print-timeout 5m`);
+    console.error('   then follow the Google login link it prints.');
+    if (out) console.error('   --- agy output ---\n' + out);
+    process.exit(1);
+  }
+} else {
+  console.error(`Unknown command: ${cmd}`);
+  console.error('Usage: antigravity-claude-mcp [install|uninstall|doctor]');
+  process.exit(1);
+}

package/examples/.mcp.json

@@ -0,0 +1,13 @@
+{
+  "$comment": "Drop this into a project's .mcp.json to share the antigravity server with your team. Or just run: claude mcp add antigravity -- npx -y antigravity-claude-mcp",
+  "mcpServers": {
+    "antigravity": {
+      "command": "npx",
+      "args": ["-y", "antigravity-claude-mcp"],
+      "env": {
+        "AGY_MODEL": "Gemini 3.1 Pro (High)",
+        "AGY_TIMEOUT": "5m"
+      }
+    }
+  }
+}

package/examples/CLAUDE_ANTIGRAVITY_LOOP.md

@@ -0,0 +1,67 @@
+# Claude + Antigravity Collaborative Loop
+
+A drop-in working agreement: paste this into your project (or your `CLAUDE.md`)
+so every task is reviewed by **two independent models** *and* you before it's
+considered done.
+
+The second model is **Antigravity**, reached through the `ask_antigravity` MCP
+tool (this package). It defaults to **Gemini 3.1 Pro (High)** — deliberately a
+**different model family from Claude**, so the review is a real cross-check, not
+Claude checking Claude.
+
+---
+
+## The Loop
+
+```
+ 1. USER PROMPT
+        │
+        ▼
+ 2. CLAUDE VALIDATES PROMPT
+    - Restate the goal, list assumptions, flag missing info.
+    - If unclear → ask the user before going further.
+        │
+        ▼
+ 3. ASK ANTIGRAVITY  (ask_antigravity)
+    - Send the validated prompt + Claude's proposed approach.
+    - Pass the relevant file(s)/folder via `paths` for full context.
+    - Antigravity replies with its own approach, risks, alternatives.
+        │
+        ▼
+ 4. DISCUSS → DECIDE
+    - Compare the two approaches. Resolve disagreements with reasons.
+    - Agree on ONE plan. Write it down before any code.
+        │
+        ▼
+ 5. CLAUDE WRITES THE CODE
+        │
+        ▼
+ 6. ANTIGRAVITY REVIEWS  (ask_antigravity, passing the changed paths)
+    - Correctness, edge cases, bugs, style.
+    - Claude fixes findings or pushes back with a reason. Repeat 5–6 until clean.
+        │
+        ▼
+ 7. USER CHECKS (the gate)
+    - Approve → DONE ✅   |   Request changes → loop from step 2/4.
+```
+
+---
+
+## Rules
+
+- **Two-model rule:** nothing is "done" until both Claude agreed it *and* Antigravity validated it.
+- **Different families:** keep the reviewer non-Claude (Gemini by default) — independence is the point.
+- **Full context, not snippets:** always pass the whole relevant file/folder via `paths`.
+- **No silent guesses:** if the prompt is unclear, ask.
+- **Reasons over opinions:** every decision in the discuss step has a stated reason.
+- **User is the final gate.**
+
+---
+
+## Roles
+
+| Actor       | Job |
+|-------------|-----|
+| User        | Gives the prompt, checks output, approves or requests changes. |
+| Claude      | Validates, proposes, discusses, writes code, applies fixes. |
+| Antigravity | Independent approach (Gemini 3 Pro), then reviews Claude's code. |

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "antigravity-claude-mcp",
+  "version": "0.1.0",
+  "description": "Use Google Antigravity (Gemini 3 Pro, Claude, GPT-OSS) as an independent second-opinion / code-review model inside Claude Code — via MCP, one command, zero dependencies.",
+  "type": "module",
+  "bin": {
+    "antigravity-claude-mcp": "bin/cli.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "start": "node bin/cli.mjs",
+    "test": "node test/smoke.mjs"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "claude-code",
+    "antigravity",
+    "gemini",
+    "agy",
+    "code-review",
+    "second-opinion",
+    "ai",
+    "agent",
+    "llm"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arjunthilak05/antigravity-claude-mcp.git"
+  },
+  "homepage": "https://github.com/arjunthilak05/antigravity-claude-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/arjunthilak05/antigravity-claude-mcp/issues"
+  },
+  "license": "MIT",
+  "author": "Arjun Thilak"
+}

package/src/server.mjs

@@ -0,0 +1,150 @@
+// antigravity-claude-mcp — MCP server
+// ------------------------------------
+// Exposes Google Antigravity's CLI (`agy`) to Claude Code (and any MCP client)
+// as a single tool, `ask_antigravity`, so Claude can get an INDEPENDENT second
+// opinion or code review from a different model family (default: Gemini 3 Pro).
+//
+// Zero runtime dependencies. Speaks MCP over newline-delimited JSON-RPC 2.0 on stdio.
+//
+// Environment overrides (all optional):
+//   AGY_BIN      absolute path to the agy binary (otherwise auto-detected)
+//   AGY_MODEL    model name as shown by `agy models`  (default: Gemini 3.1 Pro (High))
+//   AGY_TIMEOUT  agy print-mode timeout               (default: 5m)
+
+import { spawn } from 'node:child_process';
+import { statSync, realpathSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import readline from 'node:readline';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
+
+const DEFAULT_MODEL = process.env.AGY_MODEL || 'Gemini 3.1 Pro (High)';
+const PRINT_TIMEOUT = process.env.AGY_TIMEOUT || '5m';
+
+// ---------------------------------------------------------------------------
+// Locate the REAL Antigravity CLI. Note: on machines with the Antigravity IDE
+// installed, plain `agy` on PATH is often a symlink into Antigravity.app (the
+// Electron editor), which is NOT the CLI. We skip those and prefer the binary
+// the official installer drops at ~/.local/bin/agy.
+// ---------------------------------------------------------------------------
+export function detectAgy() {
+  if (process.env.AGY_BIN) return process.env.AGY_BIN;
+  const home = process.env.HOME || process.env.USERPROFILE || '';
+  const candidates = [];
+  if (home) candidates.push(join(home, '.local', 'bin', 'agy'));
+  for (const dir of (process.env.PATH || '').split(':')) {
+    if (dir) candidates.push(join(dir, 'agy'));
+  }
+  for (const c of candidates) {
+    try {
+      statSync(c); // must exist & be accessible
+      let real = c;
+      try { real = realpathSync(c); } catch { /* keep c */ }
+      if (real.includes('Antigravity.app')) continue; // that's the IDE, not the CLI
+      return c;
+    } catch { /* not here, keep looking */ }
+  }
+  return null;
+}
+
+const AGY = detectAgy();
+
+function send(msg) { process.stdout.write(JSON.stringify(msg) + '\n'); }
+function ok(id, result) { send({ jsonrpc: '2.0', id, result }); }
+function fail(id, code, message) { send({ jsonrpc: '2.0', id, error: { code, message } }); }
+
+const TOOLS = [
+  {
+    name: 'ask_antigravity',
+    description:
+      'Get an INDEPENDENT second opinion or code review from Google Antigravity ' +
+      '(default model: Gemini 3.1 Pro High) — a different model family than Claude, ' +
+      'so it is a real cross-check, not Claude reviewing Claude. Provide a `prompt`; ' +
+      'optionally pass `paths` (absolute file or folder paths) and Antigravity will read ' +
+      'the ENTIRE file/folder as context before answering. Use it to validate an approach ' +
+      'before coding, get an alternative design, or review code for bugs / edge cases / style.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        prompt: { type: 'string', description: 'The question, proposed approach, or code-review request.' },
+        paths: { type: 'array', items: { type: 'string' }, description: 'Optional absolute paths to files or folders to give Antigravity as full context.' },
+        model: { type: 'string', description: 'Optional model override (e.g. "Claude Opus 4.6 (Thinking)", "GPT-OSS 120B (Medium)"). Default: Gemini 3.1 Pro (High).' },
+      },
+      required: ['prompt'],
+    },
+  },
+];
+
+function runAgy({ prompt, paths = [], model }) {
+  return new Promise((resolve) => {
+    if (!AGY) {
+      return resolve({
+        success: false,
+        text:
+          'Antigravity CLI (`agy`) not found. Install it with:\n' +
+          '  curl -fsSL https://antigravity.google/cli/install.sh | bash\n' +
+          'then sign in once with:  ~/.local/bin/agy -p "ping" --print-timeout 5m\n' +
+          '(or set AGY_BIN to its absolute path).',
+      });
+    }
+    const dirs = new Set();
+    for (const p of paths) {
+      try { dirs.add(statSync(p).isDirectory() ? p : dirname(p)); } catch { /* unreadable: skip */ }
+    }
+    const fullPrompt = paths.length
+      ? `Context files/folders to read and consider in full:\n${paths.map((p) => `- ${p}`).join('\n')}\n\n${prompt}`
+      : prompt;
+
+    const args = ['-p', fullPrompt, '--model', model || DEFAULT_MODEL, '--print-timeout', PRINT_TIMEOUT, '--dangerously-skip-permissions'];
+    for (const d of dirs) args.push('--add-dir', d);
+
+    const child = spawn(AGY, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+    let out = '', err = '';
+    child.stdout.on('data', (d) => { out += d; });
+    child.stderr.on('data', (d) => { err += d; });
+    child.on('error', (e) => resolve({ success: false, text: `Failed to launch agy (${AGY}): ${e.message}` }));
+    child.on('close', (code) => {
+      const text = out.trim() || err.trim() || `(agy produced no output; exit code ${code})`;
+      resolve({ success: code === 0, text });
+    });
+  });
+}
+
+export function startServer() {
+  const rl = readline.createInterface({ input: process.stdin });
+  rl.on('line', async (line) => {
+    line = line.trim();
+    if (!line) return;
+    let msg;
+    try { msg = JSON.parse(line); } catch { return; }
+    const { id, method, params } = msg;
+
+    // Notifications carry no id and expect no reply.
+    if (method === 'notifications/initialized' || method === 'initialized') return;
+
+    switch (method) {
+      case 'initialize':
+        return ok(id, {
+          protocolVersion: params?.protocolVersion || '2025-06-18',
+          capabilities: { tools: {} },
+          serverInfo: { name: 'antigravity', version: pkg.version },
+        });
+      case 'ping':
+        return ok(id, {});
+      case 'tools/list':
+        return ok(id, { tools: TOOLS });
+      case 'tools/call': {
+        const name = params?.name;
+        const args = params?.arguments || {};
+        if (name !== 'ask_antigravity') return fail(id, -32602, `Unknown tool: ${name}`);
+        if (!args.prompt) return fail(id, -32602, 'Missing required argument: prompt');
+        const { success, text } = await runAgy(args);
+        return ok(id, { content: [{ type: 'text', text }], isError: !success });
+      }
+      default:
+        if (id !== undefined) fail(id, -32601, `Method not found: ${method}`);
+    }
+  });
+}