supergravity-mcp 0.1.1 → 0.1.3

package/README.md

@@ -1,5 +1,7 @@
 # supergravity-mcp
 
+![supergravity](https://raw.githubusercontent.com/presidentrice/supergravity-mcp/main/assets/hero.jpg)
+
 An MCP server that lets Claude Code (or any MCP client) delegate tasks to the
 **Google Antigravity** desktop app — by driving its real, already-logged-in UI.
 No reverse engineering, no extracted credentials, no unofficial API calls.
@@ -27,19 +29,36 @@ same way a human would use it, so it works anywhere the app itself works.
 
 ## Setup
 
-```bash
-npm install
-npm run build
-```
-
 Antigravity must be installed and already signed in. By default the tool
 looks for it at `/Applications/Antigravity.app` or `~/Desktop/Antigravity.app`;
 set `ANTIGRAVITY_APP_PATH` if it lives somewhere else.
 
-Register it with Claude Code:
+### Easiest: install the plugin (MCP server + skill together)
+
+```bash
+claude plugin marketplace add presidentrice/supergravity-mcp
+claude plugin install supergravity@supergravity-mcp
+```
+
+This gets you both the `delegate_to_antigravity` / `get_antigravity_quota`
+tools and the `supergravity:delegate` skill, which teaches Claude how to
+route natural requests ("use gemini", "ask antigravity", "check antigravity's
+quota") to the right tool call and model.
+
+### Or: just the MCP server, no skill
 
 ```bash
-claude mcp add supergravity -- node /absolute/path/to/dist/mcp-server.js
+claude mcp add supergravity -- npx -y supergravity-mcp
+```
+
+Works fine without the skill — Claude still has the tools, just less
+built-in guidance on picking a model or handling a quota-exhausted error.
+
+### Building from source
+
+```bash
+npm install
+npm run build
 ```
 
 ## The tools

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "supergravity-mcp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "🚀 MCP server that lets Claude (or any MCP client) delegate tasks to Google's Antigravity desktop app 🌌. Built for Intel Macs 💻 that Antigravity's own CLI doesn't support.",
   "type": "module",
   "bin": {
     "supergravity-mcp": "dist/mcp-server.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "skills"
   ],
   "scripts": {
     "build": "tsc",

package/skills/delegate/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: delegate
+description: Use when the user wants to delegate a task to Google's Antigravity desktop app — phrases like "use gemini", "ask antigravity", "have claude in antigravity do this", "offload this", or "check antigravity's quota". Explains which model to pick and how to handle a disabled-send-button error. Requires the supergravity MCP server (delegate_to_antigravity, get_antigravity_quota tools) to be connected.
+---
+
+# delegate
+
+Antigravity is a separate AI desktop app (Google's). This skill runs tasks
+through it via the `supergravity-mcp` MCP server, instead of answering
+yourself — useful when the user explicitly asks to use it, wants a second
+opinion from a different model family, or wants to offload work.
+
+## When to trigger
+
+Any explicit ask to use Antigravity or one of the models it hosts:
+"use gemini", "ask antigravity", "get claude opus to do this",
+"offload this to gpt-oss", "check antigravity's quota". Don't trigger on
+generic requests that don't name Antigravity or one of its models — just
+answer normally.
+
+## Picking a model
+
+If the user names a specific model ("use claude opus", "use gemini flash"),
+match it to the closest entry in `delegate_to_antigravity`'s `model` enum.
+If they just say "use gemini" or "use antigravity" with no specifics, default
+to `Gemini 3.1 Pro (High)` — solid all-around reasoning, and Gemini models
+are the reliable pool (see below).
+
+The tool's own schema carries a cost/strength cheat sheet per model
+(`MODEL_GUIDE`) — read it before picking if the task has a clear profile
+(cheap/fast vs. deep reasoning vs. coding-heavy).
+
+## Quota pools matter
+
+Antigravity draws from two separate pools: Gemini models, and Claude+GPT
+models. One pool being exhausted doesn't affect the other. If a call fails
+with `send button is disabled`, that pool is out of quota (or overloaded)
+until it refreshes — don't retry the same model. Instead:
+
+1. Call `get_antigravity_quota` to see which pool has room and how long until
+   the exhausted one refreshes.
+2. If the user's request doesn't require a specific model, retry with a
+   Gemini model instead (Gemini has consistently been the reliable default).
+3. Otherwise, tell the user which pool is out and when it refreshes — don't
+   silently fall back without saying so if they asked for a specific model.
+
+## Other failure modes
+
+- Antigravity not installed / not found: the error will say so — tell the
+  user to check `ANTIGRAVITY_APP_PATH` if it's installed somewhere unusual.
+- Timeout waiting for a reply: the task may just be a large one — retry once
+  with a longer `timeoutMs` before concluding something's wrong.