9remote 0.1.64 → 2.0.1

package/cli/index.js

@@ -3,27 +3,28 @@
 import inquirer from "inquirer";
 import chalk from "chalk";
 import qrcode from "qrcode-terminal";
-import { spawn, execSync } from "child_process";
+import { spawn, execSync, execFile } from "child_process";
 import path from "path";
 import { fileURLToPath } from "url";
 import fs from "fs";
 import os from "os";
+import dns from "dns";
 import { getConsistentMachineId } from "./utils/machineId.js";
 import { generateApiKeyWithMachine } from "./utils/apiKey.js";
 import { loadKey, saveKey, loadState, saveState, clearState, readAndClearCmd, writeCmd } from "./utils/state.js";
 import { createTempKey } from "./utils/token.js";
-import { checkAndUpdate, checkLatestVersion } from "./utils/updateChecker.js";
+import { checkAndUpdate, checkLatestVersion, stopRunningInstances } from "./utils/updateChecker.js";
+import { writePid, clearPid } from "./utils/pids.js";
 import { spawnQuickTunnel, killCloudflared, resetRestartCounter, ensureCloudflared } from "./utils/cloudflared.js";
-import { showBanner, renderProgress, resetProgress, selectMenu, confirm as tuiConfirm, subscribeSSE, openPermissionPane } from "./utils/tui.js";
+import { showBanner, getBannerText, renderProgress, resetProgress, updateProgressDesc, setProgressInfo, selectMenu, confirm as tuiConfirm, subscribeSSE, openPermissionPane, showDeviceApproval } from "./utils/tui.js";
 import { checkPermissions } from "./utils/permissions.js";
+import { initTray, killTray, openBrowser, updateTrayTooltip, showTrayNotification } from "./utils/tray.js";
+import { STEP, DEBUG, browserFetch } from "../lib/constants.js";
 
-// Parse --skip-update flag
 const skipUpdate = process.argv.includes("--skip-update");
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const PROJECT_ROOT = path.resolve(__dirname, "../..");
-// When bundled (dist/cli.cjs), server.cjs is in same dist/ folder
-// When dev (server/cli/index.js), use server/index.js directly
 const STANDALONE_SERVER = path.resolve(__dirname, "../dist/server.cjs");
 const DEV_SERVER = path.resolve(__dirname, "../index.js");
 const WORKER_URL = "https://9remote.cc";
@@ -31,20 +32,28 @@ const SERVER_PORT = 2208;
 const MAX_RESTART_ATTEMPTS = 10;
 const RESTART_WINDOW_MS = 60000; // 1 minute
 
-// Orange color from gitbook (#E68A6E)
 const ORANGE = chalk.rgb(230, 138, 110);
 const ORANGE_DIM = chalk.rgb(200, 120, 95);
 
