hermes-launch 1.1.0 → 2.0.0

package/bin/hermes-launch.js

@@ -1,640 +1,196 @@
 #!/usr/bin/env node
 /**
- * hermes-launch — one command to install, configure, and run Hermes Agent.
+ * hermes-launch — starts the web onboarding wizard and opens your browser.
+ *
+ * The web server handles everything: install, config, tools, dashboard.
+ * This CLI just launches it and gets out of the way.
  *
  * Usage:
- *   npx hermes-launch              # full interactive flow
- *   npx hermes-launch --quick      # skip prompts, use smart defaults
- *   npx hermes-launch --dashboard  # just start the web dashboard
+ *   npx hermes-launch              # start wizard, open browser
+ *   npx hermes-launch --port 8080  # custom port
+ *   npx hermes-launch --stop       # stop running instance
+ *   npx hermes-launch --status     # check if running
  *   npx hermes-launch --help       # this message
  */
 
-import { execSync, spawn } from 'child_process';
-import { readFileSync, existsSync } from 'fs';
-import { homedir, platform as osPlatform } from 'os';
-import { resolve } from 'path';
-import { createInterface } from 'readline';
+import { execSync, spawn } from 'node:child_process';
+import { readFileSync, existsSync, writeFileSync } from 'node:fs';
+import { homedir, platform as osPlatform } from 'node:os';
+import { resolve } from 'node:path';
 
-const PLATFORM = osPlatform();                     // win32, darwin, linux
+const PLATFORM = osPlatform();
 const IS_WIN = PLATFORM === 'win32';
 const IS_MAC = PLATFORM === 'darwin';
-const IS_LINUX = PLATFORM === 'linux';
-
-const HERMES_HOME = IS_WIN
-  ? resolve(process.env.USERPROFILE || homedir(), '.hermes')
-  : resolve(homedir(), '.hermes');
-const CONFIG_PATH = resolve(HERMES_HOME, 'config.yaml');
-const INSTALL_URL = 'https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh';
-
-// Windows: node strips ansi codes in cmd/powershell by default, but keep for
-// terminals that support them (Windows Terminal, VS Code terminal, etc.)
-const USE_COLOR = !IS_WIN || (process.env.TERM_PROGRAM || '').includes('vscode') || process.env.WT_SESSION;
-const BOLD = USE_COLOR ? '\x1b[1m' : '';
-const DIM = USE_COLOR ? '\x1b[2m' : '';
-const GREEN = USE_COLOR ? '\x1b[32m' : '';
-const YELLOW = USE_COLOR ? '\x1b[33m' : '';
-const RED = USE_COLOR ? '\x1b[31m' : '';
-const CYAN = USE_COLOR ? '\x1b[36m' : '';
-const RESET = USE_COLOR ? '\x1b[0m' : '';
-
-// ——— helpers ———
-
-function printBanner() {
-  console.log(`
-  ${CYAN}╔════════════════════════════════════════╗${RESET}
-  ${CYAN}║${RESET}  🐚  Hermes Launch                  ${CYAN}║${RESET}
-  ${CYAN}║${RESET}  ${DIM}zero-to-AI-agent in seconds${RESET}       ${CYAN}║${RESET}
-  ${CYAN}╚════════════════════════════════════════╝${RESET}
-  `);
-}
-
-function ask(query) {
-  const rl = createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise(resolve => rl.question(query, ans => { rl.close(); resolve(ans.trim()); }));
-}
+const PID_FILE = resolve(homedir(), '.hermes-launch.pid');
 
 function run(cmd, opts = {}) {
-  const defaults = {
-    stdio: opts.silent ? 'pipe' : 'inherit',
-    timeout: 120_000,
-    shell: IS_WIN ? true : false,         // Windows needs shell for PATH resolution
-    ...opts,
-  };
   try {
-    const out = execSync(cmd, defaults);
+    const out = execSync(cmd, { stdio: 'pipe', timeout: opts.timeout || 30_000, shell: IS_WIN, ...opts });
     return { ok: true, out: out?.toString()?.trim() || '' };
   } catch (e) {
     return { ok: false, out: e.stderr?.toString()?.trim() || e.message };
   }
 }
 
