@mem0/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,523 @@
+#!/usr/bin/env node
+import {
+  getBackend
+} from "./chunk-O3XZVUUX.js";
+import {
+  loadConfig
+} from "./chunk-EJ5AQPMT.js";
+import {
+  colors,
+  printError
+} from "./chunk-I7ABQZUR.js";
+
+// src/index.ts
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { createRequire } from "module";
+import { Command } from "commander";
+
+// src/help.ts
+import chalk from "chalk";
+var cyanBold = chalk.cyan.bold;
+var greenBold = chalk.green.bold;
+var yellowBold = chalk.yellow.bold;
+var yellow = chalk.yellow;
+var bold = chalk.bold;
+var dim = chalk.dim;
+var dimBorder = chalk.dim;
+var ANSI_RE = /\x1b\[[0-9;]*m/g;
+function stripAnsi(str) {
+  return str.replace(ANSI_RE, "").length;
+}
+var COMMAND_GROUPS = [
+  {
+    panel: "Memory",
+    commands: ["add", "search", "get", "list", "update", "delete"]
+  },
+  {
+    panel: "Management",
+    commands: ["init", "status", "import", "help", "entity", "config"]
+  }
+];
+var COMMAND_ORDER = COMMAND_GROUPS.flatMap((g) => g.commands);
+var OPTION_PANELS = {
+  add: {
+    "--user-id": "Scope",
+    "--agent-id": "Scope",
+    "--app-id": "Scope",
+    "--run-id": "Scope",
+    "--output": "Output",
+    "--api-key": "Connection",
+    "--base-url": "Connection"
+  },
+  search: {
+    "--user-id": "Scope",
+    "--agent-id": "Scope",
+    "--app-id": "Scope",
+    "--run-id": "Scope",
+    "--top-k": "Search",
+    "--threshold": "Search",
+    "--rerank": "Search",
+    "--keyword": "Search",
+    "--filter": "Search",
+    "--fields": "Search",
+    "--graph": "Search",
+    "--no-graph": "Search",
+    "--output": "Output",
+    "--api-key": "Connection",
+    "--base-url": "Connection"
+  },
+  get: {
+    "--output": "Output",
+    "--api-key": "Connection",
+    "--base-url": "Connection"
+  },
+  list: {
+    "--user-id": "Scope",
+    "--agent-id": "Scope",
+    "--app-id": "Scope",
+    "--run-id": "Scope",
+    "--page": "Pagination",
+    "--page-size": "Pagination",
+    "--category": "Filters",
+    "--after": "Filters",
+    "--before": "Filters",
+    "--graph": "Filters",
+    "--no-graph": "Filters",
+    "--output": "Output",
+    "--api-key": "Connection",
+    "--base-url": "Connection"
+  },
+  update: {
+    "--output": "Output",
+    "--api-key": "Connection",
+    "--base-url": "Connection"
+  },
+  delete: {
+    "--user-id": "Scope",
+    "--agent-id": "Scope",
+    "--app-id": "Scope",
+    "--run-id": "Scope",
+    "--output": "Output",
+    "--api-key": "Connection",
+    "--base-url": "Connection"
+  },
+  status: {
+    "--output": "Output",
+    "--api-key": "Connection",
+    "--base-url": "Connection"
+  },
+  import: {
+    "--user-id": "Scope",
+    "--agent-id": "Scope",
+    "--output": "Output",
+    "--api-key": "Connection",
+    "--base-url": "Connection"
+  }
+};
+var PANEL_ORDER = [
+  "Scope",
+  "Search",
+  "Pagination",
+  "Filters",
+  "Output",
+  "Connection"
+];
+function renderPanel(title, rows, width) {
+  if (rows.length === 0) return "";
+  const inner = width - 2;
+  const titleStr = ` ${title} `;
+  const fillLen = Math.max(0, inner - 1 - titleStr.length);
+  const topLine = dimBorder("\u256D\u2500") + dimBorder(titleStr) + dimBorder("\u2500".repeat(fillLen)) + dimBorder("\u256E");
+  const bottomLine = dimBorder("\u2570") + dimBorder("\u2500".repeat(inner)) + dimBorder("\u256F");
+  const contentLines = rows.map((row) => {
+    const visLen = stripAnsi(row);
+    const pad = Math.max(0, inner - 1 - visLen);
+    return dimBorder("\u2502") + " " + row + " ".repeat(pad) + dimBorder("\u2502");
+  });
+  return [topLine, ...contentLines, bottomLine].join("\n");
+}
+function formatOptionTerm(opt) {
+  const parts = [];
+  if (opt.short) parts.push(opt.short);
+  if (opt.long) parts.push(opt.long);
+  let term = parts.join(", ");
+  if (opt.flags) {
+    const match = opt.flags.match(/<[^>]+>|\[[^\]]+\]/);
+    if (match) {
+      term += " " + match[0];
+    }
+  }
+  return term;
+}
+function getLongFlag(opt) {
+  if (opt.long) return opt.long;
+  return opt.short || "";
+}
+function formatDefault(opt) {
+  if (opt.defaultValue !== void 0 && opt.defaultValue !== false) {
+    return dim(` [default: ${opt.defaultValue}]`);
+  }
+  return "";
+}
+function richFormatHelp(cmd, helper) {
+  const width = process.stdout.columns || 80;
+  const lines = [];
+  const isRoot = !cmd.parent;
+  const usage = helper.commandUsage(cmd);
+  lines.push("");
+  if (isRoot) {
+    lines.push(` ${yellow("Usage:")} ${bold(cmd.name())} ${yellow("<command>")} ${bold("[options]")}`);
+  } else {
+    const usageParts = usage.split(" ");
+    const cmdPath = [];
+    const argParts = [];
+    let pastCmd = false;
+    for (const part of usageParts) {
+      if (!pastCmd && !part.startsWith("[") && !part.startsWith("<")) {
+        cmdPath.push(part);
+      } else {
+        pastCmd = true;
+        argParts.push(part);
+      }
+    }
+    lines.push(` ${yellow("Usage:")} ${bold(cmdPath.join(" "))} ${yellow(argParts.join(" "))}`);
+  }
+  lines.push("");
+  const desc = helper.commandDescription(cmd);
+  if (desc) {
+    const descLines = desc.split("\n");
+    for (let i = 0; i < descLines.length; i++) {
+      const dLine = descLines[i];
+      if (i === 0 || dLine.trim() === "") {
+        lines.push(` ${dLine}`);
+      } else {
+        lines.push(` ${dim(dLine)}`);
+      }
+    }
+    lines.push("");
+  }
+  if (!isRoot) {
+    const visibleArgs = helper.visibleArguments(cmd);
+    if (visibleArgs.length > 0) {
+      const maxLen = Math.max(...visibleArgs.map((a) => a.name().length));
+      const argRows = visibleArgs.map((a) => {
+        const name = cyanBold(a.name().padEnd(maxLen));
+        const description = helper.argumentDescription(a);
+        return ` ${name}  ${description}`;
+      });
+      const panel = renderPanel("Arguments", argRows, width);
+      if (panel) lines.push(panel);
+    }
+  }
+  const visibleOpts = helper.visibleOptions(cmd);
+  const cmdName = cmd.name();
+  const panelMap = !isRoot && OPTION_PANELS[cmdName] ? OPTION_PANELS[cmdName] : {};
+  const grouped = { Options: [] };
+  for (const panelName of PANEL_ORDER) {
+    grouped[panelName] = [];
+  }
+  for (const opt of visibleOpts) {
+    const flag = getLongFlag(opt);
+    const panel = panelMap[flag];
+    if (panel && PANEL_ORDER.includes(panel)) {
+      grouped[panel].push(opt);
+    } else {
+      grouped["Options"].push(opt);
+    }
+  }
+  const visibleCmds = helper.visibleCommands(cmd);
+  if (isRoot) {
+    if (grouped["Options"].length > 0) {
+      const optRows = formatOptionRows(grouped["Options"]);
+      const panel = renderPanel("Options", optRows, width);
+      if (panel) lines.push(panel);
+    }
+    if (visibleCmds.length > 0) {
+      const cmdMap = new Map(visibleCmds.map((c) => [c.name(), c]));
+      for (const group of COMMAND_GROUPS) {
+        const groupCmds = group.commands.map((name) => cmdMap.get(name)).filter((c) => c !== void 0);
+        if (groupCmds.length === 0) continue;
+        const maxLen = Math.max(...groupCmds.map((c) => c.name().length));
+        const cmdRows = groupCmds.map((c) => {
+          const name = cyanBold(c.name().padEnd(maxLen));
+          const description = helper.subcommandDescription(c);
+          return ` ${name}  ${description}`;
+        });
+        const panel = renderPanel(group.panel, cmdRows, width);
+        if (panel) lines.push(panel);
+      }
+    }
+  } else {
+    const panelSequence = ["Options", ...PANEL_ORDER];
+    for (const panelName of panelSequence) {
+      const opts = grouped[panelName];
+      if (opts && opts.length > 0) {
+        const optRows = formatOptionRows(opts);
+        const panel = renderPanel(panelName, optRows, width);
+        if (panel) lines.push(panel);
+      }
+    }
+    if (visibleCmds.length > 0) {
+      const maxLen = Math.max(...visibleCmds.map((c) => c.name().length));
+      const cmdRows = visibleCmds.map((c) => {
+        const name = cyanBold(c.name().padEnd(maxLen));
+        const description = helper.subcommandDescription(c);
+        return ` ${name}  ${description}`;
+      });
+      const panel = renderPanel("Commands", cmdRows, width);
+      if (panel) lines.push(panel);
+    }
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function formatOptionRows(opts) {
+  const terms = opts.map((o) => formatOptionTerm(o));
+  const maxTermLen = Math.max(...terms.map((t) => t.length));
+  return opts.map((opt, i) => {
+    const term = cyanBold(terms[i].padEnd(maxTermLen));
+    const desc = opt.description || "";
+    const def = formatDefault(opt);
+    return ` ${term}  ${desc}${def}`;
+  });
+}
+
+// src/index.ts
+var _require = createRequire(import.meta.url);
+var VERSION = _require("../package.json").version;
+var program = new Command();
+function getBackendAndConfig(apiKey, baseUrl) {
+  const config = loadConfig();
+  if (apiKey) config.platform.apiKey = apiKey;
+  if (baseUrl) config.platform.baseUrl = baseUrl;
+  if (!config.platform.apiKey) {
+    printError(
+      "No API key configured.",
+      "Run 'mem0 init' or set MEM0_API_KEY environment variable."
+    );
+    process.exit(1);
+  }
+  return { backend: getBackend(config), config };
+}
+function getBackendOnly(apiKey, baseUrl) {
+  return getBackendAndConfig(apiKey, baseUrl).backend;
+}
+function resolveIds(config, opts) {
+  const hasExplicit = !!(opts.userId || opts.agentId || opts.appId || opts.runId);
+  if (hasExplicit) {
+    return {
+      userId: opts.userId || void 0,
+      agentId: opts.agentId || void 0,
+      appId: opts.appId || void 0,
+      runId: opts.runId || void 0
+    };
+  }
+  return {
+    userId: config.defaults.userId || void 0,
+    agentId: config.defaults.agentId || void 0,
+    appId: config.defaults.appId || void 0,
+    runId: config.defaults.runId || void 0
+  };
+}
+function resolveGraph(config, opts) {
+  if (opts.noGraph) return false;
+  if (opts.graph) return true;
+  return config.defaults.enableGraph;
+}
+program.name("mem0").description(`\u25C6 Mem0 CLI v${VERSION} \xB7 Node.js SDK
+
+The Memory Layer for AI Agents`).option("--version", "Show version and exit.").on("option:version", () => {
+  console.log(`  ${colors.brand("\u25C6 Mem0")} CLI v${VERSION}`);
+  process.exit(0);
+}).usage("<command> [options]").helpOption("--help", "Show this message and exit.").addHelpCommand(false).configureHelp({ formatHelp: richFormatHelp });
+program.command("init").description("Interactive setup wizard for mem0 CLI.").option("--api-key <key>", "API key (skip prompt).").option("-u, --user-id <id>", "Default user ID (skip prompt).").addHelpText("after", "\nExamples:\n  $ mem0 init\n  $ mem0 init --api-key m0-xxx --user-id alice").action(async (opts) => {
+  const { runInit } = await import("./init-N25QFHYP.js");
+  await runInit({ apiKey: opts.apiKey, userId: opts.userId });
+});
+program.command("add [text]").description("Add a memory from text, messages, file, or stdin.").option("-u, --user-id <id>", "Scope to user.").option("--agent-id <id>", "Scope to agent.").option("--app-id <id>", "Scope to app.").option("--run-id <id>", "Scope to run.").option("--messages <json>", "Conversation messages as JSON.").option("-f, --file <path>", "Read messages from JSON file.").option("-m, --metadata <json>", "Custom metadata as JSON.").option("--immutable", "Prevent future updates.", false).option("--no-infer", "Skip inference, store raw.").option("--expires <date>", "Expiration date (YYYY-MM-DD).").option("--categories <value>", "Categories (JSON array or comma-separated).").option("--graph", "Enable graph memory extraction.", false).option("--no-graph", "Disable graph memory extraction.").option("-o, --output <format>", "Output format: text, json, quiet.", "text").option("--api-key <key>", "Override API key.").option("--base-url <url>", "Override API base URL.").addHelpText("after", '\nExamples:\n  $ mem0 add "I prefer dark mode" --user-id alice\n  $ echo "text" | mem0 add -u alice\n  $ mem0 add --file msgs.json -u alice -o json').action(async (text, opts) => {
+  const { cmdAdd } = await import("./memory-JYJGE4VO.js");
+  const { backend, config } = getBackendAndConfig(opts.apiKey, opts.baseUrl);
+  const ids = resolveIds(config, opts);
+  const enableGraph = resolveGraph(config, opts);
+  await cmdAdd(backend, text, { ...ids, ...opts, enableGraph });
+});
+program.command("search [query]").description("Search memories by semantic query.").option("-u, --user-id <id>", "Filter by user.").option("--agent-id <id>", "Filter by agent.").option("--app-id <id>", "Filter by app.").option("--run-id <id>", "Filter by run.").option("-k, --top-k <n>", "Number of results.", (v) => parseInt(v), 10).option("--threshold <n>", "Minimum similarity score.", (v) => parseFloat(v), 0.3).option("--rerank", "Enable reranking (Platform only).", false).option("--keyword", "Use keyword search.", false).option("--filter <json>", "Advanced filter expression (JSON).").option("--fields <list>", "Specific fields to return (comma-separated).").option("--graph", "Enable graph in search.", false).option("--no-graph", "Disable graph in search.").option("-o, --output <format>", "Output: text, json, table.", "text").option("--api-key <key>", "Override API key.").option("--base-url <url>", "Override API base URL.").addHelpText("after", '\nExamples:\n  $ mem0 search "preferences" --user-id alice\n  $ mem0 search "tools" -u alice -o json -k 5\n  $ echo "preferences" | mem0 search -u alice').action(async (query, opts) => {
+  let resolvedQuery = query;
+  if (!resolvedQuery && !process.stdin.isTTY) {
+    resolvedQuery = fs.readFileSync(0, "utf-8").trim();
+  }
+  if (!resolvedQuery) {
+    printError("No query provided. Pass a query argument or pipe via stdin.");
+    process.exit(1);
+  }
+  const { cmdSearch } = await import("./memory-JYJGE4VO.js");
+  const { backend, config } = getBackendAndConfig(opts.apiKey, opts.baseUrl);
+  const ids = resolveIds(config, opts);
+  const enableGraph = resolveGraph(config, opts);
+  await cmdSearch(backend, resolvedQuery, {
+    ...ids,
+    topK: opts.topK,
+    threshold: opts.threshold,
+    rerank: opts.rerank,
+    keyword: opts.keyword,
+    filterJson: opts.filter,
+    fields: opts.fields,
+    enableGraph,
+    output: opts.output
+  });
+});
+program.command("get <memoryId>").description("Get a specific memory by ID.").option("-o, --output <format>", "Output: text, json.", "text").option("--api-key <key>", "Override API key.").option("--base-url <url>", "Override API base URL.").addHelpText("after", "\nExamples:\n  $ mem0 get abc-123-def-456\n  $ mem0 get abc-123-def-456 -o json").action(async (memoryId, opts) => {
+  const { cmdGet } = await import("./memory-JYJGE4VO.js");
+  const backend = getBackendOnly(opts.apiKey, opts.baseUrl);
+  await cmdGet(backend, memoryId, { output: opts.output });
+});
+program.command("list").description("List memories with optional filters.").option("-u, --user-id <id>", "Filter by user.").option("--agent-id <id>", "Filter by agent.").option("--app-id <id>", "Filter by app.").option("--run-id <id>", "Filter by run.").option("--page <n>", "Page number.", (v) => parseInt(v), 1).option("--page-size <n>", "Results per page.", (v) => parseInt(v), 100).option("--category <name>", "Filter by category.").option("--after <date>", "Created after (YYYY-MM-DD).").option("--before <date>", "Created before (YYYY-MM-DD).").option("--graph", "Enable graph in listing.", false).option("--no-graph", "Disable graph in listing.").option("-o, --output <format>", "Output: text, json, table.", "table").option("--api-key <key>", "Override API key.").option("--base-url <url>", "Override API base URL.").addHelpText("after", "\nExamples:\n  $ mem0 list -u alice\n  $ mem0 list --category prefs --after 2024-01-01 -o json").action(async (opts) => {
+  const { cmdList } = await import("./memory-JYJGE4VO.js");
+  const { backend, config } = getBackendAndConfig(opts.apiKey, opts.baseUrl);
+  const ids = resolveIds(config, opts);
+  const enableGraph = resolveGraph(config, opts);
+  await cmdList(backend, {
+    ...ids,
+    page: opts.page,
+    pageSize: opts.pageSize,
+    category: opts.category,
+    after: opts.after,
+    before: opts.before,
+    enableGraph,
+    output: opts.output
+  });
+});
+program.command("update <memoryId> [text]").description("Update a memory's text or metadata.").option("-m, --metadata <json>", "Update metadata (JSON).").option("-o, --output <format>", "Output: text, json, quiet.", "text").option("--api-key <key>", "Override API key.").option("--base-url <url>", "Override API base URL.").addHelpText("after", `
+Examples:
+  $ mem0 update abc-123 "new text"
+  $ mem0 update abc-123 --metadata '{"key":"val"}'
+  $ echo "new text" | mem0 update abc-123`).action(async (memoryId, text, opts) => {
+  let resolvedText = text;
+  if (!resolvedText && !opts.metadata && !process.stdin.isTTY) {
+    resolvedText = fs.readFileSync(0, "utf-8").trim();
+  }
+  const { cmdUpdate } = await import("./memory-JYJGE4VO.js");
+  const backend = getBackendOnly(opts.apiKey, opts.baseUrl);
+  await cmdUpdate(backend, memoryId, resolvedText, { metadata: opts.metadata, output: opts.output });
+});
+program.command("delete [memoryId]").description("Delete a memory, all memories matching a scope, or an entity.").option("--all", "Delete all memories matching scope filters.", false).option("--entity", "Delete the entity itself and all its memories (cascade).", false).option("--project", "With --all: delete ALL memories project-wide.", false).option("--dry-run", "Show what would be deleted without deleting.", false).option("--force", "Skip confirmation.", false).option("-u, --user-id <id>", "Scope to user.").option("--agent-id <id>", "Scope to agent.").option("--app-id <id>", "Scope to app.").option("--run-id <id>", "Scope to run.").option("-o, --output <format>", "Output: text, json, quiet.", "text").option("--api-key <key>", "Override API key.").option("--base-url <url>", "Override API base URL.").addHelpText("after", [
+  "\nExamples:",
+  "  $ mem0 delete abc-123-def-456              # single memory",
+  "  $ mem0 delete --all -u alice --force        # all memories for user",
+  "  $ mem0 delete --all --project --force       # project-wide wipe",
+  "  $ mem0 delete --entity -u alice --force     # entity + all its memories"
+].join("\n")).action(async (memoryId, opts) => {
+  if (memoryId && opts.all) {
+    printError("Cannot combine <memoryId> with --all. Use one or the other.");
+    process.exit(1);
+  }
+  if (memoryId && opts.entity) {
+    printError("Cannot combine <memoryId> with --entity. Use one or the other.");
+    process.exit(1);
+  }
+  if (opts.all && opts.entity) {
+    printError("Cannot combine --all with --entity. Use one or the other.");
+    process.exit(1);
+  }
+  if (!memoryId && !opts.all && !opts.entity) {
+    printError(
+      "Specify a memory ID, --all, or --entity.\n  mem0 delete <id>              Delete a single memory\n  mem0 delete --all [scope]     Delete all memories matching scope\n  mem0 delete --entity [scope]  Delete an entity and all its memories"
+    );
+    process.exit(1);
+  }
+  if (memoryId) {
+    const { cmdDelete } = await import("./memory-JYJGE4VO.js");
+    const backend = getBackendOnly(opts.apiKey, opts.baseUrl);
+    await cmdDelete(backend, memoryId, { output: opts.output, dryRun: opts.dryRun, force: opts.force });
+    return;
+  }
+  if (opts.all) {
+    const { cmdDeleteAll } = await import("./memory-JYJGE4VO.js");
+    const { backend, config } = getBackendAndConfig(opts.apiKey, opts.baseUrl);
+    const ids = opts.project ? { userId: void 0, agentId: void 0, appId: void 0, runId: void 0 } : resolveIds(config, opts);
+    await cmdDeleteAll(backend, { force: opts.force, dryRun: opts.dryRun, all: opts.project, ...ids, output: opts.output });
+    return;
+  }
+  if (opts.entity) {
+    const { cmdEntitiesDelete } = await import("./entities-XPRXH4X4.js");
+    const backend = getBackendOnly(opts.apiKey, opts.baseUrl);
+    await cmdEntitiesDelete(backend, opts);
+    return;
+  }
+});
+var configCmd = program.command("config").description("Manage mem0 configuration.").addHelpCommand(false);
+configCmd.command("show").description("Display current configuration (secrets redacted).").option("-o, --output <format>", "Output: text, json.", "text").addHelpText("after", "\nExamples:\n  $ mem0 config show\n  $ mem0 config show -o json").action(async (opts) => {
+  const { cmdConfigShow } = await import("./config-WKOCXNAS.js");
+  cmdConfigShow({ output: opts.output });
+});
+configCmd.command("get <key>").description("Get a configuration value.").addHelpText("after", "\nExamples:\n  $ mem0 config get platform.api_key\n  $ mem0 config get defaults.user_id").action(async (key) => {
+  const { cmdConfigGet } = await import("./config-WKOCXNAS.js");
+  cmdConfigGet(key);
+});
+configCmd.command("set <key> <value>").description("Set a configuration value.").addHelpText("after", "\nExamples:\n  $ mem0 config set defaults.user_id alice\n  $ mem0 config set platform.base_url https://api.mem0.ai").action(async (key, value) => {
+  const { cmdConfigSet } = await import("./config-WKOCXNAS.js");
+  cmdConfigSet(key, value);
+});
+var entityCmd = program.command("entity").description("Manage entities.").addHelpCommand(false).configureHelp({ formatHelp: richFormatHelp });
+entityCmd.command("list <entityType>").description("List all entities of a given type.").option("-o, --output <format>", "Output: table, json.", "table").option("--api-key <key>", "Override API key.").option("--base-url <url>", "Override API base URL.").addHelpText("after", "\nExamples:\n  $ mem0 entity list users\n  $ mem0 entity list agents -o json").action(async (entityType, opts) => {
+  const { cmdEntitiesList } = await import("./entities-XPRXH4X4.js");
+  const backend = getBackendOnly(opts.apiKey, opts.baseUrl);
+  await cmdEntitiesList(backend, entityType, { output: opts.output });
+});
+entityCmd.command("delete").description("Delete an entity and ALL its memories (cascade).").option("--dry-run", "Show what would be deleted without deleting.", false).option("-u, --user-id <id>", "Scope to user.").option("--agent-id <id>", "Scope to agent.").option("--app-id <id>", "Scope to app.").option("--run-id <id>", "Scope to run.").option("--force", "Skip confirmation.", false).option("-o, --output <format>", "Output: text, json, quiet.", "text").option("--api-key <key>", "Override API key.").option("--base-url <url>", "Override API base URL.").addHelpText("after", "\nExamples:\n  $ mem0 entity delete --user-id alice --force\n  $ mem0 entity delete --user-id alice --dry-run").action(async (opts) => {
+  const { cmdEntitiesDelete } = await import("./entities-XPRXH4X4.js");
+  const backend = getBackendOnly(opts.apiKey, opts.baseUrl);
+  await cmdEntitiesDelete(backend, opts);
+});
+program.command("status").description("Check connectivity and authentication.").option("-o, --output <format>", "Output: text, json.", "text").option("--api-key <key>", "Override API key.").option("--base-url <url>", "Override API base URL.").addHelpText("after", "\nExamples:\n  $ mem0 status\n  $ mem0 status -o json").action(async (opts) => {
+  const { cmdStatus } = await import("./utils-BAMFZ5H5.js");
+  const { backend, config } = getBackendAndConfig(opts.apiKey, opts.baseUrl);
+  await cmdStatus(backend, {
+    userId: config.defaults.userId || void 0,
+    agentId: config.defaults.agentId || void 0,
+    output: opts.output
+  });
+});
+program.command("import <filePath>").description("Import memories from a JSON file.").option("-u, --user-id <id>", "Override user ID.").option("--agent-id <id>", "Override agent ID.").option("-o, --output <format>", "Output: text, json.", "text").option("--api-key <key>", "Override API key.").option("--base-url <url>", "Override API base URL.").addHelpText("after", "\nExamples:\n  $ mem0 import data.json --user-id alice\n  $ mem0 import data.json -u alice -o json").action(async (filePath, opts) => {
+  const { cmdImport } = await import("./utils-BAMFZ5H5.js");
+  const { backend, config } = getBackendAndConfig(opts.apiKey, opts.baseUrl);
+  const ids = resolveIds(config, opts);
+  await cmdImport(backend, filePath, { userId: ids.userId, agentId: ids.agentId, output: opts.output });
+});
+program.command("help").description("Show help. Use --json for machine-readable output (for LLM agents).").option("--json", "Output machine-readable JSON for LLM agents.", false).addHelpText("after", "\nExamples:\n  $ mem0 help\n  $ mem0 help --json").action((opts) => {
+  if (opts.json) {
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const specPath = path.join(__dirname, "..", "..", "cli-spec.json");
+    if (fs.existsSync(specPath)) {
+      const spec = JSON.parse(fs.readFileSync(specPath, "utf-8"));
+      console.log(JSON.stringify(spec, null, 2));
+    } else {
+      console.log(JSON.stringify({ name: "mem0", version: VERSION, description: "The Memory Layer for AI Agents" }, null, 2));
+    }
+  } else {
+    const { brand: b } = colors;
+    console.log(`${b("\u25C6 Mem0 CLI")} v${VERSION} \xB7 Node.js SDK
+  The Memory Layer for AI Agents
+`);
+    console.log("Usage: mem0 <command> [OPTIONS]\n");
+    console.log("Commands:");
+    console.log("  add              Add a memory from text, messages, file, or stdin");
+    console.log("  search           Search memories by semantic query");
+    console.log("  get              Get a specific memory by ID");
+    console.log("  list             List memories with optional filters");
+    console.log("  update           Update a memory's text or metadata");
+    console.log("  delete           Delete a memory, all memories, or an entity");
+    console.log("  import           Import memories from a JSON file");
+    console.log("  config           Manage configuration (show, get, set)");
+    console.log("  entity           Manage entities (list, delete)");
+    console.log("  init             Interactive setup wizard");
+    console.log("  status           Check connectivity and authentication");
+    console.log();
+    console.log("  mem0 <command> --help    Get help for a command");
+    console.log("  mem0 help --json         Machine-readable help (for LLM agents)");
+    console.log();
+  }
+});
+program.parse();