hermes-launch 1.1.0 → 1.2.0

package/bin/hermes-launch.js

@@ -26,8 +26,7 @@ const HERMES_HOME = IS_WIN
 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.)
+// Windows Terminal / VS Code support ansi; raw cmd.exe doesn't
 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' : '';
@@ -57,7 +56,7 @@ 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
+    shell: IS_WIN ? true : false,
     ...opts,
   };
   try {
@@ -69,7 +68,6 @@ function run(cmd, opts = {}) {
 }
 
 function runPwsh(cmd, opts = {}) {
-  // Run a PowerShell command — used on Windows for winget, etc.
   return run(`powershell -NoProfile -Command "${cmd}"`, opts);
 }
 
@@ -86,30 +84,53 @@ function step(msg) {
   };
 }
 
+function openBrowser(url) {
+  try {
+    if (IS_WIN) {
+      execSync(`start "" "${url}"`, { shell: 'cmd.exe', timeout: 5000, stdio: 'ignore' });
+    } else if (IS_MAC) {
+      execSync(`open "${url}"`, { timeout: 5000, stdio: 'ignore' });
+    } else {
+      execSync(`xdg-open "${url}" 2>/dev/null || sensible-browser "${url}" 2>/dev/null || true`, { timeout: 5000, stdio: 'ignore' });
+    }
+  } catch (_) { /* best-effort */ }
+}
+
 function printSummary(info) {
+  const dashUrl = `http://localhost:${info.port || 9119}`;
+
   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}`);
+
+  // Big visible dashboard URL
+  console.log(`  ${BOLD}🌐  Web Dashboard${RESET}`);
+  console.log(`  ${CYAN}  ┌──────────────────────────────────────────┐${RESET}`);
+  console.log(`  ${CYAN}  │${RESET}  ${BOLD}${dashUrl}${RESET}  ${CYAN}│${RESET}`);
+  console.log(`  ${CYAN}  └──────────────────────────────────────────┘${RESET}`);
+  console.log(`  ${DIM}  (Opened in your browser)${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(`  ${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(`  ${BOLD}📖  Docs${RESET}`);
   console.log(`    ${CYAN}https://hermes-agent.nousresearch.com/docs${RESET}\n`);
+
   if (info.messaging) {
-    console.log(`  ${BOLD}Messaging${RESET}`);
+    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`);
+    console.log(`  ${YELLOW}  ${info.windowsNote}${RESET}\n`);
   }
 }
 
@@ -117,7 +138,6 @@ function printSummary(info) {
 
 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';
@@ -134,14 +154,9 @@ function detectPackageManager() {
   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'];
@@ -176,14 +191,11 @@ async function installPython(pkgMan) {
         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}`;
     } 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') {
@@ -212,14 +224,12 @@ 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();
@@ -318,7 +328,6 @@ async function checkPrereqs() {
 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;
@@ -343,17 +352,13 @@ async function installHermes(quick, platformInfo) {
   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'),
@@ -367,21 +372,12 @@ async function installHermes(quick, platformInfo) {
       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`);
-      }
+      console.log(`\n  ${YELLOW}Pip install failed. Try inside WSL instead:${RESET}`);
+      console.log(`    ${CYAN}wsl -d Ubuntu -e bash -c "curl -fsSL ${INSTALL_URL} | bash"${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 });
@@ -410,7 +406,6 @@ async function checkConfig(quick) {
 
   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: ''")) {
@@ -425,11 +420,9 @@ async function checkConfig(quick) {
 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 });
+    const noop = IS_WIN ? 'ver>nul' : '2>/dev/null || true';
+    run(`hermes tools enable web terminal file skills session_search delegate_task memory clarify vision ${noop}`, { silent: true });
+    run(`hermes config set display.streaming.enabled true ${noop}`, { silent: true });
     s.ok();
     return;
   }
@@ -449,7 +442,8 @@ async function runSetup(quick) {
     }
   } 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 });