-function runPwsh(cmd, opts = {}) {
-  // Run a PowerShell command — used on Windows for winget, etc.
-  return run(`powershell -NoProfile -Command "${cmd}"`, opts);
-}
-
-function spinner(ms) {
-  return new Promise(resolve => setTimeout(resolve, ms));
-}
-
-function step(msg) {
-  process.stdout.write(`  ${CYAN}→${RESET} ${msg} ... `);
-  return {
-    ok: () => { process.stdout.write(`${GREEN}done${RESET}\n`); },
-    skip: (reason) => { process.stdout.write(`${YELLOW}skipped${RESET} (${reason})\n`); },
-    fail: (err) => { process.stdout.write(`${RED}failed${RESET}\n    ${DIM}${err}${RESET}\n`); },
-  };
-}
-
-function printSummary(info) {
-  console.log(`\n${BOLD}${GREEN}  ✅  Hermes Agent is live!${RESET}\n`);
-  console.log(`  ${BOLD}Web Dashboard${RESET}`);
-  console.log(`    ${CYAN}http://localhost:${info.port || 9119}${RESET}\n`);
-  console.log(`  ${BOLD}CLI${RESET}`);
-  console.log(`    ${CYAN}hermes${RESET}              interactive chat`);
-  console.log(`    ${CYAN}hermes chat -q "..."${RESET}  one-shot query`);
-  console.log(`    ${CYAN}hermes --continue${RESET}    resume last session\n`);
-  console.log(`  ${BOLD}Key commands${RESET}`);
-  console.log(`    ${CYAN}hermes model${RESET}         change model/provider`);
-  console.log(`    ${CYAN}hermes gateway setup${RESET}  connect Telegram/Discord`);
-  console.log(`    ${CYAN}hermes tools list${RESET}     see available tools`);
-  console.log(`    ${CYAN}hermes doctor${RESET}         health check\n`);
-  console.log(`  ${BOLD}Docs${RESET}`);
-  console.log(`    ${CYAN}https://hermes-agent.nousresearch.com/docs${RESET}\n`);
-  if (info.messaging) {
-    console.log(`  ${BOLD}Messaging${RESET}`);
-    for (const [platform, status] of Object.entries(info.messaging)) {
-      console.log(`    ${platform}: ${status}`);
-    }
-    console.log();
-  }
-  if (info.windowsNote) {
-    console.log(`  ${YELLOW}${info.windowsNote}${RESET}\n`);
-  }
-}
-
-// ——— platform detection ———
-
-function detectPackageManager() {
-  if (IS_WIN) {
-    // winget ships with Windows 11 and recent Win10
-    if (run('winget --version', { silent: true }).ok) return 'winget';
-    if (run('choco --version', { silent: true }).ok) return 'choco';
-    if (run('scoop --version', { silent: true }).ok) return 'scoop';
-    return null;
-  }
-  if (IS_MAC) {
-    if (run('brew --version', { silent: true }).ok) return 'brew';
-    return null;
-  }
-  // Linux
-  if (run('apt-get --version', { silent: true }).ok) return 'apt';
-  if (run('dnf --version', { silent: true }).ok) return 'dnf';
-  if (run('pacman --version', { silent: true }).ok) return 'pacman';
-  return null;
-}
-
-function winHasWsl() {
-  return run('wsl --version', { silent: true }).ok || run('wsl -l', { silent: true }).ok;
-}
-
-// ——— prerequisite checks + auto-install ———
-
-async function checkPython() {
-  // Windows uses "python" and "py", not "python3"
-  const pyCandidates = IS_WIN
-    ? ['python', 'py -3', 'python3']
-    : ['python3.14', 'python3.13', 'python3.12', 'python3.11', 'python3.10', 'python3'];
-
-  for (const bin of pyCandidates) {
-    const r = run(`${bin} --version`, { silent: true });
-    if (r.ok) {
-      const match = r.out.match(/(\d+)\.(\d+)/);
-      if (match) {
-        const major = parseInt(match[1]), minor = parseInt(match[2]);
-        if (major >= 3 && minor >= 10) {
-          return { ok: true, bin, version: `${major}.${minor}` };
-        }
-      }
-    }
-  }
-  return { ok: false, bin: null, version: null };
-}
-
-async function installPython(pkgMan) {
-  const s = step('Installing Python 3.12+');
+function openBrowser(url) {
   try {
     if (IS_WIN) {
-      if (pkgMan === 'winget') {
-        const r = runPwsh('winget install --accept-source-agreements --accept-package-agreements Python.Python.3.12', { timeout: 180_000 });
-        if (!r.ok) throw new Error(r.out);
-      } else if (pkgMan === 'choco') {
-        run('choco install python --yes', { timeout: 180_000 });
-      } else if (pkgMan === 'scoop') {
-        run('scoop install python', { timeout: 180_000 });
-      } else {
-        s.fail('No package manager found. Install Python from https://python.org');
-        return false;
-      }
-      // Refresh PATH so we can find python immediately
-      process.env.PATH = `${process.env.USERPROFILE}\\AppData\\Local\\Programs\\Python\\Python312\\;${process.env.USERPROFILE}\\AppData\\Local\\Programs\\Python\\Python312\\Scripts\\;${process.env.PATH}`;
+      execSync(`start "" "${url}"`, { shell: 'cmd.exe', timeout: 5000, stdio: 'ignore' });
     } else if (IS_MAC) {
-      run('brew install python@3.12', { timeout: 180_000 });
-      // brew python3.12 is often keg-only — symlink or use full path
-      run('brew link --overwrite python@3.12', { silent: true, timeout: 30_000 });
-    } else {
-      // Linux
-      if (pkgMan === 'apt') {
-        run('apt-get update -qq && apt-get install -y python3 python3-pip python3-venv', { timeout: 180_000 });
-      } else if (pkgMan === 'dnf') {
-        run('dnf install -y python3 python3-pip', { timeout: 180_000 });
-      } else if (pkgMan === 'pacman') {
-        run('pacman -S --noconfirm python python-pip', { timeout: 180_000 });
-      }
-    }
-    s.ok();
-    return true;
-  } catch (e) {
-    s.fail(e.message);
-    return false;
-  }
-}
-
-async function checkCurl() {
-  const candidates = IS_WIN ? ['curl.exe', 'curl'] : ['curl'];
-  for (const bin of candidates) {
-    if (run(`${bin} --version`, { silent: true }).ok) return { ok: true, bin };
-  }
-  return { ok: false, bin: null };
-}
-
-async function installCurl(pkgMan) {
-  const s = step('Installing curl');
-  try {
-    if (IS_WIN) {
-      // Windows 10+ has curl.exe built-in. If missing, use winget.
-      if (pkgMan === 'winget') {
-        runPwsh('winget install --accept-source-agreements cURL.cURL', { timeout: 120_000 });
-      } else if (pkgMan === 'choco') {
-        run('choco install curl --yes', { timeout: 120_000 });
-      }
-    } else {
-      // macOS/Linux — curl should be present but just in case
-      run('command -v curl || (apt-get install -y curl 2>/dev/null || yum install -y curl 2>/dev/null)', { timeout: 120_000 });
-    }
-    s.ok();
-    return true;
-  } catch (e) {
-    s.fail(e.message);
-    return false;
-  }
-}
-
-async function checkGit() {
-  const candidates = IS_WIN ? ['git.exe', 'git'] : ['git'];
-  for (const bin of candidates) {
-    if (run(`${bin} --version`, { silent: true }).ok) return { ok: true, bin };
-  }
-  return { ok: false, bin: null };
-}
-
-async function installGit(pkgMan) {
-  const s = step('Installing git');
-  try {
-    if (IS_WIN) {
-      if (pkgMan === 'winget') {
-        runPwsh('winget install --accept-source-agreements --accept-package-agreements Git.Git', { timeout: 180_000 });
-      } else if (pkgMan === 'choco') {
-        run('choco install git --yes', { timeout: 180_000 });
-      } else if (pkgMan === 'scoop') {
-        run('scoop install git', { timeout: 180_000 });
-      }
-    } else {
-      run('command -v git || (apt-get install -y git 2>/dev/null || brew install git 2>/dev/null)', { timeout: 120_000 });
-    }
-    s.ok();
-    return true;
-  } catch (e) {
-    s.fail(e.message);
-    return false;
-  }
-}
-
-async function checkPrereqs() {
-  const s = step('Checking prerequisites');
-
-  const pkgMan = detectPackageManager();
-
-  // 1. Python
-  const py = await checkPython();
-  if (!py.ok) {
-    if (pkgMan) {
-      process.stdout.write(`\n`);
-      const installed = await installPython(pkgMan);
-      if (!installed) {
-        process.exit(1);
-      }
-    } else {
-      s.fail('Python 3.10+ is required but not found');
-      if (IS_WIN) {
-        console.log(`  ${YELLOW}Install: https://python.org or run: winget install Python.Python.3.12${RESET}`);
-      } else if (IS_MAC) {
-        console.log(`  ${YELLOW}Install: brew install python@3.12${RESET}`);
-      } else {
-        console.log(`  ${YELLOW}Install: sudo apt install python3 python3-pip python3-venv${RESET}`);
-      }
-      process.exit(1);
-    }
-  }
-
-  // 2. curl
-  const curlCheck = await checkCurl();
-  if (!curlCheck.ok) {
-    if (pkgMan) {
-      await installCurl(pkgMan);
-    } else {
-      s.fail('curl is required');
-      process.exit(1);
-    }
-  }
-
-  // 3. git
-  const gitCheck = await checkGit();
-  if (!gitCheck.ok) {
-    if (pkgMan) {
-      await installGit(pkgMan);
-    } else {
-      s.fail('git is required');
-      process.exit(1);
-    }
-  }
-
-  s.ok();
-  return { ...py, pkgMan, curlBin: curlCheck.bin || '', gitBin: gitCheck.bin || '' };
-}
-
-// ——— Hermes install ———
-
-async function installHermes(quick, platformInfo) {
-  const s = step('Checking Hermes installation');
-
-  // On Windows, try both "hermes" and "hermes.exe"
-  const hermesCheck = IS_WIN
-    ? (run('hermes --version', { silent: true }).ok || run('hermes.exe --version', { silent: true }).ok)
-    : run('hermes --version', { silent: true }).ok;
-
-  if (hermesCheck) {
-    const ver = run('hermes --version', { silent: true }).ok
-      ? run('hermes --version', { silent: true }).out
-      : 'installed';
-    s.skip(`${ver} already installed`);
-    return true;
-  }
-
-  if (!quick) {
-    console.log();
-    const ans = await ask(`  Hermes not found. Install it now? [Y/n] `);
-    if (ans.toLowerCase() === 'n') {
-      console.log(`  ${YELLOW}Aborted.${RESET}`);
-      process.exit(0);
-    }
-  }
-
-  const si = step('Downloading and installing Hermes');
-
-  if (IS_WIN) {
-    // Windows: install via pip (the bash script won't work without WSL)
-    try {
-      // Ensure pip is available
-      const pyBin = platformInfo.bin || 'python';
-      run(`${pyBin} -m pip install --upgrade pip`, { silent: true, timeout: 60_000 });
-
-      const r = run(`${pyBin} -m pip install hermes-agent`, { timeout: 180_000 });
-      if (!r.ok) throw new Error(r.out);
-
-      // After pip install, check if "hermes" command is available
-      // On Windows, scripts may be in %APPDATA%\Python\Scripts or %USERPROFILE%\.local\bin
-      const pathsToAdd = [
-        resolve(process.env.APPDATA || '', 'Python', 'Scripts'),
-        resolve(homedir(), '.local', 'bin'),
-      ];
-      for (const p of pathsToAdd) {
-        if (!process.env.PATH?.includes(p)) {
-          process.env.PATH = `${p};${process.env.PATH}`;
-        }
-      }
-
-      si.ok();
-      return true;
-    } catch (e) {
-      // If pip fails, suggest WSL which is the recommended path
-      si.fail(e.message);
-      if (winHasWsl()) {
-        console.log(`\n  ${YELLOW}Pip install failed. Try installing inside WSL instead:${RESET}`);
-        console.log(`    ${CYAN}wsl -d Ubuntu -e bash -c "curl -fsSL ${INSTALL_URL} | bash"${RESET}\n`);
-      } else {
-        console.log(`\n  ${YELLOW}Install WSL + Ubuntu, then run this inside WSL:${RESET}`);
-        console.log(`    ${CYAN}curl -fsSL ${INSTALL_URL} | bash${RESET}`);
-        console.log(`  ${YELLOW}Or install WSL first:${RESET}`);
-        console.log(`    ${CYAN}wsl --install${RESET}\n`);
-      }
-      process.exit(1);
-    }
-  } else {
-    // macOS / Linux
-    try {
-      const cmd = `curl -fsSL ${INSTALL_URL} | bash`;
-      const result = run(cmd, { timeout: 180_000, silent: false });
-      if (!result.ok) {
-        si.fail(result.out);
-        process.exit(1);
-      }
-      si.ok();
-      return true;
-    } catch (e) {
-      si.fail(e.message);
-      process.exit(1);
-    }
-  }
-}
-
-// ——— config ———
-
-async function checkConfig(quick) {
-  const s = step('Checking Hermes configuration');
-
-  if (!existsSync(CONFIG_PATH)) {
-    s.skip('no config yet — will be generated');
-    return false;
-  }
-
-  const raw = readFileSync(CONFIG_PATH, 'utf-8');
-
-  // Check if config has a model set (not commented out)
-  const hasModel = /^model:\s*\n/m.test(raw);
-
-  if (!hasModel || raw.includes('default: ""') || raw.includes("default: ''")) {
-    s.skip('needs model configuration');
-    return false;
-  }
-
-  s.ok();
-  return true;
-}
-
-async function runSetup(quick) {
-  if (quick) {
-    const s = step('Running headless setup');
-    const setCmds = [
-      'hermes tools enable web terminal file skills session_search delegate_task memory clarify vision 2>/dev/null || ver>nul',
-      `hermes config set display.streaming.enabled true 2>/dev/null || cmd /c ver>nul`,
-    ];
-    for (const cmd of setCmds) run(cmd, { silent: true });
-    s.ok();
-    return;
-  }
-
-  console.log(`\n  ${BOLD}Let's configure your Hermes Agent.${RESET}\n`);
-  console.log(`  ${DIM}(You can skip any step and configure later with \`hermes setup\`)${RESET}\n`);
-
-  const doSetup = await ask(`  Run the Hermes setup wizard? (recommended) [Y/n] `);
-  if (doSetup.toLowerCase() !== 'n') {
-    const s = step('Running setup wizard');
-    try {
-      const result = run('hermes setup', { stdio: 'inherit', timeout: 300_000 });
-      if (!result.ok) s.fail(result.out);
-      else s.ok();
-    } catch (e) {
-      s.fail(e.message);
-    }
-  } else {
-    const s = step('Applying minimal configuration');
-    run('hermes tools enable web terminal file skills session_search delegate_task memory 2>/dev/null || ver>nul', { silent: true });
-    s.skip('minimal config applied');
-  }
-}
-
-async function enableToolsets(quick) {
-  const s = step('Enabling tool sets');
-
-  const toolsets = ['web', 'terminal', 'file', 'skills', 'session_search', 'delegate_task', 'memory', 'vision', 'tts', 'clarify'];
-
-  // Windows: hermes commands use shell redirect
-  const noop = IS_WIN ? 'ver>nul' : '2>/dev/null || true';
-  for (const t of toolsets) {
-    run(`hermes tools enable ${t} ${noop}`, { silent: true });
-  }
-
-  run(`hermes config set display.streaming.enabled true ${noop}`, { silent: true });
-  s.ok();
-}
-
-async function startDashboard(quick) {
-  const s = step('Starting web dashboard');
-  const port = '9119';
-
-  const noop = IS_WIN ? 'ver>nul' : '2>/dev/null || true';
-
-  const statusCheck = run(`hermes dashboard --status ${noop}`, { silent: true });
-  if (statusCheck.ok && statusCheck.out.length > 0 && !statusCheck.out.includes('No running')) {
-    s.skip('already running');
-    return { port, alreadyRunning: true };
-  }
-
-  try {
-    const proc = spawn(
-      'hermes',
-      ['dashboard', '--port', port, '--tui', quick ? '--no-open' : ''],
-      {
-        stdio: 'inherit',
-        detached: false,
-        shell: IS_WIN,
-        env: { ...process.env },
-      }
-    );
-
-    await spinner(3000);
-
-    // Verify — use curl or curl.exe
-    const curlBin = IS_WIN ? 'curl.exe -s -o nul -w "%{http_code}"' : 'curl -s -o /dev/null -w "%{http_code}"';
-    const verify = run(`${curlBin} http://127.0.0.1:${port}/ 2>/dev/null || echo 0`, { silent: true });
-    if (verify.out === '0') {
-      s.skip('dashboard launched in background');
+      execSync(`open "${url}"`, { timeout: 5000, stdio: 'ignore' });
     } else {
-      s.ok();
-    }
-
-    return { port, alreadyRunning: false };
-  } catch (e) {
-    s.fail(e.message);
-    return { port, alreadyRunning: false, error: e.message };
-  }
-}
-
-async function checkGatewayStatus() {
-  const s = step('Checking messaging gateway');
-  const noop = IS_WIN ? 'ver>nul' : '2>/dev/null || true';
-  const result = run(`hermes gateway status ${noop}`, { silent: true });
-  if (result.ok) {
-    const out = result.out;
-    const hasTelegram = out.includes('telegram') && (out.includes('running') || out.includes('connected'));
-    const hasDiscord = out.includes('discord') && (out.includes('running') || out.includes('connected'));
-    const platforms = [];
-    if (hasTelegram) platforms.push('telegram');
-    if (hasDiscord) platforms.push('discord');
-    if (platforms.length > 0) {
-      s.ok();
-      return platforms;
+      execSync(`xdg-open "${url}" 2>/dev/null || sensible-browser "${url}" 2>/dev/null || true`, { timeout: 5000, stdio: 'ignore' });
     }
-  }
-  s.skip('not configured');
-  return [];
+  } catch (_) {}
 }
 
