agent-relay 2.1.1 → 2.1.3

package/dist/index.cjs

@@ -26022,7 +26022,7 @@ var jsonl_adapter_exports = {};
 __export(jsonl_adapter_exports, {
   JsonlStorageAdapter: () => JsonlStorageAdapter
 });
-var import_node_fs20, import_node_path22, DEFAULT_RETENTION_MS2, DEFAULT_CLEANUP_INTERVAL_MS2, JsonlStorageAdapter;
+var import_node_fs20, import_node_path22, DEFAULT_RETENTION_MS2, DEFAULT_CLEANUP_INTERVAL_MS2, DEFAULT_WATCH_DEBOUNCE_MS, JsonlStorageAdapter;
 var init_jsonl_adapter = __esm({
   "packages/storage/dist/jsonl-adapter.js"() {
     "use strict";
@@ -26030,6 +26030,7 @@ var init_jsonl_adapter = __esm({
     import_node_path22 = __toESM(require("node:path"), 1);
     DEFAULT_RETENTION_MS2 = 7 * 24 * 60 * 60 * 1e3;
     DEFAULT_CLEANUP_INTERVAL_MS2 = 60 * 60 * 1e3;
+    DEFAULT_WATCH_DEBOUNCE_MS = 100;
     JsonlStorageAdapter = class {
       baseDir;
       messageDir;
@@ -26045,6 +26046,12 @@ var init_jsonl_adapter = __esm({
       deletedMessages = /* @__PURE__ */ new Set();
       sessions = /* @__PURE__ */ new Map();
       resumeIndex = /* @__PURE__ */ new Map();
+      watchForChanges;
+      watchDebounceMs;
+      messageWatcher;
+      sessionWatcher;
+      reloadDebounceTimer;
+      sessionReloadDebounceTimer;
       constructor(options) {
         this.baseDir = options.baseDir;
         this.messageDir = import_node_path22.default.join(this.baseDir, "messages");
@@ -26052,6 +26059,8 @@ var init_jsonl_adapter = __esm({
         this.retentionMs = options.messageRetentionMs ?? DEFAULT_RETENTION_MS2;
         this.cleanupIntervalMs = options.cleanupIntervalMs ?? DEFAULT_CLEANUP_INTERVAL_MS2;
         this.fallbackReason = options.reason;
+        this.watchForChanges = options.watchForChanges ?? false;
+        this.watchDebounceMs = options.watchDebounceMs ?? DEFAULT_WATCH_DEBOUNCE_MS;
       }
       async init() {
         await import_node_fs20.default.promises.mkdir(this.messageDir, { recursive: true });
@@ -26062,12 +26071,16 @@ var init_jsonl_adapter = __esm({
         if (this.cleanupIntervalMs > 0) {
           this.startCleanupTimer();
         }
+        if (this.watchForChanges) {
+          this.startFileWatching();
+        }
       }
       async close() {
         if (this.cleanupTimer) {
           clearInterval(this.cleanupTimer);
           this.cleanupTimer = void 0;
         }
+        this.stopFileWatching();
         this.messages.clear();
         this.deletedMessages.clear();
         this.sessions.clear();
@@ -26323,6 +26336,64 @@ var init_jsonl_adapter = __esm({
           this.cleanupTimer.unref();
         }
       }
+      startFileWatching() {
+        try {
+          this.messageWatcher = import_node_fs20.default.watch(this.messageDir, (eventType, filename) => {
+            if (filename && filename.endsWith(".jsonl")) {
+              this.debouncedReloadMessages();
+            }
+          });
+          if (this.messageWatcher.unref) {
+            this.messageWatcher.unref();
+          }
+        } catch {
+        }
+        try {
+          this.sessionWatcher = import_node_fs20.default.watch(this.sessionFile, () => {
+            this.debouncedReloadSessions();
+          });
+          if (this.sessionWatcher.unref) {
+            this.sessionWatcher.unref();
+          }
+        } catch {
+        }
+      }
+      stopFileWatching() {
+        if (this.messageWatcher) {
+          this.messageWatcher.close();
+          this.messageWatcher = void 0;
+        }
+        if (this.sessionWatcher) {
+          this.sessionWatcher.close();
+          this.sessionWatcher = void 0;
+        }
+        if (this.reloadDebounceTimer) {
+          clearTimeout(this.reloadDebounceTimer);
+          this.reloadDebounceTimer = void 0;
+        }
+        if (this.sessionReloadDebounceTimer) {
+          clearTimeout(this.sessionReloadDebounceTimer);
+          this.sessionReloadDebounceTimer = void 0;
+        }
+      }
+      debouncedReloadMessages() {
+        if (this.reloadDebounceTimer) {
+          clearTimeout(this.reloadDebounceTimer);
+        }
+        this.reloadDebounceTimer = setTimeout(() => {
+          this.loadMessagesFromDisk().catch(() => {
+          });
+        }, this.watchDebounceMs);
+      }
+      debouncedReloadSessions() {
+        if (this.sessionReloadDebounceTimer) {
+          clearTimeout(this.sessionReloadDebounceTimer);
+        }
+        this.sessionReloadDebounceTimer = setTimeout(() => {
+          this.loadSessionsFromDisk().catch(() => {
+          });
+        }, this.watchDebounceMs);
+      }
       async loadMessagesFromDisk() {
         this.messages.clear();
         this.deletedMessages.clear();
@@ -35497,6 +35568,7 @@ __export(index_exports, {
   PROTOCOL_VERSION: () => PROTOCOL_VERSION,
   PROVIDER_AUTH_PATTERNS: () => PROVIDER_AUTH_PATTERNS,
   PostgresDLQAdapter: () => PostgresDLQAdapter,
+  RESERVED_AGENT_NAMES: () => RESERVED_AGENT_NAMES,
   RelayClient: () => RelayClient,
   RelayEvent: () => RelayEvent,
   RelayPtyOrchestrator: () => RelayPtyOrchestrator,
@@ -37229,13 +37301,81 @@ function stripAnsi2(str) {
 function sleep(ms) {
   return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
+var AUTO_SUGGEST_PATTERNS = {
+  // Dim text styling - commonly used for ghost text
+  dim: /\x1B\[2m/,
+  // Bright black (dark gray) - common for suggestions
+  brightBlack: /\x1B\[90m/,
+  // 256-color grays (8 is dark gray, 240-250 are grays)
+  gray256: /\x1B\[38;5;(?:8|24[0-9]|250)m/,
+  // Cursor save (CSI s or ESC 7)
+  cursorSave: /\x1B\[s|\x1B7/,
+  // Cursor restore (CSI u or ESC 8)
+  cursorRestore: /\x1B\[u|\x1B8/,
+  // Italic text - sometimes used for suggestions
+  italic: /\x1B\[3m/
+};
+function detectAutoSuggest(output) {
+  const patterns = [];
+  let confidence = 0;
+  if (AUTO_SUGGEST_PATTERNS.dim.test(output)) {
+    patterns.push("dim");
+    confidence += 0.4;
+  }
+  if (AUTO_SUGGEST_PATTERNS.brightBlack.test(output)) {
+    patterns.push("brightBlack");
+    confidence += 0.4;
+  }
+  if (AUTO_SUGGEST_PATTERNS.gray256.test(output)) {
+    patterns.push("gray256");
+    confidence += 0.3;
+  }
+  if (AUTO_SUGGEST_PATTERNS.italic.test(output)) {
+    patterns.push("italic");
+    confidence += 0.2;
+  }
+  const hasCursorSave = AUTO_SUGGEST_PATTERNS.cursorSave.test(output);
+  const hasCursorRestore = AUTO_SUGGEST_PATTERNS.cursorRestore.test(output);
+  if (hasCursorSave && hasCursorRestore) {
+    patterns.push("cursorSaveRestore");
+    confidence += 0.5;
+  } else if (hasCursorSave || hasCursorRestore) {
+    patterns.push(hasCursorSave ? "cursorSave" : "cursorRestore");
+    confidence += 0.2;
+  }
+  confidence = Math.min(confidence, 1);
+  const stripped = stripAnsi2(output);
+  if (patterns.length === 0) {
+    return { isAutoSuggest: false, confidence: 0, patterns, strippedContent: stripped };
+  }
+  const lines = stripped.split("\n").filter((l) => l.trim().length > 0);
+  if (lines.length > 2) {
+    confidence *= 0.5;
+  }
+  const isAutoSuggest = confidence >= 0.4;
+  return { isAutoSuggest, confidence, patterns, strippedContent: stripped };
+}
+function shouldIgnoreForIdleDetection(output) {
+  if (!output || output.length === 0) {
+    return true;
+  }
+  const result = detectAutoSuggest(output);
+  if (result.isAutoSuggest) {
+    return true;
+  }
+  const stripped = stripAnsi2(output).trim();
+  if (stripped.length === 0) {
+    return true;
+  }
+  return false;
+}
 function buildInjectionString(msg) {
   const sanitizedBody = stripAnsi2(msg.body || "").replace(/[\r\n]+/g, " ").trim();
   if (sanitizedBody.startsWith("Relay message from ")) {
     return sanitizedBody;
   }
   const shortId = msg.messageId.substring(0, 8);
-  const displayFrom = msg.from === "_DashboardUI" && typeof msg.data?.senderName === "string" ? msg.data.senderName : msg.from;
+  const displayFrom = msg.from === "Dashboard" && typeof msg.data?.senderName === "string" ? msg.data.senderName : msg.from;
   const threadHint = msg.thread ? ` [thread:${msg.thread}]` : "";
   const importanceHint = msg.importance !== void 0 && msg.importance > 75 ? " [!!]" : msg.importance !== void 0 && msg.importance > 50 ? " [!]" : "";
   const channelHint = msg.originalTo === "*" ? " [#general] (reply to #general, not sender)" : msg.originalTo?.startsWith("#") ? ` [${msg.originalTo}] (reply to ${msg.originalTo}, not sender)` : "";
@@ -42483,8 +42623,17 @@ var BaseWrapper = class extends import_node_events2.EventEmitter {
   /**
    * Feed output to the idle and stuck detectors.
    * Call this whenever new output is received from the agent.
+   *
+   * Note: Auto-suggestions (ghost text) are filtered out to prevent
+   * false idle resets. Claude Code and other CLIs show suggestions
+   * in gray/dim text with cursor save/restore, which should not
+   * be treated as "real" output for idle detection.
    */
   feedIdleDetectorOutput(output) {
+    if (shouldIgnoreForIdleDetection(output)) {
+      this.stuckDetector.onOutput(output);
+      return;
+    }
     this.idleDetector.onOutput(output);
     this.stuckDetector.onOutput(output);
   }
@@ -52803,6 +52952,16 @@ function generateEventSchemas() {
 }
 
 // packages/daemon/dist/connection.js
+var RESERVED_AGENT_NAMES = /* @__PURE__ */ new Set([
+  "Dashboard",
+  // Dashboard system client
+  "cli",
+  // CLI tool
+  "system",
+  // System messages
+  "_router"
+  // Internal router target
+]);
 var DEFAULT_CONFIG10 = {
   ...DEFAULT_CONNECTION_CONFIG
 };
@@ -52951,7 +53110,12 @@ var Connection = class {
       this.sendError("BAD_REQUEST", "Unexpected HELLO", false);
       return;
     }
-    this._agentName = envelope.payload.agent;
+    const agentName = envelope.payload.agent;
+    if (RESERVED_AGENT_NAMES.has(agentName) && !envelope.payload._isSystemComponent) {
+      this.sendError("BAD_REQUEST", `Agent name "${agentName}" is reserved for system use`, true);
+      return;
+    }
+    this._agentName = agentName;
     this._entityType = envelope.payload.entityType;
     this._cli = envelope.payload.cli;
     this._program = envelope.payload.program;
@@ -69989,7 +70153,8 @@ async function createStorageAdapter(dbPath, config2) {
   const finalConfig = {
     type: config2?.type ?? envConfig.type ?? "jsonl",
     path: config2?.path ?? envConfig.path ?? dbPath,
-    url: config2?.url ?? envConfig.url
+    url: config2?.url ?? envConfig.url,
+    watchForChanges: config2?.watchForChanges
   };
   const storageType = finalConfig.type?.toLowerCase();
   switch (storageType) {
@@ -70027,7 +70192,8 @@ async function createStorageAdapter(dbPath, config2) {
           console.warn("[storage] \u26A0\uFE0F  Falling back to JSONL storage (append-only files)");
           const adapter2 = new JsonlStorageAdapter2({
             baseDir,
-            reason: "upgrade to Node.js 22+ or run: npm rebuild better-sqlite3"
+            reason: "upgrade to Node.js 22+ or run: npm rebuild better-sqlite3",
+            watchForChanges: finalConfig.watchForChanges
           });
           await adapter2.init();
           return adapter2;
@@ -70048,7 +70214,10 @@ async function createStorageAdapter(dbPath, config2) {
       const { JsonlStorageAdapter: JsonlStorageAdapter2 } = await Promise.resolve().then(() => (init_jsonl_adapter(), jsonl_adapter_exports));
       const baseDir = import_node_path23.default.dirname(finalConfig.path);
       console.error("[storage] Using JSONL storage");
-      const adapter = new JsonlStorageAdapter2({ baseDir });
+      const adapter = new JsonlStorageAdapter2({
+        baseDir,
+        watchForChanges: finalConfig.watchForChanges
+      });
       await adapter.init();
       return adapter;
     }
@@ -70068,7 +70237,8 @@ async function createStorageAdapter(dbPath, config2) {
           console.warn("[storage] \u26A0\uFE0F  Falling back to JSONL storage (append-only files)");
           const adapter2 = new JsonlStorageAdapter2({
             baseDir,
-            reason: "upgrade to Node.js 22+ or run: npm rebuild better-sqlite3"
+            reason: "upgrade to Node.js 22+ or run: npm rebuild better-sqlite3",
+            watchForChanges: finalConfig.watchForChanges
           });
           await adapter2.init();
           return adapter2;
@@ -72681,7 +72851,7 @@ var Daemon = class _Daemon {
   isInternalAgent(name) {
     if (name.startsWith("__"))
       return true;
-    return name === "Dashboard" || name === "_DashboardUI" || name === "cli";
+    return name === "Dashboard" || name === "cli";
   }
   /**
    * Stop the daemon.
@@ -78770,6 +78940,7 @@ init_dist();
   PROTOCOL_VERSION,
   PROVIDER_AUTH_PATTERNS,
   PostgresDLQAdapter,
+  RESERVED_AGENT_NAMES,
   RelayClient,
   RelayEvent,
   RelayPtyOrchestrator,

package/dist/src/cli/index.d.ts

@@ -12,5 +12,15 @@
  *   relay agents                   - List connected agents
  *   relay who                      - Show currently active agents
  */
-export {};
+/**
+ * Install agent-relay-snippet to markdown files using prpm.
+ * Installs to CLAUDE.md, GEMINI.md, and AGENTS.md.
+ * prpm handles idempotency - won't duplicate if already installed.
+ */
+export declare function installRelaySnippets(options?: {
+    silent?: boolean;
+}): Promise<{
+    success: boolean;
+    installed: string[];
+}>;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAuGH;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAqC7H"}

package/dist/src/cli/index.js

@@ -29,59 +29,9 @@ import readline from 'node:readline';
 import { promisify } from 'node:util';
 import { exec, spawn as spawnProcess } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
-const RELAY_DASHBOARD_REPO = 'https://github.com/AgentWorkforce/relay-dashboard';
-/**
- * Prompt user to choose how to handle missing dashboard package.
- * Returns: 'npx' | 'install' | 'skip'
- */
-async function promptDashboardInstall() {
-    const rl = readline.createInterface({
-        input: process.stdin,
-        output: process.stdout,
-    });
-    console.log(`
-The web dashboard requires @agent-relay/dashboard-server package.
-
-How would you like to proceed?
-  1. Start with npx (recommended - auto-installs temporarily)
-  2. View installation instructions
-  3. Skip and continue without dashboard
-`);
-    return new Promise((resolve) => {
-        rl.question('Choose [1/2/3]: ', (answer) => {
-            rl.close();
-            const choice = answer.trim();
-            if (choice === '1') {
-                resolve('npx');
-            }
-            else if (choice === '2') {
-                resolve('install');
-            }
-            else {
-                resolve('skip');
-            }
-        });
-    });
-}
-/**
- * Show instructions for installing the external dashboard package.
- */
-function showDashboardInstallInstructions() {
-    console.log(`
-To install the dashboard, run:
-
-  npm install @agent-relay/dashboard-server @agent-relay/dashboard
-
-Then restart with:
-
-  agent-relay up --dashboard
-
-For more options, see: ${RELAY_DASHBOARD_REPO}
-`);
-}
 /**
  * Start dashboard via npx (downloads and runs if not installed).
- * Returns the spawned child process and port.
+ * Returns the spawned child process, port, and a promise that resolves when ready.
  */
 function startDashboardViaNpx(options) {
     console.log('Starting dashboard via npx (this may take a moment on first run)...');
@@ -100,10 +50,21 @@ function startDashboardViaNpx(options) {
             // Pass any additional env vars needed
         },
     });
+    // Promise that resolves when dashboard is ready (or after timeout)
+    let resolveReady;
+    const ready = new Promise((resolve) => {
+        resolveReady = resolve;
+        // Fallback timeout in case we miss the ready signal
+        setTimeout(resolve, 30000);
+    });
     // Forward dashboard output with prefix
     dashboardProcess.stdout?.on('data', (data) => {
         const lines = data.toString().split('\n').filter(Boolean);
         for (const line of lines) {
+            // Detect when dashboard is ready (listening message)
+            if (line.includes('Dashboard:') || line.includes('listening') || line.includes('ready')) {
+                resolveReady();
+            }
             // Don't duplicate the "Dashboard:" line
             if (!line.includes('Dashboard:')) {
                 console.log(`[dashboard] ${line}`);
@@ -118,13 +79,56 @@ function startDashboardViaNpx(options) {
     });
     dashboardProcess.on('error', (err) => {
         console.error('Failed to start dashboard via npx:', err.message);
+        resolveReady(); // Resolve to not block forever
     });
     dashboardProcess.on('exit', (code) => {
+        resolveReady(); // Resolve on exit to not block forever
         if (code !== 0 && code !== null) {
             console.error(`Dashboard process exited with code ${code}`);
         }
     });
-    return { process: dashboardProcess, port: options.port };
+    return { process: dashboardProcess, port: options.port, ready };
+}
+/**
+ * Install agent-relay-snippet to markdown files using prpm.
+ * Installs to CLAUDE.md, GEMINI.md, and AGENTS.md.
+ * prpm handles idempotency - won't duplicate if already installed.
+ */
+export async function installRelaySnippets(options) {
+    const execAsync = promisify(exec);
+    const installed = [];
+    const targets = [
+        { location: 'CLAUDE.md', name: 'CLAUDE.md' },
+        { location: 'GEMINI.md', name: 'GEMINI.md' },
+        { location: undefined, name: 'AGENTS.md' }, // Default location
+    ];
+    for (const target of targets) {
+        try {
+            const args = ['npx', 'prpm', 'install', '@agent-relay/agent-relay-snippet'];
+            if (target.location) {
+                args.push('--location', target.location);
+            }
+            await execAsync(args.join(' '), { timeout: 60000 });
+            installed.push(target.name);
+            if (!options?.silent) {
+                console.log(`    ✓  Installed to ${target.name}`);
+            }
+        }
+        catch (err) {
+            // prpm exits with error if already installed or other issues
+            // Check if it's an "already exists" situation by looking at stderr
+            if (err.stderr?.includes('already') || err.stdout?.includes('already')) {
+                if (!options?.silent) {
+                    console.log(`    ✓  ${target.name} (already installed)`);
+                }
+                installed.push(target.name);
+            }
+            else if (!options?.silent) {
+                console.error(`    ⚠  Failed to install to ${target.name}: ${err.message}`);
+            }
+        }
+    }
+    return { success: installed.length > 0, installed };
 }
 dotenvConfig();
 const DEFAULT_DASHBOARD_PORT = process.env.AGENT_RELAY_DASHBOARD_PORT || '3888';
@@ -465,6 +469,36 @@ program
     const socketPath = paths.socketPath;
     const dbPath = paths.dbPath;
     const pidFilePath = pidFilePathForSocket(socketPath);
+    // Auto-install relay protocol snippets if not already present
+    // Check if the snippet marker exists in any of the target files
+    const snippetTargets = ['CLAUDE.md', 'GEMINI.md', 'AGENTS.md'];
+    const snippetMarker = '<!-- prpm:snippet:start @agent-relay/agent-relay-snippet';
+    const hasSnippetInstalled = snippetTargets.some(file => {
+        const filePath = path.join(paths.projectRoot, file);
+        if (!fs.existsSync(filePath))
+            return false;
+        try {
+            const content = fs.readFileSync(filePath, 'utf-8');
+            return content.includes(snippetMarker);
+        }
+        catch {
+            return false;
+        }
+    });
+    if (!hasSnippetInstalled) {
+        console.log('Installing relay protocol snippets...');
+        try {
+            const result = await installRelaySnippets({ silent: false });
+            if (result.success) {
+                console.log(`Installed snippets to: ${result.installed.join(', ')}`);
+            }
+        }
+        catch (err) {
+            // Non-fatal - continue even if snippet install fails
+            console.log(`Note: Could not auto-install snippets: ${err.message}`);
+        }
+        console.log('');
+    }
     // Set up log file to avoid console output polluting TUI terminals
     // Only set if not already configured via environment
     if (!process.env.AGENT_RELAY_LOG_FILE) {
@@ -578,60 +612,27 @@ program
                 if (err.code === 'ERR_MODULE_NOT_FOUND' || err.code === 'MODULE_NOT_FOUND') {
                     // Dashboard package not installed
                     if (dashboardRequested) {
-                        // User explicitly asked for dashboard but it's not installed
-                        // Only prompt interactively if stdin is a TTY (not in Docker/CI)
-                        if (process.stdin.isTTY) {
-                            console.log('');
-                            const action = await promptDashboardInstall();
-                            if (action === 'npx') {
-                                // Start dashboard via npx
-                                const { process: dashboardProcess, port: npxPort } = startDashboardViaNpx({
-                                    port,
-                                    dataDir: paths.dataDir,
-                                    teamDir: paths.teamDir,
-                                    projectRoot: paths.projectRoot,
-                                });
-                                dashboardPort = npxPort;
-                                // Clean up dashboard process on exit
-                                const cleanupDashboard = () => {
-                                    if (dashboardProcess && !dashboardProcess.killed) {
-                                        dashboardProcess.kill('SIGTERM');
-                                    }
-                                };
-                                process.on('SIGINT', cleanupDashboard);
-                                process.on('SIGTERM', cleanupDashboard);
-                                process.on('exit', cleanupDashboard);
-                                // Wait a moment for dashboard to start
-                                await new Promise(resolve => setTimeout(resolve, 2000));
-                                console.log(`Dashboard: http://localhost:${dashboardPort}`);
+                        // User explicitly asked for dashboard but it's not installed - start via npx
+                        console.log('Dashboard package not installed. Starting via npx...');
+                        const { process: dashboardProcess, port: npxPort, ready } = startDashboardViaNpx({
+                            port,
+                            dataDir: paths.dataDir,
+                            teamDir: paths.teamDir,
+                            projectRoot: paths.projectRoot,
+                        });
+                        dashboardPort = npxPort;
+                        // Clean up dashboard process on exit
+                        const cleanupDashboard = () => {
+                            if (dashboardProcess && !dashboardProcess.killed) {
+                                dashboardProcess.kill('SIGTERM');
                             }
-                            else if (action === 'install') {
-                                showDashboardInstallInstructions();
-                            }
-                        }
-                        else {
-                            // Non-interactive: try npx automatically
-                            console.log('Dashboard package not installed. Starting via npx...');
-                            const { process: dashboardProcess, port: npxPort } = startDashboardViaNpx({
-                                port,
-                                dataDir: paths.dataDir,
-                                teamDir: paths.teamDir,
-                                projectRoot: paths.projectRoot,
-                            });
-                            dashboardPort = npxPort;
-                            // Clean up dashboard process on exit
-                            const cleanupDashboard = () => {
-                                if (dashboardProcess && !dashboardProcess.killed) {
-                                    dashboardProcess.kill('SIGTERM');
-                                }
-                            };
-                            process.on('SIGINT', cleanupDashboard);
-                            process.on('SIGTERM', cleanupDashboard);
-                            process.on('exit', cleanupDashboard);
-                            // Wait a moment for dashboard to start
-                            await new Promise(resolve => setTimeout(resolve, 3000));
-                            console.log(`Dashboard: http://localhost:${dashboardPort}`);
-                        }
+                        };
+                        process.on('SIGINT', cleanupDashboard);
+                        process.on('SIGTERM', cleanupDashboard);
+                        process.on('exit', cleanupDashboard);
+                        // Wait for dashboard to be ready
+                        await ready;
+                        console.log(`Dashboard: http://localhost:${dashboardPort}`);
                     }
                     // Silent if user didn't explicitly request dashboard
                 }
@@ -3155,10 +3156,11 @@ async function runInit(options) {
         console.log('  ○  Daemon is not running');
     }
     console.log('');
-    // Step 3: Install MCP for editors
+    // Step 1: Install MCP for editors (only if RELAY_MCP_AUTO_INSTALL=1)
     let mcpInstalled = false;
-    if (!options.skipMcp) {
-        console.log('  ┌─ Step 1: MCP Server for AI Editors ─────────────────────┐');
+    const mcpAutoInstallEnabled = process.env.RELAY_MCP_AUTO_INSTALL === '1';
+    if (!options.skipMcp && mcpAutoInstallEnabled) {
+        console.log('  ┌─ MCP Server for AI Editors ───────────────────────────────┐');
         console.log('  │                                                          │');
         console.log('  │  MCP (Model Context Protocol) gives AI editors native    │');
         console.log('  │  tools for agent communication:                          │');
@@ -3193,9 +3195,9 @@ async function runInit(options) {
             console.log('');
         }
     }
-    // Step 4: Start daemon
+    // Start daemon
     if (!daemonRunning && !options.skipDaemon) {
-        console.log('  ┌─ Step 2: Start the Relay Daemon ─────────────────────────┐');
+        console.log('  ┌─ Start the Relay Daemon ──────────────────────────────────┐');
         console.log('  │                                                          │');
         console.log('  │  The daemon manages agent connections and message        │');
         console.log('  │  routing. It runs in the background.                     │');