docdex 0.2.11 → 0.2.13

package/CHANGELOG.md

@@ -1,7 +1,10 @@
 # Changelog
 
-## 0.2.11
-- Added glama support
+## 0.2.13
+- Repo memory now tags items with `repoId` and filters recalls to prevent cross-repo leakage in multi-repo daemons.
+- MCP HTTP requires explicit repo selection when multiple repos are active.
+- Postinstall banner now guides users to run `docdex setup`.
+- Docs refreshed with memory, agent memory, code intelligence, web search, and Ollama guidance.
 
 ## 0.1.10
 - smithery deployment work to get a bettwe score. enriched server.js, added mcp.json and an icon address.

package/lib/install.js

@@ -1899,6 +1899,55 @@ async function main() {
   } catch (err) {
     console.warn(`[docdex] postinstall setup skipped: ${err?.message || err}`);
   }
+  printPostInstallBanner();
+}
+
+function printPostInstallBanner() {
+  const frame = "\x1b[35m";
+  const reset = "\x1b[0m";
+  const stripAnsi = (text) => text.replace(/\x1b\[[0-9;]*m/g, "");
+  const writeDirect = (message) => {
+    const ttyPath = process.platform === "win32" ? "CONOUT$" : "/dev/tty";
+    try {
+      const fd = fs.openSync(ttyPath, "w");
+      fs.writeSync(fd, message);
+      fs.closeSync(fd);
+      return true;
+    } catch {
+      return false;
+    }
+  };
+  let width = 0;
+  const content = [
+    "\x1b[31m      _               _           \x1b[0m",
+    "\x1b[31m   __| | ___   ___ __| | _____  __\x1b[0m",
+    "\x1b[31m  / _` |/ _ \\ / __/ _` |/ _ \\ \\/ /\x1b[0m",
+    "\x1b[31m | (_| | (_) | (_| (_| |  __/>  < \x1b[0m",
+    "\x1b[31m  \\__,_|\\___/ \\___\\__,_|\\___/_/\\_\\\x1b[0m",
+    "",
+    "\x1b[32mDocdex installed successfully!\x1b[0m",
+    "\x1b[41m\x1b[97m IMPORTANT \x1b[0m \x1b[33mNext step:\x1b[0m run \x1b[32m`docdex setup`\x1b[0m to complete the installation.",
+    "\x1b[33mSetup:\x1b[0m configures Ollama/models + browser.",
+    "\x1b[34mTip:\x1b[0m after setup, start the daemon with \x1b[36m`docdexd serve --repo <path>`\x1b[0m"
+  ];
+  width = Math.max(72, content.reduce((max, line) => Math.max(max, stripAnsi(line).length), 0));
+  const padLine = (text) => {
+    const visible = stripAnsi(text).length;
+    const padding = Math.max(0, width - visible);
+    return `${text}${" ".repeat(padding)}`;
+  };
+
+  const top = `${frame}╭${"─".repeat(width + 2)}╮${reset}`;
+  const bottom = `${frame}╰${"─".repeat(width + 2)}╯${reset}`;
+  const lines = [top];
+  for (const line of content) {
+    lines.push(`${frame}│ ${reset}${padLine(line)}${frame} │${reset}`);
+  }
+  lines.push(bottom);
+  const banner = `\r\x1b[2K${lines.join("\n")}\n`;
+  if (!writeDirect(banner)) {
+    console.log(banner);
+  }
 }
 
 function appendInstallSafetyLines(lines, err) {

package/lib/postinstall_setup.js

@@ -157,12 +157,50 @@ function upsertMcpServerJson(pathname, url) {
   const { value } = readJson(pathname);
   if (typeof value !== "object" || value == null || Array.isArray(value)) return false;
   const root = value;
-  if (!root.mcpServers || typeof root.mcpServers !== "object" || Array.isArray(root.mcpServers)) {
+  const pickSection = () => {
+    if (root.mcpServers && typeof root.mcpServers === "object" && !Array.isArray(root.mcpServers)) {
+      return { key: "mcpServers", section: root.mcpServers };
+    }
+    if (root.mcp_servers && typeof root.mcp_servers === "object" && !Array.isArray(root.mcp_servers)) {
+      return { key: "mcp_servers", section: root.mcp_servers };
+    }
+    return null;
+  };
+  if (Array.isArray(root.mcpServers)) {
+    const idx = root.mcpServers.findIndex((entry) => entry && entry.name === "docdex");
+    if (idx >= 0) {
+      if (root.mcpServers[idx].url === url) return false;
+      root.mcpServers[idx] = { ...root.mcpServers[idx], url };
+      writeJson(pathname, root);
+      return true;
+    }
+    root.mcpServers.push({ name: "docdex", url });
+    writeJson(pathname, root);
+    return true;
+  }
+
+  const picked = pickSection();
+  if (!picked) {
     root.mcpServers = {};
   }
-  const current = root.mcpServers.docdex;
+  const section = picked ? picked.section : root.mcpServers;
+  const current = section.docdex;
+  if (current && current.url === url) return false;
+  section.docdex = { url };
+  writeJson(pathname, root);
+  return true;
+}
+
+function upsertZedConfig(pathname, url) {
+  const { value } = readJson(pathname);
+  if (typeof value !== "object" || value == null || Array.isArray(value)) return false;
+  const root = value;
+  if (!root.experimental_mcp_servers || typeof root.experimental_mcp_servers !== "object" || Array.isArray(root.experimental_mcp_servers)) {
+    root.experimental_mcp_servers = {};
+  }
+  const current = root.experimental_mcp_servers.docdex;
   if (current && current.url === url) return false;
-  root.mcpServers.docdex = { url };
+  root.experimental_mcp_servers.docdex = { url };
   writeJson(pathname, root);
   return true;
 }
@@ -340,18 +378,45 @@ function clientConfigPaths() {
       return {
         claude: path.join(appData, "Claude", "claude_desktop_config.json"),
         cursor: path.join(userProfile, ".cursor", "mcp.json"),
+        windsurf: path.join(userProfile, ".codeium", "windsurf", "mcp_config.json"),
+        cline: path.join(appData, "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
+        roo: path.join(appData, "Code", "User", "globalStorage", "rooveterinaryinc.roo-cline", "settings", "mcp_settings.json"),
+        continue: path.join(userProfile, ".continue", "config.json"),
+        pearai: path.join(userProfile, ".kiro", "settings", "mcp.json"),
+        pearai_alt: path.join(userProfile, ".pearai", "mcp.json"),
+        void: path.join(appData, "Void", "mcp.json"),
+        vscode: path.join(appData, "Code", "User", "mcp.json"),
+        zed: path.join(appData, "Zed", "settings.json"),
         codex: path.join(userProfile, ".codex", "config.toml")
       };
     case "darwin":
       return {
         claude: path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
         cursor: path.join(home, ".cursor", "mcp.json"),
+        windsurf: path.join(home, ".codeium", "windsurf", "mcp_config.json"),
+        cline: path.join(home, "Library", "Application Support", "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
+        roo: path.join(home, "Library", "Application Support", "Code", "User", "globalStorage", "rooveterinaryinc.roo-cline", "settings", "mcp_settings.json"),
+        continue: path.join(home, ".continue", "config.json"),
+        pearai: path.join(home, ".kiro", "settings", "mcp.json"),
+        pearai_alt: path.join(home, ".config", "pearai", "mcp.json"),
+        void: path.join(home, "Library", "Application Support", "Void", "mcp.json"),
+        vscode: path.join(home, "Library", "Application Support", "Code", "User", "mcp.json"),
+        zed: path.join(home, ".config", "zed", "settings.json"),
         codex: path.join(home, ".codex", "config.toml")
       };
     default:
       return {
         claude: path.join(home, ".config", "Claude", "claude_desktop_config.json"),
         cursor: path.join(home, ".cursor", "mcp.json"),
+        windsurf: path.join(home, ".codeium", "windsurf", "mcp_config.json"),
+        cline: path.join(home, ".config", "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
+        roo: path.join(home, ".config", "Code", "User", "globalStorage", "rooveterinaryinc.roo-cline", "settings", "mcp_settings.json"),
+        continue: path.join(home, ".continue", "config.json"),
+        pearai: path.join(home, ".kiro", "settings", "mcp.json"),
+        pearai_alt: path.join(home, ".config", "pearai", "mcp.json"),
+        void: path.join(home, ".config", "Void", "mcp.json"),
+        vscode: path.join(home, ".config", "Code", "User", "mcp.json"),
+        zed: path.join(home, ".config", "zed", "settings.json"),
         codex: path.join(home, ".codex", "config.toml")
       };
   }
@@ -1207,8 +1272,24 @@ async function runPostInstallSetup({ binaryPath, logger } = {}) {
   const url = configUrlForPort(port);
   const codexUrl = configStreamableUrlForPort(port);
   const paths = clientConfigPaths();
-  upsertMcpServerJson(paths.claude, url);
-  upsertMcpServerJson(paths.cursor, url);
+  const jsonPaths = [
+    paths.claude,
+    paths.cursor,
+    paths.windsurf,
+    paths.cline,
+    paths.roo,
+    paths.continue,
+    paths.pearai,
+    paths.pearai_alt,
+    paths.void,
+    paths.vscode
+  ].filter(Boolean);
+  for (const jsonPath of jsonPaths) {
+    upsertMcpServerJson(jsonPath, url);
+  }
+  if (paths.zed) {
+    upsertZedConfig(paths.zed, url);
+  }
   upsertCodexConfig(paths.codex, codexUrl);
 
   const daemonRoot = ensureDaemonRoot();
@@ -1238,6 +1319,7 @@ module.exports = {
   upsertServerConfig,
   parseServerBind,
   upsertMcpServerJson,
+  upsertZedConfig,
   upsertCodexConfig,
   pickAvailablePort,
   configUrlForPort,

package/lib/uninstall.js

@@ -33,12 +33,14 @@ function clientConfigPaths() {
         json: [
           path.join(appData, "Claude", "claude_desktop_config.json"),
           path.join(userProfile, ".cursor", "mcp.json"),
-          path.join(userProfile, ".cursor", "settings.json"),
           path.join(userProfile, ".codeium", "windsurf", "mcp_config.json"),
           path.join(appData, "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
           path.join(appData, "Code", "User", "globalStorage", "rooveterinaryinc.roo-cline", "settings", "mcp_settings.json"),
           path.join(userProfile, ".continue", "config.json"),
           path.join(userProfile, ".kiro", "settings", "mcp.json"),
+          path.join(userProfile, ".pearai", "mcp.json"),
+          path.join(appData, "Void", "mcp.json"),
+          path.join(appData, "Code", "User", "mcp.json"),
           path.join(appData, "Zed", "settings.json")
         ],
         toml: [path.join(userProfile, ".codex", "config.toml")],
@@ -49,12 +51,14 @@ function clientConfigPaths() {
         json: [
           path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
           path.join(home, ".cursor", "mcp.json"),
-          path.join(home, ".cursor", "settings.json"),
           path.join(home, ".codeium", "windsurf", "mcp_config.json"),
           path.join(home, "Library", "Application Support", "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
           path.join(home, "Library", "Application Support", "Code", "User", "globalStorage", "rooveterinaryinc.roo-cline", "settings", "mcp_settings.json"),
           path.join(home, ".continue", "config.json"),
           path.join(home, ".kiro", "settings", "mcp.json"),
+          path.join(home, ".config", "pearai", "mcp.json"),
+          path.join(home, "Library", "Application Support", "Void", "mcp.json"),
+          path.join(home, "Library", "Application Support", "Code", "User", "mcp.json"),
           path.join(home, ".config", "zed", "settings.json")
         ],
         toml: [path.join(home, ".codex", "config.toml")],
@@ -65,12 +69,14 @@ function clientConfigPaths() {
         json: [
           path.join(home, ".config", "Claude", "claude_desktop_config.json"),
           path.join(home, ".cursor", "mcp.json"),
-          path.join(home, ".cursor", "settings.json"),
           path.join(home, ".codeium", "windsurf", "mcp_config.json"),
           path.join(home, ".config", "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
           path.join(home, ".config", "Code", "User", "globalStorage", "rooveterinaryinc.roo-cline", "settings", "mcp_settings.json"),
           path.join(home, ".continue", "config.json"),
           path.join(home, ".kiro", "settings", "mcp.json"),
+          path.join(home, ".config", "pearai", "mcp.json"),
+          path.join(home, ".config", "Void", "mcp.json"),
+          path.join(home, ".config", "Code", "User", "mcp.json"),
           path.join(home, ".config", "zed", "settings.json")
         ],
         toml: [path.join(home, ".codex", "config.toml")],
@@ -103,11 +109,32 @@ function removeMcpServerJson(pathname, name = "docdex") {
   let changed = false;
   for (const key of keys) {
     const section = root[key];
-    if (!section || typeof section !== "object" || Array.isArray(section)) continue;
-    if (!Object.prototype.hasOwnProperty.call(section, name)) continue;
-    delete section[name];
+    if (!section) continue;
+    if (Array.isArray(section)) {
+      const before = section.length;
+      root[key] = section.filter((entry) => !(entry && entry.name === name));
+      if (root[key].length !== before) {
+        changed = true;
+      }
+      if (root[key].length === 0) delete root[key];
+      continue;
+    }
+    if (typeof section !== "object") continue;
+    if (Object.prototype.hasOwnProperty.call(section, name)) {
+      delete section[name];
+      changed = true;
+      if (Object.keys(section).length === 0) delete root[key];
+    }
+  }
+  if (
+    root.experimental_mcp_servers &&
+    typeof root.experimental_mcp_servers === "object" &&
+    !Array.isArray(root.experimental_mcp_servers) &&
+    Object.prototype.hasOwnProperty.call(root.experimental_mcp_servers, name)
+  ) {
+    delete root.experimental_mcp_servers[name];
     changed = true;
-    if (Object.keys(section).length === 0) delete root[key];
+    if (Object.keys(root.experimental_mcp_servers).length === 0) delete root.experimental_mcp_servers;
   }
   if (!changed) return false;
   writeJson(pathname, root);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docdex",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "mcpName": "io.github.bekirdag/docdex",
   "description": "Docdex CLI as an npm-installable binary wrapper.",
   "bin": {