+    const noop = IS_WIN ? 'ver>nul' : '2>/dev/null || true';
+    run(`hermes tools enable web terminal file skills session_search delegate_task memory ${noop}`, { silent: true });
     s.skip('minimal config applied');
   }
 }
@@ -458,8 +452,6 @@ 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 });
@@ -469,41 +461,61 @@ async function enableToolsets(quick) {
   s.ok();
 }
 
+// ——— FIXED: dashboard launches as a detached process that survives after hermes-launch exits ———
+
 async function startDashboard(quick) {
   const s = step('Starting web dashboard');
   const port = '9119';
-
   const noop = IS_WIN ? 'ver>nul' : '2>/dev/null || true';
+  const dashUrl = `http://localhost:${port}`;
 
+  // Check if already running
   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');
+    if (!quick) openBrowser(dashUrl);
     return { port, alreadyRunning: true };
   }
 
   try {
+    // Spawn detached — survives after this script exits
     const proc = spawn(
       'hermes',
-      ['dashboard', '--port', port, '--tui', quick ? '--no-open' : ''],
+      ['dashboard', '--port', port, '--tui', '--no-open', '--skip-build'],
       {
-        stdio: 'inherit',
-        detached: false,
+        stdio: ['ignore', 'ignore', 'ignore'],
+        detached: true,
         shell: IS_WIN,
         env: { ...process.env },
       }
     );
 
-    await spinner(3000);
+    // Release the child — it lives on its own
+    proc.on('error', () => {});
+    if (proc.unref) proc.unref();
+
+    // Give it time to boot
+    await spinner(4000);
+
+    // Verify it's actually responding
+    const curlBin = IS_WIN
+      ? 'curl.exe -s -o nul -w "%{http_code}"'
+      : 'curl -s -o /dev/null -w "%{http_code}"';
+    const verify = run(`${curlBin} ${dashUrl}/ 2>/dev/null || echo 0`, { silent: true });
 
-    // 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');
+      s.skip('started in background (may take a few seconds)');
     } else {
       s.ok();
     }
 
+    // Open browser (unless --quick)
+    if (!quick) {
+      process.stdout.write(`  ${CYAN}→${RESET} Opening web dashboard in browser ... `);
+      openBrowser(dashUrl);
+      process.stdout.write(`${GREEN}done${RESET}\n`);
+    }
+
     return { port, alreadyRunning: false };
   } catch (e) {
     s.fail(e.message);
@@ -554,12 +566,12 @@ async function main() {
 
   ${BOLD}What it does:${RESET}
     1. Check prerequisites (Python, curl, git)
-    2. Install missing dependencies automatically
+    2. Install missing dependencies automatically (Windows: winget/choco)
     3. Install Hermes Agent (if not present)
     4. Run setup wizard to configure model/tools
-    5. Enable useful toolsets
+    5. Enable useful toolsets (web, terminal, file, skills, memory, ...)
     6. Start the web dashboard on port 9119
-    7. Print next steps
+    7. Open browser, print next steps
 
   ${BOLD}After launch:${RESET}
     hermes              start chatting
@@ -567,8 +579,8 @@ async function main() {
     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
+    - Python auto-installed via winget if missing
+    - Web dashboard opens in browser
     - For full functionality, WSL2 is recommended:
       wsl --install -d Ubuntu
       Then run: npx hermes-launch inside WSL
@@ -583,7 +595,7 @@ async function main() {
   }
 
   if (flags.dashboard) {
-    const result = await startDashboard(true);
+    const result = await startDashboard(false);
     if (result.error) process.exit(1);
     printSummary({ port: result.port, messaging: {} });
     process.exit(0);
@@ -613,7 +625,7 @@ async function main() {
   // 5. Enable tools
   await enableToolsets(flags.quick);
 
-  // 6. Start dashboard
+  // 6. Start dashboard (detached — survives after script exits)
   const dashResult = await startDashboard(flags.quick);
 
   // 7. Check gateway

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hermes-launch",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "One command to launch Hermes Agent — zero-to-AI-agent in seconds",
   "bin": {
     "hermes-launch": "./bin/hermes-launch.js"