supergravity-mcp 0.1.0 → 0.1.2

package/README.md

@@ -39,7 +39,21 @@ set `ANTIGRAVITY_APP_PATH` if it lives somewhere else.
 Register it with Claude Code:
 
 ```bash
-claude mcp add supergravity -- node /absolute/path/to/dist/mcp-server.js
+claude mcp add supergravity -- npx -y supergravity-mcp
+```
+
+### Optional: the skill
+
+`skills/supergravity/SKILL.md` teaches Claude how to route natural requests
+("use gemini", "ask antigravity", "check antigravity's quota") to the right
+tool call and model — without it, Claude still has the tools, just less
+guidance on picking a model or handling a quota-exhausted error. Install it
+globally so it applies everywhere:
+
+```bash
+mkdir -p ~/.claude/skills/supergravity
+curl -o ~/.claude/skills/supergravity/SKILL.md \
+  https://raw.githubusercontent.com/presidentrice/supergravity-mcp/main/skills/supergravity/SKILL.md
 ```
 
 ## The tools

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "supergravity-mcp",
-  "version": "0.1.0",
-  "description": "MCP server that lets Claude (or any MCP client) delegate tasks to the Google Antigravity desktop app by driving its real UI — no CLI, no reverse engineering. Built for Intel Macs Antigravity's own CLI doesn't support.",
+  "version": "0.1.2",
+  "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/supergravity/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: supergravity
+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 MCP server (delegate_to_antigravity, get_antigravity_quota tools) to be connected.
+---
+
+# supergravity
+
+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.