@brain-mcps/setup 0.1.0 → 0.2.1

package/README.md

@@ -2,13 +2,13 @@
 
 Configure AI assistant clients to connect to [Brain4AI](https://brain4ai.app) (Cerebro Externo) and [Mentor4AI](https://mentor4ai.app) (Forge Mentor) MCP servers.
 
-One command writes the correct config entry for any supported client, handling format differences (Gemini's `httpUrl`, Windsurf's `serverUrl`, Copilot's nested `mcp.servers` path, etc.).
+One command writes the correct config entry for any supported client, handling format differences (Antigravity's / Windsurf's `serverUrl`, Copilot's nested `mcp.servers` path, etc.).
 
 ## Quick Start
 
 ```bash
-npx @brain-mcps/setup gemini              # Configure Gemini CLI for Cerebro Externo
-npx @brain-mcps/setup gemini mentor       # Configure Gemini CLI for Forge Mentor
+npx @brain-mcps/setup antigravity         # Configure Antigravity (CLI + Desktop) for Cerebro Externo
+npx @brain-mcps/setup antigravity mentor  # Configure Antigravity (CLI + Desktop) for Forge Mentor
 npx @brain-mcps/setup --detect            # Auto-detect and configure all installed clients
 ```
 
@@ -16,15 +16,18 @@ After running, open the configured client. It will prompt you to authenticate vi
 
 ## Supported Clients
 
-| Client         | Config Format             | Key Used                           |
-| -------------- | ------------------------- | ---------------------------------- |
-| Claude Code    | `~/.claude/settings.json` | `url`                              |
-| Claude Desktop | OS-specific config        | `url`                              |
-| Gemini CLI     | `~/.gemini/settings.json` | `httpUrl`                          |
-| Codex          | `~/.codex/config.toml`    | `url` (TOML)                       |
-| Cursor         | `~/.cursor/mcp.json`      | `url`                              |
-| Windsurf       | `~/.windsurf/mcp.json`    | `serverUrl`                        |
-| GitHub Copilot | `~/.vscode/mcp.json`      | `url` (nested under `mcp.servers`) |
+| Client                      | Config Format                      | Key Used                           |
+| --------------------------- | ---------------------------------- | ---------------------------------- |
+| Claude Code                 | `~/.claude/settings.json`          | `url`                              |
+| Claude Desktop              | OS-specific config                 | `url`                              |
+| Antigravity (CLI + Desktop) | `~/.gemini/config/mcp_config.json` | `serverUrl`                        |
+| Codex                       | `~/.codex/config.toml`             | `url` (TOML)                       |
+| Cursor                      | `~/.cursor/mcp.json`               | `url`                              |
+| Windsurf                    | `~/.windsurf/mcp.json`             | `serverUrl`                        |
+| GitHub Copilot              | `~/.vscode/mcp.json`               | `url` (nested under `mcp.servers`) |
+
+> **Antigravity CLI (`agy`) and the Antigravity Desktop/IDE share one central MCP
+> config file**, so a single `antigravity` entry configures both.
 
 ## Usage
 
@@ -36,7 +39,7 @@ npx @brain-mcps/setup <client> [product]
 npx @brain-mcps/setup --detect [product]
 
 # Preview changes without writing files
-npx @brain-mcps/setup gemini --dry-run
+npx @brain-mcps/setup antigravity --dry-run
 
 # List all supported clients and their config paths
 npx @brain-mcps/setup --list
@@ -51,7 +54,7 @@ npx @brain-mcps/setup --list
 
 Use any of these as the `<client>` argument:
 
-`claude-code`, `claude-desktop`, `gemini`, `codex`, `cursor`, `windsurf`, `copilot`
+`claude-code`, `claude-desktop`, `antigravity`, `codex`, `cursor`, `windsurf`, `copilot`
 
 ## How It Works
 

package/dist/cli.js

@@ -27,8 +27,8 @@ Options:
   --help      Show this help message
 
 Examples:
-  npx @brain-mcps/setup gemini              # Configure Gemini CLI for Cerebro Externo
-  npx @brain-mcps/setup gemini mentor       # Configure Gemini CLI for Forge Mentor
+  npx @brain-mcps/setup antigravity         # Configure Antigravity (CLI + Desktop) for Cerebro Externo
+  npx @brain-mcps/setup antigravity mentor  # Configure Antigravity (CLI + Desktop) for Forge Mentor
   npx @brain-mcps/setup claude-code brain   # Configure Claude Code for Cerebro Externo
   npx @brain-mcps/setup --detect            # Configure all detected clients
   npx @brain-mcps/setup --list              # Show supported clients

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export type Product = "brain" | "mentor";
-export type ClientId = "claude-code" | "claude-desktop" | "gemini" | "codex" | "cursor" | "windsurf" | "copilot";
+export type ClientId = "claude-code" | "claude-desktop" | "antigravity" | "codex" | "cursor" | "windsurf" | "copilot";
 export type ConfigFormat = "json" | "toml";
 export interface ClientDef {
     id: ClientId;

package/dist/index.js

@@ -78,12 +78,15 @@ exports.CLIENT_DEFS = {
         buildEntry: (url) => ({ url }),
         supportedPlatforms: CLAUDE_DESKTOP_PLATFORMS,
     },
-    gemini: {
-        id: "gemini",
-        name: "Gemini CLI",
-        configPathTemplate: "~/.gemini/settings.json",
+    antigravity: {
+        id: "antigravity",
+        name: "Antigravity (CLI + Desktop)",
+        // Antigravity CLI (`agy`) and the Antigravity IDE/Desktop share one central
+        // MCP config file. Confirmed against agy v1.1.2 binary strings.
+        configPathTemplate: "~/.gemini/config/mcp_config.json",
         serversKey: ["mcpServers"],
-        buildEntry: (url) => ({ httpUrl: url }),
+        // Remote HTTP servers use `serverUrl` (same key Windsurf uses), not `url`.
+        buildEntry: (url) => ({ serverUrl: url }),
     },
     codex: {
         id: "codex",
@@ -133,6 +136,13 @@ function readConfigFile(filepath, format) {
     if (!fs.existsSync(filepath))
         return {};
     const raw = fs.readFileSync(filepath, "utf-8");
+    // An existing but empty (or whitespace-only) file is a valid "no config
+    // yet" state, not a parse error. Antigravity's own migration pre-creates
+    // an empty ~/.gemini/config/mcp_config.json, and JSON.parse("") throws
+    // ("Unexpected end of JSON input"), which would abort the whole setup.
+    // Treat it as an empty object so the non-destructive merge starts clean.
+    if (raw.trim() === "")
+        return {};
     if (format === "toml") {
         return (0, smol_toml_1.parse)(raw);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brain-mcps/setup",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Configure AI assistant clients to connect to Brain4AI and Mentor4AI MCP servers",
   "bin": {
     "brain-mcp-setup": "dist/cli.js"
@@ -21,7 +21,7 @@
     "brain4ai",
     "mentor4ai",
     "claude",
-    "gemini",
+    "antigravity",
     "chatgpt"
   ],
   "author": "SirGrimorum",

package/dist/index.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/index.test.js

@@ -1,302 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-const vitest_1 = require("vitest");
-const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
-const os = __importStar(require("node:os"));
-const smol_toml_1 = require("smol-toml");
-const index_js_1 = require("./index.js");
-/** Temporarily override process.platform for a test. */
-function withPlatform(platform, fn) {
-    const original = Object.getOwnPropertyDescriptor(process, "platform");
-    Object.defineProperty(process, "platform", {
-        value: platform,
-        configurable: true,
-    });
-    try {
-        fn();
-    }
-    finally {
-        if (original)
-            Object.defineProperty(process, "platform", original);
-    }
-}
-// ── Test helpers: use a real temp directory as fake $HOME ────────────────
-let tmpHome;
-(0, vitest_1.beforeEach)(() => {
-    tmpHome = fs.mkdtempSync(path.join(os.tmpdir(), "brain-mcp-setup-test-"));
-});
-(0, vitest_1.afterEach)(() => {
-    fs.rmSync(tmpHome, { recursive: true, force: true });
-});
-/** Create the config directory for a client inside tmpHome. */
-function ensureConfigDir(clientId) {
-    const configPath = (0, index_js_1.resolveConfigPath)(clientId, tmpHome);
-    fs.mkdirSync(path.dirname(configPath), { recursive: true });
-}
-/** Write a JSON config file for a client inside tmpHome. */
-function writeConfig(clientId, data) {
-    const configPath = (0, index_js_1.resolveConfigPath)(clientId, tmpHome);
-    fs.mkdirSync(path.dirname(configPath), { recursive: true });
-    fs.writeFileSync(configPath, JSON.stringify(data, null, 2));
-}
-/** Read a JSON config file for a client from tmpHome. */
-function readConfig(clientId) {
-    const configPath = (0, index_js_1.resolveConfigPath)(clientId, tmpHome);
-    return JSON.parse(fs.readFileSync(configPath, "utf-8"));
-}
-/** Read a TOML config file for a client from tmpHome. */
-function readTomlConfig(clientId) {
-    const configPath = (0, index_js_1.resolveConfigPath)(clientId, tmpHome);
-    return (0, smol_toml_1.parse)(fs.readFileSync(configPath, "utf-8"));
-}
-/** Write a raw string config file for a client inside tmpHome. */
-function writeRawConfig(clientId, contents) {
-    const configPath = (0, index_js_1.resolveConfigPath)(clientId, tmpHome);
-    fs.mkdirSync(path.dirname(configPath), { recursive: true });
-    fs.writeFileSync(configPath, contents);
-}
-// ── Tests ───────────────────────────────────────────────────────────────
-(0, vitest_1.describe)("listClients", () => {
-    (0, vitest_1.it)("returns all 7 supported clients", () => {
-        const clients = (0, index_js_1.listClients)();
-        (0, vitest_1.expect)(clients).toHaveLength(7);
-        const ids = clients.map((c) => c.id);
-        (0, vitest_1.expect)(ids).toContain("claude-code");
-        (0, vitest_1.expect)(ids).toContain("claude-desktop");
-        (0, vitest_1.expect)(ids).toContain("gemini");
-        (0, vitest_1.expect)(ids).toContain("codex");
-        (0, vitest_1.expect)(ids).toContain("cursor");
-        (0, vitest_1.expect)(ids).toContain("windsurf");
-        (0, vitest_1.expect)(ids).toContain("copilot");
-    });
-});
-(0, vitest_1.describe)("resolveConfigPath", () => {
-    (0, vitest_1.it)("replaces ~ with the provided home directory", () => {
-        const resolved = (0, index_js_1.resolveConfigPath)("gemini", "/fake/home");
-        (0, vitest_1.expect)(resolved).toBe("/fake/home/.gemini/settings.json");
-    });
-    (0, vitest_1.it)("uses os.homedir when no homeDir provided", () => {
-        const resolved = (0, index_js_1.resolveConfigPath)("gemini");
-        (0, vitest_1.expect)(resolved).toContain(os.homedir());
-    });
-});
-(0, vitest_1.describe)("setupClient", () => {
-    (0, vitest_1.it)("creates gemini config with httpUrl key", () => {
-        ensureConfigDir("gemini");
-        const result = (0, index_js_1.setupClient)("gemini", "brain", { homeDir: tmpHome });
-        (0, vitest_1.expect)(result.action).toBe("created");
-        (0, vitest_1.expect)(result.serverName).toBe("cerebro-externo");
-        const config = readConfig("gemini");
-        const servers = config.mcpServers;
-        (0, vitest_1.expect)(servers["cerebro-externo"].httpUrl).toBe("https://mcp.brain4ai.app/mcp");
-        // Gemini uses httpUrl, not url
-        (0, vitest_1.expect)(servers["cerebro-externo"].url).toBeUndefined();
-    });
-    (0, vitest_1.it)("creates claude-code config with type and url keys", () => {
-        ensureConfigDir("claude-code");
-        const result = (0, index_js_1.setupClient)("claude-code", "mentor", { homeDir: tmpHome });
-        (0, vitest_1.expect)(result.action).toBe("created");
-        (0, vitest_1.expect)(result.serverName).toBe("forge-mentor");
-        const config = readConfig("claude-code");
-        const servers = config.mcpServers;
-        (0, vitest_1.expect)(servers["forge-mentor"]).toEqual({
-            type: "url",
-            url: "https://mcp.mentor4ai.app/mcp",
-        });
-    });
-    (0, vitest_1.it)("creates windsurf config with serverUrl key", () => {
-        ensureConfigDir("windsurf");
-        const result = (0, index_js_1.setupClient)("windsurf", "brain", { homeDir: tmpHome });
-        (0, vitest_1.expect)(result.serverName).toBe("cerebro-externo");
-        const config = readConfig("windsurf");
-        const servers = config.mcpServers;
-        (0, vitest_1.expect)(servers["cerebro-externo"].serverUrl).toBe("https://mcp.brain4ai.app/mcp");
-    });
-    (0, vitest_1.it)("creates copilot config with nested mcp.servers path", () => {
-        ensureConfigDir("copilot");
-        (0, index_js_1.setupClient)("copilot", "brain", { homeDir: tmpHome });
-        const config = readConfig("copilot");
-        const mcp = config.mcp;
-        (0, vitest_1.expect)(mcp.servers["cerebro-externo"]).toEqual({
-            type: "http",
-            url: "https://mcp.brain4ai.app/mcp",
-        });
-    });
-    (0, vitest_1.it)("creates codex config as TOML with mcp_servers.<id>.url", () => {
-        ensureConfigDir("codex");
-        const result = (0, index_js_1.setupClient)("codex", "brain", { homeDir: tmpHome });
-        (0, vitest_1.expect)(result.action).toBe("created");
-        (0, vitest_1.expect)(result.serverName).toBe("cerebro-externo");
-        (0, vitest_1.expect)(result.configPath).toMatch(/config\.toml$/);
-        const config = readTomlConfig("codex");
-        const servers = config.mcp_servers;
-        (0, vitest_1.expect)(servers["cerebro-externo"]).toEqual({
-            url: "https://mcp.brain4ai.app/mcp",
-        });
-    });
-    (0, vitest_1.it)("merges codex config into existing TOML without losing other entries", () => {
-        writeRawConfig("codex", [
-            'model = "gpt-5"',
-            "",
-            "[mcp_servers.metalab]",
-            'command = "npx"',
-            'args = ["metalab-mcp-client"]',
-            "",
-        ].join("\n"));
-        const result = (0, index_js_1.setupClient)("codex", "mentor", { homeDir: tmpHome });
-        (0, vitest_1.expect)(result.action).toBe("updated");
-        const config = readTomlConfig("codex");
-        (0, vitest_1.expect)(config.model).toBe("gpt-5");
-        const servers = config.mcp_servers;
-        (0, vitest_1.expect)(servers.metalab).toMatchObject({
-            command: "npx",
-            args: ["metalab-mcp-client"],
-        });
-        (0, vitest_1.expect)(servers["forge-mentor"]).toEqual({
-            url: "https://mcp.mentor4ai.app/mcp",
-        });
-    });
-    (0, vitest_1.it)("returns already_configured for codex when TOML URL matches", () => {
-        writeRawConfig("codex", [
-            "[mcp_servers.cerebro-externo]",
-            'url = "https://mcp.brain4ai.app/mcp"',
-            "",
-        ].join("\n"));
-        const result = (0, index_js_1.setupClient)("codex", "brain", { homeDir: tmpHome });
-        (0, vitest_1.expect)(result.action).toBe("already_configured");
-    });
-    (0, vitest_1.it)("merges into existing config without overwriting other keys", () => {
-        writeConfig("gemini", {
-            mcpServers: { "other-server": { url: "https://other.example.com" } },
-            someOtherKey: "keep-me",
-        });
-        const result = (0, index_js_1.setupClient)("gemini", "brain", { homeDir: tmpHome });
-        (0, vitest_1.expect)(result.action).toBe("updated");
-        const config = readConfig("gemini");
-        (0, vitest_1.expect)(config.someOtherKey).toBe("keep-me");
-        const servers = config.mcpServers;
-        (0, vitest_1.expect)(servers["other-server"].url).toBe("https://other.example.com");
-        (0, vitest_1.expect)(servers["cerebro-externo"].httpUrl).toBe("https://mcp.brain4ai.app/mcp");
-    });
-    (0, vitest_1.it)("returns already_configured when URL matches", () => {
-        writeConfig("gemini", {
-            mcpServers: {
-                "cerebro-externo": { httpUrl: "https://mcp.brain4ai.app/mcp" },
-            },
-        });
-        const result = (0, index_js_1.setupClient)("gemini", "brain", { homeDir: tmpHome });
-        (0, vitest_1.expect)(result.action).toBe("already_configured");
-    });
-    (0, vitest_1.it)("dry-run does not write files", () => {
-        ensureConfigDir("gemini");
-        const configPath = (0, index_js_1.resolveConfigPath)("gemini", tmpHome);
-        const result = (0, index_js_1.setupClient)("gemini", "brain", {
-            homeDir: tmpHome,
-            dryRun: true,
-        });
-        (0, vitest_1.expect)(result.action).toBe("created");
-        (0, vitest_1.expect)(fs.existsSync(configPath)).toBe(false);
-    });
-    (0, vitest_1.it)("uses brain4ai.app for brain product", () => {
-        ensureConfigDir("claude-code");
-        (0, index_js_1.setupClient)("claude-code", "brain", { homeDir: tmpHome });
-        const config = readConfig("claude-code");
-        const servers = config.mcpServers;
-        (0, vitest_1.expect)(servers["cerebro-externo"].url).toContain("brain4ai.app");
-    });
-    (0, vitest_1.it)("uses mentor4ai.app for mentor product", () => {
-        ensureConfigDir("claude-code");
-        (0, index_js_1.setupClient)("claude-code", "mentor", { homeDir: tmpHome });
-        const config = readConfig("claude-code");
-        const servers = config.mcpServers;
-        (0, vitest_1.expect)(servers["forge-mentor"].url).toContain("mentor4ai.app");
-    });
-});
-(0, vitest_1.describe)("detectInstalledClients", () => {
-    (0, vitest_1.it)("detects clients whose config directories exist", () => {
-        // Create dirs for gemini and claude-code only
-        ensureConfigDir("gemini");
-        ensureConfigDir("claude-code");
-        const detected = (0, index_js_1.detectInstalledClients)(tmpHome);
-        (0, vitest_1.expect)(detected).toContain("gemini");
-        (0, vitest_1.expect)(detected).toContain("claude-code");
-        (0, vitest_1.expect)(detected).not.toContain("codex");
-    });
-    (0, vitest_1.it)("returns empty array when no clients are installed", () => {
-        const detected = (0, index_js_1.detectInstalledClients)(tmpHome);
-        (0, vitest_1.expect)(detected).toHaveLength(0);
-    });
-    (0, vitest_1.it)("excludes claude-desktop on linux even if config dir exists", () => {
-        ensureConfigDir("gemini");
-        ensureConfigDir("claude-desktop");
-        withPlatform("linux", () => {
-            const detected = (0, index_js_1.detectInstalledClients)(tmpHome);
-            (0, vitest_1.expect)(detected).toContain("gemini");
-            (0, vitest_1.expect)(detected).not.toContain("claude-desktop");
-        });
-    });
-});
-(0, vitest_1.describe)("isClientSupportedOnPlatform", () => {
-    (0, vitest_1.it)("returns true for any-platform clients on every OS", () => {
-        (0, vitest_1.expect)((0, index_js_1.isClientSupportedOnPlatform)("gemini", "linux")).toBe(true);
-        (0, vitest_1.expect)((0, index_js_1.isClientSupportedOnPlatform)("gemini", "darwin")).toBe(true);
-        (0, vitest_1.expect)((0, index_js_1.isClientSupportedOnPlatform)("gemini", "win32")).toBe(true);
-        (0, vitest_1.expect)((0, index_js_1.isClientSupportedOnPlatform)("codex", "linux")).toBe(true);
-    });
-    (0, vitest_1.it)("restricts claude-desktop to darwin and win32", () => {
-        (0, vitest_1.expect)((0, index_js_1.isClientSupportedOnPlatform)("claude-desktop", "darwin")).toBe(true);
-        (0, vitest_1.expect)((0, index_js_1.isClientSupportedOnPlatform)("claude-desktop", "win32")).toBe(true);
-        (0, vitest_1.expect)((0, index_js_1.isClientSupportedOnPlatform)("claude-desktop", "linux")).toBe(false);
-        (0, vitest_1.expect)((0, index_js_1.isClientSupportedOnPlatform)("claude-desktop", "freebsd")).toBe(false);
-    });
-});
-(0, vitest_1.describe)("setupClient platform restrictions", () => {
-    (0, vitest_1.it)("throws when configuring claude-desktop on linux", () => {
-        withPlatform("linux", () => {
-            (0, vitest_1.expect)(() => (0, index_js_1.setupClient)("claude-desktop", "brain", { homeDir: tmpHome })).toThrow(/not supported on linux/);
-        });
-    });
-    (0, vitest_1.it)("succeeds when configuring claude-desktop on darwin", () => {
-        ensureConfigDir("claude-desktop");
-        withPlatform("darwin", () => {
-            const result = (0, index_js_1.setupClient)("claude-desktop", "brain", {
-                homeDir: tmpHome,
-            });
-            (0, vitest_1.expect)(result.action).toBe("created");
-        });
-    });
-});