memento-mcp 0.3.11 → 0.3.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memento-mcp",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "mcpName": "io.github.myrakrusemark/memento-protocol",
   "description": "The Memento Protocol — persistent memory for AI agents",
   "type": "module",

package/scripts/memento-precompact-distill.sh

@@ -73,7 +73,7 @@ if [ -f "$SCRIPT_DIR/../.env" ]; then
 fi
 
 MEMENTO_API="${MEMENTO_API_URL:-https://memento-api.myrakrusemark.workers.dev}"
-MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-protocol/.env or .memento.json}"
+MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-mcp/.env or .memento.json}"
 MEMENTO_WS="${MEMENTO_WORKSPACE:-default}"
 
 # Parse transcript to readable text (use fathom's parser if available, else raw)

package/scripts/memento-sessionstart-identity.sh

@@ -69,7 +69,7 @@ if [ -f "$SCRIPT_DIR/../.env" ]; then
 fi
 
 MEMENTO_API="${MEMENTO_API_URL:-https://memento-api.myrakrusemark.workers.dev}"
-MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-protocol/.env or .memento.json}"
+MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-mcp/.env or .memento.json}"
 MEMENTO_WS="${MEMENTO_WORKSPACE:-default}"
 
 AUTH_HEADER="Authorization: Bearer $MEMENTO_KEY"

package/scripts/memento-stop-recall.sh

@@ -54,7 +54,7 @@ if [ -f "$SCRIPT_DIR/../.env" ]; then
 fi
 
 MEMENTO_API="${MEMENTO_API_URL:-https://memento-api.myrakrusemark.workers.dev}"
-MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-protocol/.env or .memento.json}"
+MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-mcp/.env or .memento.json}"
 MEMENTO_WS="${MEMENTO_WORKSPACE:-default}"
 
 INPUT=$(cat)
@@ -96,8 +96,8 @@ try:
 
     memories = data.get('memories', {}).get('matches', [])
     if memories:
-        for m in memories[:${RECALL_LIMIT:-5}]:
-            content = m['content'][:${RECALL_MAX_LENGTH:-120}]
+        for m in memories[:${RECALL_LIMIT:-7}]:
+            content = m['content']
             t = abbrev.get(m['type'], m['type'])
             lines.append(f'  🔹 {content} [{m[\"id\"]} {t}]')
             count += 1

package/scripts/memento-userprompt-recall.sh

@@ -55,7 +55,7 @@ if [ -f "$SCRIPT_DIR/../.env" ]; then
 fi
 
 MEMENTO_API="${MEMENTO_API_URL:-https://memento-api.myrakrusemark.workers.dev}"
-MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-protocol/.env or .memento.json}"
+MEMENTO_KEY="${MEMENTO_API_KEY:?MEMENTO_API_KEY not set — check memento-mcp/.env or .memento.json}"
 MEMENTO_WS="${MEMENTO_WORKSPACE:-default}"
 
 INPUT=$(cat)
@@ -88,8 +88,8 @@ try:
 
     memories = data.get('memories', {}).get('matches', [])
     if memories:
-        for m in memories[:${RECALL_LIMIT:-5}]:
-            content = m['content'][:${RECALL_MAX_LENGTH:-120}]
+        for m in memories[:${RECALL_LIMIT:-7}]:
+            content = m['content']
             t = abbrev.get(m['type'], m['type'])
             lines.append(f'  🔹 {content} [{m[\"id\"]} {t}]')
             count += 1

package/src/cli.js

