@gatewaze/connect 0.1.0

package/README.md

@@ -0,0 +1,79 @@
+# @gatewaze/connect
+
+One command to connect your AI clients to a Gatewaze MCP server.
+
+```
+npx @gatewaze/connect
+```
+
+The tool finds the AI clients installed on your machine, asks which ones you want to connect, and writes the right connector entry for each. No secrets are stored: each client opens your normal sign-in page in the browser the first time you use the connector.
+
+## Usage
+
+```
+npx @gatewaze/connect [options]
+
+Options:
+  --server <url>    MCP server URL (default: https://mcp.aaif.live/)
+  --name <label>    Connector name (default: derived from the server hostname, e.g. "aaif")
+  --all             Configure every detected client, no prompts
+  --client <id>     Configure a specific client (repeatable):
+                    claude-desktop, claude-code, goose, chatgpt
+  --force           Overwrite an existing entry with the same name
+  --dry-run         Show what would change without writing anything
+  -h, --help        Show help
+```
+
+Examples:
+
+```
+# Interactive: detect clients and choose which to connect
+npx @gatewaze/connect
+
+# Connect everything found, non-interactive
+npx @gatewaze/connect --all
+
+# A different server, specific clients, preview only
+npx @gatewaze/connect --server https://mcp.example.org --client claude-desktop --client goose --dry-run
+```
+
+## What it does per client
+
+**Claude Desktop** — adds an entry to `claude_desktop_config.json` (`~/Library/Application Support/Claude/` on macOS, `%APPDATA%\Claude\` on Windows, `~/.config/Claude/` on Linux):
+
+```json
+"mcpServers": {
+  "aaif": { "command": "npx", "args": ["-y", "mcp-remote", "https://mcp.aaif.live/"] }
+}
+```
+
+Claude Desktop's config cannot take a bare remote URL, so the entry goes through [mcp-remote](https://www.npmjs.com/package/mcp-remote), which opens the OAuth sign-in in your browser. All existing config content is kept, the file is backed up first, and an existing entry with the same name is never overwritten without confirmation (or `--force`). Restart Claude Desktop after connecting.
+
+**Claude Code** — runs `claude mcp add --scope user --transport http <name> <url>`. If the command cannot run, the tool prints it so you can run it yourself.
+
+**Goose** (CLI and Desktop share one config) — appends an entry to the `extensions:` map in `~/.config/goose/config.yaml`:
+
+```yaml
+extensions:
+  aaif:
+    enabled: true
+    name: aaif
+    type: streamable_http
+    uri: https://mcp.aaif.live/
+    timeout: 300
+```
+
+The rest of the file, including comments, is preserved, and a backup is written to `config.yaml.bak-<timestamp>` first. The tool also prints a `goose://extension?...` deep link as a one-click alternative for Goose Desktop.
+
+**ChatGPT** — connectors are managed in the ChatGPT web app, so the tool prints the steps: Settings -> Connectors -> Add, paste the server URL, sign in.
+
+## Development
+
+```
+npm install
+npm run build     # tsc -> dist/
+npm run dev       # run from source via tsx
+npm test          # unit tests for the config mutators
+```
+
+Requires Node 18 or newer.

package/dist/clients/chatgpt.js

@@ -0,0 +1,14 @@
+/**
+ * ChatGPT keeps its connectors in the web app — there is no local config file
+ * to edit, so all we can do is walk the user through it.
+ */
+export function chatgptInstructions(name, serverUrl) {
+    return [
+        'ChatGPT connectors are managed in the web app; add this one by hand:',
+        '  1. Open ChatGPT and go to Settings -> Connectors.',
+        '  2. Click "Add" (Create a custom connector).',
+        `  3. Name it "${name}" and paste the server URL: ${serverUrl}`,
+        '  4. Save, then sign in when the browser window opens.',
+    ];
+}
+//# sourceMappingURL=chatgpt.js.map

package/dist/clients/chatgpt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chatgpt.js","sourceRoot":"","sources":["../../src/clients/chatgpt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,SAAiB;IACjE,OAAO;QACL,sEAAsE;QACtE,qDAAqD;QACrD,+CAA+C;QAC/C,iBAAiB,IAAI,+BAA+B,SAAS,EAAE;QAC/D,wDAAwD;KACzD,CAAC;AACJ,CAAC"}

package/dist/clients/claude-code.js

@@ -0,0 +1,31 @@
+import { spawnSync } from 'node:child_process';
+import { findOnPath } from '../util.js';
+export function claudeBinaryPath() {
+    return findOnPath('claude');
+}
+/** The command we run (user scope, HTTP transport — Claude Code speaks remote MCP natively). */
+export function claudeCodeAddCommand(name, serverUrl) {
+    return ['claude', 'mcp', 'add', '--scope', 'user', '--transport', 'http', name, serverUrl];
+}
+export function formatCommand(argv) {
+    return argv.map((a) => (/[^A-Za-z0-9_@%+=:,./-]/.test(a) ? `'${a.replace(/'/g, `'\\''`)}'` : a)).join(' ');
+}
+export function runClaudeCodeAdd(name, serverUrl) {
+    const argv = claudeCodeAddCommand(name, serverUrl);
+    const command = formatCommand(argv);
+    const res = spawnSync(argv[0], argv.slice(1), { encoding: 'utf8', timeout: 30_000 });
+    if (res.error) {
+        return { ok: false, message: `Could not run claude: ${res.error.message}`, command };
+    }
+    if (res.status !== 0) {
+        const detail = (res.stderr || res.stdout || '').trim();
+        return {
+            ok: false,
+            message: `claude mcp add exited with code ${res.status}${detail ? `: ${detail}` : ''}`,
+            command,
+        };
+    }
+    const out = (res.stdout || '').trim();
+    return { ok: true, message: out || `Registered "${name}" with Claude Code (user scope).`, command };
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/clients/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/clients/claude-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,UAAU,gBAAgB;IAC9B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,SAAiB;IAClE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7G,CAAC;AASD,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,SAAiB;IAC9D,MAAM,IAAI,GAAG,oBAAoB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACrF,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,yBAAyB,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC;IACvF,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,mCAAmC,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACtF,OAAO;SACR,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,eAAe,IAAI,kCAAkC,EAAE,OAAO,EAAE,CAAC;AACtG,CAAC"}

package/dist/clients/claude-desktop.js

@@ -0,0 +1,97 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { backupFile, deepEqual, ensureParentDir } from '../util.js';
+/** Platform-specific location of claude_desktop_config.json. */
+export function claudeDesktopConfigPath() {
+    if (process.platform === 'win32') {
+        const appData = process.env.APPDATA ?? path.join(os.homedir(), 'AppData', 'Roaming');
+        return path.join(appData, 'Claude', 'claude_desktop_config.json');
+    }
+    if (process.platform === 'darwin') {
+        return path.join(os.homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    }
+    const configHome = process.env.XDG_CONFIG_HOME ?? path.join(os.homedir(), '.config');
+    return path.join(configHome, 'Claude', 'claude_desktop_config.json');
+}
+/**
+ * The entry we write. Claude Desktop's config cannot take a bare remote URL,
+ * so we go through mcp-remote, which drives the OAuth sign-in in the browser.
+ */
+export function desktopServerEntry(serverUrl) {
+    return { command: 'npx', args: ['-y', 'mcp-remote', serverUrl] };
+}
+/**
+ * Add (or update) an mcpServers entry in claude_desktop_config.json.
+ * All existing JSON content is preserved; the file is backed up before writing.
+ */
+export function applyClaudeDesktopConfig(configPath, name, serverUrl, opts = {}) {
+    const desired = desktopServerEntry(serverUrl);
+    let config = {};
+    const exists = fs.existsSync(configPath);
+    if (exists) {
+        const raw = fs.readFileSync(configPath, 'utf8');
+        if (raw.trim() !== '') {
+            try {
+                const parsed = JSON.parse(raw);
+                if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+                    return {
+                        status: 'error',
+                        message: `${configPath} does not contain a JSON object; refusing to modify it.`,
+                    };
+                }
+                config = parsed;
+            }
+            catch (err) {
+                return {
+                    status: 'error',
+                    message: `Could not parse ${configPath} (${err.message}); refusing to modify it.`,
+                };
+            }
+        }
+    }
+    const servers = (config.mcpServers ?? {});
+    if (typeof servers !== 'object' || servers === null || Array.isArray(servers)) {
+        return {
+            status: 'error',
+            message: `"mcpServers" in ${configPath} is not an object; refusing to modify it.`,
+        };
+    }
+    const existing = servers[name];
+    const isUpdate = existing !== undefined;
+    if (isUpdate && deepEqual(existing, desired)) {
+        return { status: 'unchanged', message: `"${name}" is already configured for this server.` };
+    }
+    if (isUpdate && !opts.overwrite && !opts.dryRun) {
+        return {
+            status: 'conflict',
+            message: `An mcpServers entry named "${name}" already exists in ${configPath} with different settings ` +
+                `(currently: ${JSON.stringify(existing)}).`,
+        };
+    }
+    servers[name] = desired;
+    config.mcpServers = servers;
+    const output = JSON.stringify(config, null, 2) + '\n';
+    if (opts.dryRun) {
+        return {
+            status: isUpdate ? 'would-update' : 'would-add',
+            message: `${isUpdate ? 'Would update' : 'Would add'} mcpServers.${name} in ${configPath}:\n` +
+                `  ${JSON.stringify({ [name]: desired })}`,
+            plannedContent: output,
+        };
+    }
+    let backupPath;
+    if (exists) {
+        backupPath = backupFile(configPath, opts.now);
+    }
+    else {
+        ensureParentDir(configPath);
+    }
+    fs.writeFileSync(configPath, output, 'utf8');
+    return {
+        status: isUpdate ? 'updated' : 'added',
+        message: `${isUpdate ? 'Updated' : 'Added'} mcpServers.${name} in ${configPath}`,
+        backupPath,
+    };
+}
+//# sourceMappingURL=claude-desktop.js.map

package/dist/clients/claude-desktop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-desktop.js","sourceRoot":"","sources":["../../src/clients/claude-desktop.ts"],"names":[],"mappings":"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"}

package/dist/clients/goose.js

@@ -0,0 +1,84 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { Document, parseDocument } from 'yaml';
+import { backupFile, deepEqual, ensureParentDir } from '../util.js';
+/** Goose CLI and Goose Desktop share one config file. */
+export function gooseConfigPath() {
+    if (process.platform === 'win32') {
+        const appData = process.env.APPDATA ?? path.join(os.homedir(), 'AppData', 'Roaming');
+        return path.join(appData, 'Block', 'goose', 'config', 'config.yaml');
+    }
+    const configHome = process.env.XDG_CONFIG_HOME ?? path.join(os.homedir(), '.config');
+    return path.join(configHome, 'goose', 'config.yaml');
+}
+export function gooseExtensionEntry(name, serverUrl) {
+    return { enabled: true, name, type: 'streamable_http', uri: serverUrl, timeout: 300 };
+}
+/** Desktop one-click alternative to editing the config file. */
+export function gooseDeepLink(name, serverUrl) {
+    return `goose://extension?url=${encodeURIComponent(serverUrl)}&name=${encodeURIComponent(name)}`;
+}
+/**
+ * Add (or update) an entry in the `extensions:` map of Goose's config.yaml.
+ * Parses with the yaml Document API so existing content, comments and
+ * formatting are preserved as far as the library allows. The file is backed
+ * up to config.yaml.bak-<timestamp> before writing.
+ */
+export function applyGooseConfig(configPath, name, serverUrl, opts = {}) {
+    const desired = gooseExtensionEntry(name, serverUrl);
+    const exists = fs.existsSync(configPath);
+    let doc;
+    if (exists) {
+        const raw = fs.readFileSync(configPath, 'utf8');
+        doc = parseDocument(raw);
+        if (doc.errors.length > 0) {
+            return {
+                status: 'error',
+                message: `Could not parse ${configPath} (${doc.errors[0].message}); refusing to modify it.`,
+            };
+        }
+    }
+    else {
+        doc = new Document({});
+    }
+    const existingNode = doc.getIn(['extensions', name]);
+    const existing = existingNode !== undefined && existingNode !== null && typeof existingNode.toJSON === 'function'
+        ? existingNode.toJSON()
+        : existingNode;
+    const isUpdate = existing !== undefined;
+    if (isUpdate && deepEqual(existing, desired)) {
+        return { status: 'unchanged', message: `Extension "${name}" is already configured for this server.` };
+    }
+    if (isUpdate && !opts.overwrite && !opts.dryRun) {
+        return {
+            status: 'conflict',
+            message: `An extension named "${name}" already exists in ${configPath} with different settings ` +
+                `(currently: ${JSON.stringify(existing)}).`,
+        };
+    }
+    doc.setIn(['extensions', name], desired);
+    const output = doc.toString();
+    if (opts.dryRun) {
+        return {
+            status: isUpdate ? 'would-update' : 'would-add',
+            message: `${isUpdate ? 'Would update' : 'Would add'} extensions.${name} in ${configPath}:\n` +
+                `  ${JSON.stringify(desired)}`,
+            plannedContent: output,
+        };
+    }
+    let backupPath;
+    if (exists) {
+        backupPath = backupFile(configPath, opts.now);
+    }
+    else {
+        ensureParentDir(configPath);
+    }
+    fs.writeFileSync(configPath, output, 'utf8');
+    return {
+        status: isUpdate ? 'updated' : 'added',
+        message: `${isUpdate ? 'Updated' : 'Added'} extensions.${name} in ${configPath}`,
+        backupPath,
+    };
+}
+//# sourceMappingURL=goose.js.map

package/dist/clients/goose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goose.js","sourceRoot":"","sources":["../../src/clients/goose.ts"],"names":[],"mappings":"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"}

package/dist/detect.js

@@ -0,0 +1,45 @@
+import fs from 'node:fs';
+import { claudeDesktopConfigPath } from './clients/claude-desktop.js';
+import { claudeBinaryPath } from './clients/claude-code.js';
+import { gooseConfigPath } from './clients/goose.js';
+import { findOnPath } from './util.js';
+export function detectClients() {
+    const clients = [];
+    const desktopConfig = claudeDesktopConfigPath();
+    const desktopFound = fs.existsSync(desktopConfig);
+    clients.push({
+        id: 'claude-desktop',
+        label: 'Claude Desktop',
+        detected: desktopFound,
+        detail: desktopFound ? `config at ${desktopConfig}` : `no config at ${desktopConfig}`,
+    });
+    const claudeBin = claudeBinaryPath();
+    clients.push({
+        id: 'claude-code',
+        label: 'Claude Code',
+        detected: claudeBin !== null,
+        detail: claudeBin ? `claude binary at ${claudeBin}` : 'claude binary not found on PATH',
+    });
+    const gooseConfig = gooseConfigPath();
+    const gooseConfigFound = fs.existsSync(gooseConfig);
+    const gooseBin = findOnPath('goose');
+    const gooseFound = gooseConfigFound || gooseBin !== null;
+    const gooseBits = [
+        gooseBin ? `goose binary at ${gooseBin}` : null,
+        gooseConfigFound ? `config at ${gooseConfig}` : null,
+    ].filter(Boolean);
+    clients.push({
+        id: 'goose',
+        label: 'Goose (CLI + Desktop)',
+        detected: gooseFound,
+        detail: gooseFound ? gooseBits.join(', ') : `no goose binary on PATH and no config at ${gooseConfig}`,
+    });
+    clients.push({
+        id: 'chatgpt',
+        label: 'ChatGPT',
+        detected: true,
+        detail: 'connectors are web-managed; instructions only',
+    });
+    return clients;
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,MAAM,aAAa,GAAG,uBAAuB,EAAE,CAAC;IAChD,MAAM,YAAY,GAAG,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAClD,OAAO,CAAC,IAAI,CAAC;QACX,EAAE,EAAE,gBAAgB;QACpB,KAAK,EAAE,gBAAgB;QACvB,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,aAAa,aAAa,EAAE,CAAC,CAAC,CAAC,gBAAgB,aAAa,EAAE;KACtF,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,gBAAgB,EAAE,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC;QACX,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,QAAQ,EAAE,SAAS,KAAK,IAAI;QAC5B,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,oBAAoB,SAAS,EAAE,CAAC,CAAC,CAAC,iCAAiC;KACxF,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,eAAe,EAAE,CAAC;IACtC,MAAM,gBAAgB,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG,gBAAgB,IAAI,QAAQ,KAAK,IAAI,CAAC;IACzD,MAAM,SAAS,GAAG;QAChB,QAAQ,CAAC,CAAC,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;QAC/C,gBAAgB,CAAC,CAAC,CAAC,aAAa,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;KACrD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClB,OAAO,CAAC,IAAI,CAAC;QACX,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,uBAAuB;QAC9B,QAAQ,EAAE,UAAU;QACpB,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,4CAA4C,WAAW,EAAE;KACtG,CAAC,CAAC;IAEH,OAAO,CAAC,IAAI,CAAC;QACX,EAAE,EAAE,SAAS;QACb,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,+CAA+C;KACxD,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.js

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+import { parseArgs } from 'node:util';
+import { CLIENT_IDS } from './types.js';
+import { DEFAULT_SERVER_URL, deriveName, validateServerUrl } from './util.js';
+import { detectClients } from './detect.js';
+import { confirm, selectClients } from './prompt.js';
+import { applyClaudeDesktopConfig, claudeDesktopConfigPath } from './clients/claude-desktop.js';
+import { claudeCodeAddCommand, formatCommand, runClaudeCodeAdd } from './clients/claude-code.js';
+import { applyGooseConfig, gooseConfigPath, gooseDeepLink } from './clients/goose.js';
+import { chatgptInstructions } from './clients/chatgpt.js';
+const HELP = `gatewaze-connect — connect your AI clients to a Gatewaze MCP server
+
+Usage:
+  npx @gatewaze/connect [options]
+
+Options:
+  --server <url>    MCP server URL (default: ${DEFAULT_SERVER_URL})
+  --name <label>    Connector name (default: derived from the server hostname)
+  --all             Configure every detected client, no prompts
+  --client <id>     Configure a specific client (repeatable). One of:
+                    ${CLIENT_IDS.join(', ')}
+  --force           Overwrite an existing entry with the same name
+  --dry-run         Show what would change without writing anything
+  -h, --help        Show this help
+
+Examples:
+  npx @gatewaze/connect
+  npx @gatewaze/connect --server https://mcp.aaif.live --all
+  npx @gatewaze/connect --client claude-desktop --client goose --dry-run
+`;
+function parseCliArgs(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            server: { type: 'string' },
+            name: { type: 'string' },
+            all: { type: 'boolean', default: false },
+            client: { type: 'string', multiple: true },
+            force: { type: 'boolean', default: false },
+            'dry-run': { type: 'boolean', default: false },
+            help: { type: 'boolean', short: 'h', default: false },
+        },
+    });
+    if (values.help) {
+        console.log(HELP);
+        process.exit(0);
+    }
+    const serverUrl = validateServerUrl(values.server ?? DEFAULT_SERVER_URL);
+    const name = values.name?.trim() || deriveName(serverUrl);
+    const clients = [];
+    for (const raw of values.client ?? []) {
+        const id = raw.trim().toLowerCase();
+        if (!CLIENT_IDS.includes(id)) {
+            throw new Error(`Unknown --client "${raw}". Valid values: ${CLIENT_IDS.join(', ')}`);
+        }
+        clients.push(id);
+    }
+    return {
+        serverUrl,
+        name,
+        all: values.all ?? false,
+        clients,
+        force: values.force ?? false,
+        dryRun: values['dry-run'] ?? false,
+    };
+}
+function reportApply(result) {
+    const prefix = result.status === 'error' ? '  !!' : '  ->';
+    console.log(`${prefix} ${result.message}`);
+    if (result.backupPath) {
+        console.log(`  -> Backed up previous config to ${result.backupPath}`);
+    }
+}
+async function resolveConflict(label, result, retry) {
+    if (result.status !== 'conflict')
+        return result;
+    console.log(`  !! ${result.message}`);
+    if (process.stdin.isTTY && process.stdout.isTTY) {
+        const yes = await confirm(`  Overwrite the existing "${label}" entry?`, false);
+        if (yes)
+            return retry(true);
+        return { status: 'unchanged', message: 'Left the existing entry untouched.' };
+    }
+    return {
+        status: 'unchanged',
+        message: 'Left the existing entry untouched (re-run with --force to overwrite).',
+    };
+}
+async function main() {
+    let opts;
+    try {
+        opts = parseCliArgs(process.argv.slice(2));
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}\n`);
+        console.error(HELP);
+        process.exit(2);
+    }
+    console.log('gatewaze-connect');
+    console.log(`  Server: ${opts.serverUrl}`);
+    console.log(`  Connector name: ${opts.name}`);
+    if (opts.dryRun)
+        console.log('  Mode: dry-run (nothing will be written)');
+    const detected = detectClients();
+    let targets;
+    if (opts.clients.length > 0) {
+        targets = detected.filter((c) => opts.clients.includes(c.id));
+    }
+    else if (opts.all) {
+        targets = detected.filter((c) => c.detected);
+    }
+    else if (process.stdin.isTTY && process.stdout.isTTY) {
+        targets = await selectClients(detected);
+    }
+    else {
+        console.error('\nNo TTY available for interactive selection. Re-run with --all or one or more --client flags.');
+        process.exit(2);
+    }
+    if (targets.length === 0) {
+        console.log('\nNothing selected — no changes made.');
+        return;
+    }
+    console.log('');
+    const nextSteps = [];
+    let hadError = false;
+    for (const target of targets) {
+        console.log(`${target.label}:`);
+        if (!target.detected) {
+            console.log(`  -> Not detected (${target.detail}) — configuring anyway as requested.`);
+        }
+        switch (target.id) {
+            case 'claude-desktop': {
+                const configPath = claudeDesktopConfigPath();
+                let result = applyClaudeDesktopConfig(configPath, opts.name, opts.serverUrl, {
+                    overwrite: opts.force,
+                    dryRun: opts.dryRun,
+                });
+                result = await resolveConflict(target.label, result, (overwrite) => applyClaudeDesktopConfig(configPath, opts.name, opts.serverUrl, {
+                    overwrite,
+                    dryRun: opts.dryRun,
+                }));
+                reportApply(result);
+                if (result.status === 'error')
+                    hadError = true;
+                if (result.status === 'added' || result.status === 'updated') {
+                    nextSteps.push('Claude Desktop: restart the app, then use the connector once — the first use opens your sign-in page in the browser (via mcp-remote).');
+                }
+                break;
+            }
+            case 'claude-code': {
+                if (opts.dryRun) {
+                    console.log(`  -> Would run: ${formatCommand(claudeCodeAddCommand(opts.name, opts.serverUrl))}`);
+                }
+                else {
+                    const result = runClaudeCodeAdd(opts.name, opts.serverUrl);
+                    if (result.ok) {
+                        console.log(`  -> ${result.message}`);
+                        nextSteps.push('Claude Code: run /mcp in any session to check the connection — first use opens your sign-in page.');
+                    }
+                    else {
+                        hadError = true;
+                        console.log(`  !! ${result.message}`);
+                        console.log(`  -> Run this yourself to register the server:\n       ${result.command}`);
+                    }
+                }
+                break;
+            }
+            case 'goose': {
+                const configPath = gooseConfigPath();
+                let result = applyGooseConfig(configPath, opts.name, opts.serverUrl, {
+                    overwrite: opts.force,
+                    dryRun: opts.dryRun,
+                });
+                result = await resolveConflict(target.label, result, (overwrite) => applyGooseConfig(configPath, opts.name, opts.serverUrl, { overwrite, dryRun: opts.dryRun }));
+                reportApply(result);
+                if (result.status === 'error')
+                    hadError = true;
+                console.log(`  -> Goose Desktop one-click alternative: ${gooseDeepLink(opts.name, opts.serverUrl)}`);
+                if (result.status === 'added' || result.status === 'updated') {
+                    nextSteps.push('Goose: restart Goose (Desktop) or start a new goose session (CLI) — first use of the extension opens your sign-in page.');
+                }
+                break;
+            }
+            case 'chatgpt': {
+                for (const line of chatgptInstructions(opts.name, opts.serverUrl)) {
+                    console.log(`  ${line}`);
+                }
+                break;
+            }
+        }
+        console.log('');
+    }
+    if (nextSteps.length > 0) {
+        console.log('Next steps:');
+        for (const step of nextSteps)
+            console.log(`  - ${step}`);
+    }
+    else if (opts.dryRun) {
+        console.log('Dry-run complete — nothing was written.');
+    }
+    if (hadError)
+        process.exitCode = 1;
+}
+main().catch((err) => {
+    console.error(`Unexpected error: ${err.stack ?? err}`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAChG,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,IAAI,GAAG;;;;;;+CAMkC,kBAAkB;;;;sBAI3C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;CAS1C,CAAC;AAWF,SAAS,YAAY,CAAC,IAAc;IAClC,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC3B,IAAI,EAAE,IAAI;QACV,OAAO,EAAE;YACP,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YACxC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;YAC1C,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YAC1C,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YAC9C,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE;SACtD;KACF,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,IAAI,kBAAkB,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;IAE1D,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,CAAE,UAAuB,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,oBAAoB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,EAAc,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO;QACL,SAAS;QACT,IAAI;QACJ,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,KAAK;QACxB,OAAO;QACP,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,KAAK;QAC5B,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK;KACnC,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,MAAmB;IACtC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,qCAAqC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,KAAa,EACb,MAAmB,EACnB,KAA0C;IAE1C,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IACtC,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,6BAA6B,KAAK,UAAU,EAAE,KAAK,CAAC,CAAC;QAC/E,IAAI,GAAG;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;IAChF,CAAC;IACD,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,uEAAuE;KACjF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,IAAI,CAAC,CAAC;QACpD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9C,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IAE1E,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IAEjC,IAAI,OAAyB,CAAC;IAC9B,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChE,CAAC;SAAM,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QACpB,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;SAAM,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACvD,OAAO,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CACX,gGAAgG,CACjG,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;QACrD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,MAAM,sCAAsC,CAAC,CAAC;QACzF,CAAC;QAED,QAAQ,MAAM,CAAC,EAAE,EAAE,CAAC;YAClB,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,MAAM,UAAU,GAAG,uBAAuB,EAAE,CAAC;gBAC7C,IAAI,MAAM,GAAG,wBAAwB,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE;oBAC3E,SAAS,EAAE,IAAI,CAAC,KAAK;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,CAAC,CAAC;gBACH,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CACjE,wBAAwB,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE;oBAC9D,SAAS;oBACT,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,CAAC,CACH,CAAC;gBACF,WAAW,CAAC,MAAM,CAAC,CAAC;gBACpB,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO;oBAAE,QAAQ,GAAG,IAAI,CAAC;gBAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC7D,SAAS,CAAC,IAAI,CACZ,uIAAuI,CACxI,CAAC;gBACJ,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;oBAChB,OAAO,CAAC,GAAG,CACT,mBAAmB,aAAa,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CACpF,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC3D,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;wBACd,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;wBACtC,SAAS,CAAC,IAAI,CACZ,mGAAmG,CACpG,CAAC;oBACJ,CAAC;yBAAM,CAAC;wBACN,QAAQ,GAAG,IAAI,CAAC;wBAChB,OAAO,CAAC,GAAG,CAAC,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;wBACtC,OAAO,CAAC,GAAG,CAAC,0DAA0D,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;oBAC1F,CAAC;gBACH,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC;gBACrC,IAAI,MAAM,GAAG,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE;oBACnE,SAAS,EAAE,IAAI,CAAC,KAAK;oBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,CAAC,CAAC;gBACH,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,EAAE,CACjE,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAC5F,CAAC;gBACF,WAAW,CAAC,MAAM,CAAC,CAAC;gBACpB,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO;oBAAE,QAAQ,GAAG,IAAI,CAAC;gBAC/C,OAAO,CAAC,GAAG,CACT,6CAA6C,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CACxF,CAAC;gBACF,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC7D,SAAS,CAAC,IAAI,CACZ,yHAAyH,CAC1H,CAAC;gBACJ,CAAC;gBACD,MAAM;YACR,CAAC;YAED,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,KAAK,MAAM,IAAI,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;oBAClE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;gBAC3B,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;SAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,QAAQ;QAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,qBAAsB,GAAa,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/prompt.js

@@ -0,0 +1,55 @@
+import readline from 'node:readline/promises';
+function rlInterface() {
+    return readline.createInterface({ input: process.stdin, output: process.stdout });
+}
+export async function confirm(question, defaultYes = false) {
+    const rl = rlInterface();
+    try {
+        const suffix = defaultYes ? '[Y/n]' : '[y/N]';
+        const answer = (await rl.question(`${question} ${suffix} `)).trim().toLowerCase();
+        if (answer === '')
+            return defaultYes;
+        return answer === 'y' || answer === 'yes';
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * Checkbox-style selection over detected clients: detected clients are
+ * pre-ticked; the user can accept the selection or type numbers to change it.
+ */
+export async function selectClients(clients) {
+    console.log('\nDetected AI clients:\n');
+    clients.forEach((c, i) => {
+        const box = c.detected ? '[x]' : '[ ]';
+        console.log(`  ${i + 1}. ${box} ${c.label}  (${c.detail})`);
+    });
+    console.log('');
+    const rl = rlInterface();
+    try {
+        const answer = (await rl.question('Which should be connected? Enter numbers (e.g. 1,3), "all", or press Enter for all detected: '))
+            .trim()
+            .toLowerCase();
+        if (answer === '')
+            return clients.filter((c) => c.detected);
+        if (answer === 'all' || answer === 'a')
+            return clients;
+        if (answer === 'none' || answer === 'n')
+            return [];
+        const picked = new Set();
+        for (const part of answer.split(/[\s,]+/).filter(Boolean)) {
+            const n = Number(part);
+            if (!Number.isInteger(n) || n < 1 || n > clients.length) {
+                console.log(`Ignoring "${part}" (expected a number between 1 and ${clients.length}).`);
+                continue;
+            }
+            picked.add(n - 1);
+        }
+        return clients.filter((_, i) => picked.has(i));
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export const CLIENT_IDS = ['claude-desktop', 'claude-code', 'goose', 'chatgpt'];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAe,CAAC,gBAAgB,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC"}

package/dist/util.js

@@ -0,0 +1,92 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export const DEFAULT_SERVER_URL = 'https://mcp.aaif.live/';
+/**
+ * Derive a short connector name from the server URL's hostname.
+ * e.g. https://mcp.aaif.live/ -> "aaif", https://mcp.example.test/ -> "example".
+ */
+export function deriveName(serverUrl) {
+    let hostname;
+    try {
+        hostname = new URL(serverUrl).hostname;
+    }
+    catch {
+        return 'gatewaze';
+    }
+    const generic = new Set(['mcp', 'www', 'api', 'connect']);
+    const labels = hostname.split('.').filter(Boolean);
+    const core = labels.find((l) => !generic.has(l.toLowerCase())) ?? labels[0] ?? 'gatewaze';
+    const cleaned = core.toLowerCase().replace(/[^a-z0-9_-]/g, '');
+    return cleaned || 'gatewaze';
+}
+export function validateServerUrl(raw) {
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        throw new Error(`Invalid --server URL: ${raw}`);
+    }
+    if (url.protocol !== 'https:' && url.protocol !== 'http:') {
+        throw new Error(`--server must be an http(s) URL, got: ${raw}`);
+    }
+    return url.toString();
+}
+/** Timestamp suitable for backup file suffixes: YYYYMMDD-HHMMSS */
+export function backupTimestamp(date = new Date()) {
+    const p = (n, w = 2) => String(n).padStart(w, '0');
+    return (`${date.getFullYear()}${p(date.getMonth() + 1)}${p(date.getDate())}` +
+        `-${p(date.getHours())}${p(date.getMinutes())}${p(date.getSeconds())}`);
+}
+/** Copy `filePath` to `<filePath>.bak-<timestamp>` and return the backup path. */
+export function backupFile(filePath, date = new Date()) {
+    const backupPath = `${filePath}.bak-${backupTimestamp(date)}`;
+    fs.copyFileSync(filePath, backupPath);
+    return backupPath;
+}
+export function ensureParentDir(filePath) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+}
+export function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== typeof b)
+        return false;
+    if (Array.isArray(a) || Array.isArray(b)) {
+        if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length)
+            return false;
+        return a.every((v, i) => deepEqual(v, b[i]));
+    }
+    if (a && b && typeof a === 'object') {
+        const ka = Object.keys(a);
+        const kb = Object.keys(b);
+        if (ka.length !== kb.length)
+            return false;
+        return ka.every((k) => deepEqual(a[k], b[k]));
+    }
+    return false;
+}
+/** Locate an executable on PATH (cross-platform, no shelling out). */
+export function findOnPath(binary) {
+    const pathVar = process.env.PATH ?? '';
+    const dirs = pathVar.split(path.delimiter).filter(Boolean);
+    const exts = process.platform === 'win32'
+        ? (process.env.PATHEXT ?? '.EXE;.CMD;.BAT;.COM').split(';')
+        : [''];
+    for (const dir of dirs) {
+        for (const ext of exts) {
+            const candidate = path.join(dir, binary + ext.toLowerCase());
+            try {
+                fs.accessSync(candidate, fs.constants.X_OK);
+                if (fs.statSync(candidate).isFile() || fs.lstatSync(candidate).isSymbolicLink()) {
+                    return candidate;
+                }
+            }
+            catch {
+                // keep looking
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@gatewaze/connect",
+  "version": "0.1.0",
+  "description": "One-command setup that connects your AI clients (Claude Desktop, Claude Code, Goose, ChatGPT) to a Gatewaze MCP server.",
+  "type": "module",
+  "bin": {
+    "gatewaze-connect": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gatewaze/gatewaze.git",
+    "directory": "packages/connect"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "test": "tsx --test test/*.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "yaml": "^2.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0"
+  }
+}