mindgraph-mcp 0.14.3 → 0.14.4

package/README.md

@@ -151,8 +151,14 @@ mindgraph-mcp uninstall-hooks  Remove MindGraph-owned hook entries
 mindgraph-mcp status           Show installation status
 ```
 
-Options: `--api-key <key>`, `--base-url <url>`, `--scope user|project`,
-`--project-dir <dir>`, `--harness <name>`, `--help`.
+Options: `--api-key <key>`, `--base-url <url>`, `--agent-id <id>`,
+`--scope user|project`, `--project-dir <dir>`, `--harness <name>`, `--help`.
+
+**Teams**: when several people share one org graph, give each member a
+distinct identity — `--agent-id claude-code:<name>` on `install-code` /
+`install-hooks`. Anchored knowledge is shared automatically; distinct agent
+ids keep task leases and resume briefs per-person (identical ids make
+teammates one logical agent, which claims each other's work).
 
 ## Environment
 

package/dist/cli.js

@@ -4893,7 +4893,7 @@ Capture knowledge when the user shares something worth remembering:
     server = new import_server.Server(
       {
         name: "mindgraph",
-        version: "0.14.3"
+        version: "0.14.4"
       },
       {
         capabilities: {
@@ -5131,7 +5131,8 @@ function loadHookEnv(dir) {
     const parsed = JSON.parse(raw);
     return {
       baseUrl: typeof parsed.baseUrl === "string" ? parsed.baseUrl : void 0,
-      apiKey: typeof parsed.apiKey === "string" ? parsed.apiKey : void 0
+      apiKey: typeof parsed.apiKey === "string" ? parsed.apiKey : void 0,
+      agentId: typeof parsed.agentId === "string" ? parsed.agentId : void 0
     };
   } catch {
     return {};
@@ -5143,7 +5144,8 @@ function saveHookEnv(env, dir) {
   const existing = loadHookEnv(dir);
   const merged = {
     baseUrl: env.baseUrl ?? existing.baseUrl,
-    apiKey: env.apiKey ?? existing.apiKey
+    apiKey: env.apiKey ?? existing.apiKey,
+    agentId: env.agentId ?? existing.agentId
   };
   import_node_fs.default.writeFileSync(file, `${JSON.stringify(merged, null, 2)}
 `, {
@@ -5163,6 +5165,7 @@ function parseArgs(argv) {
   let projectDir;
   let harness;
   let hooks = false;
+  let agentId = process.env.MINDGRAPH_AGENT_ID;
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     switch (arg) {
@@ -5186,6 +5189,9 @@ function parseArgs(argv) {
       case "--harness":
         harness = args[++i];
         break;
+      case "--agent-id":
+        agentId = args[++i];
+        break;
       case "--hooks":
         hooks = true;
         break;
@@ -5203,7 +5209,7 @@ function parseArgs(argv) {
         break;
     }
   }
-  return { command, apiKey, baseUrl, scope, projectDir, harness, hooks };
+  return { command, apiKey, baseUrl, scope, projectDir, harness, hooks, agentId };
 }
 function mcpAddFailureOutput(e) {
   const err5 = e;
@@ -5848,7 +5854,7 @@ function installClaudeDesktop(apiKey, baseUrl) {
   }
   console.log("Restart Claude Desktop to activate.");
 }
-function installClaudeCode(apiKey, baseUrl) {
+function installClaudeCode(apiKey, baseUrl, agentId) {
   const envArgs = [
     `--env`,
     `MINDGRAPH_API_KEY=${apiKey}`,
@@ -5857,7 +5863,7 @@ function installClaudeCode(apiKey, baseUrl) {
     "--env",
     "MINDGRAPH_HARNESS=claude-code",
     "--env",
-    "MINDGRAPH_AGENT_ID=claude-code"
+    `MINDGRAPH_AGENT_ID=${agentId || "claude-code"}`
   ];
   if (baseUrl) {
     envArgs.push("--env", `MINDGRAPH_BASE_URL=${baseUrl}`);
@@ -5951,7 +5957,7 @@ function printStatus() {
 function withHooksFlag() {
   return process.argv.includes("--hooks");
 }
-function finishCodeInstall(apiKey, baseUrl, withHooks) {
+function finishCodeInstall(apiKey, baseUrl, withHooks, agentId) {
   if (withHooks) {
     const runner = installHookRunner(__filename);
     console.log(`Installed pinned hook runner at ${runner}`);
@@ -5959,7 +5965,7 @@ function finishCodeInstall(apiKey, baseUrl, withHooks) {
     console.log(
       `Installed ${result.added} and refreshed ${result.updated} MindGraph Claude Code hook entries in ${result.path}`
     );
-    const envPath = saveHookEnv({ apiKey, baseUrl });
+    const envPath = saveHookEnv({ apiKey, baseUrl, agentId });
     console.log(`Saved hook connection settings to ${envPath} (mode 600)`);
   } else {
     console.log(
@@ -6111,13 +6117,23 @@ async function interactiveInit(baseUrl) {
       installClaudeDesktop(apiKey, baseUrl);
       break;
     case "2":
-      installClaudeCode(apiKey, baseUrl);
-      finishCodeInstall(apiKey, baseUrl, withHooksFlag());
+      installClaudeCode(apiKey, baseUrl, process.env.MINDGRAPH_AGENT_ID);
+      finishCodeInstall(
+        apiKey,
+        baseUrl,
+        withHooksFlag(),
+        process.env.MINDGRAPH_AGENT_ID
+      );
       break;
     case "3":
       installClaudeDesktop(apiKey, baseUrl);
-      installClaudeCode(apiKey, baseUrl);
-      finishCodeInstall(apiKey, baseUrl, withHooksFlag());
+      installClaudeCode(apiKey, baseUrl, process.env.MINDGRAPH_AGENT_ID);
+      finishCodeInstall(
+        apiKey,
+        baseUrl,
+        withHooksFlag(),
+        process.env.MINDGRAPH_AGENT_ID
+      );
       break;
     default:
       console.error("Invalid choice.");
@@ -6126,7 +6142,7 @@ async function interactiveInit(baseUrl) {
   console.log("\nDone! Your knowledge graph is now connected.");
 }
 async function main2() {
-  const { command, apiKey, baseUrl, scope, projectDir, harness, hooks } = parseArgs(process.argv);
+  const { command, apiKey, baseUrl, scope, projectDir, harness, hooks, agentId } = parseArgs(process.argv);
   switch (command) {
     case "help":
       printUsage();
@@ -6150,8 +6166,8 @@ async function main2() {
         );
         process.exit(1);
       }
-      installClaudeCode(apiKey, baseUrl);
-      finishCodeInstall(apiKey, baseUrl, withHooksFlag());
+      installClaudeCode(apiKey, baseUrl, agentId);
+      finishCodeInstall(apiKey, baseUrl, withHooksFlag(), agentId);
       break;
     case "uninstall":
       uninstallClaudeDesktop();
@@ -6169,8 +6185,8 @@ async function main2() {
       console.log(
         `Installed ${result.added} and refreshed ${result.updated} MindGraph Claude Code hook entries in ${result.path}`
       );
-      if (apiKey || baseUrl) {
-        const envPath = saveHookEnv({ apiKey, baseUrl });
+      if (apiKey || baseUrl || agentId) {
+        const envPath = saveHookEnv({ apiKey, baseUrl, agentId });
         console.log(`Saved hook connection settings to ${envPath} (mode 600)`);
       } else {
         console.log(
@@ -6208,7 +6224,7 @@ async function main2() {
           telemetrySurface: "mcp"
         });
         const output = await runClaudeHook(input, client2, {
-          agentId: process.env.MINDGRAPH_AGENT_ID || "claude-code"
+          agentId: process.env.MINDGRAPH_AGENT_ID || stored.agentId || "claude-code"
         });
         process.stdout.write(`${JSON.stringify(output)}
 `);

package/dist/index.js

@@ -3931,7 +3931,7 @@ if (PROFILE === "coding") {
 var server = new import_server.Server(
   {
     name: "mindgraph",
-    version: "0.14.3"
+    version: "0.14.4"
   },
   {
     capabilities: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindgraph-mcp",
-  "version": "0.14.3",
+  "version": "0.14.4",
   "description": "MCP server for MindGraph — connect Claude Desktop, Claude Code, and any MCP client to your knowledge graph",
   "repository": {
     "type": "git",