context-vault 2.8.6 → 2.8.8

package/README.md

@@ -10,16 +10,13 @@ Persistent memory for AI agents — saves and searches knowledge across sessions
 ## Quick Start
 
 ```bash
-npm install -g context-vault
-context-vault setup
+npx context-vault setup
 ```
 
-Setup auto-detects your AI tools (Claude Code, Codex, Claude Desktop, Cursor, Windsurf, Cline), downloads the embedding model (~22MB), seeds your vault with a starter entry, and verifies everything works.
+One command — no global install required. Setup detects your AI tools (Claude Code, Codex, Claude Desktop, Cursor, Windsurf, Cline, and more), downloads the embedding model (~22MB), seeds your vault, and configures MCP.
 
 Then open your AI tool and try: **"Search my vault for getting started"**
 
-> `context-mcp` still works as a CLI alias — `context-vault` is the primary command.
-
 ## What It Does
 
 - **Save** — insights, decisions, patterns, contacts. Your AI agent writes them as you work.
@@ -43,17 +40,19 @@ Entries are organized by `kind` (insight, decision, pattern, reference, contact,
 
 ## CLI
 
-| Command                          | Description                                               |
-| -------------------------------- | --------------------------------------------------------- |
-| `context-vault setup`            | Interactive installer — detects tools, writes MCP configs |
-| `context-vault ui [--port 3141]` | Web dashboard                                             |
-| `context-vault status`           | Vault health, paths, entry counts                         |
-| `context-vault reindex`          | Rebuild search index                                      |
-| `context-vault import <path>`    | Import .md, .csv, .json, .txt                             |
-| `context-vault export`           | Export to JSON or CSV                                     |
-| `context-vault sync`             | Sync with hosted account                                  |
-| `context-vault update`           | Check for updates                                         |
-| `context-vault uninstall`        | Remove MCP configs                                        |
+| Command                       | Description                                               |
+| ----------------------------- | --------------------------------------------------------- |
+| `context-vault setup`         | Interactive installer — detects tools, writes MCP configs |
+| `context-vault connect --key` | Connect AI tools to hosted vault                          |
+| `context-vault switch`        | Switch between local and hosted MCP modes                 |
+| `context-vault serve`         | Start the MCP server (used by AI clients)                 |
+| `context-vault status`        | Vault health, paths, entry counts                         |
+| `context-vault reindex`       | Rebuild search index                                      |
+| `context-vault import <path>` | Import .md, .csv, .json, .txt                             |
+| `context-vault export`        | Export to JSON or CSV                                     |
+| `context-vault ingest <url>`  | Fetch URL and save as vault entry                         |
+| `context-vault update`        | Check for updates                                         |
+| `context-vault uninstall`     | Remove MCP configs                                        |
 
 ## Manual MCP Config
 

package/bin/cli.js

@@ -38,6 +38,11 @@ function isInstalledPackage() {
   return ROOT.includes("/node_modules/") || ROOT.includes("\\node_modules\\");
 }
 
+/** Detect if running via npx (ephemeral cache — paths won't survive cache eviction) */
+function isNpx() {
+  return ROOT.includes("/_npx/") || ROOT.includes("\\_npx\\");
+}
+
 const bold = (s) => `\x1b[1m${s}\x1b[0m`;
 const dim = (s) => `\x1b[2m${s}\x1b[0m`;
 const green = (s) => `\x1b[32m${s}\x1b[0m`;
@@ -620,7 +625,14 @@ async function configureClaude(tool, vaultDir) {
   } catch {}
 
   try {
-    if (isInstalledPackage()) {
+    if (isNpx()) {
+      const cmdArgs = ["-y", "context-vault", "serve"];
+      if (vaultDir) cmdArgs.push("--vault-dir", `"${vaultDir}"`);
+      execSync(
+        `claude mcp add -s user context-vault -- npx ${cmdArgs.join(" ")}`,
+        { stdio: "pipe", env },
+      );
+    } else if (isInstalledPackage()) {
       const launcherPath = join(HOME, ".context-mcp", "server.mjs");
       const cmdArgs = [`"${launcherPath}"`];
       if (vaultDir) cmdArgs.push("--vault-dir", `"${vaultDir}"`);
@@ -653,7 +665,13 @@ async function configureCodex(tool, vaultDir) {
   } catch {}
 
   try {
-    if (isInstalledPackage()) {
+    if (isNpx()) {
+      const cmdArgs = ["-y", "context-vault", "serve"];
+      if (vaultDir) cmdArgs.push("--vault-dir", `"${vaultDir}"`);
+      execSync(`codex mcp add context-vault -- npx ${cmdArgs.join(" ")}`, {
+        stdio: "pipe",
+      });
+    } else if (isInstalledPackage()) {
       const launcherPath = join(HOME, ".context-mcp", "server.mjs");
       const cmdArgs = [`"${launcherPath}"`];
       if (vaultDir) cmdArgs.push("--vault-dir", `"${vaultDir}"`);
@@ -701,7 +719,13 @@ function configureJsonTool(tool, vaultDir) {
   // Clean up old "context-mcp" key
   delete config[tool.configKey]["context-mcp"];
 
-  if (isInstalledPackage()) {
+  if (isNpx()) {
+    const serverArgs = vaultDir ? ["--vault-dir", vaultDir] : [];
+    config[tool.configKey]["context-vault"] = {
+      command: "npx",
+      args: ["-y", "context-vault", "serve", ...serverArgs],
+    };
+  } else if (isInstalledPackage()) {
     const launcherPath = join(HOME, ".context-mcp", "server.mjs");
     const serverArgs = [];
     if (vaultDir) serverArgs.push("--vault-dir", vaultDir);
@@ -1332,7 +1356,7 @@ async function runUpdate() {
     console.log(green(`  ✓ Updated to v${latest}`));
   } catch {
     console.error(
-      red("  Update failed. Try manually: npm install -g context-vault@latest"),
+      red("  Update failed. Try manually: npx -y context-vault@latest setup"),
     );
   }
   console.log();

package/node_modules/@context-vault/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@context-vault/core",
-  "version": "2.8.6",
+  "version": "2.8.8",
   "type": "module",
   "description": "Shared core: capture, index, retrieve, tools, and utilities for context-vault",
   "main": "src/index.js",

package/node_modules/@context-vault/core/src/index/db.js

@@ -32,7 +32,7 @@ function formatNativeModuleError(err) {
     "    npm rebuild better-sqlite3 sqlite-vec",
     "",
     "  Or reinstall:",
-    "    npm install -g context-vault",
+    "    npx -y context-vault@latest setup",
   );
 
   return lines.join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-vault",
-  "version": "2.8.6",
+  "version": "2.8.8",
   "type": "module",
   "description": "Persistent memory for AI agents — saves and searches knowledge across sessions",
   "bin": {
@@ -55,7 +55,7 @@
     "@context-vault/core"
   ],
   "dependencies": {
-    "@context-vault/core": "^2.8.6",
+    "@context-vault/core": "^2.8.8",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "better-sqlite3": "^12.6.2",
     "sqlite-vec": "^0.1.0"

package/scripts/postinstall.js

@@ -90,13 +90,18 @@ async function main() {
     }
   }
 
-  // ── 3. Write local server launcher ───────────────────────────────────
-  const SERVER_ABS = join(PKG_ROOT, "src", "server", "index.js");
-  const DATA_DIR = join(homedir(), ".context-mcp");
-  const LAUNCHER = join(DATA_DIR, "server.mjs");
-  mkdirSync(DATA_DIR, { recursive: true });
-  writeFileSync(LAUNCHER, `import "${SERVER_ABS}";\n`);
-  console.log("[context-vault] Local server launcher written to " + LAUNCHER);
+  // ── 3. Write local server launcher (global installs only) ────────────
+  // Under npx the path would be stale after cache eviction — configs use
+  // `npx context-vault serve` instead, so skip writing the launcher.
+  const isNpx = PKG_ROOT.includes("/_npx/") || PKG_ROOT.includes("\\_npx\\");
+  if (!isNpx) {
+    const SERVER_ABS = join(PKG_ROOT, "src", "server", "index.js");
+    const DATA_DIR = join(homedir(), ".context-mcp");
+    const LAUNCHER = join(DATA_DIR, "server.mjs");
+    mkdirSync(DATA_DIR, { recursive: true });
+    writeFileSync(LAUNCHER, `import "${SERVER_ABS}";\n`);
+    console.log("[context-vault] Local server launcher written to " + LAUNCHER);
+  }
 }
 
 main().catch(() => {});