@llmnesia/mcp 0.2.7 → 0.2.8

package/README.md

@@ -24,12 +24,19 @@ Claude Desktop step on Windows:
 
 1. Install LLMnesia and import the chat history you want available.
 2. Open **Full settings → Connect desktop AI**.
-3. Follow every step shown for your computer, including fully quitting and
-   reopening the browser and connected AI app when instructed.
+3. Run the exact connector command shown there.
+4. Fully quit and reopen the browser.
+5. Return to **Connect desktop AI** and enable automatic sync.
+
+> **Installing the npm package is not setup.** Running
+> `npm install @llmnesia/mcp` only downloads package files; it does not register
+> the native browser connector or configure desktop AI apps. Use the exact
+> `npx -y @llmnesia/mcp@latest install` command below (or `npx.cmd` on Windows),
+> including the final `install` argument.
 
 The commands below are the connector-install step from that guided flow. They
-are also provided as a reference for technical users; running one by itself is
-not the complete LLMnesia setup.
+are also provided as a reference for technical users; the browser restart and
+permission step are still required afterward.
 
 ### Connector command
 
@@ -64,7 +71,7 @@ The installer:
    corpus,
 2. copies the server into `~/.llmnesia/bin` so it has a permanent home,
 3. sets up the supported desktop AI apps (Claude Code, Cursor,
-   and Codex/ChatGPT), and
+   Codex/ChatGPT, and ZCode), 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
@@ -205,6 +212,7 @@ received data — check it before concluding a chat does not exist.
 | Claude Desktop | macOS uses the working local JSON registration. On Windows, run `install` for browser sync, then install the official `llmnesia.mcpb` once in Claude Desktop; Claude exposes no supported external installation API for custom desktop extensions. |
 | 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. |
+| ZCode | Edits the user-scope `~/.zcode/cli/config.json`, adding the server under ZCode's nested `mcp.servers` key with a backup first, and prepares that file in advance if ZCode is installed later. ZCode validates this file strictly and connects servers from it automatically at session start. |
 | 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-O34A5U2L.js → chunk-FIH7ZNYH.js}

@@ -3,7 +3,7 @@ import { createRequire as __llmnesiaCreateRequire } from "node:module";
 const require = __llmnesiaCreateRequire(import.meta.url);
 import {
   VERSION
-} from "./chunk-CMQHGLAD.js";
+} from "./chunk-RJJRIPHA.js";
 
 // src/config.ts
 import { readFileSync } from "fs";
@@ -198,6 +198,8 @@ function canonicalConversationDoc(c) {
     indexLevel: c.indexLevel,
     estimatedBytes: c.estimatedBytes
   };
+  assignIfDefined(out, "localTitle", c.localTitle);
+  assignIfDefined(out, "localTitleUpdatedAt", c.localTitleUpdatedAt);
   assignIfDefined(out, "searchDocLength", c.searchDocLength);
   assignIfDefined(out, "contentHash", c.contentHash);
   assignIfDefined(out, "truncated", c.truncated);
