@llmnesia/mcp 0.1.2 → 0.1.5

package/dist/{cli-CNIF4XT3.js → cli-TVE63AWC.js}

@@ -9,13 +9,13 @@ import {
   ingestFile,
   openSearchIndex,
   resolveCorpusDir
-} from "./chunk-7BW63ZTP.js";
+} from "./chunk-3JQ7CGCP.js";
 import {
   VERSION,
   __commonJS,
   __require,
   __toESM
-} from "./chunk-BQM5Q4XX.js";
+} from "./chunk-YVBAQ5VA.js";
 
 // ../node_modules/isexe/windows.js
 var require_windows = __commonJS({
@@ -533,6 +533,7 @@ var HOST_NAME = "com.llmnesia.claude_code";
 var STORE_EXTENSION_ID = "leekfgbdojiaabifbjbbgiiclannjdkf";
 var here = dirname(fileURLToPath(import.meta.url));
 var home = homedir();
+var CLAUDE_PROJECTS_DIR = join(home, ".claude", "projects");
 var osPlatform = process.env.LLMNESIA_FAKE_PLATFORM || platform();
 function expandHome(p) {
   if (p === "~") {
@@ -547,6 +548,11 @@ function resolveCorpusDir2(explicit) {
   const raw = explicit ?? process.env.LLMNESIA_CORPUS_DIR ?? "~/.llmnesia/corpus";
   return expandHome(raw);
 }
+function resolveCodexHome(explicit) {
+  const candidates = [explicit, process.env.CODEX_HOME, "~/.codex"];
+  const raw = candidates.find((value) => typeof value === "string" && value.trim() !== "");
+  return expandHome(raw.trim());
+}
 async function exists(path) {
   try {
     await stat(path);
@@ -573,21 +579,24 @@ async function readExistingConfig(configPath) {
     if (err && typeof err === "object" && err.code === "ENOENT") {
       return null;
     }
-    throw new Error(`Could not read existing native-host config at ${configPath}: ${err instanceof Error ? err.message : String(err)}`);
+    throw new Error(`LLMnesia couldn't read its settings at ${configPath}: ${err instanceof Error ? err.message : String(err)}. Nothing was changed.`);
   }
   let parsed;
   try {
     parsed = JSON.parse(raw);
   } catch (err) {
     throw new Error(
-      `Could not parse existing native-host config at ${configPath}: ${err instanceof Error ? err.message : String(err)}. The file was left unchanged.`
+      `LLMnesia found invalid JSON in its settings at ${configPath}: ${err instanceof Error ? err.message : String(err)}. Nothing was changed; repair or move that file aside, then retry.`
     );
   }
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new Error(`Existing native-host config at ${configPath} must be a JSON object. The file was left unchanged.`);
+    throw new Error(`LLMnesia settings at ${configPath} must contain a JSON object. Nothing was changed.`);
   }
   if ("corpusRoot" in parsed && typeof parsed.corpusRoot !== "string") {
-    throw new Error(`Existing native-host config at ${configPath} has an invalid corpusRoot. The file was left unchanged.`);
+    throw new Error(`LLMnesia settings at ${configPath} contain an invalid conversation-data folder. Nothing was changed.`);
+  }
+  if ("codexHome" in parsed && typeof parsed.codexHome !== "string") {
+    throw new Error(`LLMnesia settings at ${configPath} contain an invalid Codex data folder. Nothing was changed.`);
   }
   return parsed;
 }
@@ -609,7 +618,7 @@ function posixBrowsers(homeDir = home, forPlatform = osPlatform) {
     ["Chromium", join(base, "chromium")]
   ];
 }
-async function installPosix(manifestBase, hostPath) {
+async function installPosix(manifestBase, hostPath, log) {
   const manifest = { ...manifestBase, path: hostPath };
   let installed = 0;
   for (const [label, browserDir] of posixBrowsers()) {
@@ -620,7 +629,7 @@ async function installPosix(manifestBase, hostPath) {
     await mkdir(dir, { recursive: true });
     await writeFile(join(dir, `${HOST_NAME}.json`), `${JSON.stringify(manifest, null, 2)}
 `, "utf8");
-    console.log(`Manifest \u2192 ${label}: ${join(dir, `${HOST_NAME}.json`)}`);
+    log(`\u2713 ${label} connected`);
     installed += 1;
   }
   return installed;
@@ -634,17 +643,16 @@ function windowsBrowsers() {
     ["Chromium", join(localAppData, "Chromium", "User Data"), "Software\\Chromium"]
   ];
 }
-async function installWindows(manifestBase, hostPath, installDir) {
+async function installWindows(manifestBase, hostPath, installDir, log) {
   const batPath = join(installDir, "llmnesia-claude-host.bat");
   await writeFile(batPath, `@echo off\r
 "${process.execPath}" "${hostPath}" %*\r
 `, "utf8");
-  console.log(`Launcher \u2192 ${batPath}`);
+  log("\u2713 Windows launcher ready");
   const manifest = { ...manifestBase, path: batPath };
   const manifestPath = join(installDir, `${HOST_NAME}.json`);
   await writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
 `, "utf8");
-  console.log(`Manifest \u2192 ${manifestPath}`);
   let installed = 0;
   for (const [label, userDataDir, vendorKey] of windowsBrowsers()) {
     if (!await exists(userDataDir)) {
@@ -653,21 +661,27 @@ async function installWindows(manifestBase, hostPath, installDir) {
     const key = `HKCU\\${vendorKey}\\NativeMessagingHosts\\${HOST_NAME}`;
     const regExe = join(process.env.SystemRoot || "C:\\Windows", "System32", "reg.exe");
     await execFileAsync(regExe, ["add", key, "/ve", "/t", "REG_SZ", "/d", manifestPath, "/f"]);
-    console.log(`Registry \u2192 ${label}: ${key}`);
+    log(`\u2713 ${label} connected`);
     installed += 1;
   }
   return installed;
 }
-async function installNativeHost({ ids = [], corpus, force = false } = {}) {
+async function installNativeHost({ ids = [], corpus, codexHome, force = false, quiet = false } = {}) {
+  const log = quiet ? () => {
+  } : console.log;
   const isWindows2 = osPlatform === "win32";
   const invalidId = ids.find((id) => !/^[a-p]{32}$/.test(id));
   if (invalidId) {
-    throw new Error(`Invalid Chromium extension id: ${JSON.stringify(invalidId)}. Expected 32 letters from a through p.`);
+    throw new Error(
+      `${JSON.stringify(invalidId)} is not a Chromium extension ID. Only unpacked/development builds need an ID; it must be 32 letters from a through p. Run with --help for an example.`
+    );
   }
   const allIds = [.../* @__PURE__ */ new Set([STORE_EXTENSION_ID, ...ids])];
   const allowedOrigins = allIds.map((id) => `chrome-extension://${id}/`);
   if (await supportedBrowserCount(isWindows2) === 0) {
-    throw new Error("No supported Chromium browser found (Chrome, Brave, Edge, or Chromium) \u2014 the browser helper was not installed.");
+    throw new Error(
+      "LLMnesia couldn't find Chrome, Brave, Edge, or Chromium. Open your browser once so it creates a profile, then retry. Safari and Firefox are not supported yet. Nothing was installed."
+    );
   }
   const installDir = join(home, ".llmnesia");
   const configPath = join(installDir, "config.json");
@@ -681,38 +695,68 @@ async function installNativeHost({ ids = [], corpus, force = false } = {}) {
   if (!isWindows2) {
     await chmod(hostPath, 493);
   }
-  console.log(`Host script \u2192 ${hostPath}`);
+  log("\u2713 Helper installed");
   const manifestBase = {
     name: HOST_NAME,
-    description: "LLMnesia \u2014 reads local Claude Code sessions",
+    description: "LLMnesia \u2014 reads local Claude Code and Codex sessions",
     type: "stdio",
     allowed_origins: allowedOrigins
   };
-  const installedCount = isWindows2 ? await installWindows(manifestBase, hostPath, installDir) : await installPosix(manifestBase, hostPath);
+  const installedCount = isWindows2 ? await installWindows(manifestBase, hostPath, installDir, log) : await installPosix(manifestBase, hostPath, log);
   const corpusRoot = resolveCorpusDir2(corpus);
+  const resolvedCodexHome = resolveCodexHome(codexHome);
   const existingRoot = existing && typeof existing.corpusRoot === "string" ? existing.corpusRoot : null;
   let corpusRootChanged = true;
   if (existingRoot && existingRoot !== corpusRoot && !force) {
     corpusRootChanged = false;
-    console.log(`Corpus config kept \u2192 ${configPath}`);
-    console.log(`  already points at: ${existingRoot}`);
-    console.log(`  to change it: re-run with --corpus <dir> --force`);
+    await writeFile(
+      configPath,
+      `${JSON.stringify({ ...existing, corpusRoot: existingRoot, codexHome: resolvedCodexHome }, null, 2)}
+`,
+      { encoding: "utf8", mode: 384 }
+    );
+    await chmod(configPath, 384);
+    log("\u2713 Kept your existing conversation-data folder");
+    log(`  Conversation data: ${existingRoot}`);
+    log(`  To change it: re-run with --corpus <dir> --force`);
+    log(`  Codex data: ${resolvedCodexHome}`);
   } else {
-    await writeFile(configPath, `${JSON.stringify({ corpusRoot }, null, 2)}
-`, { encoding: "utf8", mode: 384 });
+    await writeFile(
+      configPath,
+      `${JSON.stringify({ ...existing ?? {}, corpusRoot, codexHome: resolvedCodexHome }, null, 2)}
+`,
+      { encoding: "utf8", mode: 384 }
+    );
     await chmod(configPath, 384);
-    console.log(`Corpus config \u2192 ${configPath}`);
-    console.log(`  corpus root: ${corpusRoot}`);
+    log("\u2713 Settings saved");
+    log(`  Conversation data: ${corpusRoot}`);
+    log(`  Codex data: ${resolvedCodexHome}`);
+  }
+  const [hasClaudeCode, hasCodex] = await Promise.all([
+    exists(CLAUDE_PROJECTS_DIR),
+    exists(join(resolvedCodexHome, "sessions"))
+  ]);
+  log("");
+  log(
+    hasClaudeCode ? `\u2713 Found Claude Code sessions at ${CLAUDE_PROJECTS_DIR}` : `\u2013 No Claude Code sessions found yet (fine if you don't use Claude Code).`
+  );
+  log(
+    hasCodex ? `\u2713 Found Codex sessions at ${resolvedCodexHome}` : `\u2013 No Codex sessions found yet (fine if you don't use Codex).`
+  );
+  const extraIdCount = allIds.length - 1;
+  if (extraIdCount > 0) {
+    log(`\u2713 Also authorized ${extraIdCount} unpacked extension ${extraIdCount === 1 ? "build" : "builds"}`);
   }
-  console.log(`
-Done. Allowed extension id(s): ${allIds.join(", ")}`);
-  console.log("Fully quit and reopen the browser, then open LLMnesia Settings.");
+  log("\nAll set \u2014 LLMnesia can now read your local coding-agent sessions.");
+  log("Next: fully quit your browser (not just close its window), reopen it, then open LLMnesia Settings.");
+  log("If it doesn't connect, run: npx -y @llmnesia/local-agent-host@latest doctor");
   return {
     installedCount,
     allowedIds: allIds,
     configPath,
     corpusRoot: existingRoot && !corpusRootChanged ? existingRoot : corpusRoot,
-    corpusRootChanged
+    corpusRootChanged,
+    codexHome: resolvedCodexHome
   };
 }
 async function uninstallNativeHost() {
@@ -2568,6 +2612,7 @@ import { dirname as dirname4, join as join4 } from "path";
 import { promisify as promisify2 } from "util";
 var execFileAsync2 = promisify2(execFile2);
 var SERVER_NAME = "llmnesia";
+var CODEX_APPROVAL_MODE = "writes";
 async function commandOnPath(name) {
   try {
     const { stdout } = await execFileAsync2(process.platform === "win32" ? "where" : "which", [name]);
@@ -2910,7 +2955,7 @@ claude mcp add --scope user ${SERVER_NAME} -- ${serve.command} ${serve.args.join
 function sameServeCommand(left, right) {
   return left.command === right.command && JSON.stringify(left.args) === JSON.stringify(right.args);
 }
-async function registerCodex(serve, cli, configPath, confirm) {
+async function registerCodex(serve, cli, configPath, confirm, now) {
   if (!await cli.detect()) {
     if (!await clientDirExists(configPath)) {
       return {
@@ -2919,12 +2964,34 @@ async function registerCodex(serve, cli, configPath, confirm) {
         detail: `Not installed (no Codex CLI and no ${dirname4(configPath)}).`
       };
     }
-    return {
-      client: "Codex",
-      action: "printed",
-      detail: `Codex's CLI was not found. Add this to ${configPath}:
-${codexBlock(serve)}Then fully quit and reopen Codex.`
-    };
+    try {
+      const raw = await readFile2(configPath, "utf8");
+      if (renderCodexConfig(raw, serve) === raw) {
+        return { client: "Codex", action: "skipped", detail: `Already registered at ${configPath}.` };
+      }
+    } catch (err) {
+      if (!(isErrnoException(err) && err.code === "ENOENT")) {
+        return { client: "Codex", action: "error", detail: `Could not inspect ${configPath}: ${errorMessage(err)}` };
+      }
+    }
+    const ok2 = await confirm(
+      `Codex: update ${configPath} to register LLMnesia? Existing settings are preserved and backed up.
+Add:
+${codexBlock(serve)}`
+    );
+    if (!ok2) {
+      return { client: "Codex", action: "declined", detail: "Skipped by user." };
+    }
+    try {
+      const update = await writeCodexConfig(configPath, serve, now);
+      return {
+        client: "Codex",
+        action: update.changed ? "registered" : "skipped",
+        detail: update.changed ? `Wrote ${configPath}${update.backupPath ? ` (backup: ${update.backupPath})` : ""}.` : `Already registered at ${configPath}.`
+      };
+    } catch (err) {
+      return { client: "Codex", action: "error", detail: `Could not update ${configPath}: ${errorMessage(err)}` };
+    }
   }
   let existing;
   try {
@@ -2933,7 +3000,20 @@ ${codexBlock(serve)}Then fully quit and reopen Codex.`
     return { client: "Codex", action: "error", detail: `Could not inspect Codex MCP settings: ${errorMessage(err)}` };
   }
   if (existing?.serve && sameServeCommand(existing.serve, serve)) {
-    return { client: "Codex", action: "skipped", detail: "Already registered." };
+    try {
+      const update = await writeCodexConfig(configPath, serve, now);
+      return {
+        client: "Codex",
+        action: update.changed ? "registered" : "skipped",
+        detail: update.changed ? `Already registered; updated tool approval policy in ${configPath}.` : "Already registered."
+      };
+    } catch (err) {
+      return {
+        client: "Codex",
+        action: "error",
+        detail: `Already registered, but could not set its tool approval policy: ${errorMessage(err)}`
+      };
+    }
   }
   if (existing && !existing.serve) {
     return {
@@ -2973,6 +3053,15 @@ codex mcp add ${SERVER_NAME} -- ${serve.command} ${serve.args.join(" ")}`
     }
     return { client: "Codex", action: "error", detail: `codex mcp add failed: ${errorMessage(err)}` };
   }
+  try {
+    await writeCodexConfig(configPath, serve, now);
+  } catch (err) {
+    return {
+      client: "Codex",
+      action: "error",
+      detail: `Registered the server, but could not set its tool approval policy in ${configPath}: ${errorMessage(err)}`
+    };
+  }
   return {
     client: "Codex",
     action: "registered",
@@ -3006,8 +3095,9 @@ async function registerJsonClient(clientLabel, configPath, serve, confirm, now)
   if (already && JSON.stringify(already) === JSON.stringify(nextEntry)) {
     return { client: clientLabel, action: "skipped", detail: `Already registered at ${configPath}.` };
   }
-  const preview = JSON.stringify({ mcpServers: { ...servers, [SERVER_NAME]: nextEntry } }, null, 2);
-  const message = existed ? `${clientLabel}: update ${configPath} to add the "${SERVER_NAME}" MCP server?
+  const preview = JSON.stringify({ mcpServers: { [SERVER_NAME]: nextEntry } }, null, 2);
+  const message = existed ? `${clientLabel}: update ${configPath} to add the "${SERVER_NAME}" MCP server? Existing servers and settings are preserved.
+Add:
 ${preview}` : `${clientLabel}: create ${configPath} with the "${SERVER_NAME}" MCP server?
 ${preview}`;
   const ok = await confirm(message);
@@ -3032,8 +3122,82 @@ function codexBlock(serve) {
   return `[mcp_servers.${SERVER_NAME}]
 command = ${JSON.stringify(serve.command)}
 args = [${argsToml}]
+default_tools_approval_mode = ${JSON.stringify(CODEX_APPROVAL_MODE)}
 `;
 }
+function codexHeaders(raw) {
+  const headers = [];
+  const pattern = /^[ \t]*\[([^\]\r\n]+)\][ \t]*(?:#.*)?$/gm;
+  for (let match = pattern.exec(raw); match; match = pattern.exec(raw)) {
+    headers.push({ start: match.index, name: match[1].replace(/[ \t]/g, "") });
+  }
+  return headers;
+}
+function isCodexRootHeader(name) {
+  return /^mcp_servers\.(?:llmnesia|"llmnesia"|'llmnesia')$/.test(name);
+}
+function isCodexChildHeader(name) {
+  return /^mcp_servers\.(?:llmnesia|"llmnesia"|'llmnesia')\./.test(name);
+}
+function codexSectionRange(raw) {
+  const headers = codexHeaders(raw);
+  const roots = headers.filter((header) => isCodexRootHeader(header.name));
+  if (roots.length > 1) {
+    throw new Error(`found more than one [mcp_servers.${SERVER_NAME}] table; the file was left unchanged`);
+  }
+  const root = roots[0];
+  if (!root) {
+    if (headers.some((header) => isCodexChildHeader(header.name))) {
+      throw new Error(
+        `found LLMnesia MCP subtables without a [mcp_servers.${SERVER_NAME}] table; the file was left unchanged`
+      );
+    }
+    return null;
+  }
+  const rootIndex = headers.indexOf(root);
+  let end = raw.length;
+  for (let i = rootIndex + 1; i < headers.length; i += 1) {
+    if (!isCodexChildHeader(headers[i].name)) {
+      end = headers[i].start;
+      break;
+    }
+  }
+  return { start: root.start, end };
+}
+function renderCodexConfig(raw, serve) {
+  const newline = raw.includes("\r\n") ? "\r\n" : "\n";
+  const block = codexBlock(serve).replace(/\n/g, newline);
+  const range = codexSectionRange(raw);
+  if (range) {
+    return `${raw.slice(0, range.start)}${block}${raw.slice(range.end)}`;
+  }
+  const base = raw.replace(/[ \t\r\n]+$/g, "");
+  return `${base}${base ? `${newline}${newline}` : ""}${block}`;
+}
+async function writeCodexConfig(configPath, serve, now) {
+  let raw = "";
+  let existed = true;
+  try {
+    raw = await readFile2(configPath, "utf8");
+  } catch (err) {
+    if (isErrnoException(err) && err.code === "ENOENT") {
+      existed = false;
+    } else {
+      throw err;
+    }
+  }
+  const next = renderCodexConfig(raw, serve);
+  if (next === raw) {
+    return { changed: false };
+  }
+  let backupPath;
+  if (existed) {
+    backupPath = `${configPath}.bak-${now()}`;
+    await writeFile2(backupPath, raw, "utf8");
+  }
+  await writeFile2(configPath, next, { encoding: "utf8", mode: 384 });
+  return { changed: true, ...backupPath ? { backupPath } : {} };
+}
 function genericBlock(serve) {
   return JSON.stringify({ mcpServers: { [SERVER_NAME]: { command: serve.command, args: serve.args } } }, null, 2);
 }
@@ -3066,7 +3230,10 @@ async function registerClients(options) {
   }
   results.push(await safe("Cursor", () => registerJsonClient("Cursor", cursor, options.serve, options.confirm, now)));
   results.push(
-    await safe("Codex", () => registerCodex(options.serve, options.codexCli ?? realCodexCli, codex, options.confirm))
+    await safe(
+      "Codex",
+      () => registerCodex(options.serve, options.codexCli ?? realCodexCli, codex, options.confirm, now)
+    )
   );
   results.push({
     client: "Other MCP clients (Windsurf, Zed, LM Studio, ...)",
@@ -3108,20 +3275,27 @@ async function unregisterClaudeCode(cli) {
     };
   }
 }
-async function unregisterCodex(cli, configPath) {
+async function unregisterCodex(cli, configPath, now) {
   if (!await cli.detect()) {
     try {
-      const text = await readFile2(configPath, "utf8");
-      if (new RegExp(`^\\s*\\[mcp_servers\\.${SERVER_NAME}\\]\\s*$`, "m").test(text)) {
-        return {
-          client: "Codex",
-          action: "error",
-          detail: `A registration remains in ${configPath}, but the Codex CLI is unavailable to remove it safely. Restore the CLI and retry. The runtime was retained.`
-        };
+      const raw = await readFile2(configPath, "utf8");
+      const range = codexSectionRange(raw);
+      if (!range) {
+        return { client: "Codex", action: "skipped", detail: "`codex` not found and no registration was detected." };
       }
+      const backupPath = `${configPath}.bak-${now()}`;
+      await writeFile2(backupPath, raw, "utf8");
+      const next = `${raw.slice(0, range.start)}${raw.slice(range.end)}`.replace(/[ \t\r\n]+$/g, "");
+      await writeFile2(configPath, next ? `${next}
+` : "", "utf8");
+      return {
+        client: "Codex",
+        action: "registered",
+        detail: `Removed from ${configPath} (backup: ${backupPath}).`
+      };
     } catch (err) {
       if (!(isErrnoException(err) && err.code === "ENOENT")) {
-        return { client: "Codex", action: "error", detail: `Could not inspect ${configPath}: ${errorMessage(err)}` };
+        return { client: "Codex", action: "error", detail: `Could not update ${configPath}: ${errorMessage(err)}` };
       }
     }
     return { client: "Codex", action: "skipped", detail: "`codex` not found and no registration was detected." };
@@ -3189,7 +3363,7 @@ async function unregisterClients(options = {}) {
     results.push(await safe("Claude Desktop", () => unregisterJsonClient("Claude Desktop", claudeDesktop, now)));
   }
   results.push(await safe("Cursor", () => unregisterJsonClient("Cursor", cursor, now)));
-  results.push(await safe("Codex", () => unregisterCodex(options.codexCli ?? realCodexCli, codex)));
+  results.push(await safe("Codex", () => unregisterCodex(options.codexCli ?? realCodexCli, codex, now)));
   results.push({
     client: "Other MCP clients",
     action: "skipped",
@@ -3594,7 +3768,7 @@ Options:
   --from <iso|ms>      search: only conversations created on/after this date
   --to <iso|ms>        search: only conversations created on/before this date
   --force              install: overwrite a differing corpus root in config.json
-  --yes, -y            install/uninstall: skip confirmation prompts
+  --yes, -y            uninstall: skip its confirmation prompt
   --version, -v        print the version and exit
 `;
 function parseDate(value) {
@@ -3621,38 +3795,58 @@ ${message}
 }
 function printRegistrationResults(results) {
   for (const r of results) {
-    const icon = r.action === "registered" ? "\u2713" : r.action === "error" ? "\u2717" : "\u2022";
-    process.stdout.write(`${icon} ${r.client}: ${r.detail}
-
+    if (r.client.startsWith("Other MCP clients")) {
+      continue;
+    }
+    if (r.action === "registered") {
+      process.stdout.write(`\u2713 ${r.client}
+`);
+      continue;
+    }
+    if (r.action === "skipped" && r.detail.startsWith("Already registered")) {
+      process.stdout.write(`\u2713 ${r.client} (already configured)
 `);
+      continue;
+    }
+    if (r.action === "error") {
+      process.stderr.write(`\u2717 ${r.client}: ${r.detail}
+`);
+      continue;
+    }
+    if (r.action === "printed") {
+      process.stdout.write(`\u2022 ${r.client}: ${r.detail}
+`);
+    }
   }
 }
 async function runInstall(positionals, options, flags) {
-  const skipConfirm = flags.has("yes");
   let hadProblems = false;
-  process.stdout.write("Installing native messaging host\u2026\n");
+  process.stdout.write("Installing LLMnesia MCP\u2026\n");
   try {
-    await installNativeHost({ ids: positionals, corpus: options.corpus, force: flags.has("force") });
+    const host = await installNativeHost({
+      ids: positionals,
+      corpus: options.corpus,
+      force: flags.has("force"),
+      quiet: true
+    });
+    process.stdout.write(`\u2713 Browser helper (${host.installedCount} browser${host.installedCount === 1 ? "" : "s"})
+`);
   } catch (err) {
     hadProblems = true;
-    process.stderr.write(`
-Native host install failed: ${err instanceof Error ? err.message : String(err)}
+    process.stderr.write(`\u2717 Browser helper: ${err instanceof Error ? err.message : String(err)}
 `);
-    process.stderr.write("Continuing to register MCP clients anyway \u2014 the server itself doesn't need a browser.\n");
   }
-  process.stdout.write("\nInstalling the MCP server runtime\u2026\n");
   const runtime = await installRuntime();
-  process.stdout.write(`Installed to ${runtime.binDir} (running on ${runtime.nodePath})
-`);
-  process.stdout.write("\nRegistering MCP clients\u2026\n\n");
-  const confirm = skipConfirm ? async () => true : promptConfirm;
-  const results = await registerClients({ serve: runtime.serve, confirm });
+  process.stdout.write("\u2713 MCP runtime\n");
+  const results = await registerClients({ serve: runtime.serve, confirm: async () => true });
   printRegistrationResults(results);
   hadProblems ||= results.some((result) => result.action === "error");
   process.stdout.write(
-    "Next step: fully quit and reopen your MCP client (and your browser, if you\nuse the extension). Reloading a window is not enough \u2014 the config is read\nonce at startup.\n\nFor automatic browser-history sync, open LLMnesia Settings and click\n\u2018Enable automatic sync\u2019 once. Chrome requires that one permission click;\nthe existing-history backfill and future updates are automatic after it.\n\n"
+    "\nDesktop helper installed. Fully quit and reopen your MCP apps and browser.\nBrowser sync is required or your MCP history will be empty. If you did not start in LLMnesia Settings, open it and click \u2018Enable automatic sync\u2019 once. LLMnesia will finish the first sync automatically.\n"
   );
-  process.stdout.write("Then run `npx -y @llmnesia/mcp@latest doctor` to check what's wired up.\n");
+  const npxCommand = process.platform === "win32" ? "npx.cmd" : "npx";
+  process.stdout.write(`Then run \`${npxCommand} -y @llmnesia/mcp@latest doctor\` to check what's wired up.
+`);
   if (hadProblems) {
     process.stderr.write(
       "\nInstall completed with problems. Review the error messages above; no failure was silently treated as success.\n"