@llmnesia/mcp 0.1.0 → 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,23 +10,35 @@ 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
 
 ```bash
-npx @llmnesia/mcp install
+npx -y @llmnesia/mcp@latest install
 ```
 
+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
    corpus,
 2. copies the server into `~/.llmnesia/bin` so it has a permanent home,
-3. detects which MCP clients you have (Claude Code, Claude Desktop, Cursor,
-   Codex, and others), and
-4. registers that copy with each of them — after a confirm prompt and a backup
-   of any config file it edits.
+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 after a confirm prompt and backup for config files it
+   edits.
 
 Then **fully quit and reopen** your MCP client. Clients read their config once
 at startup, so reloading a window is not enough.
@@ -49,7 +61,7 @@ The copy is self-contained (no `node_modules` beside it) and re-running
 ### Updating
 
 ```bash
-npx @llmnesia/mcp@latest install
+npx -y @llmnesia/mcp@latest install
 ```
 
 Your corpus is untouched; only the server copy is replaced.
@@ -62,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
 
@@ -87,10 +102,10 @@ 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 | Prints a TOML block for `~/.codex/config.toml` (auto-edit is too fragile). |
+| 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. |
 | 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,
@@ -100,7 +115,7 @@ close it.
 ## Diagnose an install
 
 ```bash
-npx @llmnesia/mcp doctor
+npx -y @llmnesia/mcp@latest doctor
 ```
 
 Checks whether the native host is installed, the server runtime is present, the
@@ -115,7 +130,7 @@ reminder).
 ## Uninstall
 
 ```bash
-npx @llmnesia/mcp uninstall
+npx -y @llmnesia/mcp@latest uninstall
 ```
 
 Removes native-host manifests and registry keys, the copied server in
@@ -145,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/THIRD_PARTY_NOTICES

@@ -1,5 +1,75 @@
 @llmnesia/mcp includes portions of the following third-party software.
 
+-------------------------------------------------------------------------------
+cross-spawn
+
+The MIT License (MIT)
+
+Copyright (c) 2018 Made With MOXY Lda <hello@moxy.studio>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+-------------------------------------------------------------------------------
+path-key, shebang-command, and shebang-regex
+
+MIT License
+
+Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+Copyright (c) Kevin Mårtensson <kevinmartensson@gmail.com> (github.com/kevva)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+-------------------------------------------------------------------------------
+which and isexe
+
+The ISC License
+
+Copyright (c) Isaac Z. Schlueter and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
 -------------------------------------------------------------------------------
 @modelcontextprotocol/sdk
 

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

@@ -1,33 +1,6 @@
 #!/usr/bin/env node
-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 __commonJS = (cb, mod) => function __require() {
-  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
-));
+import { createRequire as __llmnesiaCreateRequire } from "node:module";
+const require = __llmnesiaCreateRequire(import.meta.url);
 
 // src/config.ts
 import { readFileSync } from "fs";
@@ -863,13 +836,7 @@ function normalizeMatchRole(role) {
   return role === "assistant" || role === "user" || role === "system" ? role : "unknown";
 }
 
-// src/version.ts
-var VERSION = true ? "0.1.0" : "0.0.0-dev";
-
 export {
-  __commonJS,
-  __export,
-  __toESM,
   resolveCorpusDir,
   Corpus,
   ingestFile,
@@ -877,7 +844,5 @@ export {
   drainInbox,
   SearchIndex,
   openSearchIndex,
-  deleteIndexDb,
-  VERSION
+  deleteIndexDb
 };
-//# sourceMappingURL=chunk-OBJD6H4A.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
+};