@hasna/mementos 0.14.22 → 0.14.23

package/README.md

@@ -18,8 +18,9 @@ mementos auth signup
 mementos setup agents
 ```
 
-`mementos setup agents` writes remote MCP and hook snippets for Claude Code,
-Codex, OpenCode, and Antigravity under the user's config directory.
+`mementos setup agents` registers the hosted `mementos-mcp` server in Claude
+Code, Codex, OpenCode, and Antigravity config files. It also writes managed
+diagnostic snippets under `~/.config/mementos/agent-integrations`.
 
 ## MCP
 
@@ -36,3 +37,9 @@ MEMENTOS_API_TOKEN=<token> mementos inject "project context"
 ```
 
 The command prints a prompt-ready memory block from the hosted API.
+
+Claude Code also receives `UserPromptSubmit`, `SessionStart`, and `Stop` hook
+entries that call `mementos hook ...` and return hosted memory as hook context.
+Codex does not expose a native hook file in `~/.codex/config.toml`, so the
+installer registers MCP there and keeps the injection command in the managed
+integration snippets.

package/dist/agent-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-setup.d.ts","sourceRoot":"","sources":["../src/agent-setup.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,8DAA+D,CAAC;AAElG,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;CAChF;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CA0CnF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAmCjF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,SAAwB;;;EAStE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAW9D"}
+{"version":3,"file":"agent-setup.d.ts","sourceRoot":"","sources":["../src/agent-setup.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,8DAA+D,CAAC;AAElG,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;CAChF;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CA0CnF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAqCjF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,SAAwB;;;EAStE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAW9D"}

package/dist/cli.js

@@ -2,7 +2,7 @@
 // @bun
 
 // src/agent-setup.ts
-import { existsSync, mkdirSync, rmSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { dirname, join } from "path";
 var SUPPORTED_AGENT_HOSTS = ["claude-code", "codex", "opencode", "antigravity"];
@@ -45,7 +45,7 @@ function buildAgentSetupPlan(options = {}) {
   return {
     baseDir,
     files,
-    hostResults: hosts.map((host) => ({ host, path: hostManagedConfigPath(home, host), status: "planned" })),
+    hostResults: hosts.map((host) => ({ host, path: hostNativeConfigPath(home, host), status: "planned" })),
     hosts,
     mcpCommand
   };
@@ -57,7 +57,7 @@ function installAgentSetup(options = {}) {
       ...plan,
       hostResults: plan.hostResults.map((result) => ({
         ...result,
-        status: existsSync(result.path) ? "present" : "missing"
+        status: hasNativeHostInstall(result.path, result.host) ? "present" : "missing"
       }))
     };
   }
@@ -69,7 +69,9 @@ function installAgentSetup(options = {}) {
       };
     }
     for (const result of plan.hostResults)
-      rmSync(result.path, { force: true });
+      uninstallNativeHost(result.path, result.host);
+    for (const host of plan.hosts)
+      rmSync(hostManagedConfigPath(options.homeDir ?? homedir(), host), { force: true });
     return {
       ...plan,
       hostResults: plan.hostResults.map((result) => ({ ...result, status: "removed" }))
@@ -81,6 +83,8 @@ function installAgentSetup(options = {}) {
     mkdirSync(dirname(file.path), { recursive: true });
     writeFileSync(file.path, file.content, { mode: file.executable ? 493 : 420 });
   }
+  for (const result of plan.hostResults)
+    installNativeHost(result.path, result.host, plan);
   return {
     ...plan,
     hostResults: plan.hostResults.map((result) => ({ ...result, status: "installed" }))
@@ -155,7 +159,9 @@ function renderManagedHostConfig(host, commands) {
     return {
       ...base,
       hooks: {
-        Stop: [{ hooks: [{ type: "command", command: commands.hookCommand }] }]
+        UserPromptSubmit: [{ matcher: "", hooks: [{ type: "command", command: "mementos hook user-prompt-submit" }] }],
+        SessionStart: [{ matcher: "", hooks: [{ type: "command", command: "mementos hook session-start" }] }],
+        Stop: [{ matcher: "", hooks: [{ type: "command", command: commands.hookCommand }] }]
       }
     };
   }
@@ -184,6 +190,235 @@ function hostManagedConfigPath(home, host) {
       return join(home, ".config", "antigravity", "mementos.managed.json");
   }
 }
+function hostNativeConfigPath(home, host) {
+  switch (host) {
+    case "claude-code":
+      return join(home, ".claude", "settings.json");
+    case "codex":
+      return join(home, ".codex", "config.toml");
+    case "opencode":
+      return join(home, ".config", "opencode", "opencode.json");
+    case "antigravity":
+      return join(home, ".antigravity", "mcp.json");
+  }
+}
+function installNativeHost(path, host, plan) {
+  mkdirSync(dirname(path), { recursive: true });
+  if (host === "codex") {
+    writeFileSync(path, installCodexToml(readTextFile(path), plan), { mode: 420 });
+    return;
+  }
+  const config = readJsonObject(path);
+  if (host === "claude-code") {
+    writeJsonObject(path, installClaudeConfig(config, plan));
+    return;
+  }
+  if (host === "opencode") {
+    writeJsonObject(path, installOpenCodeConfig(config, plan));
+    return;
+  }
+  writeJsonObject(path, installAntigravityConfig(config, plan));
+}
+function uninstallNativeHost(path, host) {
+  if (!existsSync(path))
+    return;
+  if (host === "codex") {
+    writeFileSync(path, uninstallCodexToml(readTextFile(path)), { mode: 420 });
+    return;
+  }
+  const config = readJsonObject(path);
+  if (host === "claude-code")
+    writeJsonObject(path, uninstallClaudeConfig(config));
+  if (host === "opencode")
+    writeJsonObject(path, uninstallOpenCodeConfig(config));
+  if (host === "antigravity")
+    writeJsonObject(path, uninstallMcpServersConfig(config));
+}
+function hasNativeHostInstall(path, host) {
+  if (!existsSync(path))
+    return false;
+  if (host === "codex")
+    return /\[mcp_servers\.mementos\]/.test(readTextFile(path));
+  const config = readJsonObject(path);
+  if (host === "opencode")
+    return isRecord(config.mcp) && isRecord(config.mcp.mementos);
+  return isRecord(config.mcpServers) && isRecord(config.mcpServers.mementos);
+}
+function installClaudeConfig(config, plan) {
+  return {
+    ...config,
+    mcpServers: {
+      ...recordValue(config.mcpServers),
+      mementos: stdioMcpServer(plan, true)
+    },
+    hooks: mergeAgentHooks(recordValue(config.hooks), {
+      UserPromptSubmit: "mementos hook user-prompt-submit",
+      SessionStart: "mementos hook session-start",
+      Stop: "mementos hook stop"
+    })
+  };
+}
+function uninstallClaudeConfig(config) {
+  return {
+    ...config,
+    mcpServers: omitKey(recordValue(config.mcpServers), "mementos"),
+    hooks: removeAgentHooks(recordValue(config.hooks), [
+      "mementos hook user-prompt-submit",
+      "mementos hook session-start",
+      "mementos hook stop"
+    ])
+  };
+}
+function installOpenCodeConfig(config, plan) {
+  return {
+    ...config,
+    mcp: {
+      ...recordValue(config.mcp),
+      mementos: {
+        type: "local",
+        command: [plan.mcpCommand],
+        enabled: true,
+        environment: remoteEnv(baseApiUrlFromPlan(plan))
+      }
+    }
+  };
+}
+function uninstallOpenCodeConfig(config) {
+  return {
+    ...config,
+    mcp: omitKey(recordValue(config.mcp), "mementos")
+  };
+}
+function installAntigravityConfig(config, plan) {
+  return {
+    ...config,
+    mcpServers: {
+      ...recordValue(config.mcpServers),
+      mementos: stdioMcpServer(plan, false)
+    }
+  };
+}
+function uninstallMcpServersConfig(config) {
+  return {
+    ...config,
+    mcpServers: omitKey(recordValue(config.mcpServers), "mementos")
+  };
+}
+function installCodexToml(current, plan) {
+  const withoutExisting = removeTomlTable(removeManagedCodexBlock(current), "mcp_servers.mementos");
+  const block = [
+    "# BEGIN @hasna/mementos",
+    "[mcp_servers.mementos]",
+    `command = ${JSON.stringify(plan.mcpCommand)}`,
+    "[mcp_servers.mementos.env]",
+    `MEMENTOS_API_URL = ${JSON.stringify(baseApiUrlFromPlan(plan))}`,
+    'MEMENTOS_API_TOKEN = "$MEMENTOS_API_TOKEN"',
+    "# END @hasna/mementos",
+    ""
+  ].join(`
+`);
+  return `${withoutExisting.trimEnd()}
+
+${block}`;
+}
+function uninstallCodexToml(current) {
+  return `${removeTomlTable(removeManagedCodexBlock(current), "mcp_servers.mementos").trimEnd()}
+`;
+}
+function mergeAgentHooks(hooks, commands) {
+  const next = { ...hooks };
+  for (const [event, command] of Object.entries(commands)) {
+    const current = next[event];
+    const entries = Array.isArray(current) ? [...current] : [];
+    if (!entries.some((entry) => JSON.stringify(entry).includes(command))) {
+      entries.push({ matcher: "", hooks: [{ type: "command", command }] });
+    }
+    next[event] = entries;
+  }
+  return next;
+}
+function removeAgentHooks(hooks, commands) {
+  const next = { ...hooks };
+  for (const [event, entries] of Object.entries(next)) {
+    if (!Array.isArray(entries))
+      continue;
+    next[event] = entries.filter((entry) => !commands.some((command) => JSON.stringify(entry).includes(command)));
+  }
+  return next;
+}
+function stdioMcpServer(plan, includeType) {
+  return {
+    ...includeType ? { type: "stdio" } : {},
+    command: plan.mcpCommand,
+    env: remoteEnv(baseApiUrlFromPlan(plan))
+  };
+}
+function remoteEnv(apiUrl) {
+  return {
+    MEMENTOS_API_URL: apiUrl,
+    MEMENTOS_API_TOKEN: "$MEMENTOS_API_TOKEN"
+  };
+}
+function baseApiUrlFromPlan(plan) {
+  const mcpFile = plan.files.find((file) => file.path.endsWith("mcp-server.json"));
+  if (!mcpFile)
+    return "https://mementos.md";
+  try {
+    const parsed = JSON.parse(mcpFile.content);
+    return parsed.mcpServers?.mementos?.env?.MEMENTOS_API_URL ?? "https://mementos.md";
+  } catch {
+    return "https://mementos.md";
+  }
+}
+function removeManagedCodexBlock(value) {
+  return value.replace(/\n?# BEGIN @hasna\/mementos\n[\s\S]*?# END @hasna\/mementos\n?/g, `
+`);
+}
+function removeTomlTable(value, table) {
+  const tablePattern = table.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const lines = value.split(`
+`);
+  const output = [];
+  let skipping = false;
+  for (const line of lines) {
+    if (new RegExp(`^\\[${tablePattern}(?:\\.|\\])`).test(line.trim())) {
+      skipping = true;
+      continue;
+    }
+    if (skipping && /^\[[^\]]+\]/.test(line.trim()))
+      skipping = false;
+    if (!skipping)
+      output.push(line);
+  }
+  return output.join(`
+`);
+}
+function readTextFile(path) {
+  return existsSync(path) ? readFileSync(path, "utf8") : "";
+}
+function readJsonObject(path) {
+  if (!existsSync(path))
+    return {};
+  const parsed = JSON.parse(readFileSync(path, "utf8"));
+  if (!isRecord(parsed))
+    throw new Error(`${path} must contain a JSON object`);
+  return parsed;
+}
+function writeJsonObject(path, value) {
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, `${JSON.stringify(value, null, 2)}
+`, { mode: 420 });
+}
+function recordValue(value) {
+  return isRecord(value) ? value : {};
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function omitKey(record, key) {
+  const { [key]: _removed, ...rest } = record;
+  return rest;
+}
 function renderInjectionInstructions({ apiUrl, injectCommand }) {
   return `# mementos.md Memory Injection
 
@@ -453,12 +688,52 @@ async function injectMemory(args) {
 }
 async function runHook(args) {
   const subcommand = args[0] ?? "help";
+  const hookEvents = {
+    "user-prompt-submit": "UserPromptSubmit",
+    "session-start": "SessionStart",
+    "subagent-start": "SubagentStart",
+    setup: "Setup"
+  };
+  if (subcommand in hookEvents) {
+    const query2 = await readHookQuery();
+    const payload = await client.injectionContext({ query: query2, limit: 12 });
+    const block = readTextPayload(payload) ?? formatMemoryInjection(payload);
+    return {
+      suppressOutput: true,
+      hookSpecificOutput: {
+        hookEventName: hookEvents[subcommand],
+        additionalContext: block
+      }
+    };
+  }
   if (subcommand !== "stop") {
-    throw new Error("usage: mementos hook stop");
+    throw new Error("usage: mementos hook <stop|user-prompt-submit|session-start|subagent-start|setup>");
   }
   const query = process.env.MEMENTOS_INJECTION_QUERY ?? process.cwd();
   return injectMemory([query]);
 }
+async function readHookQuery() {
+  if (process.env.MEMENTOS_INJECTION_QUERY)
+    return process.env.MEMENTOS_INJECTION_QUERY;
+  const stdin = await readOptionalStdin();
+  if (!stdin)
+    return process.cwd();
+  try {
+    const parsed = JSON.parse(stdin);
+    const prompt = parsed.prompt ?? parsed.userPrompt ?? parsed.message ?? parsed.cwd;
+    if (typeof prompt === "string" && prompt.trim())
+      return prompt.trim();
+  } catch {
+    if (stdin.trim())
+      return stdin.trim();
+  }
+  return process.cwd();
+}
+async function readOptionalStdin() {
+  if (process.stdin.isTTY)
+    return "";
+  return new Response(Bun.stdin.stream()).text();
+}
 function parseSetupOptions(args) {
   const options = {};
   for (let index = 0;index < args.length; index += 1) {
@@ -502,7 +777,7 @@ Usage:
   mementos auth signup
   mementos setup agents [--dry-run|--verify|--uninstall]
   mementos inject <query>
-  mementos hook stop
+  mementos hook <stop|user-prompt-submit|session-start|subagent-start|setup>
   mementos capabilities
   mementos agents
   mementos usage

package/dist/index.js

@@ -291,7 +291,7 @@ function requiredText(input, message) {
   return input.trim();
 }
 // src/agent-setup.ts
-import { existsSync, mkdirSync, rmSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { dirname, join } from "path";
 var SUPPORTED_AGENT_HOSTS = ["claude-code", "codex", "opencode", "antigravity"];
@@ -334,7 +334,7 @@ function buildAgentSetupPlan(options = {}) {
   return {
     baseDir,
     files,
-    hostResults: hosts.map((host) => ({ host, path: hostManagedConfigPath(home, host), status: "planned" })),
+    hostResults: hosts.map((host) => ({ host, path: hostNativeConfigPath(home, host), status: "planned" })),
     hosts,
     mcpCommand
   };
@@ -346,7 +346,7 @@ function installAgentSetup(options = {}) {
       ...plan,
       hostResults: plan.hostResults.map((result) => ({
         ...result,
-        status: existsSync(result.path) ? "present" : "missing"
+        status: hasNativeHostInstall(result.path, result.host) ? "present" : "missing"
       }))
     };
   }
@@ -358,7 +358,9 @@ function installAgentSetup(options = {}) {
       };
     }
     for (const result of plan.hostResults)
-      rmSync(result.path, { force: true });
+      uninstallNativeHost(result.path, result.host);
+    for (const host of plan.hosts)
+      rmSync(hostManagedConfigPath(options.homeDir ?? homedir(), host), { force: true });
     return {
       ...plan,
       hostResults: plan.hostResults.map((result) => ({ ...result, status: "removed" }))
@@ -370,6 +372,8 @@ function installAgentSetup(options = {}) {
     mkdirSync(dirname(file.path), { recursive: true });
     writeFileSync(file.path, file.content, { mode: file.executable ? 493 : 420 });
   }
+  for (const result of plan.hostResults)
+    installNativeHost(result.path, result.host, plan);
   return {
     ...plan,
     hostResults: plan.hostResults.map((result) => ({ ...result, status: "installed" }))
@@ -444,7 +448,9 @@ function renderManagedHostConfig(host, commands) {
     return {
       ...base,
       hooks: {
-        Stop: [{ hooks: [{ type: "command", command: commands.hookCommand }] }]
+        UserPromptSubmit: [{ matcher: "", hooks: [{ type: "command", command: "mementos hook user-prompt-submit" }] }],
+        SessionStart: [{ matcher: "", hooks: [{ type: "command", command: "mementos hook session-start" }] }],
+        Stop: [{ matcher: "", hooks: [{ type: "command", command: commands.hookCommand }] }]
       }
     };
   }
@@ -473,6 +479,235 @@ function hostManagedConfigPath(home, host) {
       return join(home, ".config", "antigravity", "mementos.managed.json");
   }
 }
+function hostNativeConfigPath(home, host) {
+  switch (host) {
+    case "claude-code":
+      return join(home, ".claude", "settings.json");
+    case "codex":
+      return join(home, ".codex", "config.toml");
+    case "opencode":
+      return join(home, ".config", "opencode", "opencode.json");
+    case "antigravity":
+      return join(home, ".antigravity", "mcp.json");
+  }
+}
+function installNativeHost(path, host, plan) {
+  mkdirSync(dirname(path), { recursive: true });
+  if (host === "codex") {
+    writeFileSync(path, installCodexToml(readTextFile(path), plan), { mode: 420 });
+    return;
+  }
+  const config = readJsonObject(path);
+  if (host === "claude-code") {
+    writeJsonObject(path, installClaudeConfig(config, plan));
+    return;
+  }
+  if (host === "opencode") {
+    writeJsonObject(path, installOpenCodeConfig(config, plan));
+    return;
+  }
+  writeJsonObject(path, installAntigravityConfig(config, plan));
+}
+function uninstallNativeHost(path, host) {
+  if (!existsSync(path))
+    return;
+  if (host === "codex") {
+    writeFileSync(path, uninstallCodexToml(readTextFile(path)), { mode: 420 });
+    return;
+  }
+  const config = readJsonObject(path);
+  if (host === "claude-code")
+    writeJsonObject(path, uninstallClaudeConfig(config));
+  if (host === "opencode")
+    writeJsonObject(path, uninstallOpenCodeConfig(config));
+  if (host === "antigravity")
+    writeJsonObject(path, uninstallMcpServersConfig(config));
+}
+function hasNativeHostInstall(path, host) {
+  if (!existsSync(path))
+    return false;
+  if (host === "codex")
+    return /\[mcp_servers\.mementos\]/.test(readTextFile(path));
+  const config = readJsonObject(path);
+  if (host === "opencode")
+    return isRecord(config.mcp) && isRecord(config.mcp.mementos);
+  return isRecord(config.mcpServers) && isRecord(config.mcpServers.mementos);
+}
+function installClaudeConfig(config, plan) {
+  return {
+    ...config,
+    mcpServers: {
+      ...recordValue(config.mcpServers),
+      mementos: stdioMcpServer(plan, true)
+    },
+    hooks: mergeAgentHooks(recordValue(config.hooks), {
+      UserPromptSubmit: "mementos hook user-prompt-submit",
+      SessionStart: "mementos hook session-start",
+      Stop: "mementos hook stop"
+    })
+  };
+}
+function uninstallClaudeConfig(config) {
+  return {
+    ...config,
+    mcpServers: omitKey(recordValue(config.mcpServers), "mementos"),
+    hooks: removeAgentHooks(recordValue(config.hooks), [
+      "mementos hook user-prompt-submit",
+      "mementos hook session-start",
+      "mementos hook stop"
+    ])
+  };
+}
+function installOpenCodeConfig(config, plan) {
+  return {
+    ...config,
+    mcp: {
+      ...recordValue(config.mcp),
+      mementos: {
+        type: "local",
+        command: [plan.mcpCommand],
+        enabled: true,
+        environment: remoteEnv(baseApiUrlFromPlan(plan))
+      }
+    }
+  };
+}
+function uninstallOpenCodeConfig(config) {
+  return {
+    ...config,
+    mcp: omitKey(recordValue(config.mcp), "mementos")
+  };
+}
+function installAntigravityConfig(config, plan) {
+  return {
+    ...config,
+    mcpServers: {
+      ...recordValue(config.mcpServers),
+      mementos: stdioMcpServer(plan, false)
+    }
+  };
+}
+function uninstallMcpServersConfig(config) {
+  return {
+    ...config,
+    mcpServers: omitKey(recordValue(config.mcpServers), "mementos")
+  };
+}
+function installCodexToml(current, plan) {
+  const withoutExisting = removeTomlTable(removeManagedCodexBlock(current), "mcp_servers.mementos");
+  const block = [
+    "# BEGIN @hasna/mementos",
+    "[mcp_servers.mementos]",
+    `command = ${JSON.stringify(plan.mcpCommand)}`,
+    "[mcp_servers.mementos.env]",
+    `MEMENTOS_API_URL = ${JSON.stringify(baseApiUrlFromPlan(plan))}`,
+    'MEMENTOS_API_TOKEN = "$MEMENTOS_API_TOKEN"',
+    "# END @hasna/mementos",
+    ""
+  ].join(`
+`);
+  return `${withoutExisting.trimEnd()}
+
+${block}`;
+}
+function uninstallCodexToml(current) {
+  return `${removeTomlTable(removeManagedCodexBlock(current), "mcp_servers.mementos").trimEnd()}
+`;
+}
+function mergeAgentHooks(hooks, commands) {
+  const next = { ...hooks };
+  for (const [event, command] of Object.entries(commands)) {
+    const current = next[event];
+    const entries = Array.isArray(current) ? [...current] : [];
+    if (!entries.some((entry) => JSON.stringify(entry).includes(command))) {
+      entries.push({ matcher: "", hooks: [{ type: "command", command }] });
+    }
+    next[event] = entries;
+  }
+  return next;
+}
+function removeAgentHooks(hooks, commands) {
+  const next = { ...hooks };
+  for (const [event, entries] of Object.entries(next)) {
+    if (!Array.isArray(entries))
+      continue;
+    next[event] = entries.filter((entry) => !commands.some((command) => JSON.stringify(entry).includes(command)));
+  }
+  return next;
+}
+function stdioMcpServer(plan, includeType) {
+  return {
+    ...includeType ? { type: "stdio" } : {},
+    command: plan.mcpCommand,
+    env: remoteEnv(baseApiUrlFromPlan(plan))
+  };
+}
+function remoteEnv(apiUrl) {
+  return {
+    MEMENTOS_API_URL: apiUrl,
+    MEMENTOS_API_TOKEN: "$MEMENTOS_API_TOKEN"
+  };
+}
+function baseApiUrlFromPlan(plan) {
+  const mcpFile = plan.files.find((file) => file.path.endsWith("mcp-server.json"));
+  if (!mcpFile)
+    return "https://mementos.md";
+  try {
+    const parsed = JSON.parse(mcpFile.content);
+    return parsed.mcpServers?.mementos?.env?.MEMENTOS_API_URL ?? "https://mementos.md";
+  } catch {
+    return "https://mementos.md";
+  }
+}
+function removeManagedCodexBlock(value) {
+  return value.replace(/\n?# BEGIN @hasna\/mementos\n[\s\S]*?# END @hasna\/mementos\n?/g, `
+`);
+}
+function removeTomlTable(value, table) {
+  const tablePattern = table.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const lines = value.split(`
+`);
+  const output = [];
+  let skipping = false;
+  for (const line of lines) {
+    if (new RegExp(`^\\[${tablePattern}(?:\\.|\\])`).test(line.trim())) {
+      skipping = true;
+      continue;
+    }
+    if (skipping && /^\[[^\]]+\]/.test(line.trim()))
+      skipping = false;
+    if (!skipping)
+      output.push(line);
+  }
+  return output.join(`
+`);
+}
+function readTextFile(path) {
+  return existsSync(path) ? readFileSync(path, "utf8") : "";
+}
+function readJsonObject(path) {
+  if (!existsSync(path))
+    return {};
+  const parsed = JSON.parse(readFileSync(path, "utf8"));
+  if (!isRecord(parsed))
+    throw new Error(`${path} must contain a JSON object`);
+  return parsed;
+}
+function writeJsonObject(path, value) {
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, `${JSON.stringify(value, null, 2)}
+`, { mode: 420 });
+}
+function recordValue(value) {
+  return isRecord(value) ? value : {};
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function omitKey(record, key) {
+  const { [key]: _removed, ...rest } = record;
+  return rest;
+}
 function renderInjectionInstructions({ apiUrl, injectCommand }) {
   return `# mementos.md Memory Injection
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mementos",
-  "version": "0.14.22",
+  "version": "0.14.23",
   "description": "Remote-only mementos.md SaaS CLI and MCP client",
   "type": "module",
   "main": "dist/index.js",