@ulpi/codemap 0.3.8 → 0.3.9

package/README.md

@@ -363,6 +363,46 @@ Add to `~/.config/zed/settings.json`:
 }
 ```
 
+### Multi-Project Setup
+
+You can register multiple CodeMap MCP servers — one per codebase — so your AI agent can search across your frontend, backend, shared libraries, or any other project simultaneously. Each server indexes and serves its own project independently.
+
+First, index each project:
+
+```bash
+codemap init && codemap index                           # current project
+cd /path/to/frontend && codemap init && codemap index   # another project
+```
+
+Then register them as MCP servers. The current project uses `codemap serve` with no extra arguments. Other projects use `--cwd` to point to their location:
+
+#### Claude Code
+
+Add to `.mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "codemap": {
+      "command": "codemap",
+      "args": ["serve"]
+    },
+    "codemap-frontend": {
+      "command": "codemap",
+      "args": ["serve", "--cwd", "/path/to/frontend"]
+    }
+  }
+}
+```
+
+`"codemap"` serves the current project automatically. `"codemap-frontend"` serves a different codebase via `--cwd`. Add as many as you need — each gets its own set of 12 tools (`search_code`, `get_dependencies`, etc.) scoped to that project.
+
+#### Other Editors
+
+The same pattern works in any editor — add one entry with no `--cwd` for the local project, and additional entries with `--cwd` for other codebases. Use unique names (e.g. `codemap-api`, `codemap-shared`) so your AI agent can tell them apart.
+
+Your AI agent will then have access to tools like `search_code`, `get_dependencies`, and `search_symbols` across all registered projects, making it easy to trace connections across your stack.
+
 ## MCP Tools Reference
 
 | Tool | Description |

package/dist/index.js

@@ -7029,13 +7029,14 @@ import path13 from "path";
 import { homedir as homedir3 } from "os";
 
 // src/commands/statusline-script.ts
-function buildStatuslineScript(originalScript) {
-  const body = originalScript.replace(/^#!\/.*\n/, "").trim();
+function buildStatuslineScript(originalCommand) {
+  const escapedCmd = originalCommand.replace(/'/g, "'\\''");
+  const originalSection = originalCommand ? `ORIGINAL_CMD='${escapedCmd}'
+echo "$SESSION_JSON" | eval "$ORIGINAL_CMD" 2>/dev/null || true` : "# (none)";
   return `#!/bin/bash
 # CodeMap statusline for Claude Code
 # Generated by: codemap statusline
 # Do not edit \u2014 re-run \`codemap statusline\` to regenerate.
-# Original script backed up to statusline-command.sh.bak
 
 set -euo pipefail
 
@@ -7043,9 +7044,7 @@ set -euo pipefail
 SESSION_JSON=$(cat)
 
 # --- Original statusline ---
-${body ? `(
-${body}
-) <<< "$SESSION_JSON"` : "# (none)"}
+${originalSection}
 
 # --- CodeMap status ---
 # Resolve the working directory from session JSON
@@ -7061,7 +7060,7 @@ fi
 # Parse fields
 stats_null=$(echo "$cm_json" | ${jsonExtract("stats")} 2>/dev/null || echo "null")
 if [ "$stats_null" = "null" ] || [ -z "$stats_null" ]; then
-  echo "CM: \u2014 no index"
+  echo "CM: \u2014 no index (run: codemap index)"
   exit 0
 fi
 
@@ -7183,31 +7182,13 @@ function install() {
     } catch {
     }
   }
