figma-console-mcp-cli 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import chalk from "chalk";
+import { runSystemCheck } from "./steps/systemCheck.js";
+import { promptForToken } from "./steps/auth.js";
+import { detectAndSelectClients } from "./steps/clientDetect.js";
+import { configureClients } from "./steps/configure.js";
+import { setupConnection } from "./steps/connection.js";
+import { runHealthCheck } from "./steps/healthCheck.js";
+const program = new Command();
+program
+    .name("figma-console-mcp-cli")
+    .description("Configure Figma Console MCP across AI coding clients")
+    .version("1.0.0")
+    .action(async () => {
+    console.log(chalk.bold.cyan("\n  Figma Console MCP — Setup Wizard\n"));
+    try {
+        await runSystemCheck();
+        const token = await promptForToken();
+        const clients = await detectAndSelectClients();
+        if (clients.length === 0) {
+            console.log(chalk.yellow("\nNo clients selected. Exiting.\n"));
+            return;
+        }
+        const configured = await configureClients(clients, token);
+        if (configured.length === 0) {
+            console.log(chalk.yellow("\nNo clients were configured. Exiting.\n"));
+            return;
+        }
+        const method = await setupConnection();
+        await runHealthCheck(configured, method);
+    }
+    catch (err) {
+        if (err.name === "ExitPromptError") {
+            console.log(chalk.dim("\nSetup cancelled.\n"));
+            return;
+        }
+        console.error(chalk.red(`\nError: ${err instanceof Error ? err.message : err}\n`));
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,uBAAuB,CAAC;KAC7B,WAAW,CAAC,sDAAsD,CAAC;KACnE,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC,CAAC;IAEvE,IAAI,CAAC;QACH,MAAM,cAAc,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,MAAM,sBAAsB,EAAE,CAAC;QAE/C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,mCAAmC,CAAC,CAAC,CAAC;YAC/D,OAAO;QACT,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAE1D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,0CAA0C,CAAC,CAAC,CAAC;YACtE,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC;QACvC,MAAM,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAAyB,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QACD,OAAO,CAAC,KAAK,CACX,KAAK,CAAC,GAAG,CAAC,YAAY,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CACpE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/steps/auth.d.ts

@@ -0,0 +1 @@
+export declare function promptForToken(): Promise<string>;

package/dist/steps/auth.js

@@ -0,0 +1,18 @@
+import { password } from '@inquirer/prompts';
+import chalk from 'chalk';
+export async function promptForToken() {
+    console.log(chalk.bold('\n🔑 Figma Authentication\n'));
+    console.log(`  Generate a Personal Access Token at:\n  ${chalk.cyan('https://developers.figma.com/docs/rest-api/authentication/#generate-a-personal-access-token')}\n`);
+    while (true) {
+        const token = await password({
+            message: 'Paste your Figma Personal Access Token:',
+            mask: '*',
+        });
+        if (token.startsWith('figd_')) {
+            console.log(chalk.green('  ✓ Token accepted'));
+            return token;
+        }
+        console.log(chalk.red('  ✗ Invalid token — must start with "figd_". Try again.\n'));
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/steps/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/steps/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CACT,6CAA6C,KAAK,CAAC,IAAI,CACrD,6FAA6F,CAC9F,IAAI,CACN,CAAC;IAEF,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC;YAC3B,OAAO,EAAE,yCAAyC;YAClD,IAAI,EAAE,GAAG;SACV,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAC/C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC,CAAC;IACtF,CAAC;AACH,CAAC"}

package/dist/steps/clientDetect.d.ts

@@ -0,0 +1,7 @@
+export interface Client {
+    name: string;
+    id: string;
+    configPath: string | null;
+    detected: boolean;
+}
+export declare function detectAndSelectClients(): Promise<Client[]>;

package/dist/steps/clientDetect.js

@@ -0,0 +1,74 @@
+import fs from 'node:fs';
+import { execSync } from 'node:child_process';
+import { checkbox } from '@inquirer/prompts';
+import chalk from 'chalk';
+import { getPlatform, getAppDataPath, resolveConfigPath } from '../utils/platform.js';
+function isCommandAvailable(cmd) {
+    try {
+        execSync(`which ${cmd}`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getClients() {
+    const platform = getPlatform();
+    const appData = getAppDataPath();
+    const claudeDesktopPath = platform === 'windows'
+        ? `${appData}\\Claude\\claude_desktop_config.json`
+        : `${appData}/Claude/claude_desktop_config.json`;
+    return [
+        {
+            name: 'Claude Code',
+            id: 'claude-code',
+            configPath: null,
+            detected: isCommandAvailable('claude'),
+        },
+        {
+            name: 'Claude Desktop',
+            id: 'claude-desktop',
+            configPath: claudeDesktopPath,
+            detected: fs.existsSync(claudeDesktopPath),
+        },
+        {
+            name: 'Cursor',
+            id: 'cursor',
+            configPath: resolveConfigPath('.cursor', 'mcp.json'),
+            detected: fs.existsSync(resolveConfigPath('.cursor', 'mcp.json')),
+        },
+        {
+            name: 'Windsurf',
+            id: 'windsurf',
+            configPath: resolveConfigPath('.codeium', 'windsurf', 'mcp_config.json'),
+            detected: fs.existsSync(resolveConfigPath('.codeium', 'windsurf', 'mcp_config.json')),
+        },
+    ];
+}
+export async function detectAndSelectClients() {
+    console.log(chalk.bold('\n🔎 Client Detection\n'));
+    const clients = getClients();
+    const detected = clients.filter((c) => c.detected);
+    const notDetected = clients.filter((c) => !c.detected);
+    for (const c of detected) {
+        console.log(chalk.green(`  ✓ ${c.name} detected`));
+    }
+    for (const c of notDetected) {
+        console.log(chalk.dim(`  · ${c.name} not found`));
+    }
+    if (detected.length === 0) {
+        console.log(chalk.yellow('\n  No supported clients detected.'));
+        return [];
+    }
+    console.log('');
+    const selected = await checkbox({
+        message: 'Select clients to configure:',
+        choices: detected.map((c) => ({
+            name: c.name,
+            value: c.id,
+            checked: true,
+        })),
+    });
+    return detected.filter((c) => selected.includes(c.id));
+}
+//# sourceMappingURL=clientDetect.js.map

package/dist/steps/clientDetect.js.map

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

package/dist/steps/configure.d.ts

@@ -0,0 +1,2 @@
+import type { Client } from './clientDetect.js';
+export declare function configureClients(clients: Client[], token: string): Promise<Client[]>;

package/dist/steps/configure.js

@@ -0,0 +1,89 @@
+import { execSync } from 'node:child_process';
+import chalk from 'chalk';
+import { select } from '@inquirer/prompts';
+import { readJsonConfig, writeJsonConfig, mergeServerConfig } from '../utils/config.js';
+import { getPlatform } from '../utils/platform.js';
+export async function configureClients(clients, token) {
+    console.log(chalk.bold('\n⚙️  Configuring MCP Server\n'));
+    const configured = [];
+    for (const client of clients) {
+        try {
+            if (client.id === 'claude-code') {
+                const ok = await configureClaudeCode(token);
+                if (!ok) {
+                    console.log(chalk.yellow(`  ⊘ ${client.name} skipped`));
+                    continue;
+                }
+            }
+            else if (client.configPath) {
+                configureJsonClient(client, token);
+            }
+            configured.push(client);
+            console.log(chalk.green(`  ✓ ${client.name} configured`));
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.log(chalk.red(`  ✗ ${client.name} failed: ${message}`));
+        }
+    }
+    return configured;
+}
+function isClaudeRunning() {
+    try {
+        const cmd = getPlatform() === 'windows'
+            ? 'tasklist /FI "IMAGENAME eq claude.exe" /NH'
+            : 'pgrep -x claude';
+        const output = execSync(cmd, { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
+        if (getPlatform() === 'windows') {
+            return output.includes('claude.exe');
+        }
+        return true; // pgrep exits 0 only if a match is found
+    }
+    catch {
+        return false; // pgrep exits 1 if no match
+    }
+}
+function isFigmaConsoleConfigured() {
+    try {
+        const output = execSync('claude mcp list', {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return output.includes('figma-console');
+    }
+    catch {
+        return false;
+    }
+}
+async function configureClaudeCode(token) {
+    while (isClaudeRunning()) {
+        console.log(chalk.yellow('\n  ⚠ Claude Code appears to be running.'));
+        console.log(chalk.yellow('    It holds a lock that prevents `claude mcp add` from succeeding.'));
+        console.log(chalk.yellow('    Please quit Claude Code before continuing.\n'));
+        const action = await select({
+            message: 'What would you like to do?',
+            choices: [
+                { name: 'I\'ve closed Claude Code — retry', value: 'retry' },
+                { name: 'Skip Claude Code setup', value: 'skip' },
+            ],
+        });
+        if (action === 'skip') {
+            console.log(chalk.dim('  Skipped. You can configure manually later:'));
+            console.log(chalk.dim(`  claude mcp add figma-console -s user -e FIGMA_ACCESS_TOKEN=<token> -e ENABLE_MCP_APPS=true -- npx -y figma-console-mcp@latest`));
+            return false;
+        }
+        // action === 'retry' → loop continues, re-checks isClaudeRunning()
+    }
+    if (isFigmaConsoleConfigured()) {
+        execSync('claude mcp remove figma-console -s user', { stdio: 'ignore' });
+    }
+    execSync(`claude mcp add figma-console -s user -e FIGMA_ACCESS_TOKEN=${token} -e ENABLE_MCP_APPS=true -- npx -y figma-console-mcp@latest`, { stdio: 'ignore' });
+    return true;
+}
+function configureJsonClient(client, token) {
+    const configPath = client.configPath;
+    const existing = readJsonConfig(configPath);
+    const merged = mergeServerConfig(existing, token);
+    writeJsonConfig(configPath, merged);
+}
+//# sourceMappingURL=configure.js.map

package/dist/steps/configure.js.map

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

package/dist/steps/connection.d.ts

@@ -0,0 +1 @@
+export declare function setupConnection(): Promise<"bridge" | "cdp">;

package/dist/steps/connection.js

@@ -0,0 +1,140 @@
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { input, select } from "@inquirer/prompts";
+import chalk from "chalk";
+import { getHomedir, getPlatform } from "../utils/platform.js";
+const REPO_URL = "https://github.com/southleft/figma-console-mcp.git";
+const DEFAULT_CLONE_DIR_NAME = "figma-console-mcp";
+export async function setupConnection() {
+    console.log(chalk.bold("\n🔌 Figma Connection Method\n"));
+    const method = await select({
+        message: "How do you want to connect to Figma?",
+        choices: [
+            {
+                name: "Desktop Bridge Plugin (Recommended)",
+                value: "bridge",
+                description: "Install a Figma plugin — no restart needed",
+            },
+            {
+                name: "CDP Debug Mode",
+                value: "cdp",
+                description: "Relaunch Figma with remote debugging enabled",
+            },
+        ],
+    });
+    if (method === "bridge") {
+        await setupBridge();
+    }
+    else {
+        setupCDP();
+    }
+    return method;
+}
+function isGitInstalled() {
+    try {
+        const result = spawnSync("git", ["--version"], {
+            encoding: "utf-8",
+            timeout: 5_000,
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        return result.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+function isExistingClone(dir) {
+    return (existsSync(join(dir, ".git")) &&
+        existsSync(join(dir, "figma-desktop-bridge", "manifest.json")));
+}
+function cloneOrUpdateRepo(targetDir) {
+    const manifestPath = join(targetDir, "figma-desktop-bridge", "manifest.json");
+    if (isExistingClone(targetDir)) {
+        console.log(chalk.dim("  Existing clone detected — pulling latest…"));
+        try {
+            spawnSync("git", ["-C", targetDir, "pull"], {
+                encoding: "utf-8",
+                timeout: 30_000,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+        }
+        catch {
+            // non-fatal — existing clone is still usable
+        }
+        return manifestPath;
+    }
+    if (existsSync(targetDir)) {
+        throw new Error(`Directory already exists but is not the figma-console-mcp repo: ${targetDir}`);
+    }
+    console.log(chalk.dim("  Cloning figma-console-mcp…"));
+    const result = spawnSync("git", ["clone", REPO_URL, targetDir], {
+        encoding: "utf-8",
+        timeout: 60_000,
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    if (result.status !== 0) {
+        const stderr = result.stderr?.trim() ?? "unknown error";
+        throw new Error(`git clone failed: ${stderr}`);
+    }
+    if (!existsSync(manifestPath)) {
+        throw new Error(`Clone succeeded but manifest not found at: ${manifestPath}`);
+    }
+    return manifestPath;
+}
+function showManualFallback() {
+    console.log(chalk.yellow("\n  Automatic setup unavailable. Manual steps:\n"));
+    console.log(`  1. Clone the repo manually:\n`);
+    console.log(chalk.cyan(`     git clone ${REPO_URL}\n`));
+    console.log("  2. Open Figma Desktop");
+    console.log("  3. Go to Plugins → Development → Import plugin from manifest…");
+    console.log("  4. Select: <clone-dir>/figma-desktop-bridge/manifest.json\n");
+    console.log("  5. Run the plugin: Plugins → Development → Figma Console Bridge\n");
+}
+async function setupBridge() {
+    console.log(chalk.bold("\n  Desktop Bridge Setup:\n"));
+    if (!isGitInstalled()) {
+        console.log(chalk.yellow("  git is not installed or not on PATH."));
+        showManualFallback();
+        return;
+    }
+    const defaultDir = join(getHomedir(), DEFAULT_CLONE_DIR_NAME);
+    const targetDir = await input({
+        message: "Where should we clone figma-console-mcp?",
+        default: defaultDir,
+    });
+    let manifestPath;
+    try {
+        manifestPath = cloneOrUpdateRepo(targetDir.trim());
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.log(chalk.red(`\n  Error: ${msg}`));
+        showManualFallback();
+        return;
+    }
+    console.log(chalk.bold("\n  Next steps:\n"));
+    console.log("  1. Open Figma Desktop");
+    console.log("  2. Go to Plugins → Development → Import plugin from manifest…");
+    console.log("  3. Select this file:\n");
+    console.log(chalk.cyan(`     ${manifestPath}\n`));
+    console.log("  4. Run the plugin: Plugins → Development → Figma Console Bridge\n");
+}
+function setupCDP() {
+    const platform = getPlatform();
+    console.log(chalk.bold("\n  CDP Debug Mode Setup:\n"));
+    if (platform === "macos") {
+        console.log("  Close Figma if running, then launch with:\n");
+        console.log(chalk.cyan("    open -a Figma --args --remote-debugging-port=9222\n"));
+    }
+    else if (platform === "windows") {
+        console.log("  Close Figma if running, then launch with:\n");
+        console.log(chalk.cyan('    "%LOCALAPPDATA%\\Figma\\Figma.exe" --remote-debugging-port=9222\n'));
+    }
+    else {
+        console.log("  Close Figma if running, then relaunch with the flag:\n");
+        console.log(chalk.cyan("    figma --remote-debugging-port=9222\n"));
+    }
+    console.log("  Figma must be restarted with this flag each time you want CDP access.");
+}
+//# sourceMappingURL=connection.js.map

package/dist/steps/connection.js.map

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

package/dist/steps/healthCheck.d.ts

@@ -0,0 +1,2 @@
+import type { Client } from "./clientDetect.js";
+export declare function runHealthCheck(clients: Client[], method: "bridge" | "cdp"): Promise<void>;

package/dist/steps/healthCheck.js

@@ -0,0 +1,215 @@
+import chalk from "chalk";
+import { createServer } from "node:http";
+import { createHash } from "node:crypto";
+import { confirm, select } from "@inquirer/prompts";
+const BRIDGE_PORTS = [
+    9223, 9224, 9225, 9226, 9227, 9228, 9229, 9230, 9231, 9232,
+];
+const BRIDGE_TIMEOUT_MS = 60_000;
+function tryListen(server, port) {
+    return new Promise((resolve) => {
+        server.once("error", () => resolve(false));
+        server.listen(port, "127.0.0.1", () => resolve(true));
+    });
+}
+function restoreStdin() {
+    if (process.stdin.isTTY && process.stdin.isRaw) {
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+    }
+}
+/**
+ * Start a temporary WebSocket server on the first available bridge port,
+ * show a cancellable spinner, and wait for the Figma Bridge plugin to connect.
+ *
+ * Returns "connected" if the plugin connected, "cancelled" if the user pressed
+ * Escape, or "timeout" if the timeout expired.
+ * If all ports are already in use, assumes healthy (returns "connected").
+ */
+async function waitForBridgeWithCancel() {
+    const server = createServer();
+    let bound = false;
+    for (const port of BRIDGE_PORTS) {
+        bound = await tryListen(server, port);
+        if (bound)
+            break;
+    }
+    if (!bound) {
+        return "connected";
+    }
+    const spinnerMessage = "Waiting for Bridge plugin... (press Escape to cancel)";
+    return new Promise((resolve) => {
+        let resolved = false;
+        const cleanup = () => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearInterval(spinnerInterval);
+            clearTimeout(timer);
+            // Clear spinner line
+            process.stdout.write(`\r${" ".repeat(spinnerMessage.length + 6)}\r`);
+            server.close();
+            restoreStdin();
+            process.removeListener("exit", restoreStdin);
+        };
+        // Spinner
+        let frame = 0;
+        const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+        const spinnerInterval = setInterval(() => {
+            const f = SPINNER_FRAMES[frame % SPINNER_FRAMES.length];
+            process.stdout.write(`\r  ${chalk.cyan(f)} ${spinnerMessage}`);
+            frame++;
+        }, 80);
+        // Timeout
+        const timer = setTimeout(() => {
+            cleanup();
+            resolve("timeout");
+        }, BRIDGE_TIMEOUT_MS);
+        // Escape listener
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(true);
+            process.stdin.resume();
+            process.stdin.setEncoding("utf8");
+            process.on("exit", restoreStdin);
+            const onData = (data) => {
+                if (data === "\x1b") {
+                    process.stdin.removeListener("data", onData);
+                    cleanup();
+                    resolve("cancelled");
+                }
+            };
+            process.stdin.on("data", onData);
+            // Remove data listener when server closes from other paths
+            server.on("close", () => {
+                process.stdin.removeListener("data", onData);
+            });
+        }
+        // WebSocket upgrade
+        server.on("upgrade", (req, socket) => {
+            const key = req.headers["sec-websocket-key"];
+            if (typeof key === "string") {
+                const accept = createHash("sha1")
+                    .update(key + "258EAFA5-E914-47DA-95CA-5AB5E34B13E5")
+                    .digest("base64");
+                socket.write("HTTP/1.1 101 Switching Protocols\r\n" +
+                    "Upgrade: websocket\r\n" +
+                    "Connection: Upgrade\r\n" +
+                    `Sec-WebSocket-Accept: ${accept}\r\n` +
+                    "\r\n");
+            }
+            socket.destroy();
+            cleanup();
+            resolve("connected");
+        });
+    });
+}
+async function checkCdp() {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 3000);
+        const res = await fetch("http://localhost:9222", {
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        return res.ok || res.status > 0;
+    }
+    catch {
+        return false;
+    }
+}
+const SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+async function withSpinner(message, fn) {
+    let i = 0;
+    const id = setInterval(() => {
+        const frame = SPINNER_FRAMES[i % SPINNER_FRAMES.length];
+        process.stdout.write(`\r  ${chalk.cyan(frame)} ${message}`);
+        i++;
+    }, 80);
+    try {
+        const result = await fn();
+        process.stdout.write(`\r${" ".repeat(message.length + 6)}\r`);
+        return result;
+    }
+    finally {
+        clearInterval(id);
+    }
+}
+export async function runHealthCheck(clients, method) {
+    console.log(chalk.bold("\n🏥 Health Check\n"));
+    if (method === "cdp") {
+        const ready = await confirm({
+            message: "Have you relaunched Figma with the --remote-debugging-port flag?",
+            default: true,
+        });
+        if (!ready) {
+            console.log(chalk.yellow("\n  Complete the setup steps above, then run the wizard again.\n"));
+            return;
+        }
+    }
+    let healthy = false;
+    while (!healthy) {
+        if (method === "cdp") {
+            healthy = await withSpinner("Checking CDP endpoint...", checkCdp);
+            if (healthy) {
+                console.log(chalk.green("  ✓ Figma CDP endpoint reachable (localhost:9222)"));
+            }
+            else {
+                console.log(chalk.yellow("  ⚠ Figma CDP endpoint not reachable — launch Figma with the connection method you chose"));
+            }
+            if (!healthy) {
+                const action = await select({
+                    message: "What would you like to do?",
+                    choices: [
+                        { name: "Retry health check", value: "retry" },
+                        { name: "Exit setup", value: "exit" },
+                    ],
+                });
+                if (action === "exit") {
+                    console.log(chalk.yellow("\n  Setup incomplete. Run the wizard again when ready.\n"));
+                    return;
+                }
+                console.log("");
+            }
+        }
+        else {
+            console.log(chalk.cyan("\n  → Start (or restart) the Figma Console Bridge plugin in Figma now.\n"));
+            const result = await waitForBridgeWithCancel();
+            if (result === "connected") {
+                console.log(chalk.green("  ✓ Bridge plugin connected"));
+                healthy = true;
+            }
+            else if (result === "cancelled") {
+                console.log(chalk.yellow("\n  Setup cancelled. Run the wizard again when ready.\n"));
+                return;
+            }
+            else {
+                console.log(chalk.yellow("  ⚠ Bridge plugin not detected — make sure you started/restarted the plugin after seeing this prompt"));
+                const action = await select({
+                    message: "What would you like to do?",
+                    choices: [
+                        { name: "Retry health check", value: "retry" },
+                        { name: "Exit setup", value: "exit" },
+                    ],
+                });
+                if (action === "exit") {
+                    console.log(chalk.yellow("\n  Setup incomplete. Run the wizard again when ready.\n"));
+                    return;
+                }
+                console.log("");
+            }
+        }
+    }
+    // Success dashboard
+    console.log(chalk.bold.green("\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"));
+    console.log(chalk.bold.green("  ✅ Setup Complete!"));
+    console.log(chalk.bold.green("━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n"));
+    console.log(chalk.bold("  Configured clients:"));
+    for (const c of clients) {
+        console.log(chalk.green(`    • ${c.name}`));
+    }
+    console.log(chalk.bold("\n  Try these prompts in your AI client:\n"));
+    console.log(chalk.dim('    "Take a screenshot of the current Figma file"'));
+    console.log(chalk.dim('    "List all components in the design system"'));
+    console.log(chalk.dim('    "Create a 400×300 frame with a blue background"\n'));
+}
+//# sourceMappingURL=healthCheck.js.map

package/dist/steps/healthCheck.js.map

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

package/dist/steps/systemCheck.d.ts

@@ -0,0 +1 @@
+export declare function runSystemCheck(): Promise<void>;

package/dist/steps/systemCheck.js

@@ -0,0 +1,33 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+import { getPlatform, getLocalAppDataPath } from '../utils/platform.js';
+export async function runSystemCheck() {
+    console.log(chalk.bold('\n🔍 System Check\n'));
+    // Node version check
+    const nodeVersion = process.version;
+    const major = parseInt(nodeVersion.slice(1).split('.')[0], 10);
+    if (major >= 18) {
+        console.log(chalk.green(`  ✓ Node.js ${nodeVersion}`));
+    }
+    else {
+        console.log(chalk.red(`  ✗ Node.js ${nodeVersion} — version 18+ required`));
+        process.exit(1);
+    }
+    // Figma Desktop check
+    const platform = getPlatform();
+    let figmaInstalled = false;
+    if (platform === 'macos') {
+        figmaInstalled = fs.existsSync('/Applications/Figma.app');
+    }
+    else if (platform === 'windows') {
+        figmaInstalled = fs.existsSync(path.join(getLocalAppDataPath(), 'Figma', 'Figma.exe'));
+    }
+    if (figmaInstalled) {
+        console.log(chalk.green('  ✓ Figma Desktop detected'));
+    }
+    else {
+        console.log(chalk.yellow('  ⚠ Figma Desktop not found — install from https://figma.com/downloads'));
+    }
+}
+//# sourceMappingURL=systemCheck.js.map

package/dist/steps/systemCheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemCheck.js","sourceRoot":"","sources":["../../src/steps/systemCheck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAExE,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAE/C,qBAAqB;IACrB,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/D,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,WAAW,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,WAAW,yBAAyB,CAAC,CAAC,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,sBAAsB;IACtB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,IAAI,cAAc,GAAG,KAAK,CAAC;IAE3B,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,cAAc,GAAG,EAAE,CAAC,UAAU,CAAC,yBAAyB,CAAC,CAAC;IAC5D,CAAC;SAAM,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,cAAc,GAAG,EAAE,CAAC,UAAU,CAC5B,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,CACvD,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,wEAAwE,CAAC,CAAC,CAAC;IACtG,CAAC;AACH,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,3 @@
+export declare function readJsonConfig(filePath: string): Record<string, unknown>;
+export declare function writeJsonConfig(filePath: string, data: Record<string, unknown>): void;
+export declare function mergeServerConfig(existing: Record<string, unknown>, token: string): Record<string, unknown>;

package/dist/utils/config.js

@@ -0,0 +1,36 @@
+import fs from 'node:fs';
+import path from 'node:path';
+export function readJsonConfig(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+export function writeJsonConfig(filePath, data) {
+    const dir = path.dirname(filePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+export function mergeServerConfig(existing, token) {
+    const mcpServers = existing.mcpServers || {};
+    return {
+        ...existing,
+        mcpServers: {
+            ...mcpServers,
+            'figma-console': {
+                command: 'npx',
+                args: ['-y', 'figma-console-mcp@latest'],
+                env: {
+                    FIGMA_ACCESS_TOKEN: token,
+                    ENABLE_MCP_APPS: 'true',
+                },
+            },
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAA4B,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAA6B;IAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAAiC,EACjC,KAAa;IAEb,MAAM,UAAU,GAAI,QAAQ,CAAC,UAAsC,IAAI,EAAE,CAAC;IAC1E,OAAO;QACL,GAAG,QAAQ;QACX,UAAU,EAAE;YACV,GAAG,UAAU;YACb,eAAe,EAAE;gBACf,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,0BAA0B,CAAC;gBACxC,GAAG,EAAE;oBACH,kBAAkB,EAAE,KAAK;oBACzB,eAAe,EAAE,MAAM;iBACxB;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/manifest.d.ts

@@ -0,0 +1 @@
+export declare function resolveManifestPath(): string | null;

package/dist/utils/manifest.js

@@ -0,0 +1,76 @@
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+export function resolveManifestPath() {
+    return resolveViaNpx() ?? resolveViaNpmRoot();
+}
+function resolveViaNpx() {
+    // 1. Try running the command itself
+    for (let attempt = 0; attempt < 2; attempt++) {
+        try {
+            const result = spawnSync("npx", ["-y", "figma-console-mcp@latest", "--print-path"], {
+                encoding: "utf-8",
+                timeout: 10_000,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            const output = (result.stdout || "") + (result.stderr || "");
+            if (output) {
+                const match = output.match(/[^\s"']+\/manifest\.json|[^\s"']+\\manifest\.json/);
+                if (match)
+                    return match[0].trim();
+            }
+        }
+        catch {
+            // retry
+        }
+    }
+    // 2. Fallback: Search the NPX cache directly
+    try {
+        const npxDir = join(homedir(), ".npm", "_npx");
+        if (existsSync(npxDir)) {
+            const result = spawnSync("find", [npxDir, "-name", "manifest.json"], {
+                encoding: "utf-8",
+                timeout: 5_000,
+            });
+            if (result.stdout) {
+                const found = result.stdout
+                    .split("\n")
+                    .find((line) => line.includes("figma-console-mcp") &&
+                    line.includes("figma-desktop-bridge"));
+                if (found)
+                    return found.trim();
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+function resolveViaNpmRoot() {
+    const subpath = join("figma-console-mcp", "figma-desktop-bridge", "manifest.json");
+    for (const args of [["-g"], []]) {
+        try {
+            const result = spawnSync("npm", ["root", ...args], {
+                encoding: "utf-8",
+                timeout: 5_000,
+                stdio: ["ignore", "pipe", "ignore"],
+            });
+            if (result.status === 0 && result.stdout) {
+                const root = result.stdout.trim().split("\n")[0];
+                if (root) {
+                    const candidate = join(root, subpath);
+                    if (existsSync(candidate)) {
+                        return candidate;
+                    }
+                }
+            }
+        }
+        catch {
+            // try next
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/utils/manifest.js.map

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

package/dist/utils/platform.d.ts

@@ -0,0 +1,6 @@
+export type Platform = 'macos' | 'windows' | 'linux';
+export declare function getPlatform(): Platform;
+export declare function getHomedir(): string;
+export declare function resolveConfigPath(...segments: string[]): string;
+export declare function getAppDataPath(): string;
+export declare function getLocalAppDataPath(): string;

package/dist/utils/platform.js

@@ -0,0 +1,32 @@
+import os from 'node:os';
+import path from 'node:path';
+export function getPlatform() {
+    switch (os.platform()) {
+        case 'darwin':
+            return 'macos';
+        case 'win32':
+            return 'windows';
+        default:
+            return 'linux';
+    }
+}
+export function getHomedir() {
+    return os.homedir();
+}
+export function resolveConfigPath(...segments) {
+    return path.join(getHomedir(), ...segments);
+}
+export function getAppDataPath() {
+    const platform = getPlatform();
+    if (platform === 'windows') {
+        return process.env.APPDATA || path.join(getHomedir(), 'AppData', 'Roaming');
+    }
+    if (platform === 'macos') {
+        return path.join(getHomedir(), 'Library', 'Application Support');
+    }
+    return path.join(getHomedir(), '.config');
+}
+export function getLocalAppDataPath() {
+    return process.env.LOCALAPPDATA || path.join(getHomedir(), 'AppData', 'Local');
+}
+//# sourceMappingURL=platform.js.map

package/dist/utils/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,UAAU,WAAW;IACzB,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;QACtB,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,OAAO,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,CAAC,OAAO,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAG,QAAkB;IACrD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,qBAAqB,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AACjF,CAAC"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "figma-console-mcp-cli",
+  "version": "0.1.0",
+  "description": "Interactive CLI to configure Figma Console MCP across AI coding clients",
+  "type": "module",
+  "bin": {
+    "figma-console-mcp-cli": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "tsx": "^4.19.3",
+    "typescript": "^5.7.3"
+  }
+}