@@ -1208,9 +1210,14 @@ var SearchIndex = class {
   // transaction() helper for single upserts, or rebuildFrom's manual one).
   writeRecord(rec) {
     const { conversation, messages } = rec;
+    const displayTitle = conversation.localTitle?.trim() || conversation.title;
     this.deleteFtsRows(conversation.docId);
     this.stmts.deleteConversation.run(conversation.docId);
-    const titleText = [conversation.title, conversation.preview].filter(Boolean).join("\n");
+    const titleText = [
+      ...conversation.localTitle ? [conversation.localTitle, conversation.localTitle] : [],
+      conversation.title,
+      conversation.preview
+    ].filter(Boolean).join("\n");
     if (titleText.trim()) {
       this.insertFtsRow(conversation.docId, TITLE_ROW_INDEX, TITLE_ROLE, titleText);
     }
@@ -1222,7 +1229,7 @@ var SearchIndex = class {
     this.stmts.insertConversation.run({
       docId: conversation.docId,
       platform: conversation.platform,
-      title: conversation.title,
+      title: displayTitle,
       url: conversation.url,
       createdAt: conversation.createdAt,
       updatedAt: conversation.updatedAt ?? conversation.contentUpdatedAt ?? 0,
@@ -1350,7 +1357,11 @@ var SearchIndex = class {
   }
   hydrateSnippet(row, match) {
     const record = this.corpus?.getFromPlatformSync(row.platform, row.docId);
-    const source = row.msgIndex === TITLE_ROW_INDEX ? [record?.conversation.title ?? row.title, record?.conversation.preview ?? row.preview].filter(Boolean).join("\n") : record?.messages.find((message) => message.msgIndex === row.msgIndex)?.text ?? row.preview;
+    const source = row.msgIndex === TITLE_ROW_INDEX ? [
+      record?.conversation.localTitle,
+      record?.conversation.title ?? row.title,
+      record?.conversation.preview ?? row.preview
+    ].filter(Boolean).join("\n") : record?.messages.find((message) => message.msgIndex === row.msgIndex)?.text ?? row.preview;
     this.stmts.clearSnippetFts.run();
     try {
       this.stmts.insertSnippetFts.run(source);

package/dist/{chunk-CMQHGLAD.js → chunk-RJJRIPHA.js}

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

package/dist/{cli-XQUMZ3BU.js → cli-D2IVH5S2.js}

@@ -17,13 +17,13 @@ import {
   runtimeBinDir,
   staleIndexFiles,
   uninstallRuntime
-} from "./chunk-O34A5U2L.js";
+} from "./chunk-FIH7ZNYH.js";
 import {
   VERSION,
   __commonJS,
   __require,
   __toESM
-} from "./chunk-CMQHGLAD.js";
+} from "./chunk-RJJRIPHA.js";
 
 // ../node_modules/isexe/windows.js
 var require_windows = __commonJS({
@@ -2841,7 +2841,8 @@ function paths(home2, osPlatform2, appData) {
     claudeCode: join4(claudeCodeRoot, ".claude.json"),
     claudeDesktop,
     cursor: join4(home2, ".cursor", "mcp.json"),
-    codex: join4(home2, ".codex", "config.toml")
+    codex: join4(home2, ".codex", "config.toml"),
+    zcode: join4(home2, ".zcode", "cli", "config.json")
   };
 }
 async function readJsonFile(path) {
@@ -2873,6 +2874,38 @@ function mcpServersOf(data, configPath) {
   }
   return data.mcpServers;
 }
+function nestedMcpServersOf(data, configPath) {
+  if (data.mcp === void 0) {
+    return {};
+  }
+  if (!data.mcp || typeof data.mcp !== "object" || Array.isArray(data.mcp)) {
+    throw new Error(`Could not update ${configPath}: "mcp" must be a JSON object. The file was left unchanged.`);
+  }
+  const mcp = data.mcp;
+  if (mcp.servers === void 0) {
+    return {};
+  }
+  if (!mcp.servers || typeof mcp.servers !== "object" || Array.isArray(mcp.servers)) {
+    throw new Error(
+      `Could not update ${configPath}: "mcp.servers" must be a JSON object. The file was left unchanged.`
+    );
+  }
+  return mcp.servers;
+}
+function asObject(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+var topLevelServers = {
+  read: (data, configPath) => mcpServersOf(data, configPath),
+  merge: (data, servers) => ({ ...data, mcpServers: servers }),
+  preview: (entry) => JSON.stringify({ mcpServers: { [SERVER_NAME]: entry } }, null, 2)
+};
+var zcodeNestedServers = {
+  read: (data, configPath) => nestedMcpServersOf(data, configPath),
+  // Keep any other settings ZCode stores beside `servers` inside its `mcp` key.
+  merge: (data, servers) => ({ ...data, mcp: { ...asObject(data.mcp), servers } }),
+  preview: (entry) => JSON.stringify({ mcp: { servers: { [SERVER_NAME]: entry } } }, null, 2)
+};
 function isErrnoException(value) {
   return value instanceof Error && "code" in value;
 }
@@ -3091,7 +3124,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, prepareWhenConfigAbsent = false, includeTransportType = true) {
+async function registerJsonClient(clientLabel, configPath, serve, confirm, now, prepareMissing = false, prepareWhenConfigAbsent = false, includeTransportType = true, layout = topLevelServers) {
   const configDirExists = await clientDirExists(configPath);
   if (!configDirExists && !prepareMissing) {
     return {
@@ -3117,7 +3150,7 @@ async function registerJsonClient(clientLabel, configPath, serve, confirm, now,
   }
   let servers;
   try {
-    servers = mcpServersOf(data, configPath);
+    servers = layout.read(data, configPath);
   } catch (err) {
     return { client: clientLabel, action: "error", detail: errorMessage(err) };
   }
@@ -3126,7 +3159,7 @@ 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: { [SERVER_NAME]: nextEntry } }, null, 2);
+  const preview = layout.preview(nextEntry);
   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?
@@ -3140,7 +3173,7 @@ ${preview}`;
       const backupPath = `${configPath}.bak-${now()}`;
       await writeFile2(backupPath, raw ?? JSON.stringify(data, null, 2), "utf8");
     }
-    const nextData = { ...data, mcpServers: { ...servers, [SERVER_NAME]: nextEntry } };
+    const nextData = layout.merge(data, { ...servers, [SERVER_NAME]: nextEntry });
     await writeFile2(configPath, `${JSON.stringify(nextData, null, 2)}
 `, "utf8");
     return {
@@ -3245,7 +3278,7 @@ async function registerClients(options) {
   const osPlatform2 = options.osPlatform ?? platform2();
   const now = options.now ?? (() => Date.now());
   const prepareMissing = options.prepareMissingDesktopApps === true;
-  const { claudeCode, claudeDesktop, cursor, codex } = paths(home2, osPlatform2, options.appData);
+  const { claudeCode, claudeDesktop, cursor, codex, zcode } = paths(home2, osPlatform2, options.appData);
   const results = [];
   const safe = async (client, fn) => {
     try {
@@ -3292,6 +3325,22 @@ async function registerClients(options) {
       () => registerCodex(options.serve, options.codexCli ?? realCodexCli, codex, options.confirm, now, prepareMissing)
     )
   );
+  results.push(
+    await safe(
+      "ZCode",
+      () => registerJsonClient(
+        "ZCode",
+        zcode,
+        options.serve,
+        options.confirm,
+        now,
+        prepareMissing,
+        false,
+        true,
+        zcodeNestedServers
+      )
+    )
+  );
   results.push({
     client: "Other MCP clients (Windsurf, Zed, LM Studio, ...)",
     action: "printed",
@@ -3368,7 +3417,7 @@ async function unregisterCodex(cli, configPath, now) {
     return { client: "Codex", action: "error", detail: `codex mcp remove failed: ${errorMessage(err)}` };
   }
 }
-async function unregisterJsonClient(clientLabel, configPath, now) {
+async function unregisterJsonClient(clientLabel, configPath, now, layout = topLevelServers) {
   let data;
   let existed;
   let raw;
@@ -3382,7 +3431,7 @@ async function unregisterJsonClient(clientLabel, configPath, now) {
   }
   let servers;
   try {
-    servers = mcpServersOf(data, configPath);
+    servers = layout.read(data, configPath);
   } catch (err) {
     return { client: clientLabel, action: "error", detail: errorMessage(err) };
   }
@@ -3393,7 +3442,7 @@ async function unregisterJsonClient(clientLabel, configPath, now) {
   try {
     await writeFile2(backupPath, raw ?? JSON.stringify(data, null, 2), "utf8");
     const { [SERVER_NAME]: _removed, ...rest } = servers;
-    const nextData = { ...data, mcpServers: rest };
+    const nextData = layout.merge(data, rest);
     await writeFile2(configPath, `${JSON.stringify(nextData, null, 2)}
 `, "utf8");
     return { client: clientLabel, action: "registered", detail: `Removed from ${configPath} (backup: ${backupPath}).` };
@@ -3405,7 +3454,7 @@ async function unregisterClients(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 { claudeDesktop, cursor, codex, zcode } = paths(home2, osPlatform2);
   const safe = async (client, fn) => {
     try {
       return await fn();
@@ -3421,6 +3470,7 @@ async function unregisterClients(options = {}) {
   }
   results.push(await safe("Cursor", () => unregisterJsonClient("Cursor", cursor, now)));
   results.push(await safe("Codex", () => unregisterCodex(options.codexCli ?? realCodexCli, codex, now)));
+  results.push(await safe("ZCode", () => unregisterJsonClient("ZCode", zcode, now, zcodeNestedServers)));
   results.push({
     client: "Other MCP clients",
     action: "skipped",
@@ -3592,7 +3642,7 @@ function checkAutoUpdate(home2, env) {
   const latest = state.lastSeenVersion ? `; latest published ${state.lastSeenVersion}` : "";
   return { name, status: "ok", detail: `On. Last checked ${checkedAt}${latest}.` };
 }
-async function checkJsonClient(label, configPath) {
+async function checkJsonClient(label, configPath, nestedServers = false) {
   if (!existsSync(dirname5(configPath))) {
     return { name: label, status: "warn", detail: `Not installed (no ${dirname5(configPath)}).` };
   }
@@ -3605,7 +3655,8 @@ async function checkJsonClient(label, configPath) {
   }
   try {
     const data = JSON.parse(readFileSync(configPath, "utf8"));
-    const entry = data.mcpServers?.[SERVER_NAME];
+    const servers = nestedServers ? data.mcp?.servers : data.mcpServers;
+    const entry = servers?.[SERVER_NAME];
     if (!entry) {
       return {
         name: label,
@@ -3741,6 +3792,7 @@ async function runDoctor(options = {}) {
   await run("Cursor", () => checkJsonClient("Cursor", join5(home2, ".cursor", "mcp.json")));
   await run("Claude Code", () => checkClaudeCode(claudeCli));
   await run("Codex", () => checkCodex(home2, codexCli));
+  await run("ZCode", () => checkJsonClient("ZCode", join5(home2, ".zcode", "cli", "config.json"), true));
   checks.push({
     name: "Reminder",
     status: "warn",
@@ -3760,7 +3812,8 @@ Usage: llmnesia-mcp <command> [options]
 
 Setup:
   install [ext-id...]  Install the native host + register this MCP server with
-                        detected clients (Claude Code/Desktop, Cursor, Codex, ...)
+                        detected clients (Claude Code/Desktop, Cursor, Codex,
+                        ZCode, ...)
   doctor                Diagnose: host installed? corpus present? clients wired?
   uninstall             Remove native host + client registrations (never deletes
                         your corpus \u2014 see the printed path if you want that too)

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-CMQHGLAD.js";
+} from "./chunk-RJJRIPHA.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-XQUMZ3BU.js");
+  const { main } = await import("./cli-D2IVH5S2.js");
   return main();
 }
 bootstrap().then((code) => {

package/dist/mcp.js

@@ -12,13 +12,13 @@ import {
   resolveCorpusDir,
   runAutomaticMaintenance,
   scheduleSelfUpdate
-} from "./chunk-O34A5U2L.js";
+} from "./chunk-FIH7ZNYH.js";
 import {
   VERSION,
   __commonJS,
   __export,
   __toESM
-} from "./chunk-CMQHGLAD.js";
+} from "./chunk-RJJRIPHA.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.2.7",
+  "version": "0.2.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.",

package/server.json

@@ -3,13 +3,13 @@
   "name": "com.llmnesia/mcp",
   "title": "LLMnesia",
   "description": "Search your AI chat history from Claude, Cursor, Codex, and other MCP clients.",
-  "version": "0.2.7",
+  "version": "0.2.8",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@llmnesia/mcp",
-      "version": "0.2.7",
+      "version": "0.2.8",
       "transport": {
         "type": "stdio"
       }