-  let originalScript = "";
-  if (settings.statusline_command) {
-    const currentCommand = settings.statusline_command;
-    if (currentCommand.includes(SCRIPT_FILE) || currentCommand.endsWith("statusline-command.sh")) {
-      if (fs18.existsSync(SCRIPT_FILE)) {
-        originalScript = fs18.readFileSync(SCRIPT_FILE, "utf-8");
-      }
-    } else if (currentCommand.startsWith("/") || currentCommand.startsWith("~")) {
-      const resolved = currentCommand.replace(/^~/, homedir3());
-      try {
-        originalScript = fs18.readFileSync(resolved, "utf-8");
-      } catch {
-        originalScript = `#!/bin/bash
-${currentCommand}`;
-      }
-    } else {
-      originalScript = `#!/bin/bash
-${currentCommand}`;
-    }
+  const originalCommand = settings.statusline_command || "";
+  if (originalCommand && originalCommand !== SCRIPT_FILE) {
+    fs18.mkdirSync(CLAUDE_DIR, { recursive: true });
+    fs18.writeFileSync(BACKUP_FILE, originalCommand);
+    console.log(chalk17.dim(`Saved original statusline command to ${BACKUP_FILE}`));
   }
-  if (fs18.existsSync(SCRIPT_FILE)) {
-    fs18.copyFileSync(SCRIPT_FILE, BACKUP_FILE);
-    console.log(chalk17.dim(`Backed up existing script to ${BACKUP_FILE}`));
-  }
-  const script = buildStatuslineScript(originalScript);
+  const script = buildStatuslineScript(originalCommand !== SCRIPT_FILE ? originalCommand : "");
   fs18.mkdirSync(CLAUDE_DIR, { recursive: true });
   fs18.writeFileSync(SCRIPT_FILE, script, { mode: 493 });
   if (settings.statusline_command !== SCRIPT_FILE) {
@@ -7217,45 +7198,54 @@ ${currentCommand}`;
   }
   console.log();
   console.log(chalk17.green("CodeMap statusline installed."));
+  if (originalCommand && originalCommand !== SCRIPT_FILE) {
+    console.log(chalk17.dim("Your existing statusline is preserved \u2014 CodeMap appends to it."));
+  }
   console.log();
-  console.log("The statusline will show:");
+  console.log("CodeMap will append to the statusline:");
   console.log(chalk17.cyan("  CM: \u25CF 842f 12.4k\u25C6 | 23m ago") + chalk17.dim("       \u2014 watcher running, index fresh"));
   console.log(chalk17.cyan("  CM: \u25CB 842f 12.4k\u25C6 \u26A03 | 2h ago") + chalk17.dim("    \u2014 no watcher, 3 stale files"));
   console.log(chalk17.cyan("  CM: \u25CB 842f 12.4k\u25C6 IDX | 5s ago") + chalk17.dim("   \u2014 indexing in progress"));
-  console.log(chalk17.cyan("  CM: \u2014 no index") + chalk17.dim("                     \u2014 no stats.json found"));
+  console.log(chalk17.cyan("  CM: \u2014 no index (run: codemap index)") + chalk17.dim("  \u2014 not yet indexed"));
   console.log();
   console.log(chalk17.dim("Restart Claude Code to see the statusline."));
   console.log(chalk17.dim("Run `codemap statusline --uninstall` to remove."));
+  console.log();
+  console.log(chalk17.dim("Tip: Install codemap in multiple projects to give each Claude Code"));
+  console.log(chalk17.dim("session its own code intelligence \u2014 frontend, backend, shared libs."));
+  console.log(chalk17.dim("Run `codemap init` in any project to get started."));
 }
 function uninstall() {
-  let restored = false;
+  let originalCommand = "";
   if (fs18.existsSync(BACKUP_FILE)) {
-    fs18.copyFileSync(BACKUP_FILE, SCRIPT_FILE);
-    fs18.unlinkSync(BACKUP_FILE);
-    console.log(chalk17.dim(`Restored original script from backup.`));
-    restored = true;
-  } else if (fs18.existsSync(SCRIPT_FILE)) {
+    try {
+      originalCommand = fs18.readFileSync(BACKUP_FILE, "utf-8").trim();
+    } catch {
+    }
+    try {
+      fs18.unlinkSync(BACKUP_FILE);
+    } catch {
+    }
+  }
+  if (fs18.existsSync(SCRIPT_FILE)) {
     try {
       const content = fs18.readFileSync(SCRIPT_FILE, "utf-8");
       if (content.includes("Generated by: codemap statusline")) {
         fs18.unlinkSync(SCRIPT_FILE);
-        console.log(chalk17.dim(`Removed statusline script.`));
-        const settings = readSettings();
-        if (settings.statusline_command === SCRIPT_FILE) {
-          delete settings.statusline_command;
-          writeSettings(settings);
-          console.log(chalk17.dim(`Cleared statusline_command from settings.`));
-        }
+        console.log(chalk17.dim("Removed statusline script."));
       }
     } catch {
     }
   }
-  if (!restored) {
-    const settings = readSettings();
-    if (settings.statusline_command) {
-      delete settings.statusline_command;
-      writeSettings(settings);
-    }
+  const settings = readSettings();
+  if (originalCommand && originalCommand !== SCRIPT_FILE) {
+    settings.statusline_command = originalCommand;
+    writeSettings(settings);
+    console.log(chalk17.dim(`Restored original statusline command.`));
+  } else if (settings.statusline_command) {
+    delete settings.statusline_command;
+    writeSettings(settings);
+    console.log(chalk17.dim("Cleared statusline_command from settings."));
   }
   console.log();
   console.log(chalk17.green("CodeMap statusline removed."));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ulpi/codemap",
-  "version": "0.3.8",
+  "version": "0.3.9",
   "type": "module",
   "description": "Standalone code intelligence CLI — hybrid vector + BM25 search, dependency analysis, PageRank",
   "bin": {
@@ -10,9 +10,11 @@
     ".": "./dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "scripts/postinstall.js"
   ],
   "scripts": {
+    "postinstall": "node scripts/postinstall.js",
     "build": "tsup && node --import tsx scripts/copy-grammars.ts",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",

package/scripts/postinstall.js

@@ -0,0 +1,36 @@
+// Postinstall welcome message for `npm install -g @ulpi/codemap`
+const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+const dim = (s) => `\x1b[2m${s}\x1b[0m`;
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+
+console.log();
+console.log(bold("codemap") + " installed successfully.");
+console.log();
+console.log("Get started:");
+console.log(`  ${cyan("codemap init")}          ${dim("# Choose embedding provider + model")}`);
+console.log(`  ${cyan("codemap index")}         ${dim("# Index your project")}`);
+console.log(`  ${cyan("codemap search")} ${dim('"query"')}  ${dim("# Search your code")}`);
+console.log();
+console.log("Add as an MCP server to give your AI agent code intelligence:");
+console.log(`  ${cyan("codemap serve")}         ${dim("# Start MCP server (stdio)")}`);
+console.log();
+console.log("Multi-project: Index each codebase, then register one MCP server per project.");
+console.log("Your AI agent gets code intelligence across your entire stack.");
+console.log();
+console.log(`  ${dim("# Index each project once:")}`);
+console.log(`  ${dim("$")} ${cyan("codemap init")} && ${cyan("codemap index")}                  ${dim("# current project")}`);
+console.log(`  ${dim("$")} cd ~/projects/frontend && ${cyan("codemap init")} && ${cyan("codemap index")}`);
+console.log();
+console.log(`  ${dim("# .mcp.json — add to the project where you use your AI agent:")}`);
+console.log(`  ${dim("{")}`)
+console.log(`  ${dim('  "mcpServers": {')}`);
+console.log(`  ${dim('    "codemap": {')}`);
+console.log(`  ${dim('      "command": "codemap", "args": ["serve"]')}              ${dim("← this project")}`);
+console.log(`  ${dim('    },')}`);
+console.log(`  ${dim('    "codemap-frontend": {')}`);
+console.log(`  ${dim('      "command": "codemap", "args": ["serve", "--cwd",')}`);
+console.log(`  ${dim('        "/path/to/frontend"]')}                               ${dim("← another project")}`);
+console.log(`  ${dim('    }')}`);
+console.log(`  ${dim("  }")}`);
+console.log(`  ${dim("}")}`);
+console.log();