-// ——— main ———
-
 async function main() {
   const args = process.argv.slice(2);
   const flags = {
-    quick: args.includes('--quick') || args.includes('-q'),
-    dashboard: args.includes('--dashboard'),
+    port: parseInt(args.find(a => a.startsWith('--port='))?.split('=')[1] || args[args.indexOf('--port') + 1]) || 5050,
+    stop: args.includes('--stop'),
+    status: args.includes('--status'),
     help: args.includes('--help') || args.includes('-h'),
     version: args.includes('--version') || args.includes('-v'),
   };
 
   if (flags.help) {
     console.log(`
-  ${BOLD}hermes-launch${RESET} — one command to install and run Hermes Agent
-
-  ${BOLD}Usage:${RESET}
-    npx hermes-launch              full interactive setup
-    npx hermes-launch --quick      non-interactive, smart defaults
-    npx hermes-launch --dashboard  just start the web dashboard
-    npx hermes-launch --help       this message
+  hermes-launch — web onboarding for Hermes Agent
 
-  ${BOLD}What it does:${RESET}
-    1. Check prerequisites (Python, curl, git)
-    2. Install missing dependencies automatically
-    3. Install Hermes Agent (if not present)
-    4. Run setup wizard to configure model/tools
-    5. Enable useful toolsets
-    6. Start the web dashboard on port 9119
-    7. Print next steps
+  Usage:
+    npx hermes-launch               start wizard + open browser
+    npx hermes-launch --port 8080   custom port
+    npx hermes-launch --stop        stop running instance
+    npx hermes-launch --status      check if running
+    npx hermes-launch --help        this message
 
-  ${BOLD}After launch:${RESET}
-    hermes              start chatting
-    hermes gateway setup  add Telegram/Discord
-    hermes model        change AI provider
-
-  ${BOLD}Windows notes:${RESET}
-    - Python is auto-installed via winget (or choco/scoop) if missing
-    - Recommended: use Windows Terminal for best experience
-    - For full functionality, WSL2 is recommended:
-      wsl --install -d Ubuntu
-      Then run: npx hermes-launch inside WSL
+  The web wizard handles everything: install, config, tools, dashboard.
+  Open http://localhost:5050 in your browser if it doesn't open automatically.
     `);
     process.exit(0);
   }
 
   if (flags.version) {
-    const pkg = JSON.parse(readFileSync(resolve(import.meta.dirname, '../package.json'), 'utf-8'));
-    console.log(`hermes-launch v${pkg.version}`);
+    const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf-8'));
+    console.log('hermes-launch v' + pkg.version);
     process.exit(0);
   }
 
-  if (flags.dashboard) {
-    const result = await startDashboard(true);
-    if (result.error) process.exit(1);
-    printSummary({ port: result.port, messaging: {} });
+  // Handle stop/status regardless of pid file
+  if (flags.stop) {
+    try {
+      const curPid = process.pid;
+      const pids = run(`ps aux | grep -E 'node.*hermes-launch|node.*server.js' | grep -v grep | awk '{print $2}' | grep -v "${curPid}"`, { silent: true, shell: true });
+      if (pids.ok && pids.out) {
+        const pidList = pids.out.split('\n').filter(Boolean);
+        for (const pid of pidList) {
+          try { process.kill(parseInt(pid), 'SIGTERM'); } catch {}
+        }
+        console.log('  Stopped ' + pidList.length + ' instance(s)');
+      } else {
+        console.log('  No running instances found');
+      }
+    } catch {}
+    try { writeFileSync(PID_FILE, ''); } catch {}
     process.exit(0);
   }
 
-  // ——— full flow ———
-  printBanner();
-
-  if (IS_WIN) {
-    console.log(`  ${DIM}Windows detected — auto-installing missing deps${RESET}\n`);
+  if (flags.status) {
+    const check = run('curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:' + flags.port + '/ 2>/dev/null || echo 0', { silent: true });
+    if (check.out === '200') {
+      console.log('  Running at http://localhost:' + flags.port);
+    } else {
+      console.log('  Not running');
+    }
+    process.exit(0);
   }
 
-  // 1. Prerequisites (auto-installs Python, git, curl if missing)
-  const platformInfo = await checkPrereqs();
+  // Print banner
+  console.log(`
+  🐚  Hermes Launch
+  ${'─'.repeat(30)}
+  Starting the web setup wizard...
+  `);
 
-  // 2. Install Hermes
-  await installHermes(flags.quick, platformInfo);
+  // Start the server in a detached child process
+  const serverPath = resolve(import.meta.dirname, '../src/server.js');
+  const proc = spawn(process.execPath, [serverPath, '--port', String(flags.port)], {
+    stdio: ['ignore', 'pipe', 'pipe'],
+    detached: true,
+    shell: IS_WIN,
+    env: { ...process.env },
+  });
+
+  // Collect startup output
+  let started = false;
+  proc.stdout.on('data', (data) => {
+    const text = data.toString();
+    process.stdout.write('  ' + text);
+    if (text.includes('Setup wizard at')) {
+      started = true;
+    }
+  });
+  proc.stderr.on('data', (data) => {
+    process.stderr.write('  ' + data.toString());
+  });
+
+  proc.on('error', (err) => {
+    console.error('  Failed to start:', err.message);
+    process.exit(1);
+  });
+
+  // Wait for the server to signal ready or timeout
+  await new Promise((resolve) => {
+    const timeout = setTimeout(() => {
+      if (!started) {
+        // Server may have started without printing — check if listening
+        const check = run('curl -s -o /dev/null -w "%{http_code}" http://127.0.0.1:' + flags.port + '/ 2>/dev/null || echo 0', { silent: true });
+        if (check.out === '200') started = true;
+      }
+      resolve();
+    }, 8000);
 
-  // 3. Check config
-  const needsSetup = await checkConfig(flags.quick);
+    proc.stdout.on('data', () => {
+      if (started) {
+        clearTimeout(timeout);
+        resolve();
+      }
+    });
+  });
 
-  // 4. Setup if needed
-  if (!needsSetup) {
-    await runSetup(flags.quick);
+  // Save pid
+  if (proc.pid) {
+    try { writeFileSync(PID_FILE, String(proc.pid)); } catch {}
   }
 
-  // 5. Enable tools
-  await enableToolsets(flags.quick);
+  // Detach — let the server live on
+  proc.unref();
 
-  // 6. Start dashboard
-  const dashResult = await startDashboard(flags.quick);
+  if (started) {
+    // Remove pipe listeners so event loop can exit
+    proc.stdout.removeAllListeners();
+    proc.stderr.removeAllListeners();
 
-  // 7. Check gateway
-  const platforms = await checkGatewayStatus();
+    console.log(`\n  ${'✅'}  Wizard ready at ${'http://localhost:' + flags.port}`);
 
-  // 8. Show summary
-  const summary = {
-    port: dashResult.port,
-    messaging: platforms.length > 0
-      ? Object.fromEntries(platforms.map(p => [p, `${GREEN}connected${RESET}`]))
-      : { none: `${YELLOW}not configured${RESET} (run \`hermes gateway setup\`)` },
-  };
+    // Auto-open browser
+    const url = 'http://localhost:' + flags.port;
+    openBrowser(url);
 
-  if (IS_WIN) {
-    summary.windowsNote = 'On Windows, some tools work best in WSL2. Run `wsl --install -d Ubuntu` for the full experience.';
-  }
+    console.log(`\n  Browser should open automatically. If not, visit:`);
+    console.log(`  ${'http://localhost:' + flags.port}`);
+    console.log(`\n  Run ${'npx hermes-launch --stop'} to stop the server.`);
+    console.log(`  This terminal is free now — the wizard runs in the background.\n`);
 
-  printSummary(summary);
+    // Explicit exit — the server is detached and will keep running
+    process.exit(0);
+  } else {
+    console.log(`\n  Server started in background. Open ${'http://localhost:' + flags.port} in your browser.\n`);
+  }
 }
 
 main().catch(e => {
-  console.error(`${RED}Error:${RESET}`, e.message);
+  console.error('Error:', e.message);
   process.exit(1);
 });