@memmo/cli 0.7.0 → 0.7.1

package/README.md

@@ -16,6 +16,7 @@ npm install -g @memmo/cli
 memmo login            # once per machine; stores a token in ~/.memmo
 memmo init             # in a repo: registers it from the git remote, wires Claude Code, offers a scan
 memmo status           # check the setup
+memmo desktop          # wire Claude Desktop to this repo (init offers this when Desktop is installed)
 memmo scan             # propose starter memories (drives your local Claude Code)
 memmo decision "…"     # record a decision as memory
 memmo sync             # write approved memories into a managed CLAUDE.md block

package/dist/index.js

@@ -254,8 +254,8 @@ async function loginCommand(opts) {
 
 // src/commands/init.ts
 import { createInterface as createInterface2 } from "node:readline/promises";
-import { existsSync as existsSync4 } from "node:fs";
-import { join as join4 } from "node:path";
+import { existsSync as existsSync5 } from "node:fs";
+import { join as join5 } from "node:path";
 init_api();
 
 // src/commands/claude-install.ts
@@ -291,7 +291,10 @@ var HOOK_EVENTS = {
   },
   SessionEnd: { hooks: [{ type: "command", command: hook("session-end") }] }
 };
-var isMemmoHook = (e) => e.hooks?.some((h) => typeof h.command === "string" && h.command.includes("memmo hook"));
+var isMemmoHook = (e) => e.hooks?.some((h) => typeof h.command === "string" && isMemmoHookCommand(h.command));
+function isMemmoHookCommand(cmd) {
+  return /(^|[\s/@])memmo(\/cli)?\s+hook\s/.test(cmd);
+}
 function mergeMcpJson(path) {
   if (!existsSync2(path)) {
     writeFileSync2(path, JSON.stringify({ mcpServers: { memmo: MCP_SERVER } }, null, 2) + "\n");
@@ -332,6 +335,20 @@ function mergeSettingsHooks(claudeDir) {
     }
   }
   json.hooks = json.hooks ?? {};
+  let removed = 0;
+  for (const event of Object.keys(json.hooks)) {
+    const list = json.hooks[event] ?? [];
+    let seen = false;
+    json.hooks[event] = list.filter((e) => {
+      if (!isMemmoHook(e)) return true;
+      if (seen) {
+        removed++;
+        return false;
+      }
+      seen = true;
+      return true;
+    });
+  }
   let added = 0;
   for (const [event, entry] of Object.entries(HOOK_EVENTS)) {
     const list = json.hooks[event] = json.hooks[event] ?? [];
@@ -339,8 +356,9 @@ function mergeSettingsHooks(claudeDir) {
     list.push(entry);
     added++;
   }
-  if (added === 0) return ".claude/settings.json already has the memmo hooks \u2014 left as is";
+  if (added === 0 && removed === 0) return ".claude/settings.json already has the memmo hooks \u2014 left as is";
   writeFileSync2(path, JSON.stringify(json, null, 2) + "\n");
+  if (added === 0) return `removed ${removed} duplicate Memmo hook(s) from .claude/settings.json`;
   return existsSync2(path) ? `registered ${added} Memmo hook(s) in .claude/settings.json` : "wrote .claude/settings.json";
 }
 function writeClaudeAssets(cwd = process.cwd()) {
@@ -502,9 +520,7 @@ async function agentScan(claudeBin, client, config, cwd) {
   });
   if (code !== 0) {
     throw new Error(
-      `Claude Code exited with code ${code}.
-If you saw a 401/auth error, make sure Claude Code is logged in: run \`claude\` once and sign in (or \`claude login\`).
-Alternatively, use \`memmo scan --server\` to scan with the project API key.`
+      "Claude Code couldn't run the scan (it's usually not signed in \u2014 run `claude` once). No problem: memory also builds up from your normal sessions, and you can retry with `memmo scan`."
     );
   }
   const after = await countProposed(client, config.repoId);
@@ -556,6 +572,83 @@ async function scanCommand(opts = {}) {
   return serverScan(client, config);
 }
 
+// src/commands/desktop.ts
+import { existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "node:fs";
+import { homedir as homedir2, platform } from "node:os";
+import { dirname, join as join4 } from "node:path";
+init_api();
+function desktopConfigPath() {
+  const home = homedir2();
+  if (platform() === "darwin") return join4(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+  if (platform() === "win32") return join4(process.env.APPDATA ?? join4(home, "AppData", "Roaming"), "Claude", "claude_desktop_config.json");
+  return join4(process.env.XDG_CONFIG_HOME ?? join4(home, ".config"), "Claude", "claude_desktop_config.json");
+}
+function desktopInstalled() {
+  if (existsSync4(dirname(desktopConfigPath()))) return true;
+  if (platform() === "darwin") return existsSync4("/Applications/Claude.app");
+  if (platform() === "win32") return existsSync4(join4(process.env.LOCALAPPDATA ?? "", "AnthropicClaude"));
+  return false;
+}
+function readConfig(path) {
+  if (!existsSync4(path)) return {};
+  try {
+    return JSON.parse(readFileSync3(path, "utf8"));
+  } catch {
+    throw new Error(`${path} isn't valid JSON \u2014 fix or remove it, then run \`memmo desktop\` again.`);
+  }
+}
+async function desktopCommand(opts = {}) {
+  const path = desktopConfigPath();
+  const config = readConfig(path);
+  if (opts.remove) {
+    if (!config.mcpServers?.memmo) {
+      console.log("Claude Desktop isn't wired to Memmo \u2014 nothing to remove.");
+      return;
+    }
+    delete config.mcpServers.memmo;
+    writeFileSync3(path, JSON.stringify(config, null, 2) + "\n");
+    console.log(`Removed the memmo server from ${path}. Restart Claude Desktop.`);
+    return;
+  }
+  const creds = loadCredentials();
+  if (!creds) throw new Error("Not logged in. Run `memmo login` first.");
+  const client = { baseUrl: process.env.MEMMO_API_URL ?? creds.apiBaseUrl, token: creds.token };
+  let repoId = opts.repo;
+  let label = repoId;
+  if (!repoId) {
+    const here = await resolveProjectConfig(process.cwd());
+    if (here) {
+      repoId = here.repoId;
+      label = here.repoFullName ?? here.repoId;
+    }
+  }
+  if (!repoId) {
+    const repos = await apiFetch(client, "/repos");
+    if (repos.length === 0) throw new Error("No repo connected yet. Run `memmo init` inside a repo first.");
+    if (repos.length > 1) {
+      console.log("Claude Desktop serves one repo at a time. Pass --repo <id>; your repos:");
+      for (const r of repos) console.log(`  ${r.id}  ${r.fullName}`);
+      throw new Error("Choose a repo with --repo.");
+    }
+    repoId = repos[0].id;
+    label = repos[0].fullName;
+  }
+  config.mcpServers = config.mcpServers ?? {};
+  const args = ["-y", "@memmo/cli", "mcp", "--repo", repoId];
+  const existing = config.mcpServers.memmo;
+  const same = existing && existing.command === "npx" && JSON.stringify(existing.args) === JSON.stringify(args);
+  if (same) {
+    console.log(`Claude Desktop already serves ${label ?? repoId} from Memmo (${path}).`);
+    return;
+  }
+  config.mcpServers.memmo = { command: "npx", args };
+  mkdirSync3(dirname(path), { recursive: true });
+  writeFileSync3(path, JSON.stringify(config, null, 2) + "\n");
+  console.log(`${existing ? "Updated" : "Added"} the memmo server in ${path}`);
+  console.log(`  repo: ${label ?? repoId}`);
+  console.log("Restart Claude Desktop, then look for the memmo tools (get_repo_context, search_memory, \u2026) in a chat.");
+}
+
 // src/commands/init.ts
 async function ask(q) {
   const rl = createInterface2({ input: process.stdin, output: process.stdout });
@@ -584,7 +677,7 @@ async function initCommand(opts) {
   if (!creds) throw new Error("Not logged in. Run `memmo login` first.");
   const client = { baseUrl: process.env.MEMMO_API_URL ?? creds.apiBaseUrl, token: creds.token };
   const cwd = process.cwd();
-  if (!existsSync4(join4(cwd, ".git"))) {
+  if (!existsSync5(join5(cwd, ".git"))) {
     console.log("note: no .git here \u2014 run `memmo init` at your repo root.");
   }
   const remote = detectGitRemote(cwd);
@@ -630,6 +723,18 @@ Add ${name} to project "${project.name}"?`);
   }
   const actions = writeClaudeAssets(cwd);
   for (const a of actions) console.log("  - " + a);
+  let doDesktop = opts.desktop === true;
+  if (!doDesktop && !opts.yes && desktopInstalled()) {
+    const ans = (await ask("\nAlso give Claude Desktop this repo's memory? (Y/n) ")).toLowerCase();
+    doDesktop = ans === "" || ans === "y" || ans === "yes";
+  }
+  if (doDesktop) {
+    try {
+      await desktopCommand({ repo: repo.id });
+    } catch (e) {
+      console.log(`Claude Desktop not wired: ${e instanceof Error ? e.message : String(e)} (retry with \`memmo desktop\`)`);
+    }
+  }
   let doScan = opts.scan === true;
   if (!doScan && !opts.yes) {
     const ans = (await ask("\nScan this repo now to propose starter memories? (Y/n) ")).toLowerCase();
@@ -640,8 +745,8 @@ Add ${name} to project "${project.name}"?`);
       console.log("");
       await scanCommand();
     } catch (e) {
-      console.log(`Scan skipped: ${e instanceof Error ? e.message : String(e)}`);
-      console.log("Run it later with `memmo scan`.");
+      console.log(`
+Scan skipped. ${e instanceof Error ? e.message : String(e)}`);
     }
   }
   const appUrl = await appUrlFor(client);
@@ -804,8 +909,8 @@ async function mcpCommand(opts = {}) {
 }
 
 // src/commands/hook.ts
-import { readFileSync as readFileSync3, existsSync as existsSync5, writeFileSync as writeFileSync3 } from "node:fs";
-import { join as join5 } from "node:path";
+import { readFileSync as readFileSync4, existsSync as existsSync6, writeFileSync as writeFileSync4 } from "node:fs";
+import { join as join6 } from "node:path";
 import { tmpdir } from "node:os";
 import { createHash } from "node:crypto";
 init_api();
@@ -899,10 +1004,10 @@ async function preEdit(input, env) {
   });
   if (!warnings.length) return;
   const key = createHash("sha1").update(`${input.session_id ?? "x"}:${file}`).digest("hex").slice(0, 16);
-  const marker = join5(tmpdir(), `memmo-warned-${key}`);
-  if (existsSync5(marker)) return;
+  const marker = join6(tmpdir(), `memmo-warned-${key}`);
+  if (existsSync6(marker)) return;
   try {
-    writeFileSync3(marker, "1");
+    writeFileSync4(marker, "1");
   } catch {
   }
   const body = warnings.map((w) => `\u26A0 [${w.type}] ${w.title}
@@ -913,8 +1018,8 @@ ${body}
   process.exit(2);
 }
 async function sessionEnd(input, env) {
-  if (!input.transcript_path || !existsSync5(input.transcript_path)) return;
-  const raw = readFileSync3(input.transcript_path, "utf8");
+  if (!input.transcript_path || !existsSync6(input.transcript_path)) return;
+  const raw = readFileSync4(input.transcript_path, "utf8");
   const filesChanged = [];
   const commandsRun = [];
   const errors = [];
@@ -1000,8 +1105,8 @@ async function hookCommand(event) {
 }
 
 // src/commands/status.ts
-import { readFileSync as readFileSync4, existsSync as existsSync6 } from "node:fs";
-import { join as join6 } from "node:path";
+import { readFileSync as readFileSync5, existsSync as existsSync7 } from "node:fs";
+import { join as join7 } from "node:path";
 init_api();
 var OK = "\x1B[32m\u2713\x1B[0m";
 var NO = "\x1B[31m\u2717\x1B[0m";
@@ -1011,18 +1116,18 @@ function line(mark, label, detail = "") {
 }
 function readJson(path) {
   try {
-    return JSON.parse(readFileSync4(path, "utf8"));
+    return JSON.parse(readFileSync5(path, "utf8"));
   } catch {
     return null;
   }
 }
 function hasMemmoHooks(cwd) {
   const json = readJson(
-    join6(cwd, ".claude", "settings.json")
+    join7(cwd, ".claude", "settings.json")
   );
   if (!json?.hooks) return { present: false, events: [] };
   const events = Object.entries(json.hooks).filter(
-    ([, list]) => list?.some((e) => e.hooks?.some((h) => h.command?.includes("memmo hook")))
+    ([, list]) => list?.some((e) => e.hooks?.some((h) => !!h.command && isMemmoHookCommand(h.command)))
   ).map(([event]) => event);
   return { present: events.length > 0, events };
 }
@@ -1037,9 +1142,9 @@ async function statusCommand() {
     "Repo connected",
     config ? `${config.repoFullName ?? config.repoId}` : "run `memmo init`"
   );
-  const mcp = readJson(join6(cwd, ".mcp.json"));
+  const mcp = readJson(join7(cwd, ".mcp.json"));
   line(mcp?.mcpServers?.memmo ? OK : NO, ".mcp.json (memmo MCP server)");
-  const claudeMd = existsSync6(join6(cwd, "CLAUDE.md")) ? readFileSync4(join6(cwd, "CLAUDE.md"), "utf8") : "";
+  const claudeMd = existsSync7(join7(cwd, "CLAUDE.md")) ? readFileSync5(join7(cwd, "CLAUDE.md"), "utf8") : "";
   line(claudeMd.includes("Memmo") ? OK : WARN, "CLAUDE.md guidance");
   const hooks = hasMemmoHooks(cwd);
   line(
@@ -1068,8 +1173,8 @@ async function statusCommand() {
 }
 
 // src/commands/uninstall.ts
-import { existsSync as existsSync7, rmSync, readdirSync } from "node:fs";
-import { join as join7 } from "node:path";
+import { existsSync as existsSync8, rmSync, readdirSync } from "node:fs";
+import { join as join8 } from "node:path";
 import { createInterface as createInterface3 } from "node:readline/promises";
 async function uninstallCommand(opts = {}) {
   const cwd = process.cwd();
@@ -1095,16 +1200,16 @@ async function uninstallCommand(opts = {}) {
   push(removeClaudeSection(cwd));
   const remote = detectGitRemote(cwd);
   if (remote) forgetRepo(remote);
-  const configFile = join7(cwd, ".memmo", "config.json");
-  if (existsSync7(configFile)) {
+  const configFile = join8(cwd, ".memmo", "config.json");
+  if (existsSync8(configFile)) {
     rmSync(configFile, { force: true });
     actions.push("removed .memmo/config.json");
-    const dir = join7(cwd, ".memmo");
-    if (existsSync7(dir) && readdirSync(dir).length === 0) rmSync(dir, { recursive: true, force: true });
+    const dir = join8(cwd, ".memmo");
+    if (existsSync8(dir) && readdirSync(dir).length === 0) rmSync(dir, { recursive: true, force: true });
   }
   for (const f of ["memmo-session-end.sh", "memmo-before-edit.sh"]) {
-    const p = join7(cwd, ".claude", "hooks", f);
-    if (existsSync7(p)) {
+    const p = join8(cwd, ".claude", "hooks", f);
+    if (existsSync8(p)) {
       rmSync(p, { force: true });
       actions.push(`removed legacy .claude/hooks/${f}`);
     }
@@ -1120,8 +1225,8 @@ async function uninstallCommand(opts = {}) {
 
 // src/commands/chat.ts
 import { spawn as spawn2 } from "node:child_process";
-import { existsSync as existsSync8 } from "node:fs";
-import { join as join8, delimiter as delimiter2 } from "node:path";
+import { existsSync as existsSync9 } from "node:fs";
+import { join as join9, delimiter as delimiter2 } from "node:path";
 import { createInterface as createInterface4 } from "node:readline/promises";
 import Anthropic from "@anthropic-ai/sdk";
 init_api();
@@ -1133,7 +1238,7 @@ function findOnPath2(cmd) {
   const exts = process.platform === "win32" ? ["", ".exe", ".cmd", ".bat"] : [""];
   for (const dir of (process.env.PATH ?? "").split(delimiter2)) {
     if (!dir) continue;
-    for (const ext of exts) if (existsSync8(join8(dir, cmd + ext))) return join8(dir, cmd + ext);
+    for (const ext of exts) if (existsSync9(join9(dir, cmd + ext))) return join9(dir, cmd + ext);
   }
   return null;
 }
@@ -1273,8 +1378,8 @@ Why: ${opts.why}` : title;
 }
 
 // src/commands/sync.ts
-import { readFileSync as readFileSync5, writeFileSync as writeFileSync4, existsSync as existsSync9 } from "node:fs";
-import { join as join9 } from "node:path";
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync5, existsSync as existsSync10 } from "node:fs";
+import { join as join10 } from "node:path";
 init_api();
 var START = "<!-- memmo:memory:start -->";
 var END = "<!-- memmo:memory:end -->";
@@ -1323,15 +1428,15 @@ async function syncCommand() {
     `/repos/${config.repoId}/memories?status=approved`
   );
   const block = renderBlock(memories);
-  const path = join9(process.cwd(), "CLAUDE.md");
-  const existing = existsSync9(path) ? readFileSync5(path, "utf8") : "";
-  writeFileSync4(path, upsertBlock(existing, block));
+  const path = join10(process.cwd(), "CLAUDE.md");
+  const existing = existsSync10(path) ? readFileSync6(path, "utf8") : "";
+  writeFileSync5(path, upsertBlock(existing, block));
   console.log(`Synced ${memories.length} approved memory(ies) into CLAUDE.md.`);
 }
 
 // src/commands/review.ts
 import { execFileSync } from "node:child_process";
-import { writeFileSync as writeFileSync5 } from "node:fs";
+import { writeFileSync as writeFileSync6 } from "node:fs";
 init_api();
 
 // ../../packages/shared/src/types.ts
@@ -1674,12 +1779,12 @@ function buildReviewPayload(summary, findings, commentable, existingKeys = /* @_
 }
 
 // src/github.ts
-import { readFileSync as readFileSync6, existsSync as existsSync10 } from "node:fs";
+import { readFileSync as readFileSync7, existsSync as existsSync11 } from "node:fs";
 function readEvent() {
   const p = process.env.GITHUB_EVENT_PATH;
-  if (!p || !existsSync10(p)) return {};
+  if (!p || !existsSync11(p)) return {};
   try {
-    const ev = JSON.parse(readFileSync6(p, "utf8"));
+    const ev = JSON.parse(readFileSync7(p, "utf8"));
     return {
       title: ev.pull_request?.title,
       body: ev.pull_request?.body ?? void 0,
@@ -1805,7 +1910,7 @@ async function reviewCommand(opts = {}) {
     }
   }
   if (opts.out) {
-    writeFileSync5(opts.out, comment);
+    writeFileSync6(opts.out, comment);
     console.error(`Wrote review to ${opts.out} (${res.review?.findings.length ?? 0} findings).`);
   }
   process.stdout.write(comment + "\n");
@@ -1877,8 +1982,8 @@ async function listReviewComments(ctx) {
 }
 
 // src/commands/ci.ts
-import { writeFileSync as writeFileSync6, mkdirSync as mkdirSync3, existsSync as existsSync11 } from "node:fs";
-import { join as join10 } from "node:path";
+import { writeFileSync as writeFileSync7, mkdirSync as mkdirSync4, existsSync as existsSync12 } from "node:fs";
+import { join as join11 } from "node:path";
 var WORKFLOW = `name: Memmo Review
 on:
   pull_request:
@@ -1905,14 +2010,14 @@ jobs:
           GH_TOKEN: \${{ github.token }}
 `;
 async function ciCommand(opts = {}) {
-  const dir = join10(process.cwd(), ".github", "workflows");
-  const file = join10(dir, "memmo-review.yml");
-  if (existsSync11(file) && !opts.force) {
+  const dir = join11(process.cwd(), ".github", "workflows");
+  const file = join11(dir, "memmo-review.yml");
+  if (existsSync12(file) && !opts.force) {
     console.error(`${file} already exists. Re-run with --force to overwrite.`);
     return;
   }
-  mkdirSync3(dir, { recursive: true });
-  writeFileSync6(file, WORKFLOW);
+  mkdirSync4(dir, { recursive: true });
+  writeFileSync7(file, WORKFLOW);
   console.log("Wrote .github/workflows/memmo-review.yml\n");
   console.log("Next steps:");
   console.log("  1. Commit .memmo/config.json and the workflow file.");
@@ -1928,8 +2033,9 @@ init_version();
 var program = new Command();
 program.name("memmo").description("Long-term memory for AI coding agents").version(VERSION);
 program.command("login").description("Sign in (opens your browser) and store an API token in ~/.memmo").option("-t, --token <token>", "Use a token from Account \u2192 API tokens instead of the browser (CI/headless)").option("-e, --email <email>", "Dev-only email login (local API)").option("--no-browser", "Print the sign-in URL instead of opening a browser").option("--api <url>", "API base URL").action((opts) => run(() => loginCommand(opts)));
-program.command("init").description("Connect this repo to Memmo (registers it from the git remote) and wire up Claude Code").option("-r, --repo <repoId>", "Repo ID to connect (default: detected from the git remote)").option("-p, --project <idOrName>", "Project to add the repo to (default: your only project, or a prompt)").option("-y, --yes", "Skip prompts").option("--scan", "Run an initial codebase scan after connecting").action((opts) => run(() => initCommand(opts)));
+program.command("init").description("Connect this repo to Memmo (registers it from the git remote) and wire up Claude Code").option("-r, --repo <repoId>", "Repo ID to connect (default: detected from the git remote)").option("-p, --project <idOrName>", "Project to add the repo to (default: your only project, or a prompt)").option("-y, --yes", "Skip prompts").option("--scan", "Run an initial codebase scan after connecting").option("--desktop", "Also wire Claude Desktop to this repo (asked interactively when Desktop is installed)").action((opts) => run(() => initCommand(opts)));
 program.command("claude").description("Claude Code integration").command("install").description("Generate CLAUDE.md, .mcp.json, and hooks").action(() => run(() => claudeInstallCommand()));
+program.command("desktop").description("Wire Memmo into Claude Desktop (writes its MCP config; Desktop serves one repo)").option("-r, --repo <repoId>", "Repo to serve (default: the current directory's repo)").option("--remove", "Remove the memmo server from Claude Desktop").action((opts) => run(() => desktopCommand(opts)));
 program.command("mcp").description("Run the Memmo MCP stdio server (used by Claude Code / Claude Desktop)").option("-r, --repo <repoId>", "Repo to serve (for Claude Desktop; defaults to .memmo/config.json)").option("--api <url>", "API base URL").action((opts) => run(() => mcpCommand(opts)));
 program.command("scan").description("Scan the connected repo and propose starter memories").option("--agent", "Deep scan with local Claude Code (no API key, uses your subscription)").option("--server", "Scan on the server from GitHub (uses the project Anthropic key)").action((opts) => run(() => scanCommand(opts)));
 program.command("chat [question...]").description("Chat with this repo's memory using your own Anthropic (key or Claude subscription)").action((question) => run(() => chatCommand(question)));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memmo/cli",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Long-term memory for AI coding agents — CLI + MCP server for Claude Code.",
   "license": "MIT",
   "author": "Benjamin Beguin",