explaingit

presidentrice/supergravity-mcp

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A small server that lets Claude Code or other MCP clients control Google's Antigravity desktop app through its real interface, useful on Intel Macs that cannot run Antigravity's own command line tool.

Mindmap

mindmap
  root((repo))
    What it does
      Delegates tasks to Antigravity
      Drives real app UI
      Reads back replies
    Tech stack
      TypeScript
      MCP server
      Chrome remote debugging
    Use cases
      Run tasks on Intel Macs
      Batch concurrent tasks
      Check usage quota
    Audience
      Claude Code users
      Mac users without agy CLI

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Delegate a coding or writing task to Google's Antigravity app from inside Claude Code without leaving your terminal

USE CASE 2

Run several independent tasks in separate Antigravity windows at the same time instead of waiting for each one

USE CASE 3

Check remaining Antigravity usage quota before starting a big task

USE CASE 4

Find files Antigravity generated in past conversations without hunting through the app

What is it built with?

TypeScriptNode.jsElectronMCP

How does it compare?

presidentrice/supergravity-mcp0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity3/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Antigravity already installed and signed in, plus a macOS Accessibility permission for the batch tool.

You can use, modify, and distribute this software freely, including for commercial purposes, as long as you keep the copyright notice.

In plain English

supergravity-mcp is a small server that lets Claude Code, or any other MCP client, hand off tasks to Google's Antigravity desktop app by controlling its actual interface, the same way a person would click through it. It does not read Antigravity's stored login information, call any hidden programming interface, or take apart the app's code. Instead it relaunches Antigravity with a special Chrome debugging flag, the same technique browser testing tools use to control other Electron based apps, then connects to that debug port to type a task into the chat box, click send, and read back the finished reply. The project exists to help people whose computers can run the Antigravity app but cannot run its official command line tool, which does not work on older Intel based Macs. The author confirms it works on a 2015 MacBook Pro running an older version of macOS. Once installed, either as a combined plugin with its own skill or as a plain MCP server, it offers a few tools. One sends a single task to Antigravity and returns the reply, optionally letting you pick which underlying model to use and how long to wait. Another can run several separate tasks at the same time, each in its own Antigravity window, opening new windows automatically as needed, though this needs a special macOS permission and only works reliably with one window running at a time otherwise. A third tool lists every file Antigravity has generated across all past sessions, and a fourth checks how much of your usage quota remains, since Google models and Claude or GPT models draw from separate limits. Because this project only automates the same interface a human already uses, it avoids the legal risk of reverse engineering. The tradeoff is that if Google changes how the app looks or behaves, parts of this tool may need updating to match. It currently assumes only one Antigravity window is open when running a single task. The project is released under the MIT license.

Copy-paste prompts

Prompt 1
Use supergravity to draft a short blog post about our new feature with Antigravity's Gemini model
Prompt 2
Ask supergravity what my remaining Antigravity quota is before I delegate a big task
Prompt 3
Delegate this refactor to Antigravity using Claude Sonnet 4.6 and show me the result
Prompt 4
List every file Antigravity has generated so far in this project

Frequently asked questions

What is supergravity-mcp?

A small server that lets Claude Code or other MCP clients control Google's Antigravity desktop app through its real interface, useful on Intel Macs that cannot run Antigravity's own command line tool.

What language is supergravity-mcp written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Electron.

What license does supergravity-mcp use?

You can use, modify, and distribute this software freely, including for commercial purposes, as long as you keep the copyright notice.

How hard is supergravity-mcp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is supergravity-mcp for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.