figma-rust-mcp 3.2.12 → 4.0.0

package/bin/{figma-mcp.js → figma-rust-mcp.js}

@@ -1,591 +1,668 @@
-#!/usr/bin/env node
-
-/**
- * Figma MCP - NPX Binary Runner
- * Automatically detects platform/arch, downloads prebuilt Rust binary from GitHub Releases,
- * caches it locally, and executes it transparently.
- */
-
-import { spawn, execSync, execFileSync } from 'node:child_process';
-import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
-import https from 'node:https';
-import http from 'node:http';
-import { fileURLToPath } from 'node:url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// Read package.json version
-const pkgPath = path.resolve(__dirname, '../package.json');
-let pkgVersion = null;
-let repoOwner = 'BuiHung1612';
-let repoName = 'figma-mcp';
-
-try {
-  if (fs.existsSync(pkgPath)) {
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-    if (pkg.version) pkgVersion = pkg.version;
-    if (pkg.repository && typeof pkg.repository.url === 'string') {
-      const m = pkg.repository.url.match(/github\.com[/:]([^/]+)\/([^/.]+)/);
-      if (m) {
-        repoOwner = m[1];
-        repoName = m[2];
-      }
-    }
-  }
-} catch (_) {}
-if (!pkgVersion) throw new Error(`Cannot read package version from ${pkgPath}`);
-
-function getPlatformArch() {
-  const platform = process.platform;
-  const arch = process.arch;
-
-  let osName = '';
-  let archName = '';
-  let ext = 'tar.gz';
-  let binName = 'figma-mcp';
-
-  if (platform === 'darwin') {
-    osName = 'macos';
-    archName = arch === 'arm64' ? 'arm64' : 'x86_64';
-  } else if (platform === 'linux') {
-    osName = 'linux';
-    archName = arch === 'arm64' ? 'arm64' : 'x86_64';
-  } else if (platform === 'win32') {
-    osName = 'windows';
-    archName = 'x86_64';
-    ext = 'zip';
-    binName = 'figma-mcp.exe';
-  } else {
-    throw new Error(`Unsupported operating system: ${platform}`);
-  }
-
-  const assetName = `figma-mcp-${osName}-${archName}.${ext}`;
-  return { osName, archName, ext, binName, assetName };
-}
-
-function getCacheDir(version) {
-  const platform = process.platform;
-  let baseCache = '';
-
-  if (platform === 'win32') {
-    baseCache = process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local');
-  } else if (platform === 'darwin') {
-    baseCache = path.join(os.homedir(), 'Library', 'Caches');
-  } else {
-    baseCache = process.env.XDG_CACHE_HOME || path.join(os.homedir(), '.cache');
-  }
-
-  return path.join(baseCache, 'figma-mcp', `v${version}`);
-}
-
-function downloadFile(url, destPath) {
-  return new Promise((resolve, reject) => {
-    const followRedirects = (currentUrl, redirectCount = 0) => {
-      if (redirectCount > 10) {
-        reject(new Error('Too many redirects while downloading binary'));
-        return;
-      }
-
-      const client = currentUrl.startsWith('https') ? https : http;
-      client.get(currentUrl, { headers: { 'User-Agent': 'figma-mcp-npx' } }, (res) => {
-        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-          followRedirects(res.headers.location, redirectCount + 1);
-          return;
-        }
-
-        if (res.statusCode !== 200) {
-          reject(new Error(`Failed to download binary: HTTP ${res.statusCode} from ${currentUrl}`));
-          return;
-        }
-
-        const fileStream = fs.createWriteStream(destPath);
-        res.pipe(fileStream);
-
-        fileStream.on('finish', () => {
-          fileStream.close(() => resolve());
-        });
-
-        fileStream.on('error', (err) => {
-          fs.unlink(destPath, () => {});
-          reject(err);
-        });
-      }).on('error', (err) => {
-        reject(err);
-      });
-    };
-
-    followRedirects(url);
-  });
-}
-
-function extractArchive(archivePath, targetDir, ext) {
-  fs.mkdirSync(targetDir, { recursive: true });
-
-  if (ext === 'zip') {
-    try {
-      execSync(`tar -xf "${archivePath}" -C "${targetDir}"`, { stdio: 'pipe' });
-      return;
-    } catch (_) {
-      execSync(`powershell -Command "Expand-Archive -Path '${archivePath}' -DestinationPath '${targetDir}' -Force"`, { stdio: 'pipe' });
-      return;
-    }
-  }
-
-  execSync(`tar -xzf "${archivePath}" -C "${targetDir}"`, { stdio: 'pipe' });
-}
-
-async function findOrDownloadBinary() {
-  if (process.env.FIGMA_MCP_BIN && fs.existsSync(process.env.FIGMA_MCP_BIN)) {
-    return process.env.FIGMA_MCP_BIN;
-  }
-
-  const localRelease = path.resolve(__dirname, '../target/release/figma-mcp' + (process.platform === 'win32' ? '.exe' : ''));
-  const localDebug = path.resolve(__dirname, '../target/debug/figma-mcp' + (process.platform === 'win32' ? '.exe' : ''));
-
-  if (fs.existsSync(localRelease)) return localRelease;
-  if (fs.existsSync(localDebug)) return localDebug;
-
-  const info = getPlatformArch();
-  const cacheDir = getCacheDir(pkgVersion);
-  const cachedBin = path.join(cacheDir, info.binName);
-
-  if (fs.existsSync(cachedBin)) {
-    if (process.platform !== 'win32') {
-      try { fs.chmodSync(cachedBin, 0o755); } catch (_) {}
-    }
-    return cachedBin;
-  }
-
-  fs.mkdirSync(cacheDir, { recursive: true });
-  const archivePath = path.join(cacheDir, info.assetName);
-
-  const releaseUrl = `https://github.com/${repoOwner}/${repoName}/releases/download/v${pkgVersion}/${info.assetName}`;
-  const latestUrl = `https://github.com/${repoOwner}/${repoName}/releases/latest/download/${info.assetName}`;
-
-  process.stderr.write(`\x1b[36m[figma-mcp]\x1b[0m Downloading binary for ${info.osName}-${info.archName} (v${pkgVersion})...\n`);
-
-  try {
-    await downloadFile(releaseUrl, archivePath);
-  } catch (err) {
-    process.stderr.write(`\x1b[33m[figma-mcp]\x1b[0m Release v${pkgVersion} not found, trying latest release...\n`);
-    try {
-      await downloadFile(latestUrl, archivePath);
-    } catch (fallbackErr) {
-      throw new Error(`Failed to download figma-mcp prebuilt binary:\n  - ${err.message}\n  - ${fallbackErr.message}\n\nPlease verify your internet connection or build from source: cargo build --release`);
-    }
-  }
-
-  try {
-    extractArchive(archivePath, cacheDir, info.ext);
-  } finally {
-    try { fs.unlinkSync(archivePath); } catch (_) {}
-  }
-
-  if (!fs.existsSync(cachedBin)) {
-    const files = fs.readdirSync(cacheDir, { recursive: true });
-    const found = files.find(f => path.basename(f) === info.binName);
-    if (found) {
-      const foundPath = path.join(cacheDir, found);
-      fs.renameSync(foundPath, cachedBin);
-    } else {
-      throw new Error(`Binary ${info.binName} not found inside downloaded archive`);
-    }
-  }
-
-  if (process.platform !== 'win32') {
-    fs.chmodSync(cachedBin, 0o755);
-  }
-
-  process.stderr.write(`\x1b[32m[figma-mcp]\x1b[0m Ready! (cached in ${cacheDir})\n\n`);
-  return cachedBin;
-}
-
-// ─── SERVICE MANAGEMENT ───────────────────────────────────────────────────────
-
-/**
- * Install figma-mcp as a background service that auto-starts on login.
- * - macOS: LaunchAgent plist (~/.config/figma-mcp/launchd.plist → ~/Library/LaunchAgents/)
- * - Linux: systemd user service (~/.config/systemd/user/figma-mcp.service)
- * - Windows: Task Scheduler XML via schtasks
- */
-async function installService(binPath) {
-  const platform = process.platform;
-  const nodeExec = process.execPath;
-  const scriptPath = path.resolve(__filename);
-
-  if (platform === 'darwin') {
-    const plistLabel = 'io.github.figma-mcp.server';
-    const plistDir = path.join(os.homedir(), 'Library', 'LaunchAgents');
-    const plistPath = path.join(plistDir, `${plistLabel}.plist`);
-
-    fs.mkdirSync(plistDir, { recursive: true });
-
-    const logDir = path.join(os.homedir(), 'Library', 'Logs', 'figma-mcp');
-    fs.mkdirSync(logDir, { recursive: true });
-
-    const plist = `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key>
-  <string>${plistLabel}</string>
-  <key>ProgramArguments</key>
-  <array>
-    <string>${binPath}</string>
-    <string>--server</string>
-  </array>
-  <key>RunAtLoad</key>
-  <true/>
-  <key>KeepAlive</key>
-  <true/>
-  <key>StandardOutPath</key>
-  <string>${path.join(logDir, 'stdout.log')}</string>
-  <key>StandardErrorPath</key>
-  <string>${path.join(logDir, 'stderr.log')}</string>
-  <key>ThrottleInterval</key>
-  <integer>5</integer>
-</dict>
-</plist>`;
-
-    fs.writeFileSync(plistPath, plist, 'utf8');
-
-    // Unload first (ignore error if not loaded)
-    try { execSync(`launchctl unload "${plistPath}" 2>/dev/null`, { stdio: 'pipe' }); } catch (_) {}
-    execSync(`launchctl load -w "${plistPath}"`, { stdio: 'inherit' });
-
-    console.log(`\x1b[32m✓ figma-mcp service installed!\x1b[0m`);
-    console.log(`  Plist: ${plistPath}`);
-    console.log(`  Logs:  ${logDir}/stdout.log`);
-    console.log(`\n\x1b[36mThe server will now start automatically on every login.\x1b[0m`);
-    console.log(`\x1b[36mTo uninstall: npx figma-mcp --uninstall-service\x1b[0m`);
-
-  } else if (platform === 'linux') {
-    const serviceDir = path.join(os.homedir(), '.config', 'systemd', 'user');
-    const servicePath = path.join(serviceDir, 'figma-mcp.service');
-
-    fs.mkdirSync(serviceDir, { recursive: true });
-
-    const unit = `[Unit]
-Description=Figma MCP Bridge Server
-After=network.target
-
-[Service]
-Type=simple
-ExecStart=${binPath} --server
-Restart=on-failure
-RestartSec=5
-
-[Install]
-WantedBy=default.target
-`;
-
-    fs.writeFileSync(servicePath, unit, 'utf8');
-    execSync(`systemctl --user daemon-reload`, { stdio: 'inherit' });
-    execSync(`systemctl --user enable --now figma-mcp`, { stdio: 'inherit' });
-
-    console.log(`\x1b[32m✓ figma-mcp systemd user service installed!\x1b[0m`);
-    console.log(`  Service: ${servicePath}`);
-    console.log(`\n\x1b[36mThe server will now start automatically on every login.\x1b[0m`);
-    console.log(`\x1b[36mTo uninstall: npx figma-mcp --uninstall-service\x1b[0m`);
-
-  } else if (platform === 'win32') {
-    const taskName = 'FigmaMCPServer';
-    // Use schtasks to create a task that runs at login
-    // The native launcher detaches the server and redirects output to a log file.
-    const taskCommand = `"${binPath}" --background`;
-    execFileSync('schtasks', ['/Create', '/F', '/TN', taskName,
-      '/TR', taskCommand, '/SC', 'ONLOGON'], { stdio: 'inherit', windowsHide: true });
-
-    // Start it immediately too
-    try { execSync(`schtasks /Run /TN "${taskName}"`, { stdio: 'pipe' }); } catch (_) {}
-
-    console.log(`\x1b[32m✓ figma-rust-mcp Windows Task installed!\x1b[0m`);
-    console.log(`  Task: ${taskName}`);
-    console.log(`\n\x1b[36mThe server will now start automatically on every login.\x1b[0m`);
-    console.log(`\x1b[36mTo uninstall: npx figma-rust-mcp --uninstall-service\x1b[0m`);
-
-  } else {
-    console.error(`\x1b[31mUnsupported platform: ${platform}\x1b[0m`);
-    process.exit(1);
-  }
-}
-
-/**
- * Uninstall the background service.
- */
-async function uninstallService() {
-  const platform = process.platform;
-
-  if (platform === 'darwin') {
-    const plistLabel = 'io.github.figma-mcp.server';
-    const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', `${plistLabel}.plist`);
-
-    if (!fs.existsSync(plistPath)) {
-      console.log(`\x1b[33mService not found at ${plistPath}\x1b[0m`);
-      process.exit(0);
-    }
-
-    try { execSync(`launchctl unload -w "${plistPath}"`, { stdio: 'inherit' }); } catch (_) {}
-    try { execSync(`pkill -f figma-mcp 2>/dev/null`, { stdio: 'pipe' }); } catch (_) {}
-    fs.unlinkSync(plistPath);
-
-    console.log(`\x1b[32m✓ figma-rust-mcp service uninstalled.\x1b[0m`);
-
-  } else if (platform === 'linux') {
-    try { execSync(`systemctl --user disable --now figma-mcp`, { stdio: 'inherit' }); } catch (_) {}
-    const servicePath = path.join(os.homedir(), '.config', 'systemd', 'user', 'figma-mcp.service');
-    if (fs.existsSync(servicePath)) fs.unlinkSync(servicePath);
-    try { execSync(`systemctl --user daemon-reload`, { stdio: 'inherit' }); } catch (_) {}
-
-    console.log(`\x1b[32m✓ figma-rust-mcp service uninstalled.\x1b[0m`);
-
-  } else if (platform === 'win32') {
-    const taskName = 'FigmaMCPServer';
-    try { execSync(`schtasks /Delete /F /TN "${taskName}"`, { stdio: 'inherit' }); } catch (_) {}
-
-    console.log(`\x1b[32m✓ figma-rust-mcp Windows Task removed.\x1b[0m`);
-
-  } else {
-    console.error(`\x1b[31mUnsupported platform: ${platform}\x1b[0m`);
-    process.exit(1);
-  }
-}
-
-/**
- * Check if the service is currently installed.
- */
-function isServiceInstalled() {
-  const platform = process.platform;
-  if (platform === 'darwin') {
-    const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', 'io.github.figma-mcp.server.plist');
-    return fs.existsSync(plistPath);
-  } else if (platform === 'linux') {
-    const servicePath = path.join(os.homedir(), '.config', 'systemd', 'user', 'figma-mcp.service');
-    return fs.existsSync(servicePath);
-  } else if (platform === 'win32') {
-    try {
-      execSync('schtasks /Query /TN "FigmaMCPServer"', { stdio: 'pipe' });
-      return true;
-    } catch (_) { return false; }
-  }
-  return false;
-}
-
-function setupPlugin(customDir) {
-  const pluginDir = customDir || path.join(os.homedir(), '.figma-mcp', 'plugin');
-  const sourcePluginDir = path.resolve(__dirname, '../plugin');
-
-  fs.mkdirSync(pluginDir, { recursive: true });
-
-  const files = ['manifest.json', 'code.js', 'ui.html', 'icon16.png', 'icon32.png'];
-  for (const f of files) {
-    const src = path.join(sourcePluginDir, f);
-    const dest = path.join(pluginDir, f);
-    if (fs.existsSync(src)) {
-      fs.copyFileSync(src, dest);
-    }
-  }
-
-  const manifestPath = path.join(pluginDir, 'manifest.json');
-  console.log(`\n\x1b[32m✓ Figma MCP Dynamic Thin Plugin installed to:\x1b[0m`);
-  console.log(`  \x1b[36m${manifestPath}\x1b[0m\n`);
-  console.log(`\x1b[1mTo connect Figma (Do this ONCE forever):\x1b[0m`);
-  console.log(`  1. Open Figma Desktop`);
-  console.log(`  2. Go to Plugins → Development → Import plugin from manifest...`);
-  console.log(`  3. Select: ${manifestPath}`);
-  console.log(`  4. Done! All future updates load dynamically from figma-mcp without file re-imports.\n`);
-  return manifestPath;
-}
-
-function isNewer(latest, current) {
-  const pLatest = latest.split('.').map(n => parseInt(n, 10) || 0);
-  const pCurrent = current.split('.').map(n => parseInt(n, 10) || 0);
-  for (let i = 0; i < 3; i++) {
-    if ((pLatest[i] || 0) > (pCurrent[i] || 0)) return true;
-    if ((pLatest[i] || 0) < (pCurrent[i] || 0)) return false;
-  }
-  return false;
-}
-
-function checkForUpdatesAsync() {
-  const updateStateFile = path.join(os.homedir(), '.figma-mcp', 'update-check.json');
-  try {
-    if (fs.existsSync(updateStateFile)) {
-      const state = JSON.parse(fs.readFileSync(updateStateFile, 'utf8'));
-      const now = Date.now();
-      if (state.lastChecked && (now - state.lastChecked < 6 * 3600 * 1000)) {
-        if (state.latestVersion && isNewer(state.latestVersion, pkgVersion)) {
-          process.stderr.write(`\n\x1b[36m⚡ Update available: v${pkgVersion} → v${state.latestVersion} (Run: npx figma-rust-mcp --upgrade)\x1b[0m\n\n`);
-        }
-        return;
-      }
-    }
-  } catch (_) {}
-
-  const req = https.get('https://registry.npmjs.org/figma-rust-mcp/latest', {
-    headers: { 'User-Agent': 'figma-mcp-updater' },
-    timeout: 2000
-  }, (res) => {
-    let data = '';
-    res.on('data', chunk => { data += chunk; });
-    res.on('end', () => {
-      try {
-        if (res.statusCode === 200) {
-          const json = JSON.parse(data);
-          const latest = json.version;
-          fs.mkdirSync(path.join(os.homedir(), '.figma-mcp'), { recursive: true });
-          fs.writeFileSync(updateStateFile, JSON.stringify({
-            lastChecked: Date.now(),
-            latestVersion: latest
-          }, null, 2));
-          if (latest && isNewer(latest, pkgVersion)) {
-            process.stderr.write(`\n\x1b[36m⚡ Update available: v${pkgVersion} → v${latest}\x1b[0m\n\x1b[36m   Run: npx figma-rust-mcp --upgrade\x1b[0m\n\n`);
-          }
-        }
-      } catch (_) {}
-    });
-  });
-  req.on('error', () => {});
-  req.on('timeout', () => req.destroy());
-}
-
-async function upgrade() {
-  console.log('\x1b[36m[figma-mcp]\x1b[0m Checking for updates and upgrading figma-rust-mcp...');
-  try {
-    execSync('npm install -g figma-rust-mcp@latest', { stdio: 'inherit' });
-    console.log('\x1b[32m✓ Upgraded figma-rust-mcp to latest version.\x1b[0m');
-    setupPlugin();
-    if (isServiceInstalled()) {
-      console.log('\x1b[36mUpdating background service binary...\x1b[0m');
-      const binPath = await findOrDownloadBinary();
-      await installService(binPath);
-    }
-  } catch (err) {
-    console.log('\x1b[33mTip: Run directly with latest version:\x1b[0m\n  npx -y figma-rust-mcp@latest\n');
-  }
-}
-
-function setupAlias() {
-  const platform = process.platform;
-  if (platform === 'win32') {
-    console.log('\x1b[33mOn Windows, install globally for direct command access:\x1b[0m\n  npm install -g figma-rust-mcp\n');
-    return;
-  }
-
-  const shellRc = process.env.SHELL && process.env.SHELL.includes('zsh')
-    ? path.join(os.homedir(), '.zshrc')
-    : path.join(os.homedir(), '.bashrc');
-
-  const aliasLine = "alias figma-mcp='npx figma-rust-mcp'";
-  try {
-    let content = fs.existsSync(shellRc) ? fs.readFileSync(shellRc, 'utf8') : '';
-    if (!content.includes('alias figma-mcp=')) {
-      fs.appendFileSync(shellRc, `\n# Figma MCP alias\n${aliasLine}\n`);
-      console.log(`\x1b[32m✓ Added alias to ${shellRc}:\x1b[0m`);
-      console.log(`  ${aliasLine}`);
-      console.log(`\nRun \x1b[36msource ${shellRc}\x1b[0m to start using \x1b[1mfigma-mcp\x1b[0m command directly!`);
-    } else {
-      console.log(`\x1b[32m✓ Alias already exists in ${shellRc}\x1b[0m`);
-    }
-  } catch (err) {
-    console.error(`Failed to configure alias: ${err.message}`);
-  }
-}
-
-// ─── MAIN ─────────────────────────────────────────────────────────────────────
-
-async function main() {
-  const args = process.argv.slice(2);
-
-  if (args.includes('--upgrade') || args.includes('--update')) {
-    await upgrade();
-    return;
-  }
-
-  if (args.includes('--alias')) {
-    setupAlias();
-    return;
-  }
-
-  if (args.includes('--setup-plugin') || args.includes('--export-plugin') || args.includes('--setup')) {
-    const customDir = args.find(a => !a.startsWith('-') && a !== '--setup-plugin' && a !== '--export-plugin' && a !== '--setup');
-    setupPlugin(customDir);
-    return;
-  }
-
-  if (args.includes('--install-service')) {
-    try {
-      setupPlugin();
-      const binPath = await findOrDownloadBinary();
-      await installService(binPath);
-    } catch (err) {
-      console.error(`\x1b[31m[figma-rust-mcp error]\x1b[0m ${err.message}`);
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (args.includes('--uninstall-service')) {
-    try {
-      await uninstallService();
-    } catch (err) {
-      console.error(`\x1b[31m[figma-rust-mcp error]\x1b[0m ${err.message}`);
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (args.includes('--service-status')) {
-    const installed = isServiceInstalled();
-    if (installed) {
-      console.log('\x1b[32m✓ figma-rust-mcp service is installed.\x1b[0m');
-      console.log('  To uninstall: npx figma-rust-mcp --uninstall-service');
-    } else {
-      console.log('\x1b[33m✗ figma-rust-mcp service is NOT installed.\x1b[0m');
-      console.log('  To install:   npx figma-rust-mcp --install-service');
-    }
-    return;
-  }
-
-  // Non-blocking auto update check
-  checkForUpdatesAsync();
-
-  try {
-    const binPath = await findOrDownloadBinary();
-
-    const child = spawn(binPath, args, {
-      stdio: 'inherit',
-      env: process.env,
-    });
-
-    child.on('error', (err) => {
-      console.error(`[figma-mcp] Failed to start binary: ${err.message}`);
-      process.exit(1);
-    });
-
-    child.on('exit', (code, signal) => {
-      if (signal) {
-        process.kill(process.pid, signal);
-      } else {
-        process.exit(code ?? 0);
-      }
-    });
-
-    const forwardSignal = (sig) => {
-      if (child && !child.killed) {
-        child.kill(sig);
-      }
-    };
-
-    process.on('SIGINT', () => forwardSignal('SIGINT'));
-    process.on('SIGTERM', () => forwardSignal('SIGTERM'));
-  } catch (err) {
-    console.error(`\x1b[31m[figma-mcp error]\x1b[0m ${err.message}`);
-    process.exit(1);
-  }
-}
-
-main();
+#!/usr/bin/env node
+
+/**
+ * Figma Rust MCP - NPX Binary Runner
+ * Automatically detects platform/arch, downloads prebuilt Rust binary from GitHub Releases,
+ * caches it locally, and executes it transparently.
+ */
+
+import { spawn, execSync, execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import https from 'node:https';
+import http from 'node:http';
+import { fileURLToPath } from 'node:url';
+import { createInterface } from 'node:readline/promises';
+import { configureAgent, detectAgents } from './agent-config.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Read package.json version
+const pkgPath = path.resolve(__dirname, '../package.json');
+let pkgVersion = null;
+let repoOwner = 'BuiHung1612';
+let repoName = 'figma-rust-mcp';
+
+try {
+  if (fs.existsSync(pkgPath)) {
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    if (pkg.version) pkgVersion = pkg.version;
+    if (pkg.repository && typeof pkg.repository.url === 'string') {
+      const m = pkg.repository.url.match(/github\.com[/:]([^/]+)\/([^/.]+)/);
+      if (m) {
+        repoOwner = m[1];
+        repoName = m[2];
+      }
+    }
+  }
+} catch (_) {}
+if (!pkgVersion) throw new Error(`Cannot read package version from ${pkgPath}`);
+
+function getPlatformArch() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  let osName = '';
+  let archName = '';
+  let ext = 'tar.gz';
+  let binName = 'figma-rust-mcp';
+
+  if (platform === 'darwin') {
+    osName = 'macos';
+    archName = arch === 'arm64' ? 'arm64' : 'x86_64';
+  } else if (platform === 'linux') {
+    osName = 'linux';
+    archName = arch === 'arm64' ? 'arm64' : 'x86_64';
+  } else if (platform === 'win32') {
+    osName = 'windows';
+    archName = 'x86_64';
+    ext = 'zip';
+    binName = 'figma-rust-mcp.exe';
+  } else {
+    throw new Error(`Unsupported operating system: ${platform}`);
+  }
+
+  const assetName = `figma-rust-mcp-${osName}-${archName}.${ext}`;
+  return { osName, archName, ext, binName, assetName };
+}
+
+function getCacheDir(version) {
+  const platform = process.platform;
+  let baseCache = '';
+
+  if (platform === 'win32') {
+    baseCache = process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local');
+  } else if (platform === 'darwin') {
+    baseCache = path.join(os.homedir(), 'Library', 'Caches');
+  } else {
+    baseCache = process.env.XDG_CACHE_HOME || path.join(os.homedir(), '.cache');
+  }
+
+  return path.join(baseCache, 'figma-rust-mcp', `v${version}`);
+}
+
+function downloadFile(url, destPath) {
+  return new Promise((resolve, reject) => {
+    const followRedirects = (currentUrl, redirectCount = 0) => {
+      if (redirectCount > 10) {
+        reject(new Error('Too many redirects while downloading binary'));
+        return;
+      }
+
+      const client = currentUrl.startsWith('https') ? https : http;
+      client.get(currentUrl, { headers: { 'User-Agent': 'figma-rust-mcp-npx' } }, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          followRedirects(res.headers.location, redirectCount + 1);
+          return;
+        }
+
+        if (res.statusCode !== 200) {
+          reject(new Error(`Failed to download binary: HTTP ${res.statusCode} from ${currentUrl}`));
+          return;
+        }
+
+        const fileStream = fs.createWriteStream(destPath);
+        res.pipe(fileStream);
+
+        fileStream.on('finish', () => {
+          fileStream.close(() => resolve());
+        });
+
+        fileStream.on('error', (err) => {
+          fs.unlink(destPath, () => {});
+          reject(err);
+        });
+      }).on('error', (err) => {
+        reject(err);
+      });
+    };
+
+    followRedirects(url);
+  });
+}
+
+function extractArchive(archivePath, targetDir, ext) {
+  fs.mkdirSync(targetDir, { recursive: true });
+
+  if (ext === 'zip') {
+    try {
+      execSync(`tar -xf "${archivePath}" -C "${targetDir}"`, { stdio: 'pipe' });
+      return;
+    } catch (_) {
+      execSync(`powershell -Command "Expand-Archive -Path '${archivePath}' -DestinationPath '${targetDir}' -Force"`, { stdio: 'pipe' });
+      return;
+    }
+  }
+
+  execSync(`tar -xzf "${archivePath}" -C "${targetDir}"`, { stdio: 'pipe' });
+}
+
+async function findOrDownloadBinary() {
+  if (process.env.FIGMA_RUST_MCP_BIN && fs.existsSync(process.env.FIGMA_RUST_MCP_BIN)) {
+    return process.env.FIGMA_RUST_MCP_BIN;
+  }
+
+  const localRelease = path.resolve(__dirname, '../target/release/figma-rust-mcp' + (process.platform === 'win32' ? '.exe' : ''));
+  const localDebug = path.resolve(__dirname, '../target/debug/figma-rust-mcp' + (process.platform === 'win32' ? '.exe' : ''));
+
+  if (fs.existsSync(localRelease)) return localRelease;
+  if (fs.existsSync(localDebug)) return localDebug;
+
+  const info = getPlatformArch();
+  const cacheDir = getCacheDir(pkgVersion);
+  const cachedBin = path.join(cacheDir, info.binName);
+
+  if (fs.existsSync(cachedBin)) {
+    if (process.platform !== 'win32') {
+      try { fs.chmodSync(cachedBin, 0o755); } catch (_) {}
+    }
+    return cachedBin;
+  }
+
+  fs.mkdirSync(cacheDir, { recursive: true });
+  const archivePath = path.join(cacheDir, info.assetName);
+
+  const releaseUrl = `https://github.com/${repoOwner}/${repoName}/releases/download/v${pkgVersion}/${info.assetName}`;
+  const latestUrl = `https://github.com/${repoOwner}/${repoName}/releases/latest/download/${info.assetName}`;
+
+  process.stderr.write(`\x1b[36m[figma-rust-mcp]\x1b[0m Downloading binary for ${info.osName}-${info.archName} (v${pkgVersion})...\n`);
+
+  try {
+    await downloadFile(releaseUrl, archivePath);
+  } catch (err) {
+    process.stderr.write(`\x1b[33m[figma-rust-mcp]\x1b[0m Release v${pkgVersion} not found, trying latest release...\n`);
+    try {
+      await downloadFile(latestUrl, archivePath);
+    } catch (fallbackErr) {
+      throw new Error(`Failed to download figma-rust-mcp prebuilt binary:\n  - ${err.message}\n  - ${fallbackErr.message}\n\nPlease verify your internet connection or build from source: cargo build --release`);
+    }
+  }
+
+  try {
+    extractArchive(archivePath, cacheDir, info.ext);
+  } finally {
+    try { fs.unlinkSync(archivePath); } catch (_) {}
+  }
+
+  if (!fs.existsSync(cachedBin)) {
+    const files = fs.readdirSync(cacheDir, { recursive: true });
+    const found = files.find(f => path.basename(f) === info.binName);
+    if (found) {
+      const foundPath = path.join(cacheDir, found);
+      fs.renameSync(foundPath, cachedBin);
+    } else {
+      throw new Error(`Binary ${info.binName} not found inside downloaded archive`);
+    }
+  }
+
+  if (process.platform !== 'win32') {
+    fs.chmodSync(cachedBin, 0o755);
+  }
+
+  process.stderr.write(`\x1b[32m[figma-rust-mcp]\x1b[0m Ready! (cached in ${cacheDir})\n\n`);
+  return cachedBin;
+}
+
+// ─── SERVICE MANAGEMENT ───────────────────────────────────────────────────────
+
+/**
+ * Install figma-rust-mcp as a background service that auto-starts on login.
+ * - macOS: LaunchAgent plist (~/.config/figma-rust-mcp/launchd.plist → ~/Library/LaunchAgents/)
+ * - Linux: systemd user service (~/.config/systemd/user/figma-rust-mcp.service)
+ * - Windows: Task Scheduler XML via schtasks
+ */
+async function installService(binPath) {
+  removeLegacyService();
+  const platform = process.platform;
+
+  if (platform === 'darwin') {
+    const plistLabel = 'io.github.figma-rust-mcp.server';
+    const plistDir = path.join(os.homedir(), 'Library', 'LaunchAgents');
+    const plistPath = path.join(plistDir, `${plistLabel}.plist`);
+
+    fs.mkdirSync(plistDir, { recursive: true });
+
+    const logDir = path.join(os.homedir(), 'Library', 'Logs', 'figma-rust-mcp');
+    fs.mkdirSync(logDir, { recursive: true });
+
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${plistLabel}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${binPath}</string>
+    <string>--server</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${path.join(logDir, 'stdout.log')}</string>
+  <key>StandardErrorPath</key>
+  <string>${path.join(logDir, 'stderr.log')}</string>
+  <key>ThrottleInterval</key>
+  <integer>5</integer>
+</dict>
+</plist>`;
+
+    fs.writeFileSync(plistPath, plist, 'utf8');
+
+    // Unload first (ignore error if not loaded)
+    try { execSync(`launchctl unload "${plistPath}" 2>/dev/null`, { stdio: 'pipe' }); } catch (_) {}
+    execSync(`launchctl load -w "${plistPath}"`, { stdio: 'inherit' });
+
+    console.log(`\x1b[32m✓ figma-rust-mcp service installed!\x1b[0m`);
+    console.log(`  Plist: ${plistPath}`);
+    console.log(`  Logs:  ${logDir}/stdout.log`);
+    console.log(`\n\x1b[36mThe server will now start automatically on every login.\x1b[0m`);
+    console.log(`\x1b[36mTo uninstall: npx figma-rust-mcp --uninstall-service\x1b[0m`);
+
+  } else if (platform === 'linux') {
+    const serviceDir = path.join(os.homedir(), '.config', 'systemd', 'user');
+    const servicePath = path.join(serviceDir, 'figma-rust-mcp.service');
+
+    fs.mkdirSync(serviceDir, { recursive: true });
+
+    const unit = `[Unit]
+Description=Figma Rust MCP Bridge Server
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=${binPath} --server
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=default.target
+`;
+
+    fs.writeFileSync(servicePath, unit, 'utf8');
+    execSync(`systemctl --user daemon-reload`, { stdio: 'inherit' });
+    execSync(`systemctl --user enable --now figma-rust-mcp`, { stdio: 'inherit' });
+
+    console.log(`\x1b[32m✓ figma-rust-mcp systemd user service installed!\x1b[0m`);
+    console.log(`  Service: ${servicePath}`);
+    console.log(`\n\x1b[36mThe server will now start automatically on every login.\x1b[0m`);
+    console.log(`\x1b[36mTo uninstall: npx figma-rust-mcp --uninstall-service\x1b[0m`);
+
+  } else if (platform === 'win32') {
+    const taskName = 'FigmaRustMCPServer';
+    // Use schtasks to create a task that runs at login
+    // The native launcher detaches the server and redirects output to a log file.
+    const taskCommand = `"${binPath}" --background`;
+    execFileSync('schtasks', ['/Create', '/F', '/TN', taskName,
+      '/TR', taskCommand, '/SC', 'ONLOGON'], { stdio: 'inherit', windowsHide: true });
+
+    // Start it immediately too
+    try { execSync(`schtasks /Run /TN "${taskName}"`, { stdio: 'pipe' }); } catch (_) {}
+
+    console.log(`\x1b[32m✓ figma-rust-mcp Windows Task installed!\x1b[0m`);
+    console.log(`  Task: ${taskName}`);
+    console.log(`\n\x1b[36mThe server will now start automatically on every login.\x1b[0m`);
+    console.log(`\x1b[36mTo uninstall: npx figma-rust-mcp --uninstall-service\x1b[0m`);
+
+  } else {
+    console.error(`\x1b[31mUnsupported platform: ${platform}\x1b[0m`);
+    process.exit(1);
+  }
+}
+
+/**
+ * Uninstall the background service.
+ */
+async function uninstallService() {
+  const platform = process.platform;
+
+  if (platform === 'darwin') {
+    const plistLabel = 'io.github.figma-rust-mcp.server';
+    const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', `${plistLabel}.plist`);
+
+    if (fs.existsSync(plistPath)) {
+      try { execSync(`launchctl unload -w "${plistPath}"`, { stdio: 'inherit' }); } catch (_) {}
+      try { execSync(`pkill -f figma-rust-mcp 2>/dev/null`, { stdio: 'pipe' }); } catch (_) {}
+      fs.unlinkSync(plistPath);
+    }
+    removeLegacyService();
+
+    console.log(`\x1b[32m✓ figma-rust-mcp service uninstalled.\x1b[0m`);
+
+  } else if (platform === 'linux') {
+    try { execSync(`systemctl --user disable --now figma-rust-mcp`, { stdio: 'inherit' }); } catch (_) {}
+    const servicePath = path.join(os.homedir(), '.config', 'systemd', 'user', 'figma-rust-mcp.service');
+    if (fs.existsSync(servicePath)) fs.unlinkSync(servicePath);
+    try { execSync(`systemctl --user daemon-reload`, { stdio: 'inherit' }); } catch (_) {}
+    removeLegacyService();
+
+    console.log(`\x1b[32m✓ figma-rust-mcp service uninstalled.\x1b[0m`);
+
+  } else if (platform === 'win32') {
+    const taskName = 'FigmaRustMCPServer';
+    try { execSync(`schtasks /Delete /F /TN "${taskName}"`, { stdio: 'inherit' }); } catch (_) {}
+    removeLegacyService();
+
+    console.log(`\x1b[32m✓ figma-rust-mcp Windows Task removed.\x1b[0m`);
+
+  } else {
+    console.error(`\x1b[31mUnsupported platform: ${platform}\x1b[0m`);
+    process.exit(1);
+  }
+}
+
+function removeLegacyService() {
+  if (process.platform === 'darwin') {
+    const legacyPlist = path.join(os.homedir(), 'Library', 'LaunchAgents', 'io.github.figma-mcp.server.plist');
+    if (fs.existsSync(legacyPlist)) {
+      try { execSync(`launchctl unload -w "${legacyPlist}"`, { stdio: 'pipe' }); } catch (_) {}
+      try { execSync('pkill -x figma-mcp', { stdio: 'pipe' }); } catch (_) {}
+      fs.unlinkSync(legacyPlist);
+    }
+  } else if (process.platform === 'linux') {
+    const legacyUnit = path.join(os.homedir(), '.config', 'systemd', 'user', 'figma-mcp.service');
+    if (fs.existsSync(legacyUnit)) {
+      try { execSync('systemctl --user disable --now figma-mcp', { stdio: 'pipe' }); } catch (_) {}
+      fs.unlinkSync(legacyUnit);
+      try { execSync('systemctl --user daemon-reload', { stdio: 'pipe' }); } catch (_) {}
+    }
+  } else if (process.platform === 'win32') {
+    try { execSync('schtasks /End /TN "FigmaMCPServer"', { stdio: 'pipe' }); } catch (_) {}
+    try { execSync('schtasks /Delete /F /TN "FigmaMCPServer"', { stdio: 'pipe' }); } catch (_) {}
+  }
+}
+
+/**
+ * Check if the service is currently installed.
+ */
+function isServiceInstalled() {
+  const platform = process.platform;
+  if (platform === 'darwin') {
+    const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', 'io.github.figma-rust-mcp.server.plist');
+    return fs.existsSync(plistPath) || fs.existsSync(path.join(os.homedir(), 'Library', 'LaunchAgents', 'io.github.figma-mcp.server.plist'));
+  } else if (platform === 'linux') {
+    const servicePath = path.join(os.homedir(), '.config', 'systemd', 'user', 'figma-rust-mcp.service');
+    return fs.existsSync(servicePath) || fs.existsSync(path.join(os.homedir(), '.config', 'systemd', 'user', 'figma-mcp.service'));
+  } else if (platform === 'win32') {
+    try {
+      execSync('schtasks /Query /TN "FigmaRustMCPServer"', { stdio: 'pipe' });
+      return true;
+    } catch (_) {
+      try { execSync('schtasks /Query /TN "FigmaMCPServer"', { stdio: 'pipe' }); return true; }
+      catch (_) { return false; }
+    }
+  }
+  return false;
+}
+
+function setupPlugin(customDir) {
+  const pluginDir = customDir || path.join(os.homedir(), '.figma-rust-mcp', 'plugin');
+  const sourcePluginDir = path.resolve(__dirname, '../plugin');
+
+  fs.mkdirSync(pluginDir, { recursive: true });
+
+  const files = ['manifest.json', 'code.js', 'ui.html', 'icon16.png', 'icon32.png'];
+  for (const f of files) {
+    const src = path.join(sourcePluginDir, f);
+    const dest = path.join(pluginDir, f);
+    if (fs.existsSync(src)) {
+      fs.copyFileSync(src, dest);
+    }
+  }
+
+  const manifestPath = path.join(pluginDir, 'manifest.json');
+  console.log(`\n\x1b[32m✓ Figma Rust MCP Dynamic Thin Plugin installed to:\x1b[0m`);
+  console.log(`  \x1b[36m${manifestPath}\x1b[0m\n`);
+  console.log(`\x1b[1mTo connect Figma (Do this ONCE forever):\x1b[0m`);
+  console.log(`  1. Open Figma Desktop`);
+  console.log(`  2. Go to Plugins → Development → Import plugin from manifest...`);
+  console.log(`  3. Select: ${manifestPath}`);
+  console.log(`  4. Done! All future updates load dynamically from figma-rust-mcp without file re-imports.\n`);
+  return manifestPath;
+}
+
+function isNewer(latest, current) {
+  const pLatest = latest.split('.').map(n => parseInt(n, 10) || 0);
+  const pCurrent = current.split('.').map(n => parseInt(n, 10) || 0);
+  for (let i = 0; i < 3; i++) {
+    if ((pLatest[i] || 0) > (pCurrent[i] || 0)) return true;
+    if ((pLatest[i] || 0) < (pCurrent[i] || 0)) return false;
+  }
+  return false;
+}
+
+function checkForUpdatesAsync() {
+  const updateStateFile = path.join(os.homedir(), '.figma-rust-mcp', 'update-check.json');
+  try {
+    if (fs.existsSync(updateStateFile)) {
+      const state = JSON.parse(fs.readFileSync(updateStateFile, 'utf8'));
+      const now = Date.now();
+      if (state.lastChecked && (now - state.lastChecked < 6 * 3600 * 1000)) {
+        if (state.latestVersion && isNewer(state.latestVersion, pkgVersion)) {
+          process.stderr.write(`\n\x1b[36m⚡ Update available: v${pkgVersion} → v${state.latestVersion} (Run: npx figma-rust-mcp --upgrade)\x1b[0m\n\n`);
+        }
+        return;
+      }
+    }
+  } catch (_) {}
+
+  const req = https.get('https://registry.npmjs.org/figma-rust-mcp/latest', {
+    headers: { 'User-Agent': 'figma-rust-mcp-updater' },
+    timeout: 2000
+  }, (res) => {
+    let data = '';
+    res.on('data', chunk => { data += chunk; });
+    res.on('end', () => {
+      try {
+        if (res.statusCode === 200) {
+          const json = JSON.parse(data);
+          const latest = json.version;
+          fs.mkdirSync(path.join(os.homedir(), '.figma-rust-mcp'), { recursive: true });
+          fs.writeFileSync(updateStateFile, JSON.stringify({
+            lastChecked: Date.now(),
+            latestVersion: latest
+          }, null, 2));
+          if (latest && isNewer(latest, pkgVersion)) {
+            process.stderr.write(`\n\x1b[36m⚡ Update available: v${pkgVersion} → v${latest}\x1b[0m\n\x1b[36m   Run: npx figma-rust-mcp --upgrade\x1b[0m\n\n`);
+          }
+        }
+      } catch (_) {}
+    });
+  });
+  req.on('error', () => {});
+  req.on('timeout', () => req.destroy());
+}
+
+async function upgrade() {
+  console.log('\x1b[36m[figma-rust-mcp]\x1b[0m Checking for updates and upgrading figma-rust-mcp...');
+  try {
+    execSync('npm install -g figma-rust-mcp@latest', { stdio: 'inherit' });
+    console.log('\x1b[32m✓ Upgraded figma-rust-mcp to latest version.\x1b[0m');
+    setupPlugin();
+    if (isServiceInstalled()) {
+      console.log('\x1b[36mUpdating background service binary...\x1b[0m');
+      const binPath = await findOrDownloadBinary();
+      await installService(binPath);
+    }
+  } catch (err) {
+    console.log('\x1b[33mTip: Run directly with latest version:\x1b[0m\n  npx -y figma-rust-mcp@latest\n');
+  }
+}
+
+async function setupMenu() {
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    console.log(`Figma Rust MCP setup options:\n  npx -y figma-rust-mcp@latest --install-service  Install plugin and background service\n  npx -y figma-rust-mcp@latest --setup-plugin     Install/update plugin only\n  npx -y figma-rust-mcp@latest --service-status    Check background service`);
+    return;
+  }
+
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  const agents = detectAgents();
+  try {
+    console.log(`\n\x1b[1mFigma Rust MCP setup\x1b[0m  v${pkgVersion}\n\n  1) Quick setup — plugin + background service + detected agents\n  2) Install/update Figma plugin only\n  3) Start server in this terminal\n  4) Configure detected agents\n  5) Check background service\n  6) Upgrade package and refresh setup\n  7) Remove background service\n  0) Exit\n`);
+    const choice = (await rl.question('Choose an option [1]: ')).trim() || '1';
+    switch (choice) {
+      case '1': {
+        setupPlugin();
+        const binPath = await findOrDownloadBinary();
+        await installService(binPath);
+        await configureDetectedAgents(rl, agents);
+        break;
+      }
+      case '2': setupPlugin(); break;
+      case '3': await runBinary(['--server']); break;
+      case '4': await configureDetectedAgents(rl, agents); break;
+      case '5': console.log(isServiceInstalled() ? '✓ Background service is installed.' : '✗ Background service is not installed.'); break;
+      case '6': await upgrade(); break;
+      case '7': await uninstallService(); break;
+      case '0': break;
+      default: console.log('Unknown option. Run --init to try again.');
+    }
+  } finally {
+    rl.close();
+  }
+}
+
+async function configureDetectedAgents(rl, agents) {
+  if (!agents.length) {
+    console.log('No supported AI coding agents were detected. Install an agent and rerun --init.');
+    return;
+  }
+
+  console.log('\nDetected agents:');
+  agents.forEach((agent, index) => console.log(`  ${index + 1}) ${agent.label} — ${agent.configPath}`));
+  const answer = (await rl.question('Configure which agents? Enter numbers separated by commas, a=all, Enter=skip [a]: ')).trim().toLowerCase();
+  if (answer === '') return;
+  const selected = answer === 'a'
+    ? agents
+    : [...new Set(answer.split(',').map(value => Number(value.trim()) - 1))]
+      .filter(index => Number.isInteger(index) && index >= 0 && index < agents.length)
+      .map(index => agents[index]);
+  if (!selected.length) {
+    console.log('No valid agent selection; MCP configuration was not changed.');
+    return;
+  }
+
+  for (const agent of selected) {
+    try {
+      const changed = configureAgent(agent);
+      console.log(`  ${changed ? '✓ Configured' : '✓ Already configured'} ${agent.label}`);
+    } catch (err) {
+      console.error(`  ✗ Could not configure ${agent.label}: ${err.message}`);
+    }
+  }
+  console.log('Restart or reload the selected agent to connect it to Figma Rust MCP.');
+}
+
+function runBinary(args) {
+  return findOrDownloadBinary().then(binPath => new Promise((resolve, reject) => {
+    const child = spawn(binPath, args, { stdio: 'inherit', env: process.env });
+    child.on('error', reject);
+    child.on('exit', (code, signal) => signal ? process.kill(process.pid, signal) : resolve(code ?? 0));
+    for (const sig of ['SIGINT', 'SIGTERM']) process.once(sig, () => child.kill(sig));
+  }));
+}
+
+function setupAlias() {
+  const platform = process.platform;
+  if (platform === 'win32') {
+    console.log('\x1b[33mOn Windows, install globally for direct command access:\x1b[0m\n  npm install -g figma-rust-mcp\n');
+    return;
+  }
+
+  const shellRc = process.env.SHELL && process.env.SHELL.includes('zsh')
+    ? path.join(os.homedir(), '.zshrc')
+    : path.join(os.homedir(), '.bashrc');
+
+  const aliasLine = "alias figma-rust-mcp='npx figma-rust-mcp'";
+  try {
+    let content = fs.existsSync(shellRc) ? fs.readFileSync(shellRc, 'utf8') : '';
+    if (!content.includes('alias figma-rust-mcp=')) {
+      fs.appendFileSync(shellRc, `\n# Figma Rust MCP alias\n${aliasLine}\n`);
+      console.log(`\x1b[32m✓ Added alias to ${shellRc}:\x1b[0m`);
+      console.log(`  ${aliasLine}`);
+      console.log(`\nRun \x1b[36msource ${shellRc}\x1b[0m to start using \x1b[1mfigma-rust-mcp\x1b[0m command directly!`);
+    } else {
+      console.log(`\x1b[32m✓ Alias already exists in ${shellRc}\x1b[0m`);
+    }
+  } catch (err) {
+    console.error(`Failed to configure alias: ${err.message}`);
+  }
+}
+
+// ─── MAIN ─────────────────────────────────────────────────────────────────────
+
+async function main() {
+  const args = process.argv.slice(2);
+
+  if (args.includes('--init') || args.includes('--configure')) {
+    try { await setupMenu(); }
+    catch (err) { console.error(`\x1b[31m[figma-rust-mcp error]\x1b[0m ${err.message}`); process.exit(1); }
+    return;
+  }
+
+  if (args.includes('--upgrade') || args.includes('--update')) {
+    await upgrade();
+    return;
+  }
+
+  if (args.includes('--alias')) {
+    setupAlias();
+    return;
+  }
+
+  if (args.includes('--setup-plugin') || args.includes('--export-plugin') || args.includes('--setup')) {
+    const customDir = args.find(a => !a.startsWith('-') && a !== '--setup-plugin' && a !== '--export-plugin' && a !== '--setup');
+    setupPlugin(customDir);
+    return;
+  }
+
+  if (args.includes('--install-service')) {
+    try {
+      setupPlugin();
+      const binPath = await findOrDownloadBinary();
+      await installService(binPath);
+    } catch (err) {
+      console.error(`\x1b[31m[figma-rust-mcp error]\x1b[0m ${err.message}`);
+      process.exit(1);
+    }
+    return;
+  }
+
+  if (args.includes('--uninstall-service')) {
+    try {
+      await uninstallService();
+    } catch (err) {
+      console.error(`\x1b[31m[figma-rust-mcp error]\x1b[0m ${err.message}`);
+      process.exit(1);
+    }
+    return;
+  }
+
+  if (args.includes('--service-status')) {
+    const installed = isServiceInstalled();
+    if (installed) {
+      console.log('\x1b[32m✓ figma-rust-mcp service is installed.\x1b[0m');
+      console.log('  To uninstall: npx figma-rust-mcp --uninstall-service');
+    } else {
+      console.log('\x1b[33m✗ figma-rust-mcp service is NOT installed.\x1b[0m');
+      console.log('  To install:   npx figma-rust-mcp --install-service');
+    }
+    return;
+  }
+
+  // Non-blocking auto update check
+  checkForUpdatesAsync();
+
+  try {
+    process.exit(await runBinary(args));
+  } catch (err) {
+    console.error(`\x1b[31m[figma-rust-mcp error]\x1b[0m ${err.message}`);
+    process.exit(1);
+  }
+}
+
+main();