@@ -120,9 +120,7 @@ before compaction. Trust the hooks. Focus on writing good memories.`;
 
 const HEADLESS_CMDS = {
   "claude-code": (prompt) => ["claude", "-p", "--dangerously-skip-permissions", prompt],
-  "codex":       (prompt) => ["codex", "exec", prompt],
   "gemini":      (prompt) => ["gemini", prompt],
-  "opencode":    (prompt) => ["opencode", "run", prompt],
 };
 
 function buildIntegrationPrompt(blob) {
@@ -162,13 +160,16 @@ function runAgentHeadless(agentKey, prompt) {
 // ---------------------------------------------------------------------------
 
 function parseFlags(argv) {
-  const flags = { nonInteractive: false, apiKey: null };
+  const flags = { nonInteractive: false, apiKey: null, agent: null };
   for (let i = 0; i < argv.length; i++) {
     if (argv[i] === "-y" || argv[i] === "--yes") {
       flags.nonInteractive = true;
     } else if (argv[i] === "--api-key" && argv[i + 1]) {
       flags.apiKey = argv[i + 1];
       i++;
+    } else if (argv[i] === "--agent" && argv[i + 1]) {
+      flags.agent = argv[i + 1];
+      i++;
     }
   }
   // Also check environment variable
@@ -244,29 +245,6 @@ function writeMcpJson(cwd) {
   return ".mcp.json";
 }
 
-function writeCodexToml(cwd) {
-  const dir = path.join(cwd, ".codex");
-  fs.mkdirSync(dir, { recursive: true });
-  const filePath = path.join(dir, "config.toml");
-
-  let content = "";
-  try {
-    content = fs.readFileSync(filePath, "utf8");
-  } catch {
-    /* file doesn't exist */
-  }
-
-  // Skip if memento section already exists
-  if (/\[mcp_servers\.memento\]/.test(content)) {
-    return ".codex/config.toml (already configured)";
-  }
-
-  const section = `\n[mcp_servers.memento]\ncommand = "npx"\nargs = ["-y", "memento-mcp"]\n`;
-  const separator = content && !content.endsWith("\n") ? "\n" : "";
-  fs.writeFileSync(filePath, content + separator + section);
-  return ".codex/config.toml";
-}
-
 function writeGeminiJson(cwd) {
   const dir = path.join(cwd, ".gemini");
   fs.mkdirSync(dir, { recursive: true });
@@ -277,22 +255,6 @@ function writeGeminiJson(cwd) {
   return ".gemini/settings.json";
 }
 
-function writeOpencodeJson(cwd) {
-  const filePath = path.join(cwd, "opencode.json");
-  const existing = readJsonFile(filePath) || {};
-  deepMerge(existing, {
-    mcp: {
-      memento: {
-        type: "local",
-        command: ["npx", "-y", "memento-mcp"],
-        enabled: true,
-      },
-    },
-  });
-  writeJsonFile(filePath, existing);
-  return "opencode.json";
-}
-
 const AGENTS = {
   "claude-code": {
     name: "Claude Code",
@@ -301,38 +263,31 @@ const AGENTS = {
     hasHooks: true,
     nextSteps: "Restart Claude Code to activate.",
   },
-  codex: {
-    name: "OpenAI Codex",
-    detect: (cwd) => fs.existsSync(path.join(cwd, ".codex")),
-    configWriter: writeCodexToml,
-    hasHooks: false,
-    nextSteps: "Run `codex` in this directory — memento tools load automatically.",
-  },
   gemini: {
     name: "Gemini CLI",
     detect: (cwd) => fs.existsSync(path.join(cwd, ".gemini")),
     configWriter: writeGeminiJson,
-    hasHooks: false,
+    hasHooks: true,
     nextSteps: "Run `gemini` in this directory — memento tools load automatically.",
   },
-  opencode: {
-    name: "OpenCode",
-    detect: (cwd) => fs.existsSync(path.join(cwd, "opencode.json")),
-    configWriter: writeOpencodeJson,
+  manual: {
+    name: "I'll set up my agent myself",
+    detect: () => false,
+    configWriter: () => "(skipped — manual setup)",
     hasHooks: false,
-    nextSteps: "Run `opencode` in this directory — memento tools load automatically.",
+    nextSteps: "Point your agent's MCP config at: npx -y memento-mcp",
   },
 };
 
 // Exported for testing
-export { AGENTS, writeMcpJson, writeCodexToml, writeGeminiJson, writeOpencodeJson };
+export { AGENTS, writeMcpJson, writeGeminiJson };
 
 // ---------------------------------------------------------------------------
 // CLI
 // ---------------------------------------------------------------------------
 
 async function runInit(flags = {}) {
-  const { nonInteractive = false, apiKey: flagApiKey = null } = flags;
+  const { nonInteractive = false, apiKey: flagApiKey = null, agent: flagAgent = null } = flags;
   const cwd = process.cwd();
   const projectName = path.basename(cwd);
 
@@ -420,16 +375,25 @@ async function runInit(flags = {}) {
 
   let selectedAgents;
   if (nonInteractive) {
-    // Auto-detect: use first detected agent, or default to claude-code
-    selectedAgents = detected.length > 0 ? [detected[0]] : ["claude-code"];
-    console.log(`  Agent: ${AGENTS[selectedAgents[0]].name} (auto-detected)`);
+    if (flagAgent) {
+      // Validate --agent value
+      if (!AGENTS[flagAgent]) {
+        const valid = Object.keys(AGENTS).join(", ");
+        console.error(`  Error: unknown agent "${flagAgent}". Valid agents: ${valid}`);
+        process.exit(1);
+      }
+      selectedAgents = [flagAgent];
+      console.log(`  Agent: ${AGENTS[flagAgent].name} (--agent flag)`);
+    } else {
+      // Auto-detect: use first detected agent, or default to claude-code
+      selectedAgents = detected.length > 0 ? [detected[0]] : ["claude-code"];
+      console.log(`  Agent: ${AGENTS[selectedAgents[0]].name} (auto-detected)`);
+    }
   } else {
     console.log("\nDetected agents:");
     const markers = {
       "claude-code": ".claude/",
-      codex: ".codex/",
       gemini: ".gemini/",
-      opencode: "opencode.json",
     };
     for (const key of agentKeys) {
       const agent = AGENTS[key];
@@ -464,8 +428,6 @@ async function runInit(flags = {}) {
   }
 
   const hasClaude = selectedAgents.includes("claude-code");
-
-  // 5. Hooks — if any hook-supporting agent is selected (Claude Code, Gemini CLI)
   const hasGemini = selectedAgents.includes("gemini");
   const hasHookAgent = hasClaude || hasGemini;
 
@@ -531,7 +493,6 @@ async function runInit(flags = {}) {
   created.push(".memento.json");
 
   // 7. Copy hook scripts — gated on any hook-supporting agent
-  const hasCodex = selectedAgents.includes("codex");
   const anyHookEnabled =
     enableUserPrompt || enableStop || enablePreCompact || enableSessionStart;
 
@@ -549,9 +510,6 @@ async function runInit(flags = {}) {
       enableSessionStart && "memento-sessionstart-identity.sh",
     ].filter(Boolean);
 
-    // Also copy Codex notify script if Codex is selected
-    if (hasCodex) scriptFiles.push("memento-codex-notify.sh");
-
     for (const name of scriptFiles) {
       const src = path.join(pkgScriptsDir, name);
       if (!fs.existsSync(src)) continue; // skip if script doesn't exist yet
@@ -604,31 +562,7 @@ async function runInit(flags = {}) {
     }
   }
 
-  // 8c. Codex CLI notify — .codex/config.toml (fire-and-forget, post-turn memory storage)
-  if (hasCodex) {
-    const pkgScriptsDir = path.resolve(__dirname, "..", "scripts");
-    const localScriptsDir = path.join(cwd, ".memento", "scripts");
-    // Ensure the notify script is copied (may not have been copied above if no hook agent)
-    const notifySrc = path.join(pkgScriptsDir, "memento-codex-notify.sh");
-    const notifyDest = path.join(localScriptsDir, "memento-codex-notify.sh");
-    if (fs.existsSync(notifySrc) && !fs.existsSync(notifyDest)) {
-      fs.mkdirSync(localScriptsDir, { recursive: true });
-      fs.copyFileSync(notifySrc, notifyDest);
-      fs.chmodSync(notifyDest, 0o755);
-    }
-    const notifyScript = notifyDest;
-    const codexTomlPath = path.join(cwd, ".codex", "config.toml");
-    let tomlContent = "";
-    try { tomlContent = fs.readFileSync(codexTomlPath, "utf-8"); } catch { /* doesn't exist yet */ }
-    if (!tomlContent.includes("notify")) {
-      const notifyLine = `\nnotify = ["bash", "${notifyScript}"]\n`;
-      const separator = tomlContent && !tomlContent.endsWith("\n") ? "\n" : "";
-      fs.writeFileSync(codexTomlPath, tomlContent + separator + notifyLine);
-      created.push(".codex/config.toml (notify)");
-    }
-  }
-
-  // 9. Per-agent config files
+  // 8c. Per-agent config files
   for (const agentKey of selectedAgents) {
     const agent = AGENTS[agentKey];
     const result = agent.configWriter(cwd);
@@ -641,16 +575,15 @@ async function runInit(flags = {}) {
   if (appendToGitignore(cwd, ".memento/scripts/")) gitignoreUpdated = true;
   if (gitignoreUpdated) created.push(".gitignore (updated)");
 
-  // 11. Summary
+  // 10. Summary
   const labels = {
     ".memento.json": "workspace config + credentials",
     ".memento/scripts/": "hook scripts (recall + distillation)",
     ".claude/settings.local.json": "hooks registered with Claude Code",
     ".mcp.json": "MCP server registered (Claude Code)",
-    ".codex/config.toml": "MCP server registered (Codex)",
-    ".codex/config.toml (already configured)": "MCP server (Codex, skipped)",
     ".gemini/settings.json": "MCP server registered (Gemini CLI)",
-    "opencode.json": "MCP server registered (OpenCode)",
+    ".gemini/settings.json (hooks)": "hooks registered with Gemini CLI",
+    "(skipped — manual setup)": "MCP config skipped (manual setup)",
     ".gitignore (updated)": "credentials excluded from git",
   };
   const colWidth = Math.max(...created.map((f) => f.length)) + 2;
@@ -669,6 +602,14 @@ async function runInit(flags = {}) {
   }
   console.log("  Your agent will wake up remembering.\n");
 
+  // Show non-interactive equivalent
+  if (!nonInteractive) {
+    const parts = ["npx memento-mcp init -y"];
+    if (apiKey) parts.push(`--api-key ${apiKey}`);
+    parts.push(`--agent ${selectedAgents[0]}`);
+    console.log(`  Non-interactive equivalent:\n    ${parts.join(" ")}\n`);
+  }
+
   // 12. Auto-integrate agent instructions
   const primaryAgent = selectedAgents[0];
   const prompt = buildIntegrationPrompt(INSTRUCTIONS_BLOB);
@@ -797,23 +738,6 @@ async function runUpdate() {
     }
   }
 
-  // Codex CLI — ensure notify is configured
-  const hasCodex = agents.includes("codex")
-    || fs.existsSync(path.join(cwd, ".codex"));
-  if (hasCodex) {
-    const notifyScript = path.join(localScriptsDir, "memento-codex-notify.sh");
-    const codexTomlPath = path.join(cwd, ".codex", "config.toml");
-    let tomlContent = "";
-    try { tomlContent = fs.readFileSync(codexTomlPath, "utf-8"); } catch { /* doesn't exist yet */ }
-    if (!tomlContent.includes("notify") && fs.existsSync(notifyScript)) {
-      const notifyLine = `\nnotify = ["bash", "${notifyScript}"]\n`;
-      const separator = tomlContent && !tomlContent.endsWith("\n") ? "\n" : "";
-      fs.mkdirSync(path.dirname(codexTomlPath), { recursive: true });
-      fs.writeFileSync(codexTomlPath, tomlContent + separator + notifyLine);
-      registeredHooks.push("Codex CLI → .codex/config.toml (notify)");
-    }
-  }
-
   console.log(`\n  ✓ Memento hooks updated to v${pkgVersion}\n`);
   console.log("  Updated scripts:");
   for (const name of updated) {
@@ -882,16 +806,22 @@ if (isMain) {
   Memento Protocol CLI
 
   Usage:
-    npx memento-mcp init                Set up Memento in the current project
-    npx memento-mcp init -y             Non-interactive setup (uses defaults)
-    npx memento-mcp init --api-key KEY  Provide API key (skips signup)
-    npx memento-mcp update              Update hook scripts to latest version
-    npx memento-mcp                     Start the MCP server (used by .mcp.json)
-
-  The -y flag enables fully non-interactive setup for CI/scripting.
-  Combine with --api-key to skip auto-signup.
-
-  Supports Claude Code, Codex, Gemini CLI, and OpenCode.
+    npx memento-mcp init                       Set up Memento in the current project
+    npx memento-mcp init -y                    Non-interactive setup (uses defaults)
+    npx memento-mcp init -y --agent gemini     Non-interactive with specific agent
+    npx memento-mcp init --api-key KEY         Provide API key (skips signup)
+    npx memento-mcp update                     Update hook scripts to latest version
+    npx memento-mcp                            Start the MCP server (used by .mcp.json)
+
+  Flags:
+    -y, --yes          Non-interactive mode (uses defaults, for CI/scripting)
+    --api-key KEY      Provide API key (skips signup prompt)
+    --agent AGENT      Select agent: claude-code, gemini, or manual
+
+  The -y flag enables fully non-interactive setup. Combine with --agent
+  to select a specific agent (defaults to auto-detect, then claude-code).
+
+  Supports Claude Code, Gemini CLI, and manual setup for any agent.
 `);
     process.exit(1);
   }