@llmnesia/mcp 0.1.1 → 0.1.2

package/README.md

@@ -1,7 +1,7 @@
 # @llmnesia/mcp
 
 Search your own AI chat history from Claude Desktop, Claude Code, Cursor,
-Codex, and other MCP clients. Covers every conversation the
+Codex, and other MCP clients. It is designed to cover every conversation the
 [LLMnesia browser extension](https://llmnesia.com) has captured across
 ChatGPT, Claude, Gemini, Character.AI, Grok, DeepSeek, and the rest of the
 supported platforms.
@@ -10,7 +10,9 @@ supported platforms.
 machine and the MCP server speaks [Model Context Protocol](https://modelcontextprotocol.io)
 over stdio.
 
-Requires **Node.js ≥ 22.13.0** (for the built-in `node:sqlite` module).
+Requires **Node.js ≥ 22.13.0** (for the built-in `node:sqlite` module). The
+installer checks this before changing anything and prints the exact recovery
+steps when the installed version is too old.
 
 ## Install
 
@@ -22,6 +24,11 @@ That is the same command in Terminal on macOS/Linux and PowerShell on Windows.
 It requires Node.js 22.13 or newer; there is no global package install and no
 client config to edit by hand in the normal path.
 
+If `npx` is not recognised, Node.js is not installed. Install the current LTS
+release from [nodejs.org](https://nodejs.org/), reopen Terminal/PowerShell, and
+run the command again. `npx` cannot prompt for or install Node.js because it is
+itself part of Node.js.
+
 The installer:
 
 1. sets up the native host that bridges the browser extension to your local
@@ -67,11 +74,14 @@ the [Chrome Web Store](https://chromewebstore.google.com/detail/llmnesia/leekfgb
 
 1. Install the extension and run a one-time backfill to import existing history.
 2. After that, the extension captures new conversations as you chat.
-3. It writes them to the local corpus at `~/.llmnesia/corpus/`. `@llmnesia/mcp`
-   reads from the same folder — there is nothing to configure.
+3. Run the installer above, fully restart the browser, then open LLMnesia
+   Settings and click **Enable automatic sync** once. Chrome requires this
+   one-time permission confirmation.
+4. The extension immediately backfills its indexed history to the local corpus
+   at `~/.llmnesia/corpus/`, then syncs new and changed chats automatically.
+   `@llmnesia/mcp` reads from the same folder — there is nothing to configure.
 
-If you have not run the extension yet, the corpus will be empty and every
-search will come back empty too.
+If nothing has written to the corpus yet, search results will be empty.
 
 ## Tools
 
@@ -92,7 +102,7 @@ received data — check it before concluding a chat does not exist.
 
 | Client | How `install` wires it |
 | --- | --- |
-| Claude Code | Runs `claude mcp add` with the absolute Node and installed runtime paths (detects `claude` on PATH). |
+| 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. It also detects the CLI bundled in the macOS desktop app; prints a TOML fallback only if no Codex CLI is available. |
@@ -150,8 +160,7 @@ llmnesia-mcp --version     # print the installed version
 
 ## Support
 
-Questions and bug reports: [llmnesia.com/mcp](https://llmnesia.com/mcp) or
-hello@llmnesia.com.
+Questions and bug reports: [hello@llmnesia.com](mailto:hello@llmnesia.com).
 
 ## License
 

package/dist/{chunk-4CBIA42T.js → chunk-7BW63ZTP.js}

@@ -1,41 +1,6 @@
 #!/usr/bin/env node
 import { createRequire as __llmnesiaCreateRequire } from "node:module";
 const require = __llmnesiaCreateRequire(import.meta.url);
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-var __commonJS = (cb, mod) => function __require2() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 
 // src/config.ts
 import { readFileSync } from "fs";
@@ -871,14 +836,7 @@ function normalizeMatchRole(role) {
   return role === "assistant" || role === "user" || role === "system" ? role : "unknown";
 }
 
-// src/version.ts
-var VERSION = true ? "0.1.1" : "0.0.0-dev";
-
 export {
-  __require,
-  __commonJS,
-  __export,
-  __toESM,
   resolveCorpusDir,
   Corpus,
   ingestFile,
@@ -886,7 +844,5 @@ export {
   drainInbox,
   SearchIndex,
   openSearchIndex,
-  deleteIndexDb,
-  VERSION
+  deleteIndexDb
 };
-//# sourceMappingURL=chunk-4CBIA42T.js.map

package/dist/chunk-BQM5Q4XX.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { createRequire as __llmnesiaCreateRequire } from "node:module";
+const require = __llmnesiaCreateRequire(import.meta.url);
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __commonJS = (cb, mod) => function __require2() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/version.ts
+var VERSION = true ? "0.1.2" : "0.0.0-dev";
+
+export {
+  __require,
+  __commonJS,
+  __export,
+  __toESM,
+  VERSION
+};