-/**
- * Get current version from package.json
- */
+// Submenus set this to receive SSE-driven refreshes (permissions, state, ...) while open
+let activeSubmenuRefresh = null;
+
+/** Ensure API key exists, create if missing */
+async function ensureKeyData() {
+  const machineId = await getConsistentMachineId();
+  let keyData = loadKey();
+  if (!keyData.key) {
+    const { key } = generateApiKeyWithMachine(machineId);
+    keyData = saveKey(machineId, key, "Default");
+  }
+  return keyData;
+}
+
 function getVersion() {
-  // When bundled, version is injected at build time
   if (typeof __CLI_VERSION__ !== "undefined") {
     return __CLI_VERSION__;
   }
   
-  // Dev mode: read from package.json
   try {
     const packagePath = path.join(__dirname, "..", "package.json");
     const packageJson = JSON.parse(fs.readFileSync(packagePath, "utf-8"));
@@ -54,10 +63,6 @@ function getVersion() {
   }
 }
 
-
-/**
- * Helper: Show QR code for connect URL
- */
 function showQRCode(url, title = "📱 Scan QR to connect:") {
   console.log(ORANGE(`\n${title}`));
   qrcode.generate(url, { small: true, type: "terminal", margin: 0 }, (qr) => {
@@ -65,7 +70,6 @@ function showQRCode(url, title = "📱 Scan QR to connect:") {
   });
 }
 
-/** Build QR block as string (for use in headerContent) */
 function buildQRString(url) {
   return new Promise((resolve) => {
     qrcode.generate(url, { small: true, type: "terminal", margin: 0 }, (qr) => {
@@ -74,9 +78,6 @@ function buildQRString(url) {
   });
 }
 
-/**
- * Helper: Show connection info
- */
 async function showConnectionInfo(selectedKey, tunnelUrl) {
   const tempKeyData = await createTempKey(selectedKey, WORKER_URL);
   
@@ -88,9 +89,7 @@ async function showConnectionInfo(selectedKey, tunnelUrl) {
   const connectUrl = `${WORKER_URL}/login?k=${tempKeyData.tempKey}`;
   const width = Math.min(44, process.stdout.columns || 55);
 
-  // Push ready state to UI (include permanentKey, expiresAt, workerUrl for server-side key generation)
-  pushUiState({
-    step: 4,
+  await setStep(STEP.READY, {
     tunnelUrl,
     oneTimeKey: tempKeyData.tempKey,
     oneTimeKeyExpiresAt: tempKeyData.expiresAt,
@@ -105,17 +104,14 @@ async function showConnectionInfo(selectedKey, tunnelUrl) {
   
   console.log(ORANGE("═".repeat(width)));
   
-  // App URL
   const appLabel = "App URL";
   const appValue = `${WORKER_URL}/login`;
   console.log(chalk.white(appLabel.padEnd(14)) + chalk.gray(appValue));
   
-  // One-Time Key
   const keyLabel = "One-Time Key";
   const keyValue = tempKeyData.tempKey;
   console.log(chalk.white(keyLabel.padEnd(14)) + ORANGE.bold(keyValue));
   
-  // Permanent Key
   const permLabel = "Key";
   const permValue = selectedKey;
   console.log(chalk.white(permLabel.padEnd(14)) + chalk.gray(permValue));
@@ -123,10 +119,7 @@ async function showConnectionInfo(selectedKey, tunnelUrl) {
   console.log(ORANGE("═".repeat(width)));
 }
 
-/**
- * Build full header string: QR + keys info (for selectMenu headerContent)
- */
-async function buildMenuHeader(oneTimeKey, permanentKey, connectUrl) {
+async function buildMenuHeader(oneTimeKey, permanentKey, connectUrl, tunnelUrl = "") {
   const w = Math.min(44, process.stdout.columns || 44);
   const lines = [];
 
@@ -141,6 +134,13 @@ async function buildMenuHeader(oneTimeKey, permanentKey, connectUrl) {
   lines.push(
     ORANGE("═".repeat(w)),
     chalk.white("App URL".padEnd(14))      + chalk.gray(`${WORKER_URL}/login`),
+  );
+
+  if (DEBUG.showTunnelUrlInMenu) {
+    lines.push(chalk.white("Tunnel".padEnd(14)) + (tunnelUrl ? chalk.cyan(tunnelUrl) : chalk.gray("—")));
+  }
+
+  lines.push(
     chalk.white("One-Time Key".padEnd(14)) + (oneTimeKey ? ORANGE.bold(oneTimeKey) + chalk.dim("  (expires in 30m)") : chalk.gray("—")),
     chalk.white("Key".padEnd(14))          + chalk.dim(permanentKey),
     ORANGE("═".repeat(w)),
@@ -148,13 +148,10 @@ async function buildMenuHeader(oneTimeKey, permanentKey, connectUrl) {
   return lines.join("\n");
 }
 
-/**
- * Kill process on specific port
- */
 function killProcessOnPort(port) {
   try {
     if (process.platform === "win32") {
-      execSync(`for /f "tokens=5" %a in ('netstat -aon ^| findstr :${port}') do taskkill /F /PID %a`, { stdio: "ignore" });
+      execSync(`for /f "tokens=5" %a in ('netstat -aon ^| findstr :${port}') do taskkill /F /PID %a`, { stdio: "ignore", windowsHide: true });
     } else {
       const nullDevice = "/dev/null";
       execSync(`lsof -ti:${port} | xargs kill -9 2>${nullDevice} || true`, { stdio: "ignore" });
@@ -162,9 +159,6 @@ function killProcessOnPort(port) {
   } catch { }
 }
 
-/**
- * Start server with auto-restart on crash
- */
 function startServerWithRestart(onReady, onServerCrash) {
   const restartTimes = [];
   let currentProcess = null;
@@ -172,15 +166,12 @@ function startServerWithRestart(onReady, onServerCrash) {
   let isFirstStart = true;
 
   const spawnServer = () => {
-    // Only kill port on first start, not on restart
-    if (isFirstStart) {
+      if (isFirstStart) {
       killProcessOnPort(SERVER_PORT);
       isFirstStart = false;
-    } else {
     }
 
-    // Use dev server if exists (development), otherwise use standalone (npm package)
-    const useDevServer = process.env.NODE_ENV === "development" && fs.existsSync(DEV_SERVER);
+      const useDevServer = process.env.NODE_ENV === "development" && fs.existsSync(DEV_SERVER);
     const serverPath = useDevServer ? DEV_SERVER : STANDALONE_SERVER;
     
     if (!fs.existsSync(serverPath)) {
@@ -188,17 +179,18 @@ function startServerWithRestart(onReady, onServerCrash) {
       process.exit(1);
     }
     
-    // Strip NODE_ENV=development when running standalone server (production build)
-    const spawnEnv = { ...process.env, PORT: String(SERVER_PORT) };
+      const spawnEnv = { ...process.env, PORT: String(SERVER_PORT) };
     if (!useDevServer) delete spawnEnv.NODE_ENV;
 
     currentProcess = spawn("node", [serverPath], {
       cwd: path.dirname(serverPath),
-      stdio: ["ignore", "inherit", "inherit"],
+      stdio: "inherit",
       detached: false,
+      windowsHide: true,
       env: spawnEnv,
     });
-    
+    // No separate PID file: server is a direct child of agent. When the
+    // updater kills agent with `taskkill /F /T`, this child dies too.
 
     currentProcess.on("exit", (code, signal) => {
       if (isShuttingDown) {
@@ -213,18 +205,20 @@ function startServerWithRestart(onReady, onServerCrash) {
         const now = Date.now();
         restartTimes.push(now);
         
-        // Remove old restart times outside window
-        while (restartTimes.length > 0 && restartTimes[0] < now - RESTART_WINDOW_MS) {
+              while (restartTimes.length > 0 && restartTimes[0] < now - RESTART_WINDOW_MS) {
           restartTimes.shift();
         }
 
         if (restartTimes.length > MAX_RESTART_ATTEMPTS) {
           console.log(chalk.red(`❌ Too many restarts (${MAX_RESTART_ATTEMPTS} in ${RESTART_WINDOW_MS / 1000}s). Giving up.`));
-          process.exit(1);
+          // Don't bare-exit: cloudflared + tray would orphan and PID files
+          // would go stale. shutdownAll handles all of that.
+          isShuttingDown = true;
+          shutdownAll({ code: 1 });
+          return;
         }
 
         console.log(chalk.yellow(`🔄 Restarting server... (attempt ${restartTimes.length}/${MAX_RESTART_ATTEMPTS})`));
-        console.log(ORANGE_DIM("⚠️  [DEBUG] NOTE: Tunnel connection may be stale - will restart tunnel"));
         
         // ✅ Callback để restart cloudflared
         if (onServerCrash) {
@@ -232,11 +226,9 @@ function startServerWithRestart(onReady, onServerCrash) {
           onServerCrash();
         }
         
-        // Wait a bit before restart
-        setTimeout(() => {
+              setTimeout(() => {
           spawnServer();
         }, 1000);
-      } else {
       }
     });
 
@@ -256,38 +248,125 @@ function startServerWithRestart(onReady, onServerCrash) {
     shutdown: () => {
       isShuttingDown = true;
       if (currentProcess) {
-        currentProcess.kill();
+        // SIGKILL so Windows TerminateProcess fires immediately — SIGTERM
+        // on Windows is best-effort and leaves server node.exe orphaned
+        // when agent exits right after.
+        try { currentProcess.kill("SIGKILL"); } catch {}
       }
     }
   };
 }
 
 /**
- * Helper: Setup exit handler for server processes
+ * Tear down every 9remote resource and exit. Single source of truth for
+ * shutdown so Ctrl+C, menu Exit, tray "Shutdown" and IPC all behave the same:
+ *   - stop server (in-memory manager + port safety net)
+ *   - kill cloudflared (PID file + in-memory tunnel reference)
+ *   - kill tray helper
+ *   - clear PID files so next update doesn't hit stale entries
+ *   - clear local state/IPC files
  */
+function shutdownAll({ serverManager, tunnelProcess, exit = true, code = 0 } = {}) {
+  try { serverManager?.shutdown?.(); } catch {}
+  try { tunnelProcess?.kill?.(); } catch {}
+  try { killCloudflared(); } catch {}
+  try { killTray(); } catch {}
+  try { killProcessOnPort(SERVER_PORT); } catch {}
+  try { resetRestartCounter(); } catch {}
+  try { clearState(); } catch {}
+  try { clearPid("agent"); } catch {}
+  try { clearPid("cloudflared"); } catch {}
+  if (exit) {
+    // Delay so tray / HTTP replies flush AND Windows `taskkill /F` on port
+    // finishes killing orphan server node.exe before we exit. 200ms was
+    // too short on Windows and left 1 node.exe alive.
+    setTimeout(() => process.exit(code), 500);
+  }
+}
+
 let exitHandlerRegistered = false;
 
+/**
+ * Register cleanup for every "shutdown path" we can observe.
+ *
+ * Why so many signals:
+ *   - SIGINT           : Ctrl+C in terminal
+ *   - SIGTERM          : `kill <pid>`, service manager stop, Docker stop
+ *   - SIGHUP           : terminal closed on POSIX (parent shell died)
+ *   - SIGBREAK         : Ctrl+Break on Windows (Node's Windows-only signal)
+ *   - Windows X button : Node emits SIGHUP on CTRL_CLOSE_EVENT when stdin is
+ *                        in raw mode OR when a readline interface is open.
+ *                        We force-enable it by creating a readline iface on
+ *                        Windows so closing the console window triggers
+ *                        cleanup instead of orphaning tray + cloudflared.
+ *   - beforeExit       : natural event-loop drain (last-resort cleanup)
+ *   - uncaughtException/unhandledRejection: don't leak processes on crash
+ *
+ * Without this, closing the terminal with the X button on Windows (or
+ * kill -TERM) leaves tray_windows_release.exe + cloudflared.exe alive,
+ * which hold file handles inside node_modules\9remote\dist and cause
+ * `npm i -g 9remote@latest` to fail with EBUSY rename errors.
+ */
 function setupExitHandler(serverManager, tunnelProcess, apiKey) {
   if (exitHandlerRegistered) return;
   exitHandlerRegistered = true;
-  
-  process.on("SIGINT", async () => {
-    console.log(chalk.yellow("\n\n🛑 Stopping server..."));
-    
-    serverManager.shutdown();
-    if (tunnelProcess) tunnelProcess.kill();
-    killProcessOnPort(SERVER_PORT);
-    resetRestartCounter();
-    clearState();
-    
-    console.log(chalk.green("✅ Server stopped"));
-    process.exit(0);
+
+  let shuttingDown = false;
+  const onSignal = (sig) => {
+    if (shuttingDown) return;
+    shuttingDown = true;
+    // Only log when attached to a TTY — if the console was closed (SIGHUP
+    // on window-close), stdout may already be gone and writes throw.
+    try {
+      if (process.stdout.isTTY) {
+        console.log(chalk.yellow(`\n\n🛑 Stopping 9Remote (${sig})...`));
+      }
+    } catch {}
+    shutdownAll({ serverManager, tunnelProcess });
+    try {
+      if (process.stdout.isTTY) {
+        console.log(chalk.green("✅ Server stopped"));
+      }
+    } catch {}
+  };
+
+  // POSIX + Windows common signals
+  process.on("SIGINT", () => onSignal("SIGINT"));
+  process.on("SIGTERM", () => onSignal("SIGTERM"));
+  process.on("SIGHUP", () => onSignal("SIGHUP"));
+  // SIGBREAK only exists on Windows; registering it elsewhere is harmless
+  // but Node warns — guard it.
+  if (process.platform === "win32") {
+    process.on("SIGBREAK", () => onSignal("SIGBREAK"));
+
+    // Windows "X button" on the console window fires CTRL_CLOSE_EVENT. Node
+    // only translates this into SIGHUP if it has a readline interface open
+    // (see Node docs: "Signal Events" → Windows). Open a minimal one so the
+    // signal actually fires and our cleanup runs.
+    try {
+      // Lazy import so non-Windows platforms don't pay for it
+      import("readline").then(({ createInterface }) => {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        rl.on("SIGINT", () => onSignal("SIGINT"));
+        // Detach from event loop — don't keep the process alive just for this
+        if (process.stdin.isTTY) process.stdin.unref?.();
+      }).catch(() => {});
+    } catch {}
+  }
+
+  // Last-resort cleanup on crash — don't leak tray/cloudflared if we throw.
+  process.on("uncaughtException", (err) => {
+    try { console.error(chalk.red("Uncaught exception:"), err?.message || err); } catch {}
+    onSignal("uncaughtException");
+    setTimeout(() => process.exit(1), 300);
+  });
+  process.on("unhandledRejection", (err) => {
+    try { console.error(chalk.red("Unhandled rejection:"), err?.message || err); } catch {}
+    onSignal("unhandledRejection");
+    setTimeout(() => process.exit(1), 300);
   });
 }
 
-/**
- * Get first non-internal LAN IPv4 address
- */
 function getLanIp() {
   const interfaces = os.networkInterfaces();
   for (const iface of Object.values(interfaces)) {
@@ -298,24 +377,49 @@ function getLanIp() {
   return null;
 }
 
-/** Push UI state to server via HTTP */
-async function pushUiState(data) {
+/** Local API helpers */
+async function apiPost(path, data) {
   try {
-    await fetch(`http://localhost:${SERVER_PORT}/api/ui/state`, {
+    return await fetch(`http://localhost:${SERVER_PORT}${path}`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify(data),
     });
-  } catch { /* server may not be ready yet */ }
+  } catch { return null; }
+}
+
+async function apiGet(path) {
+  try {
+    const res = await fetch(`http://localhost:${SERVER_PORT}${path}`);
+    return res.ok ? await res.json() : null;
+  } catch { return null; }
+}
+
+async function pushUiState(data) {
+  await apiPost("/api/ui/state", data);
+}
+
+// DRY: single source for step progression — updates both terminal progress + web UI state.
+// Terminal rendering only active in TUI mode (guarded by isTuiActive flag).
+let isTuiActive = false;
+async function setStep(step, extra = {}) {
+  if (isTuiActive) renderProgress(step - 1, step > STEP.PREPARING);
+  await pushUiState({ step, stepDesc: "", ...extra });
+}
+
+// DRY: single handler for cloudflared binary progress → updates both TUI + web UI.
+function onBinaryProgress({ phase, percent }) {
+  const text = phase === "download"
+    ? `Downloading tunnel binary ${percent ?? 0}%`
+    : "Extracting tunnel binary";
+  if (isTuiActive) updateProgressDesc(text);
+  pushUiState({ stepDesc: text });
 }
 
-/**
- * Update session tunnelUrl on worker + push to UI
- */
 async function updateTunnelUrl(selectedKey, tunnelUrl) {
   const lanIp = getLanIp();
   try {
-    await fetch(`${WORKER_URL}/api/session/update`, {
+    await browserFetch(`${WORKER_URL}/api/session/update`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({
@@ -327,12 +431,9 @@ async function updateTunnelUrl(selectedKey, tunnelUrl) {
   } catch { }
 }
 
-/**
- * Helper: Start server and quick tunnel
- */
 async function startServerAndTunnel(selectedKey) {
   console.log(ORANGE("\n🚀 Starting server..."));
-  pushUiState({ step: 1 });
+  await setStep(STEP.PREPARING);
 
   // Kill existing cloudflared process
   try {
@@ -342,19 +443,14 @@ async function startServerAndTunnel(selectedKey) {
 
   // Create session on worker
   try {
-    const sessionResponse = await fetch(`${WORKER_URL}/api/session/create`, {
+    const res = await browserFetch(`${WORKER_URL}/api/session/create`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ apiKey: selectedKey })
+      body: JSON.stringify({ apiKey: selectedKey }),
     });
-    if (!sessionResponse.ok) {
-      const text = await sessionResponse.text();
-      console.log(chalk.red(`❌ Failed to create session: ${sessionResponse.status} ${text.substring(0, 200)}`));
-      return null;
-    }
-  } catch (error) {
-    console.log(chalk.red(`❌ Failed to create session: ${error.message}`));
-    return null;
+    if (!res.ok) { console.log(chalk.red(`❌ Session create failed: ${res.status}`)); return null; }
+  } catch (e) {
+    console.log(chalk.red(`❌ Session create failed: ${e.message}`)); return null;
   }
 
   // Skip spawning server if already running (e.g. nodemon in dev mode)
@@ -366,7 +462,7 @@ async function startServerAndTunnel(selectedKey) {
   if (!alreadyRunning) await new Promise(resolve => setTimeout(resolve, 2000));
 
   console.log(ORANGE("✅ Starting tunnel..."));
-  pushUiState({ step: 2 });
+  await setStep(STEP.CONNECTING);
 
   // Spawn quick tunnel — URL comes directly from cloudflared stdout
   let tunnelProcess, tunnelUrl;
@@ -385,6 +481,11 @@ async function startServerAndTunnel(selectedKey) {
     return null;
   }
 
+  // Health check tunnel from outside before proceeding
+  const tunnelReady = await waitForTunnelReady(tunnelUrl);
+  if (!tunnelReady) {
+    console.log(chalk.yellow("\n⚠️  Tunnel health check timed out, proceeding anyway..."));
+  }
 
   // Save tunnelUrl to worker DB
   await updateTunnelUrl(selectedKey, tunnelUrl);
@@ -400,53 +501,33 @@ async function startServerAndTunnel(selectedKey) {
   return { serverManager, tunnelProcess, tunnelUrl };
 }
 
-
-/**
- * TUI mode — main flow for `9remote` (no subcommand)
- */
 async function tuiMode() {
   console.clear();
+  resetProgress();
+  isTuiActive = true;
+  await setStep(STEP.PREPARING);
 
-  // ── 1. Parallel: check latest version + start server ──────────────────────
-  const machineId = await getConsistentMachineId();
-  let keyData = loadKey();
-  if (!keyData.key) {
-    const { key } = generateApiKeyWithMachine(machineId);
-    keyData = saveKey(machineId, key, "Default");
-  }
+  let keyData = await ensureKeyData();
 
-  // Run update check & server start in parallel
   let tuiServerMgr = { getProcess: () => null, shutdown: () => {} };
-  const [updateInfo] = await Promise.all([
-    checkLatestVersion(),
-    (async () => {
-      const alreadyRunning = await isServerRunning();
-      if (!alreadyRunning) {
-        tuiServerMgr = startServerWithRestart(null, null);
-        await new Promise((r) => setTimeout(r, 2000));
-      }
-    })(),
-  ]);
-
-  // ── 2. Show banner (with update notice if available) ──────────────────────
-  const version = getVersion();
-  showBanner(version, updateInfo?.latest ?? null);
-
-  // ── 3. Progress: Preparing → Connecting → Tunneling → Ready ──────────────
-  resetProgress();
-  renderProgress(0); // Preparing
+  const alreadyRunning = await isServerRunning();
+  if (!alreadyRunning) {
+    tuiServerMgr = startServerWithRestart(null, null);
+    // Poll until server ready instead of fixed sleep
+    const deadline = Date.now() + 5000;
+    while (Date.now() < deadline && !(await isServerRunning())) {
+      await new Promise((r) => setTimeout(r, 200));
+    }
+  }
 
-  // Kill stale cloudflared
   try { killCloudflared(); await new Promise((r) => setTimeout(r, 300)); } catch {}
 
-  // Step 1 — Preparing (ensureCloudflared)
-  await ensureCloudflared();
+  await ensureCloudflared(onBinaryProgress);
 
-  renderProgress(1, true); // Connecting
+  await setStep(STEP.CONNECTING);
 
-  // Step 2 — Connecting (create session)
   try {
-    const res = await fetch(`${WORKER_URL}/api/session/create`, {
+    const res = await browserFetch(`${WORKER_URL}/api/session/create`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
       body: JSON.stringify({ apiKey: keyData.key }),
@@ -457,9 +538,8 @@ async function tuiMode() {
     process.exit(1);
   }
 
-  renderProgress(2, true); // Starting tunnel
+  await setStep(STEP.TUNNELING);
 
-  // Step 3 — Tunnel
   let tunnelProcess, tunnelUrl;
   try {
     const result = await spawnQuickTunnel(SERVER_PORT, async (newUrl) => {
@@ -473,17 +553,21 @@ async function tuiMode() {
     process.exit(1);
   }
 
+  await setStep(STEP.VERIFYING);
+  const tunnelReady = await waitForTunnelReady(tunnelUrl);
+  if (!tunnelReady) {
+    console.log(chalk.yellow("\n⚠️  Tunnel health check timed out, proceeding anyway..."));
+  }
+
   await updateTunnelUrl(keyData.key, tunnelUrl);
   saveState({ apiKey: keyData.key, tunnelUrl, tunnelPid: tunnelProcess.pid });
 
-  // ── 4. Create temp key + push ready state ─────────────────────────────────
   const tempKeyData = await createTempKey(keyData.key, WORKER_URL);
   const connectUrl = tempKeyData
     ? `${WORKER_URL}/login?k=${tempKeyData.tempKey}`
     : `${WORKER_URL}/login`;
 
-  await pushUiState({
-    step: 4,
+  await setStep(STEP.READY, {
     tunnelUrl,
     oneTimeKey: tempKeyData?.tempKey || "",
     oneTimeKeyExpiresAt: tempKeyData?.expiresAt || null,
@@ -491,33 +575,48 @@ async function tuiMode() {
     qrUrl: connectUrl,
     workerUrl: WORKER_URL,
   });
+  await new Promise((r) => setTimeout(r, 1000));
 
-  // ── 5. Load initial state from server ────────────────────────────────────
   let currentOneTimeKey = tempKeyData?.tempKey || "";
   let currentConnectUrl = connectUrl;
+  let currentTunnelUrl = tunnelUrl;
 
-  // ── 6. Build initial header ───────────────────────────────────────────────
-  let menuHeader = await buildMenuHeader(currentOneTimeKey, keyData.key, currentConnectUrl);
+  let menuHeader = await buildMenuHeader(currentOneTimeKey, keyData.key, currentConnectUrl, currentTunnelUrl);
 
-  // Mutable ref for menu re-render callback (set by selectMenu)
   let triggerMenuRedraw = null;
+  const logBuffer = [];
+  const MAX_LOG_LINES = 200;
 
-  // ── 7. Subscribe SSE — auto-rebuild header on state changes ──────────────
+  let deviceApprovalBusy = false;
   const stopSSE = subscribeSSE(SERVER_PORT, async (type, data) => {
-    if (type === "state") {
+    if (type === "log" && data.message) {
+      logBuffer.push(data.message);
+      if (logBuffer.length > MAX_LOG_LINES) logBuffer.shift();
+    } else if (type === "state") {
       const newKey = data.permanentKey || keyData.key;
       // Explicit check: "" means cleared (one-time key consumed), preserve existing if undefined
       const newOtk = data.oneTimeKey !== undefined ? data.oneTimeKey : currentOneTimeKey;
       const newUrl = data.qrUrl !== undefined ? data.qrUrl : currentConnectUrl;
-      if (newOtk !== currentOneTimeKey || newKey !== keyData.key) {
+      const newTunnel = data.tunnelUrl !== undefined ? data.tunnelUrl : currentTunnelUrl;
+      if (newOtk !== currentOneTimeKey || newKey !== keyData.key || newTunnel !== currentTunnelUrl) {
         currentOneTimeKey = newOtk;
         currentConnectUrl = newUrl;
+        currentTunnelUrl = newTunnel;
         if (data.permanentKey) keyData = { ...keyData, key: data.permanentKey };
-        menuHeader = await buildMenuHeader(currentOneTimeKey, keyData.key, currentConnectUrl);
+        menuHeader = await buildMenuHeader(currentOneTimeKey, keyData.key, currentConnectUrl, currentTunnelUrl);
         triggerMenuRedraw?.();
       }
     } else if (type === "permissions") {
-      // desktopEnabled changed — trigger redraw so menu label refreshes
+      // desktopEnabled or permission values changed — refresh both main menu and active submenu
+      activeSubmenuRefresh?.();
+      triggerMenuRedraw?.();
+    } else if (type === "deviceApproval" && data.action === "pending") {
+      if (deviceApprovalBusy) return;
+      deviceApprovalBusy = true;
+      const approved = await showDeviceApproval(data.deviceId, data.ip);
+      const endpoint = approved ? "approve" : "reject";
+      await apiPost(`/api/device/${endpoint}`, { socketId: data.socketId });
+      deviceApprovalBusy = false;
       triggerMenuRedraw?.();
     }
   });
@@ -527,23 +626,32 @@ async function tuiMode() {
     shutdown: () => { tuiServerMgr.shutdown(); stopSSE(); }
   }, tunnelProcess, keyData.key);
 
-  // ── 8. Interactive menu loop ───────────────────────────────────────────────
+  // Handle web UI Start/Stop commands while TUI is running
+  let activeTunnel = tunnelProcess;
+  setupCmdPoller(() => activeTunnel, (t) => { activeTunnel = t; }, keyData.key);
+
+  const onShutdown = () => {
+    try { stopSSE(); } catch {}
+    shutdownAll({
+      serverManager: tuiServerMgr,
+      tunnelProcess,
+      exit: false, // let the menu loop print Goodbye and exit itself
+    });
+  };
+
   await tuiMenuLoop(
     keyData, tunnelUrl,
     () => menuHeader,
     (h) => { menuHeader = h; },
     (cb) => { triggerMenuRedraw = cb; },
-    () => { tuiServerMgr.shutdown(); killProcessOnPort(SERVER_PORT); stopSSE(); }
+    onShutdown,
+    logBuffer
   );
 }
 
-/** Fetch desktopEnabled from server (source of truth) */
-async function fetchDesktopEnabled() {
-  try {
-    const res = await fetch(`http://localhost:${SERVER_PORT}/api/ui/state`);
-    if (res.ok) { const d = await res.json(); return !!d.desktopEnabled; }
-  } catch {}
-  return false;
+async function fetchServerState() {
+  const d = await apiGet("/api/ui/state");
+  return { desktopEnabled: !!d?.desktopEnabled, remoteAvailable: !!d?.remoteAvailable };
 }
 
 /**
@@ -554,125 +662,135 @@ async function fetchDesktopEnabled() {
  * @param {(newHeader: string) => void} setHeader - update header from inside loop
  * @param {(cb: () => void) => void} onRedrawRegister - register redraw callback
  */
-async function tuiMenuLoop(keyData, tunnelUrl, getHeader = () => "", setHeader = () => {}, onRedrawRegister = () => {}, onCtrlC = null) {
+async function tuiMenuLoop(keyData, tunnelUrl, getHeader = () => "", setHeader = () => {}, onRedrawRegister = () => {}, onCtrlC = null, logBuffer = []) {
   while (true) {
-    const desktopOn = await fetchDesktopEnabled();
-    const desktopLabel = `Remote Desktop: ${desktopOn ? chalk.green("ON") : chalk.gray("OFF")}  ▶`;
+    const { desktopEnabled: desktopOn, remoteAvailable } = await fetchServerState();
+
     const items = [
-      { label: "Open Web UI" },
-      { label: "New One-Time Key" },
-      { label: "Regenerate Permanent Key" },
-      { label: desktopLabel },
-      { label: chalk.gray("Exit") },
+      { label: "Open Web UI", action: "webui" },
+      { label: "New One-Time Key", action: "otk" },
+      { label: "Regenerate Permanent Key", action: "regen" },
     ];
+    if (remoteAvailable) {
+      const desktopLabel = `Remote Desktop: ${desktopOn ? chalk.green("ON") : chalk.gray("OFF")}  ▶`;
+      items.push({ label: desktopLabel, action: "desktop" });
+    }
+    items.push(
+      { label: "Manage Devices  \u25b6", action: "devices" },
+      { label: `View Logs (${logBuffer.length})`, action: "logs" },
+      { label: chalk.gray("Exit"), action: "exit" },
+    );
 
-    // Register SSE-triggered redraw with selectMenu
     let redrawMenu = null;
     onRedrawRegister(() => redrawMenu?.());
 
-    const idx = await selectMenu("Select action", items, 0, getHeader, (setRedraw) => {
+    const idx = await selectMenu("", items, 0, getHeader, (setRedraw) => {
       redrawMenu = setRedraw;
     }, onCtrlC);
 
-    if (idx === 0) {
-      // Open UI
+    const action = idx >= 0 ? items[idx].action : "exit";
+
+    if (action === "webui") {
       const url = `http://localhost:${SERVER_PORT}`;
-      const cmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
-      spawn(cmd, [url], { detached: true, stdio: "ignore" }).unref();
+      openBrowser(url);
       console.log(chalk.green(`\n🌐 Opening ${url}\n`));
 
-    } else if (idx === 1) {
-      // New One-Time Key — rebuild header with fresh QR
+    } else if (action === "otk") {
       const newTempKey = await createTempKey(keyData.key, WORKER_URL);
       if (newTempKey) {
         const newConnectUrl = `${WORKER_URL}/login?k=${newTempKey.tempKey}`;
-        setHeader(await buildMenuHeader(newTempKey.tempKey, keyData.key, newConnectUrl));
+        setHeader(await buildMenuHeader(newTempKey.tempKey, keyData.key, newConnectUrl, tunnelUrl));
         await pushUiState({ oneTimeKey: newTempKey.tempKey, oneTimeKeyExpiresAt: newTempKey.expiresAt, qrUrl: newConnectUrl });
       }
 
-    } else if (idx === 2) {
-      // Regenerate Key
+    } else if (action === "regen") {
       const confirmed = await tuiConfirm(chalk.yellow("⚠️  Replace current key and disconnect all sessions? Continue?"));
       if (confirmed) {
         const machineId = await getConsistentMachineId();
         const { key } = generateApiKeyWithMachine(machineId);
         keyData = saveKey(machineId, key, keyData.name || "Default");
         await pushUiState({ permanentKey: keyData.key });
-        // Rebuild header with new key
         const newTmp = await createTempKey(keyData.key, WORKER_URL);
         if (newTmp) {
           const newUrl = `${WORKER_URL}/login?k=${newTmp.tempKey}`;
-          setHeader(await buildMenuHeader(newTmp.tempKey, keyData.key, newUrl));
+          setHeader(await buildMenuHeader(newTmp.tempKey, keyData.key, newUrl, tunnelUrl));
           await pushUiState({ oneTimeKey: newTmp.tempKey, oneTimeKeyExpiresAt: newTmp.expiresAt, qrUrl: newUrl });
         }
       }
 
-    } else if (idx === 3) {
-      // Remote Desktop submenu
+    } else if (action === "desktop") {
       await tuiDesktopMenu();
 
+    } else if (action === "devices") {
+      await tuiDevicesMenu();
+
+    } else if (action === "logs") {
+      await tuiLogsView(logBuffer);
+
     } else {
-      // Exit — kill server child process before exiting
-      killProcessOnPort(SERVER_PORT);
+      // Exit path — onCtrlC contains the full shutdownAll sequence
+      try { onCtrlC?.(); } catch {}
       console.log(chalk.gray("\nGoodbye!\n"));
       process.exit(0);
     }
   }
 }
 
+/** View logs screen — scrollable, ESC to go back */
+async function tuiLogsView(logBuffer) {
+  const header = logBuffer.length
+    ? logBuffer.join("\n")
+    : chalk.gray("  No logs yet");
+  await selectMenu("Logs", [{ label: chalk.gray("← Back") }], 0, header);
+}
+
 /**
  * Remote Desktop submenu.
  * All state (desktopEnabled + permissions) fetched from server — no local tracking.
  */
 async function tuiDesktopMenu() {
   while (true) {
-    // Always read from server
-    let desktopOn = false, perms = { screenRecording: false, accessibility: false };
-    try {
-      const res = await fetch(`http://localhost:${SERVER_PORT}/api/ui/state`);
-      if (res.ok) {
-        const d = await res.json();
-        desktopOn = !!d.desktopEnabled;
-        perms = { screenRecording: !!d.screenRecording, accessibility: !!d.accessibility };
-      }
-    } catch {}
-
-    const toggleLabel = `Toggle: ${desktopOn ? chalk.green("ON  → turn OFF") : chalk.gray("OFF → turn ON")}`;
-    const srLabel = `Screen Recording          ${perms.screenRecording ? chalk.green("✓") : chalk.red("✗ (click to grant)")}`;
-    const axLabel = `Mouse & Keyboard control  ${perms.accessibility  ? chalk.green("✓") : chalk.red("✗ (click to grant)")}`;
+    // State captured in closure — SSE may mutate items in-place while menu is open
+    let desktopOn = false;
+    let perms = { screenRecording: false, accessibility: false };
+
+    const buildLabels = () => ({
+      toggle: `Toggle: ${desktopOn ? chalk.green("ON  → turn OFF") : chalk.gray("OFF → turn ON")}`,
+      sr: `Screen Recording          ${perms.screenRecording ? chalk.green("✓") : chalk.red("✗ (click to grant)")}`,
+      ax: `Mouse & Keyboard control  ${perms.accessibility  ? chalk.green("✓") : chalk.red("✗ (click to grant)")}`,
+    });
 
-    const idx = await selectMenu("Remote Desktop", [
-      { label: toggleLabel },
-      { label: srLabel },
-      { label: axLabel },
+    const items = [
+      { label: "" },
+      { label: "" },
+      { label: "" },
       { label: chalk.gray("← Back") },
-    ], 0);
+    ];
 
-    if (idx === 0) {
-      // Toggle — flip current value via server
-      try {
-        await fetch(`http://localhost:${SERVER_PORT}/api/desktop/toggle`, {
-          method: "POST",
-          headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({ enabled: !desktopOn }),
-        });
-      } catch {}
+    let redrawMenu = null;
+    const syncFromServer = async () => {
+      const s = await apiGet("/api/ui/state") || {};
+      desktopOn = !!s.desktopEnabled;
+      perms = { screenRecording: !!s.screenRecording, accessibility: !!s.accessibility };
+      const L = buildLabels();
+      items[0].label = L.toggle;
+      items[1].label = L.sr;
+      items[2].label = L.ax;
+      redrawMenu?.();
+    };
+
+    await syncFromServer();
+    // Register SSE-driven refresh while this submenu is active
+    activeSubmenuRefresh = syncFromServer;
+    const idx = await selectMenu("Remote Desktop", items, 0, "", (setRedraw) => { redrawMenu = setRedraw; });
+    activeSubmenuRefresh = null;
 
+    if (idx === 0) {
+      await apiPost("/api/desktop/toggle", { enabled: !desktopOn });
     } else if (idx === 1 && !perms.screenRecording) {
-      try {
-        await fetch(`http://localhost:${SERVER_PORT}/api/permissions/request`, {
-          method: "POST", headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({ type: "screenRecording" }),
-        });
-      } catch { openPermissionPane("screenRecording"); }
-
+      if (!await apiPost("/api/permissions/request", { type: "screenRecording" })) openPermissionPane("screenRecording");
     } else if (idx === 2 && !perms.accessibility) {
-      try {
-        await fetch(`http://localhost:${SERVER_PORT}/api/permissions/request`, {
-          method: "POST", headers: { "Content-Type": "application/json" },
-          body: JSON.stringify({ type: "accessibility" }),
-        });
-      } catch { openPermissionPane("accessibility"); }
+      if (!await apiPost("/api/permissions/request", { type: "accessibility" })) openPermissionPane("accessibility");
 
     } else if (idx === 3 || idx === -1) {
       return; // Back
@@ -680,30 +798,39 @@ async function tuiDesktopMenu() {
   }
 }
 
+async function tuiDevicesMenu() {
+  while (true) {
+    const data = await apiGet("/api/device/approved");
+    const devices = data?.devices || [];
 
-/**
- * Auto start dev server (--auto flag)
- */
-async function autoStartDev() {
-  showBanner(getVersion());
+    const items = [
+      ...devices.map((d) => {
+        const short = d.deviceId.slice(0, 8);
+        const date = d.approvedAt ? new Date(d.approvedAt).toLocaleString() : "unknown";
+        return { label: `${short}...  ${chalk.dim(date)}` };
+      }),
+      { label: chalk.gray("\u2190 Back") },
+    ];
 
-  const machineId = await getConsistentMachineId();
-  let keyData = loadKey();
+    const title = `Approved Devices (${devices.length})`;
+    const idx = await selectMenu(title, items, items.length - 1);
 
-  // Auto create key if none exists
-  if (!keyData.key) {
-    console.log(chalk.yellow("⚠️  No key found. Creating default key..."));
-    const { key } = generateApiKeyWithMachine(machineId);
-    keyData = saveKey(machineId, key, "Default");
-    console.log(chalk.green("✅ Default key created!"));
+    if (idx === -1 || idx === devices.length) return; // Back/ESC
+
+    // Remove selected device
+    const deviceId = devices[idx].deviceId;
+    const confirmed = await tuiConfirm(chalk.yellow(`Remove device ${deviceId.slice(0, 8)}...?`));
+    if (confirmed) await apiPost("/api/device/remove", { deviceId });
   }
+}
 
+async function autoStartDev() {
+  showBanner(getVersion());
+  let keyData = await ensureKeyData();
   console.log(chalk.gray(`Using key: ${keyData.key.slice(0, 20)}... (${keyData.name})`));
 
   const result = await startServerAndTunnel(keyData.key);
-  if (!result) {
-    process.exit(1);
-  }
+  if (!result) process.exit(1);
 
   const { serverManager, tunnelProcess, tunnelUrl } = result;
 
@@ -721,14 +848,9 @@ async function autoStartDev() {
     pushUiState({ uptime: `${h}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}` });
   }, 5000);
 
-  // Keep process alive
   await new Promise(() => { });
 }
 
-
-/**
- * Listen for key regen, stop-tunnel, start-tunnel from server UI
- */
 function setupCmdPoller(getActiveTunnel, setActiveTunnel, apiKey) {
   let busy = false;
   setInterval(async () => {
@@ -745,40 +867,47 @@ function setupCmdPoller(getActiveTunnel, setActiveTunnel, apiKey) {
         setActiveTunnel(null);
         console.log(chalk.yellow("🛑 Tunnel stopped"));
       }
-      await pushUiState({ step: 0, tunnelUrl: "", oneTimeKey: "", oneTimeKeyExpiresAt: null });
+      await setStep(STEP.STOPPED, { tunnelUrl: "", oneTimeKey: "", oneTimeKeyExpiresAt: null });
+      updateTrayTooltip({ tunnelUrl: "", running: true });
     }
 
     if (cmd === "start-tunnel") {
       if (getActiveTunnel()) { busy = false; return; } // already running
       console.log(ORANGE("🚀 Starting tunnel..."));
       try {
-        // Step 1: Preparing — check/download cloudflared binary
-        await pushUiState({ step: 1 });
-        await ensureCloudflared();
+        await setStep(STEP.PREPARING);
+        await ensureCloudflared(onBinaryProgress);
 
-        // Step 2: Connecting — create session on worker
-        await pushUiState({ step: 2 });
-        const sessionResponse = await fetch(`${WORKER_URL}/api/session/create`, {
+        await setStep(STEP.CONNECTING);
+        const sessionResponse = await browserFetch(`${WORKER_URL}/api/session/create`, {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify({ apiKey }),
         });
         if (!sessionResponse.ok) throw new Error(`Session create failed: ${sessionResponse.status}`);
 
-        // Step 3: Tunneling — spawn cloudflared
-        await pushUiState({ step: 3 });
+        await setStep(STEP.TUNNELING);
         const result = await spawnQuickTunnel(SERVER_PORT, async (newUrl) => {
           await updateTunnelUrl(apiKey, newUrl);
           await pushUiState({ tunnelUrl: newUrl });
         });
         setActiveTunnel(result.child);
+
+        await setStep(STEP.VERIFYING);
+        const tunnelOk = await waitForTunnelReady(result.tunnelUrl);
+        if (!tunnelOk) {
+          console.log(chalk.yellow("\n⚠️  Tunnel health check timed out, proceeding anyway..."));
+        }
+
         await updateTunnelUrl(apiKey, result.tunnelUrl);
+        updateTrayTooltip({ tunnelUrl: result.tunnelUrl, running: true });
 
-        // Step 4: Ready
+        // Hold for 3s so UI sees all steps complete before showing Ready screen
+        await new Promise(r => setTimeout(r, 2000));
         await showConnectionInfo(apiKey, result.tunnelUrl);
       } catch (err) {
         console.log(chalk.red(`❌ Failed to start tunnel: ${err.message}`));
-        await pushUiState({ step: 0 });
+        await setStep(STEP.STOPPED);
       }
     }
 
@@ -791,89 +920,368 @@ function setupCmdPoller(getActiveTunnel, setActiveTunnel, apiKey) {
       console.log(chalk.green(`✅ Key regenerated: ${key}`));
     }
 
+    if (cmd === "shutdown") {
+      console.log(chalk.yellow("\n🛑 Shutting down 9Remote completely..."));
+      const tunnel = getActiveTunnel();
+      setActiveTunnel(null);
+      shutdownAll({ tunnelProcess: tunnel });
+      console.log(chalk.green("✅ 9Remote stopped"));
+    }
+
     } finally {
       busy = false;
     }
   }, 1000);
 }
 
-/**
- * Check if server is already running on SERVER_PORT
- */
-async function isServerRunning() {
+// Win DNS negative cache giữ ENOTFOUND lâu hơn thời điểm Cloudflare publish subdomain.
+// Flush trước mỗi attempt để query đi thẳng upstream, tránh chờ TTL âm hết hạn.
+// Async fire-and-forget + windowsHide → không block, không popup cmd window.
+function flushWinDns() {
+  if (process.platform !== "win32") return;
+  execFile("ipconfig", ["/flushdns"], { windowsHide: true }, () => {});
+}
+
+// Resolve DNS trực tiếp qua Cloudflare 1.1.1.1 (bypass resolver hệ thống / ISP cache)
+// → biết ngay subdomain đã propagate chưa mà không tốn 5s chờ fetch timeout.
+const dnsResolver = new dns.promises.Resolver();
+dnsResolver.setServers(["1.1.1.1", "1.0.0.1", "8.8.8.8"]);
+
+async function resolveTunnelDns(hostname, timeoutMs = 2000) {
+  const t0 = Date.now();
   try {
-    const res = await fetch(`http://localhost:${SERVER_PORT}/api/health`);
-    return res.ok;
-  } catch {
-    return false;
+    const addrs = await Promise.race([
+      dnsResolver.resolve4(hostname),
+      new Promise((_, reject) =>
+        setTimeout(() => reject(Object.assign(new Error("DNS timeout"), { code: "ETIMEOUT" })), timeoutMs)
+      ),
+    ]);
+    return { ok: true, addrs, elapsedMs: Date.now() - t0 };
+  } catch (err) {
+    const code = err.code || err.message;
+    return { ok: false, code, elapsedMs: Date.now() - t0 };
   }
 }
 
-/**
- * UI mode: start server (if not running) + tunnel + open browser
- * Same as "Start Server" in TUI but auto-opens browser
- */
-async function startUiMode() {
-  showBanner(getVersion());
+async function waitForTunnelReady(tunnelUrl, { intervalMs = 2000, timeoutMs = 180000 } = {}) {
+  const healthUrl = `${tunnelUrl}/api/health`;
+  const hostname = (() => {
+    try { return new URL(tunnelUrl).hostname; } catch { return null; }
+  })();
+  const start = Date.now();
+  let attempt = 0;
+  const logs = [];
 
-  const machineId = await getConsistentMachineId();
-  let keyData = loadKey();
+  // Init terminal-like panel in web UI
+  await pushUiState({
+    healthCheck: { running: true, timeoutMs, startedAt: start, logs: [] },
+  });
 
-  if (!keyData.key) {
-    const { key } = generateApiKeyWithMachine(machineId);
-    keyData = saveKey(machineId, key, "Default");
+  const pushLog = (entry) => {
+    logs.push(entry);
+    // Keep last 80 entries to stay snappy
+    const trimmed = logs.length > 80 ? logs.slice(-80) : logs;
+    pushUiState({
+      healthCheck: { running: true, timeoutMs, startedAt: start, logs: trimmed },
+    });
+  };
+
+  while (Date.now() - start < timeoutMs) {
+    attempt++;
+    flushWinDns();
+
+    // Bước 1: DNS probe qua 1.1.1.1 (timeout 2s) — biết sớm subdomain đã publish chưa
+    // Chỉ áp dụng khi có hostname hợp lệ (tunnel URL thực tế).
+    if (hostname) {
+      const dnsRes = await resolveTunnelDns(hostname, 2000);
+      if (!dnsRes.ok) {
+        const isWaiting = dnsRes.code === "ENOTFOUND" || dnsRes.code === "ETIMEOUT" || dnsRes.code === "ESERVFAIL";
+        const status = isWaiting ? "connecting..." : dnsRes.code;
+        updateProgressDesc(`#${attempt} → ${status}`);
+        pushLog({ attempt, status, elapsedMs: dnsRes.elapsedMs, ok: false, waiting: isWaiting, time: Date.now() });
+        // Subdomain chưa propagate → skip fetch 5s, chờ interval rồi thử lại.
+        await new Promise((r) => setTimeout(r, intervalMs));
+        continue;
+      }
+    }
+
+    // Bước 2: DNS OK (hoặc không có hostname) → fetch health endpoint
+    const t0 = Date.now();
+    try {
+      const res = await browserFetch(healthUrl, {
+        signal: AbortSignal.timeout(5000),
+      });
+      const elapsedMs = Date.now() - t0;
+      updateProgressDesc(`#${attempt} → ${res.status}`);
+      pushLog({ attempt, status: String(res.status), elapsedMs, ok: res.ok, time: Date.now() });
+      if (res.ok) {
+        // Clear logs immediately — UI jumps straight to Ready, no lingering log
+        await pushUiState({
+          healthCheck: { running: false, timeoutMs: 0, startedAt: null, logs: [] },
+        });
+        await new Promise(r => setTimeout(r, 2000));
+        return true;
+      }
+    } catch (err) {
+      const elapsedMs = Date.now() - t0;
+      const code = err.cause?.code || err.code || err.message;
+      // ENOTFOUND = tunnel DNS chưa propagate → đây là trạng thái "đang chờ", không phải lỗi
+      const isWaiting = code === "ENOTFOUND";
+      const status = isWaiting ? "connecting..." : code;
+      updateProgressDesc(`#${attempt} → ${status}`);
+      pushLog({ attempt, status, elapsedMs, ok: false, waiting: isWaiting, time: Date.now() });
+    }
+    await new Promise((r) => setTimeout(r, intervalMs));
   }
 
-  // Parse --theme flag
-  const themeArg = process.argv.find(arg => arg.startsWith("--theme="));
+  await pushUiState({
+    healthCheck: { running: false, timeoutMs, startedAt: start, logs },
+  });
+  return false;
+}
+
+async function isServerRunning() {
+  return !!(await apiGet("/api/health"));
+}
+
+/** Spawn background process with --tray flag, open browser, exit current process */
+async function launchBackground() {
+  const uiUrl = `http://localhost:${SERVER_PORT}`;
+
+  // If an orphan server from a previous run is holding the port, kill it
+  // so our fresh agent spawns a fresh server it actually owns. Skipping
+  // this leaves alreadyRunning=true in startTrayMode → serverManager
+  // becomes a no-op → Shutdown can't kill the orphan node.exe.
+  if (await isServerRunning()) {
+    killProcessOnPort(SERVER_PORT);
+    await new Promise(r => setTimeout(r, 500));
+  }
+
+  // Spawn CLI itself with --tray — tray logic lives in CLI, not server
+  // Bundle: __dirname = dist/,      entry = dist/cli.cjs
+  // Dev:    __dirname = agent/cli/, entry = agent/cli/index.js
+  const scriptPath = typeof __CLI_VERSION__ !== "undefined"
+    ? path.resolve(__dirname, "cli.cjs")
+    : path.resolve(__dirname, "index.js");
+  const bgArgs = [scriptPath, "--tray"];
+
+  const themeArg = process.argv.find(a => a.startsWith("--theme="));
+  if (themeArg) bgArgs.push(themeArg);
+
+  // Redirect child stdout/stderr to log file for debugging crashes
+  const logDir = path.join(os.homedir(), ".9remote");
+  if (!fs.existsSync(logDir)) fs.mkdirSync(logDir, { recursive: true });
+  const logPath = path.join(logDir, "bg.log");
+
+  // Log startup marker
+  try {
+    fs.appendFileSync(logPath, `\n\n=== ${new Date().toISOString()} spawn bg ===\n`);
+  } catch {}
+
+  let bgPid = null;
+
+  // Unified detached spawn for all platforms.
+  //
+  // Windows specifics:
+  //   - node.exe is a console-subsystem binary. With plain `detached: true` Windows
+  //     would allocate a new console for the child and flash a black cmd window.
+  //   - `windowsHide: true` adds CREATE_NO_WINDOW, which combined with DETACHED_PROCESS
+  //     (from `detached: true`) + non-inherit stdio makes the launch fully silent —
+  //     no VBS/wscript wrapper needed.
+  //   - stdio MUST be either "ignore" or a file fd (not "inherit") or Windows will
+  //     still surface a console window tied to the parent.
+  //
+  // PID tracking:
+  //   - We write `agent.pid` here in the PARENT before the child even boots, so the
+  //     updater can always find it — even if the child crashes before `startTrayMode`
+  //     gets to call writePid() itself.
+  try {
+    const logFd = fs.openSync(logPath, "a");
+    const bg = spawn(process.execPath, bgArgs, {
+      detached: true,
+      windowsHide: true,
+      stdio: ["ignore", logFd, logFd],
+      env: { ...process.env },
+    });
+    bg.unref();
+    // Close our copy of the fd — the child has its own handle now.
+    try { fs.closeSync(logFd); } catch {}
+    bgPid = bg.pid;
+    // Track background agent PID so the updater can release dist/cli.cjs lock
+    // without touching other node.exe processes on the machine.
+    if (bg.pid) writePid("agent", bg.pid);
+  } catch (err) {
+    console.log(chalk.red(`\n❌ Failed to launch background: ${err.message}`));
+    process.exit(1);
+  }
+
+  // Wait and verify server came up; Windows + first-run cloudflared download can
+  // be slow, so give it up to 15s before giving up.
+  const deadline = Date.now() + 15000;
+  let ready = false;
+  while (Date.now() < deadline) {
+    if (await isServerRunning()) { ready = true; break; }
+    await new Promise(r => setTimeout(r, 300));
+  }
+
+  if (!ready) {
+    console.log(chalk.red(`\n❌ Background server failed to start.`));
+    console.log(chalk.gray(`   Check log: ${logPath}\n`));
+    process.exit(1);
+  }
+
+  openBrowser(uiUrl);
+  const pidStr = bgPid ? ` (PID: ${bgPid})` : "";
+  console.log(chalk.green(`\n🌐 9Remote running at ${uiUrl}${pidStr}`));
+  console.log(chalk.gray(`💡 Log: ${logPath}\n`));
+  // Give the detached browser-launcher child a brief moment to actually spawn
+  // before this parent exits — especially on Windows where cmd/start needs a tick.
+  await new Promise(r => setTimeout(r, 400));
+  process.exit(0);
+}
+
+/** Tray mode: start server + system tray, no terminal UI */
+async function startTrayMode() {
+  // Record own PID — this process holds dist/cli.cjs open in memory.
+  // Needed so `npm i -g 9remote@latest` can kill us and rename node_modules\9remote.
+  writePid("agent", process.pid);
+
+  let keyData = await ensureKeyData();
+
+  const themeArg = process.argv.find(a => a.startsWith("--theme="));
   const theme = themeArg ? themeArg.split("=")[1] : null;
 
-  // Start server only (no tunnel yet — wait for UI Connect button)
   const alreadyRunning = await isServerRunning();
   const serverManager = alreadyRunning
     ? { getProcess: () => null, shutdown: () => {} }
     : startServerWithRestart(null, null);
 
-  if (!alreadyRunning) await new Promise(resolve => setTimeout(resolve, 2000));
+  if (!alreadyRunning) await new Promise(r => setTimeout(r, 2000));
 
-  console.log(chalk.green(`\n🌐 UI ready at http://localhost:${SERVER_PORT}`));
+  const uiUrl = `http://localhost:${SERVER_PORT}`;
 
-  // Mutable ref for active tunnel
   let activeTunnel = null;
-  const getActiveTunnel = () => activeTunnel;
-  const setActiveTunnel = (t) => { activeTunnel = t; };
-
-  // Push permanentKey + theme to UI so Welcome screen can display it
-  await pushUiState({ permanentKey: keyData.key, step: 0, theme });
+  await pushUiState({ permanentKey: keyData.key, step: STEP.STOPPED, theme });
+
+  const cleanup = () => {
+    const tunnel = activeTunnel;
+    activeTunnel = null;
+    // Tray's own onClick handler calls process.exit after this returns,
+    // so don't double-exit here.
+    shutdownAll({ serverManager, tunnelProcess: tunnel, exit: false });
+  };
 
   setupExitHandler(serverManager, null, keyData.key);
-  setupCmdPoller(getActiveTunnel, setActiveTunnel, keyData.key);
+  setupCmdPoller(() => activeTunnel, (t) => { activeTunnel = t; }, keyData.key);
 
-  // Auto start tunnel if --start flag is passed
-  if (process.argv.includes("--start")) {
-    writeCmd("start-tunnel");
+  if (process.argv.includes("--start")) writeCmd("start-tunnel");
+
+  const tray = await initTray({
+    port: SERVER_PORT,
+    onQuit: cleanup,
+    onOpenUI: () => openBrowser(uiUrl),
+  });
+
+  // Show a one-shot balloon tip so the user knows the agent is running
+  // in the background and where to find it (tray area + local URL).
+  if (tray) {
+    showTrayNotification({
+      title: "9Remote is running",
+      message: `Open ${uiUrl} or use the tray icon to manage.`,
+    });
   }
 
-  await new Promise(() => { });
+  await new Promise(() => {});
+}
+
+/** UI mode (9remote ui): start server + open browser, no tray */
+async function startUiMode() {
+  showBanner(getVersion());
+  let keyData = await ensureKeyData();
+
+  const themeArg = process.argv.find(a => a.startsWith("--theme="));
+  const theme = themeArg ? themeArg.split("=")[1] : null;
+
+  const alreadyRunning = await isServerRunning();
+  const serverManager = alreadyRunning
+    ? { getProcess: () => null, shutdown: () => {} }
+    : startServerWithRestart(null, null);
+
+  if (!alreadyRunning) await new Promise(r => setTimeout(r, 2000));
+
+  const uiUrl = `http://localhost:${SERVER_PORT}`;
+  console.log(chalk.green(`\n🌐 UI ready at ${uiUrl}`));
+
+  let activeTunnel = null;
+  await pushUiState({ permanentKey: keyData.key, step: STEP.STOPPED, theme });
+
+  setupExitHandler(serverManager, null, keyData.key);
+  setupCmdPoller(() => activeTunnel, (t) => { activeTunnel = t; }, keyData.key);
+
+  if (process.argv.includes("--start")) writeCmd("start-tunnel");
+
+  await new Promise(() => {});
 }
 
 // Start app
 async function start() {
-  // Disable auto-update - TUI already shows update notification
-  // const hasUpdate = await checkAndUpdate(skipUpdate);
-  // if (hasUpdate) return;
-  
   const command = process.argv[2];
-  
+
+  // Kill any existing 9remote instance (agent + cloudflared) before starting
+  // a new one. ptyDaemon is preserved to keep terminal sessions alive.
+  // Skip when re-entering via --tray / --auto (child spawned by launchBackground),
+  // otherwise the detached child would read its own PID from agent.pid and
+  // kill itself right after spawn.
+  const isChildRespawn = process.argv.includes("--tray") || process.argv.includes("--auto");
+  if (!isChildRespawn) {
+    stopRunningInstances();
+  }
+
   if (command === "ui") {
-    // UI mode: 9remote ui
     await startUiMode();
   } else if (command === "start" || process.argv.includes("--auto")) {
-    // Direct start: 9remote start
     await autoStartDev();
+  } else if (process.argv.includes("--tray")) {
+    await startTrayMode();
   } else {
-    // TUI mode: 9remote
+    await startupMenu();
+  }
+}
+
+async function startupMenu() {
+  const version = getVersion();
+  const updateInfo = await checkLatestVersion();
+  const banner = getBannerText(version, updateInfo?.latest ?? null);
+
+  const items = [];
+  if (updateInfo?.latest) {
+    items.push({ label: chalk.yellow(`Update to v${updateInfo.latest}`), action: "update" });
+  }
+  items.push(
+    { label: "Open Web UI (background)", action: "ui" },
+    { label: "Terminal UI", action: "tui" },
+    { label: chalk.gray("Exit"), action: "exit" },
+  );
+
+  const idx = await selectMenu("", items, 0, banner);
+  const action = idx >= 0 ? items[idx].action : "exit";
+
+  if (action === "update") {
+    const w = Math.min(44, process.stdout.columns || 44);
+    // Stop running background instances so npm install can overwrite locked files
+    stopRunningInstances();
+    console.log(ORANGE("\n" + "═".repeat(w)));
+    console.log(chalk.gray("  ✓ Stopped running instances\n"));
+    console.log(chalk.yellow("  ⬆  Run this command to update:\n"));
+    console.log(chalk.white.bold(`     npm i -g 9remote@latest\n`));
+    console.log(ORANGE("═".repeat(w)) + "\n");
+    process.exit(0);
+  } else if (action === "ui") {
+    await launchBackground();
+  } else if (action === "tui") {
     await tuiMode();
+  } else {
+    process.exit(0);
   }
 }