@llmnesia/mcp 0.1.6 → 0.1.8

package/README.md

@@ -48,12 +48,11 @@ 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.
-   It also prepares the standard Claude Desktop, Cursor, and Codex/ChatGPT
-   config paths, so installing one of those desktop apps later does not require
+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
@@ -121,7 +120,7 @@ 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 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. |

package/dist/{chunk-JBCYML3I.js → chunk-TP5KBWQA.js}

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

package/dist/{cli-LNUL4QWX.js → cli-KDKBKT22.js}

@@ -15,7 +15,7 @@ import {
   __commonJS,
   __require,
   __toESM
-} from "./chunk-JBCYML3I.js";
+} from "./chunk-TP5KBWQA.js";
 
 // ../node_modules/isexe/windows.js
 var require_windows = __commonJS({
@@ -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 {
@@ -3072,7 +3077,7 @@ 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, prepareMissing = false) {
+async function registerJsonClient(clientLabel, configPath, serve, confirm, now, prepareMissing = false, prepareWhenConfigAbsent = false) {
   const configDirExists = await clientDirExists(configPath);
   if (!configDirExists && !prepareMissing) {
     return {
@@ -3103,7 +3108,7 @@ async function registerJsonClient(clientLabel, configPath, serve, confirm, now,
     return { client: clientLabel, action: "error", detail: errorMessage(err) };
   }
   const already = servers[SERVER_NAME];
-  const nextEntry = { command: serve.command, args: serve.args };
+  const nextEntry = { type: "stdio", command: serve.command, args: serve.args };
   if (already && JSON.stringify(already) === JSON.stringify(nextEntry)) {
     return { client: clientLabel, action: "skipped", detail: `Already registered at ${configPath}.` };
   }
@@ -3126,8 +3131,8 @@ ${preview}`;
 `, "utf8");
     return {
       client: clientLabel,
-      action: configDirExists ? "registered" : "prepared",
-      detail: configDirExists ? `Wrote ${configPath}.` : `Prepared ${configPath} for a future ${clientLabel} installation.`
+      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)}` };
@@ -3215,14 +3220,18 @@ async function writeCodexConfig(configPath, serve, now) {
   return { changed: true, ...backupPath ? { backupPath } : {} };
 }
 function genericBlock(serve) {
-  return JSON.stringify({ mcpServers: { [SERVER_NAME]: { command: serve.command, args: serve.args } } }, null, 2);
+  return JSON.stringify(
+    { mcpServers: { [SERVER_NAME]: { type: "stdio", command: serve.command, args: serve.args } } },
+    null,
+    2
+  );
 }
 async function registerClients(options) {
   const home2 = options.home ?? homedir2();
   const osPlatform2 = options.osPlatform ?? platform2();
   const now = options.now ?? (() => Date.now());
   const prepareMissing = options.prepareMissingDesktopApps === true;
-  const { claudeDesktop, cursor, codex } = paths(home2, osPlatform2);
+  const { claudeCode, claudeDesktop, cursor, codex } = paths(home2, osPlatform2, options.appData);
   const results = [];
   const safe = async (client, fn) => {
     try {
@@ -3234,7 +3243,14 @@ 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) {
@@ -3828,21 +3844,8 @@ function summarizeClientRegistrations(results) {
   }
   return { connected, prepared, errors };
 }
-function naturalList(items) {
-  if (items.length <= 1) return items[0] ?? "";
-  if (items.length === 2) return `${items[0]} and ${items[1]}`;
-  return `${items.slice(0, -1).join(", ")}, and ${items.at(-1)}`;
-}
-function formatInstallSuccess(connectedClients, preparedClients = []) {
-  const apps = naturalList(connectedClients);
-  const restart = apps ? `Fully close and reopen your browser and ${apps}.
-` : "Fully close and reopen your browser.\n";
-  const future = preparedClients.length > 0 ? `${naturalList(preparedClients)} will also be ready if you install ${preparedClients.length === 1 ? "it" : "them"} later.
-` : "";
-  return `
-Setup complete.
-${restart}${future}LLMnesia Settings will confirm when your history is ready.
-`;
+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;
@@ -3876,26 +3879,16 @@ async function runInstall(positionals, options, flags) {
     prepareMissingDesktopApps: true
   });
   const registrations = summarizeClientRegistrations(results);
-  for (const client of registrations.connected) {
-    process.stdout.write(`${client} connected.
-`);
-  }
   for (const error of registrations.errors) {
     process.stderr.write(`Could not connect ${error.client}: ${error.detail}
 `);
   }
   hadProblems ||= registrations.errors.length > 0;
-  if (registrations.connected.length === 0 && registrations.prepared.length === 0) {
-    hadProblems = true;
-    process.stderr.write(
-      "No supported desktop AI app was found. Install or open Codex, Claude Desktop, or Cursor, then run the same command again.\n"
-    );
-  }
   if (hadProblems) {
     process.stderr.write("\nSetup needs attention. Fix the message above, then run the same command again.\n");
     return 1;
   }
-  process.stdout.write(formatInstallSuccess(registrations.connected, registrations.prepared));
+  process.stdout.write(formatInstallSuccess());
   return 0;
 }
 async function runUninstall(flags) {

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-JBCYML3I.js";
+} from "./chunk-TP5KBWQA.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-LNUL4QWX.js");
+  const { main } = await import("./cli-KDKBKT22.js");
   return main();
 }
 bootstrap().then((code) => {

package/dist/mcp.js

@@ -13,7 +13,7 @@ import {
   __commonJS,
   __export,
   __toESM
-} from "./chunk-JBCYML3I.js";
+} from "./chunk-TP5KBWQA.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.6",
+  "version": "0.1.8",
   "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.",