@llmnesia/mcp 0.1.5 → 0.1.7

package/README.md

@@ -48,10 +48,12 @@ The installer:
 1. sets up the native host that bridges the browser extension to your local
    corpus,
 2. copies the server into `~/.llmnesia/bin` so it has a permanent home,
-3. detects supported MCP clients you have (Claude Code, Claude Desktop,
-   Cursor, and Codex), and
-4. registers that copy with each detected client — using the client's own CLI
-   where available, or with an automatic backup before editing its config file.
+3. sets up the supported desktop AI apps (Claude Code, Claude Desktop, Cursor,
+   and Codex/ChatGPT), and
+4. registers that copy using the client's own CLI where available, or with an
+   automatic backup before editing its documented user config. It prepares all
+   of those standard config paths, so an app installed later does not require
+   running setup again.
 
 The `install` command is the approval to perform those setup steps. It does not
 interrupt setup with a separate prompt for every detected app, and it never
@@ -118,10 +120,10 @@ received data — check it before concluding a chat does not exist.
 
 | Client | How `install` wires it |
 | --- | --- |
-| Claude Code | Runs `claude mcp add --scope user` with the absolute Node and installed runtime paths, making it available in every project (detects `claude` on PATH). |
-| Claude Desktop | Edits `claude_desktop_config.json` at the standard OS-specific path. |
-| Cursor | Edits `~/.cursor/mcp.json`. |
-| Codex | Runs `codex mcp add` with the absolute runtime paths when available. If Windows does not expose the app's bundled CLI, the installer safely edits `~/.codex/config.toml` itself and backs up existing settings first. Read-only LLMnesia tools are configured to run without repeated approval prompts; writes still ask. |
+| Claude Code | Runs `claude mcp add --scope user` with the absolute Node and installed runtime paths when available. Otherwise it writes the documented user-scope `~/.claude.json` entry, so Windows users do not need the `claude` command on PATH. |
+| Claude Desktop | Edits `claude_desktop_config.json` at the standard OS-specific path, preparing it in advance if Claude Desktop is installed later. |
+| Cursor | Edits `~/.cursor/mcp.json`, preparing it in advance if Cursor is installed later. |
+| Codex / ChatGPT desktop | Runs `codex mcp add` with the absolute runtime paths when available. If the bundled CLI is unavailable, the installer safely edits `~/.codex/config.toml` itself and backs up existing settings first, including preparing it for a later installation. Read-only LLMnesia tools are configured to run without repeated approval prompts; writes still ask. |
 | Others (Windsurf, Zed, LM Studio, …) | Prints the generic stdio block for you to paste. |
 
 **Cloud-only clients cannot reach a local stdio server** (web ChatGPT, Lovable,

package/dist/{chunk-YVBAQ5VA.js → chunk-VVUZBDC7.js}

@@ -38,7 +38,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/version.ts
-var VERSION = true ? "0.1.5" : "0.0.0-dev";
+var VERSION = true ? "0.1.7" : "0.0.0-dev";
 
 export {
   __require,

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

@@ -15,7 +15,7 @@ import {
   __commonJS,
   __require,
   __toESM
-} from "./chunk-YVBAQ5VA.js";
+} from "./chunk-VVUZBDC7.js";
 
 // ../node_modules/isexe/windows.js
 var require_windows = __commonJS({
@@ -2606,7 +2606,7 @@ async function watchInbox(corpus, onDrain) {
 // src/clientRegistration.ts
 var import_cross_spawn = __toESM(require_cross_spawn(), 1);
 import { execFile as execFile2 } from "child_process";
-import { access, readFile as readFile2, stat as stat5, writeFile as writeFile2 } from "fs/promises";
+import { access, mkdir as mkdir2, readFile as readFile2, stat as stat5, writeFile as writeFile2 } from "fs/promises";
 import { homedir as homedir2, platform as platform2 } from "os";
 import { dirname as dirname4, join as join4 } from "path";
 import { promisify as promisify2 } from "util";
@@ -2820,9 +2820,11 @@ ${"stderr" in err ? String(err.stderr) : ""}` : errorMessage(err);
     await runCodex(["mcp", "remove", name]);
   }
 };
-function paths(home2, osPlatform2) {
-  const claudeDesktop = osPlatform2 === "darwin" ? join4(home2, "Library", "Application Support", "Claude", "claude_desktop_config.json") : osPlatform2 === "win32" ? join4(process.env.APPDATA || join4(home2, "AppData", "Roaming"), "Claude", "claude_desktop_config.json") : null;
+function paths(home2, osPlatform2, appData) {
+  const claudeCodeRoot = process.env.CLAUDE_CONFIG_DIR || home2;
+  const claudeDesktop = osPlatform2 === "darwin" ? join4(home2, "Library", "Application Support", "Claude", "claude_desktop_config.json") : osPlatform2 === "win32" ? join4(appData || process.env.APPDATA || join4(home2, "AppData", "Roaming"), "Claude", "claude_desktop_config.json") : null;
   return {
+    claudeCode: join4(claudeCodeRoot, ".claude.json"),
     claudeDesktop,
     cursor: join4(home2, ".cursor", "mcp.json"),
     codex: join4(home2, ".codex", "config.toml")
@@ -2870,10 +2872,13 @@ async function clientDirExists(configPath) {
     return false;
   }
 }
-async function registerClaudeCode(serve, cli, confirm) {
+async function registerClaudeCode(serve, cli, configPath, confirm, now, prepareMissing) {
   const present = await cli.detect();
   if (!present) {
-    return { client: "Claude Code", action: "skipped", detail: "`claude` not found on PATH." };
+    if (!prepareMissing) {
+      return { client: "Claude Code", action: "skipped", detail: "`claude` not found on PATH." };
+    }
+    return registerJsonClient("Claude Code", configPath, serve, confirm, now, prepareMissing, true);
   }
   let existing;
   try {
@@ -2955,15 +2960,19 @@ 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, now) {
+async function registerCodex(serve, cli, configPath, confirm, now, prepareMissing = false) {
   if (!await cli.detect()) {
-    if (!await clientDirExists(configPath)) {
+    const configDirExists = await clientDirExists(configPath);
+    if (!configDirExists && !prepareMissing) {
       return {
         client: "Codex",
         action: "skipped",
         detail: `Not installed (no Codex CLI and no ${dirname4(configPath)}).`
       };
     }
+    if (!configDirExists) {
+      await mkdir2(dirname4(configPath), { recursive: true });
+    }
     try {
       const raw = await readFile2(configPath, "utf8");
       if (renderCodexConfig(raw, serve) === raw) {
@@ -2986,8 +2995,8 @@ ${codexBlock(serve)}`
       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}.`
+        action: update.changed ? configDirExists ? "registered" : "prepared" : "skipped",
+        detail: update.changed ? configDirExists ? `Wrote ${configPath}${update.backupPath ? ` (backup: ${update.backupPath})` : ""}.` : `Prepared ${configPath} for a future Codex or ChatGPT installation.` : `Already registered at ${configPath}.`
       };
     } catch (err) {
       return { client: "Codex", action: "error", detail: `Could not update ${configPath}: ${errorMessage(err)}` };
@@ -3068,14 +3077,22 @@ codex mcp add ${SERVER_NAME} -- ${serve.command} ${serve.args.join(" ")}`
     detail: `Ran: codex mcp add ${SERVER_NAME} -- ${serve.command} ${serve.args.join(" ")}`
   };
 }
-async function registerJsonClient(clientLabel, configPath, serve, confirm, now) {
-  if (!await clientDirExists(configPath)) {
+async function registerJsonClient(clientLabel, configPath, serve, confirm, now, prepareMissing = false, prepareWhenConfigAbsent = false) {
+  const configDirExists = await clientDirExists(configPath);
+  if (!configDirExists && !prepareMissing) {
     return {
       client: clientLabel,
       action: "skipped",
       detail: `Not installed (no ${dirname4(configPath)}). Re-run install after setting it up.`
     };
   }
+  if (!configDirExists) {
+    try {
+      await mkdir2(dirname4(configPath), { recursive: true });
+    } catch (err) {
+      return { client: clientLabel, action: "error", detail: `Could not prepare ${configPath}: ${errorMessage(err)}` };
+    }
+  }
   let data;
   let existed;
   let raw;
@@ -3112,7 +3129,11 @@ ${preview}`;
     const nextData = { ...data, mcpServers: { ...servers, [SERVER_NAME]: nextEntry } };
     await writeFile2(configPath, `${JSON.stringify(nextData, null, 2)}
 `, "utf8");
-    return { client: clientLabel, action: "registered", detail: `Wrote ${configPath}.` };
+    return {
+      client: clientLabel,
+      action: configDirExists && !(prepareWhenConfigAbsent && !existed) ? "registered" : "prepared",
+      detail: configDirExists ? prepareWhenConfigAbsent && !existed ? `Prepared ${configPath} for a future ${clientLabel} installation.` : `Wrote ${configPath}.` : `Prepared ${configPath} for a future ${clientLabel} installation.`
+    };
   } catch (err) {
     return { client: clientLabel, action: "error", detail: `Could not write ${configPath}: ${errorMessage(err)}` };
   }
@@ -3205,7 +3226,8 @@ async function registerClients(options) {
   const home2 = options.home ?? homedir2();
   const osPlatform2 = options.osPlatform ?? platform2();
   const now = options.now ?? (() => Date.now());
-  const { claudeDesktop, cursor, codex } = paths(home2, osPlatform2);
+  const prepareMissing = options.prepareMissingDesktopApps === true;
+  const { claudeCode, claudeDesktop, cursor, codex } = paths(home2, osPlatform2, options.appData);
   const results = [];
   const safe = async (client, fn) => {
     try {
@@ -3217,22 +3239,31 @@ async function registerClients(options) {
   results.push(
     await safe(
       "Claude Code",
-      () => registerClaudeCode(options.serve, options.claudeCli ?? realClaudeCli, options.confirm)
+      () => registerClaudeCode(
+        options.serve,
+        options.claudeCli ?? realClaudeCli,
+        claudeCode,
+        options.confirm,
+        now,
+        prepareMissing
+      )
     )
   );
   if (claudeDesktop) {
     results.push(
       await safe(
         "Claude Desktop",
-        () => registerJsonClient("Claude Desktop", claudeDesktop, options.serve, options.confirm, now)
+        () => registerJsonClient("Claude Desktop", claudeDesktop, options.serve, options.confirm, now, prepareMissing)
       )
     );
   }
-  results.push(await safe("Cursor", () => registerJsonClient("Cursor", cursor, options.serve, options.confirm, now)));
+  results.push(
+    await safe("Cursor", () => registerJsonClient("Cursor", cursor, options.serve, options.confirm, now, prepareMissing))
+  );
   results.push(
     await safe(
       "Codex",
-      () => registerCodex(options.serve, options.codexCli ?? realCodexCli, codex, options.confirm, now)
+      () => registerCodex(options.serve, options.codexCli ?? realCodexCli, codex, options.confirm, now, prepareMissing)
     )
   );
   results.push({
@@ -3378,7 +3409,7 @@ import { delimiter, dirname as dirname6, isAbsolute as isAbsolute2, join as join
 import { homedir as homedir4, platform as platform3 } from "os";
 
 // src/runtimeInstall.ts
-import { cp, mkdir as mkdir2, readdir as readdir3, rename, rm as rm2, writeFile as writeFile3 } from "fs/promises";
+import { cp, mkdir as mkdir3, readdir as readdir3, rename, rm as rm2, writeFile as writeFile3 } from "fs/promises";
 import { existsSync } from "fs";
 import { homedir as homedir3 } from "os";
 import { dirname as dirname5, join as join5 } from "path";
@@ -3404,10 +3435,10 @@ async function installRuntime(options = {}) {
   const nonce = `${process.pid}-${Date.now()}`;
   const stagingDir = join5(parentDir, `.bin-install-${nonce}`);
   const backupDir = join5(parentDir, `.bin-backup-${nonce}`);
-  await mkdir2(parentDir, { recursive: true });
+  await mkdir3(parentDir, { recursive: true });
   await rm2(stagingDir, { recursive: true, force: true });
   await rm2(backupDir, { recursive: true, force: true });
-  await mkdir2(stagingDir, { recursive: true });
+  await mkdir3(stagingDir, { recursive: true });
   try {
     for (const name of await readdir3(sourceDir)) {
       await cp(join5(sourceDir, name), join5(stagingDir, name), { recursive: true });
@@ -3793,66 +3824,67 @@ ${message}
     rl.close();
   }
 }
-function printRegistrationResults(results) {
-  for (const r of results) {
-    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}
-`);
-    }
-  }
+function summarizeClientRegistrations(results) {
+  const connected = [];
+  const prepared = [];
+  const errors = [];
+  for (const result of results) {
+    if (result.client.startsWith("Other MCP clients")) continue;
+    if (result.action === "registered" || result.action === "skipped" && result.detail.startsWith("Already registered")) {
+      connected.push(result.client);
+    } else if (result.action === "prepared") {
+      prepared.push(result.client);
+    } else if (result.action === "error") {
+      errors.push({ client: result.client, detail: result.detail });
+    }
+  }
+  return { connected, prepared, errors };
+}
+function formatInstallSuccess() {
+  return "\nSetup complete.\nFully close and reopen your browser and any desktop AI app you use.\nLLMnesia will be available in each supported desktop AI app you use.\nLLMnesia Settings will confirm when your history is ready.\n";
 }
 async function runInstall(positionals, options, flags) {
   let hadProblems = false;
-  process.stdout.write("Installing LLMnesia MCP\u2026\n");
+  process.stdout.write("Connecting your browser...\n");
   try {
-    const host = await installNativeHost({
+    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"})
-`);
+    process.stdout.write("Browser connected.\n");
   } catch (err) {
     hadProblems = true;
-    process.stderr.write(`\u2717 Browser helper: ${err instanceof Error ? err.message : String(err)}
+    process.stderr.write(`Could not connect your browser: ${err instanceof Error ? err.message : String(err)}
 `);
   }
-  const runtime = await installRuntime();
-  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(
-    "\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"
-  );
-  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.
+  process.stdout.write("Connecting your desktop AI apps...\n");
+  let runtime;
+  try {
+    runtime = await installRuntime();
+  } catch (err) {
+    process.stderr.write(`Could not install LLMnesia: ${err instanceof Error ? err.message : String(err)}
 `);
+    process.stderr.write("Setup needs attention. Fix the message above, then run the same command again.\n");
+    return 1;
+  }
+  const results = await registerClients({
+    serve: runtime.serve,
+    confirm: async () => true,
+    prepareMissingDesktopApps: true
+  });
+  const registrations = summarizeClientRegistrations(results);
+  for (const error of registrations.errors) {
+    process.stderr.write(`Could not connect ${error.client}: ${error.detail}
+`);
+  }
+  hadProblems ||= registrations.errors.length > 0;
   if (hadProblems) {
-    process.stderr.write(
-      "\nInstall completed with problems. Review the error messages above; no failure was silently treated as success.\n"
-    );
+    process.stderr.write("\nSetup needs attention. Fix the message above, then run the same command again.\n");
     return 1;
   }
+  process.stdout.write(formatInstallSuccess());
   return 0;
 }
 async function runUninstall(flags) {
@@ -3867,10 +3899,19 @@ async function runUninstall(flags) {
     }
   }
   const results = await unregisterClients();
-  printRegistrationResults(results);
+  for (const result of results) {
+    if (result.client.startsWith("Other MCP clients")) continue;
+    if (result.action === "registered") {
+      process.stdout.write(`${result.client} disconnected.
+`);
+    } else if (result.action === "error") {
+      process.stderr.write(`Could not disconnect ${result.client}: ${result.detail}
+`);
+    }
+  }
   if (results.some((result) => result.action === "error")) {
     process.stderr.write(
-      "Uninstall stopped before removing the runtime or browser host because one or more client registrations could not be removed. Fix the \u2717 messages above and retry.\n"
+      "Uninstall stopped before removing the remaining files. Fix the message above and try again.\n"
     );
     return 1;
   }
@@ -4062,7 +4103,9 @@ function collapse(text) {
   return text.replace(/\s+/g, " ").trim();
 }
 export {
-  main
+  formatInstallSuccess,
+  main,
+  summarizeClientRegistrations
 };
 /*! Bundled license information:
 

package/dist/cli.js

@@ -3,7 +3,7 @@ import { createRequire as __llmnesiaCreateRequire } from "node:module";
 const require = __llmnesiaCreateRequire(import.meta.url);
 import {
   VERSION
-} from "./chunk-YVBAQ5VA.js";
+} from "./chunk-VVUZBDC7.js";
 
 // src/nodeDownload.ts
 var NODE_DOWNLOAD_URLS = {
@@ -141,7 +141,7 @@ async function bootstrap() {
     await guideUnsupportedNodeVersion(process.versions.node);
     return 1;
   }
-  const { main } = await import("./cli-TVE63AWC.js");
+  const { main } = await import("./cli-I5OU54IJ.js");
   return main();
 }
 bootstrap().then((code) => {

package/dist/mcp.js

@@ -13,7 +13,7 @@ import {
   __commonJS,
   __export,
   __toESM
-} from "./chunk-YVBAQ5VA.js";
+} from "./chunk-VVUZBDC7.js";
 
 // ../node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llmnesia/mcp",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "private": false,
   "type": "module",
   "comment:mcpName": "The MCP Registry's ownership marker: it must equal server.json's `name`, and the namespace must match how you authenticate with mcp-publisher. `com.llmnesia/...` requires DNS auth (a TXT record on llmnesia.com) — see docs/MCP_INSTALLER_BOARD.md.",