@mem0/cli 0.1.0

package/README.md

@@ -0,0 +1,75 @@
+# mem0 CLI (Node.js)
+
+The official command-line interface for [mem0](https://mem0.ai) — the memory layer for AI agents. TypeScript implementation.
+
+## Prerequisites
+
+- Node.js **18+**
+- pnpm (`npm install -g pnpm`)
+
+## Installation
+
+```bash
+npm install -g @mem0/cli
+```
+
+Or from source:
+
+```bash
+cd node
+pnpm install
+pnpm build
+pnpm link --global
+
+# Now use it like a normal CLI
+mem0 --help
+```
+
+## Running during development
+
+```bash
+cd node
+pnpm install
+
+# Development mode (runs TypeScript directly, no build needed)
+pnpm dev --help
+pnpm dev add "test memory" --user-id alice
+pnpm dev search "test" --user-id alice
+
+# Or build first, then run the compiled JS
+pnpm build
+node dist/index.js --help
+node dist/index.js add "test memory" --user-id alice
+```
+
+## Quick Start
+
+```bash
+# Set up your configuration
+mem0 init
+
+# Add a memory
+mem0 add "I prefer dark mode and use vim keybindings" --user-id alice
+
+# Search memories
+mem0 search "What are Alice's preferences?" --user-id alice
+
+# List all memories
+mem0 list --user-id alice
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `MEM0_API_KEY` | API key (overrides config file) |
+| `MEM0_BASE_URL` | API base URL |
+| `MEM0_USER_ID` | Default user ID |
+| `MEM0_AGENT_ID` | Default agent ID |
+| `MEM0_APP_ID` | Default app ID |
+| `MEM0_RUN_ID` | Default run ID |
+| `MEM0_ENABLE_GRAPH` | Enable graph memory (true/false) |
+
+## License
+
+Apache-2.0

package/development.md

@@ -0,0 +1,91 @@
+# Development
+
+## Prerequisites
+
+- Node.js **18+**
+- pnpm (`npm install -g pnpm`)
+
+## Setup
+
+From the `node/` directory:
+
+```bash
+pnpm install
+```
+
+## Running the CLI
+
+There are two ways to run the CLI during development:
+
+### Option 1: Development mode (no build needed)
+
+Uses `tsx` to run TypeScript directly. Pass CLI arguments after `pnpm dev`:
+
+```bash
+pnpm dev --help
+pnpm dev version
+pnpm dev add "test memory" --user-id alice
+pnpm dev search "test" --user-id alice
+pnpm dev config show
+```
+
+> **Note:** Do NOT use `pnpm dev -- --help`. With pnpm, arguments pass through directly — adding `--` inserts a literal `--` that breaks the CLI parser.
+
+### Option 2: Build and run compiled JS
+
+```bash
+# Build first
+pnpm build
+
+# Run the compiled CLI
+node dist/index.js --help
+node dist/index.js version
+node dist/index.js add "test memory" --user-id alice
+```
+
+### Option 3: Link globally (makes `mem0` available system-wide)
+
+```bash
+pnpm build
+pnpm link --global
+
+# Now use it like a normal CLI
+mem0 --help
+mem0 version
+```
+
+> **Warning:** If you also have the Python CLI installed, both register the `mem0` command. The last one linked/installed wins. Unlink with `pnpm unlink --global`.
+
+## Build
+
+```bash
+pnpm build
+```
+
+The compiled output is in `dist/`.
+
+## Run tests
+
+```bash
+# Run all tests
+pnpm test
+
+# Watch mode
+pnpm test:watch
+```
+
+## Lint
+
+```bash
+# Check
+pnpm lint
+
+# Auto-fix
+pnpm lint:fix
+```
+
+## Type checking
+
+```bash
+pnpm typecheck
+```

package/dist/chunk-EJ5AQPMT.js

@@ -0,0 +1,120 @@
+// src/config.ts
+import fs from "fs";
+import os from "os";
+import path from "path";
+var CONFIG_DIR = path.join(os.homedir(), ".mem0");
+var CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+var DEFAULT_BASE_URL = "https://api.mem0.ai";
+var CONFIG_VERSION = 1;
+function createDefaultConfig() {
+  return {
+    version: CONFIG_VERSION,
+    defaults: {
+      userId: "",
+      agentId: "",
+      appId: "",
+      runId: "",
+      enableGraph: false
+    },
+    platform: {
+      apiKey: "",
+      baseUrl: DEFAULT_BASE_URL
+    }
+  };
+}
+function ensureConfigDir() {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 448 });
+  return CONFIG_DIR;
+}
+function loadConfig() {
+  const config = createDefaultConfig();
+  if (fs.existsSync(CONFIG_FILE)) {
+    const raw = fs.readFileSync(CONFIG_FILE, "utf-8");
+    const data = JSON.parse(raw);
+    config.version = data.version ?? CONFIG_VERSION;
+    const plat = data.platform ?? {};
+    config.platform.apiKey = plat.api_key ?? "";
+    config.platform.baseUrl = plat.base_url ?? DEFAULT_BASE_URL;
+    const defaults = data.defaults ?? {};
+    config.defaults.userId = defaults.user_id ?? "";
+    config.defaults.agentId = defaults.agent_id ?? "";
+    config.defaults.appId = defaults.app_id ?? "";
+    config.defaults.runId = defaults.run_id ?? "";
+    config.defaults.enableGraph = defaults.enable_graph ?? false;
+  }
+  if (process.env.MEM0_API_KEY) config.platform.apiKey = process.env.MEM0_API_KEY;
+  if (process.env.MEM0_BASE_URL) config.platform.baseUrl = process.env.MEM0_BASE_URL;
+  if (process.env.MEM0_USER_ID) config.defaults.userId = process.env.MEM0_USER_ID;
+  if (process.env.MEM0_AGENT_ID) config.defaults.agentId = process.env.MEM0_AGENT_ID;
+  if (process.env.MEM0_APP_ID) config.defaults.appId = process.env.MEM0_APP_ID;
+  if (process.env.MEM0_RUN_ID) config.defaults.runId = process.env.MEM0_RUN_ID;
+  if (process.env.MEM0_ENABLE_GRAPH) {
+    config.defaults.enableGraph = ["true", "1", "yes"].includes(
+      process.env.MEM0_ENABLE_GRAPH.toLowerCase()
+    );
+  }
+  return config;
+}
+function saveConfig(config) {
+  ensureConfigDir();
+  const data = {
+    version: config.version,
+    defaults: {
+      user_id: config.defaults.userId,
+      agent_id: config.defaults.agentId,
+      app_id: config.defaults.appId,
+      run_id: config.defaults.runId,
+      enable_graph: config.defaults.enableGraph
+    },
+    platform: {
+      api_key: config.platform.apiKey,
+      base_url: config.platform.baseUrl
+    }
+  };
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(data, null, 2));
+  fs.chmodSync(CONFIG_FILE, 384);
+}
+function redactKey(key) {
+  if (!key) return "(not set)";
+  if (key.length <= 8) return key.slice(0, 2) + "***";
+  return key.slice(0, 4) + "..." + key.slice(-4);
+}
+var KEY_MAP = {
+  "platform.api_key": ["platform", "apiKey"],
+  "platform.base_url": ["platform", "baseUrl"],
+  "defaults.user_id": ["defaults", "userId"],
+  "defaults.agent_id": ["defaults", "agentId"],
+  "defaults.app_id": ["defaults", "appId"],
+  "defaults.run_id": ["defaults", "runId"],
+  "defaults.enable_graph": ["defaults", "enableGraph"]
+};
+function getNestedValue(config, dottedKey) {
+  const mapping = KEY_MAP[dottedKey];
+  if (!mapping) return void 0;
+  const [section, field] = mapping;
+  return config[section][field];
+}
+function setNestedValue(config, dottedKey, value) {
+  const mapping = KEY_MAP[dottedKey];
+  if (!mapping) return false;
+  const [section, field] = mapping;
+  const obj = config[section];
+  const current = obj[field];
+  if (typeof current === "boolean") {
+    obj[field] = ["true", "1", "yes"].includes(value.toLowerCase());
+  } else if (typeof current === "number") {
+    obj[field] = parseInt(value, 10);
+  } else {
+    obj[field] = value;
+  }
+  return true;
+}
+
+export {
+  createDefaultConfig,
+  loadConfig,
+  saveConfig,
+  redactKey,
+  getNestedValue,
+  setNestedValue
+};

package/dist/chunk-I7ABQZUR.js

@@ -0,0 +1,111 @@
+// src/branding.ts
+import chalk from "chalk";
+import ora from "ora";
+import { createRequire } from "module";
+var _require = createRequire(import.meta.url);
+var PKG_VERSION = _require("../package.json").version;
+var LOGO = `
+\u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557      \u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2557     \u2588\u2588\u2557
+\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2588\u2588\u2588\u2588\u2557    \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255D\u2588\u2588\u2551     \u2588\u2588\u2551
+\u2588\u2588\u2554\u2588\u2588\u2588\u2588\u2554\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2554\u2588\u2588\u2588\u2588\u2554\u2588\u2588\u2551\u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2551    \u2588\u2588\u2551     \u2588\u2588\u2551     \u2588\u2588\u2551
+\u2588\u2588\u2551\u255A\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255D  \u2588\u2588\u2551\u255A\u2588\u2588\u2554\u255D\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2554\u255D\u2588\u2588\u2551    \u2588\u2588\u2551     \u2588\u2588\u2551     \u2588\u2588\u2551
+\u2588\u2588\u2551 \u255A\u2550\u255D \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551 \u255A\u2550\u255D \u2588\u2588\u2551\u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255D    \u255A\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551
+\u255A\u2550\u255D     \u255A\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D     \u255A\u2550\u255D \u255A\u2550\u2550\u2550\u2550\u2550\u255D      \u255A\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u255D\u255A\u2550\u255D
+`;
+var TAGLINE = "The Memory Layer for AI Agents";
+var BRAND_COLOR = "#8b5cf6";
+var ACCENT_COLOR = "#a78bfa";
+var SUCCESS_COLOR = "#22c55e";
+var ERROR_COLOR = "#ef4444";
+var WARNING_COLOR = "#f59e0b";
+var DIM_COLOR = "#6b7280";
+var brand = chalk.hex(BRAND_COLOR);
+var accent = chalk.hex(ACCENT_COLOR);
+var success = chalk.hex(SUCCESS_COLOR);
+var error = chalk.hex(ERROR_COLOR);
+var warning = chalk.hex(WARNING_COLOR);
+var dim = chalk.hex(DIM_COLOR);
+function sym(fancy, plain) {
+  if (!process.stdout.isTTY || process.env.NO_COLOR) return plain;
+  return fancy;
+}
+function printBanner() {
+  const pad = 3;
+  const logoLines = LOGO.trimEnd().split("\n");
+  const tagline = `  ${TAGLINE}`;
+  const subtitle = `Node.js SDK \xB7 v${PKG_VERSION}`;
+  const contentLines = ["", ...logoLines, "", tagline, ""];
+  const maxContent = Math.max(...contentLines.map((l) => l.length));
+  const innerWidth = maxContent + pad * 2;
+  const totalWidth = innerWidth + 2;
+  const topBorder = brand(`\u256D${"\u2500".repeat(totalWidth - 2)}\u256E`);
+  const subtitleFill = totalWidth - 2 - subtitle.length - 3;
+  const bottomBorder = brand(`\u2570${"\u2500".repeat(subtitleFill)} ${dim(subtitle)} ${"\u2500"}\u256F`);
+  const body = contentLines.map((line) => {
+    const rightPad = innerWidth - pad - line.length;
+    return `${brand("\u2502")}${" ".repeat(pad)}${brand.bold(line)}${" ".repeat(Math.max(rightPad, 0))}${brand("\u2502")}`;
+  });
+  const taglineIdx = body.length - 2;
+  const taglineRightPad = innerWidth - pad - tagline.length;
+  body[taglineIdx] = `${brand("\u2502")}${" ".repeat(pad)}${accent(tagline)}${" ".repeat(Math.max(taglineRightPad, 0))}${brand("\u2502")}`;
+  console.log(topBorder);
+  for (const line of body) console.log(line);
+  console.log(bottomBorder);
+}
+function printSuccess(message) {
+  console.log(`${success(sym("\u2713", "[ok]"))} ${message}`);
+}
+function printError(message, hint) {
+  console.error(`${error(sym("\u2717", "[error]") + " Error:")} ${message}`);
+  if (hint) {
+    console.error(`  ${dim(hint)}`);
+  }
+}
+function printInfo(message) {
+  console.log(`${brand(sym("\u25C6", "*"))} ${message}`);
+}
+function printScope(ids) {
+  const parts = [];
+  for (const [key, val] of Object.entries(ids)) {
+    if (val) {
+      const label = key.replace(/_/g, " ").replace("id", "ID").trim();
+      parts.push(`${label}=${val}`);
+    }
+  }
+  if (parts.length > 0) {
+    console.log(`  ${dim(`Scope: ${parts.join(", ")}`)}`);
+  }
+}
+async function timedStatus(message, fn) {
+  const ctx = { successMsg: "", errorMsg: "" };
+  const spinner = ora({ text: dim(message), color: "magenta", stream: process.stderr }).start();
+  const start = performance.now();
+  try {
+    const result = await fn(ctx);
+    const elapsed = ((performance.now() - start) / 1e3).toFixed(2);
+    spinner.stop();
+    if (ctx.successMsg) {
+      console.error(`${success("\u2713")} ${ctx.successMsg} (${elapsed}s)`);
+    }
+    return result;
+  } catch (err) {
+    const elapsed = ((performance.now() - start) / 1e3).toFixed(2);
+    spinner.stop();
+    if (ctx.errorMsg) {
+      console.error(`${error("\u2717 Error:")} ${ctx.errorMsg} (${elapsed}s)`);
+    }
+    throw err;
+  }
+}
+var colors = { brand, accent, success, error, warning, dim };
+
+export {
+  sym,
+  printBanner,
+  printSuccess,
+  printError,
+  printInfo,
+  printScope,
+  timedStatus,
+  colors
+};

package/dist/chunk-J7DYZDMM.js

@@ -0,0 +1,187 @@
+import {
+  colors,
+  sym
+} from "./chunk-I7ABQZUR.js";
+
+// src/output.ts
+import Table from "cli-table3";
+import boxen from "boxen";
+var { brand, accent, success, error: errorColor, dim } = colors;
+function formatDate(dtStr) {
+  if (!dtStr) return void 0;
+  try {
+    const dt = new Date(dtStr.replace("Z", "+00:00"));
+    return dt.toISOString().slice(0, 10);
+  } catch {
+    return dtStr?.slice(0, 10);
+  }
+}
+function formatMemoriesText(memories, title = "memories") {
+  const count = memories.length;
+  console.log(`
+${brand(`Found ${count} ${title}:`)}
+`);
+  for (let i = 0; i < memories.length; i++) {
+    const mem = memories[i];
+    const memoryText = mem.memory ?? mem.text ?? "";
+    const memId = (mem.id ?? "").slice(0, 8);
+    const score = mem.score;
+    const created = formatDate(mem.created_at);
+    let category;
+    const cats = mem.categories;
+    if (Array.isArray(cats)) {
+      category = cats[0];
+    }
+    console.log(`  ${i + 1}. ${memoryText}`);
+    const details = [];
+    if (score !== void 0) details.push(`Score: ${score.toFixed(2)}`);
+    if (memId) details.push(`ID: ${memId}`);
+    if (created) details.push(`Created: ${created}`);
+    if (category) details.push(`Category: ${category}`);
+    if (details.length > 0) {
+      console.log(`     ${dim(details.join(" \xB7 "))}`);
+    }
+    console.log();
+  }
+}
+function formatMemoriesTable(memories) {
+  const table = new Table({
+    head: [accent("ID"), accent("Memory"), accent("Category"), accent("Created")],
+    colWidths: [12, 52, 16, 14],
+    wordWrap: true,
+    style: { head: [], border: [] }
+  });
+  for (const mem of memories) {
+    const memId = (mem.id ?? "").slice(0, 8);
+    let memoryText = mem.memory ?? mem.text ?? "";
+    if (memoryText.length > 60) {
+      memoryText = memoryText.slice(0, 57) + "...";
+    }
+    const categories = mem.categories;
+    const cat = Array.isArray(categories) && categories.length > 0 ? categories[0] : "\u2014";
+    const created = formatDate(mem.created_at) ?? "\u2014";
+    table.push([dim(memId), memoryText, cat, created]);
+  }
+  console.log();
+  console.log(table.toString());
+  console.log();
+}
+function formatJson(data) {
+  console.log(JSON.stringify(data, null, 2));
+}
+function formatSingleMemory(mem, output = "text") {
+  if (output === "json") {
+    formatJson(mem);
+    return;
+  }
+  const memoryText = mem.memory ?? mem.text ?? "";
+  const memId = mem.id ?? "";
+  const lines = [];
+  lines.push(`  ${memoryText}`);
+  lines.push("");
+  if (memId) lines.push(`  ${dim("ID:")}         ${memId}`);
+  const created = formatDate(mem.created_at);
+  if (created) lines.push(`  ${dim("Created:")}    ${created}`);
+  const updated = formatDate(mem.updated_at);
+  if (updated) lines.push(`  ${dim("Updated:")}    ${updated}`);
+  const meta = mem.metadata;
+  if (meta) lines.push(`  ${dim("Metadata:")}   ${JSON.stringify(meta)}`);
+  const categories = mem.categories;
+  if (categories) {
+    const catStr = Array.isArray(categories) ? categories.join(", ") : String(categories);
+    lines.push(`  ${dim("Categories:")} ${catStr}`);
+  }
+  const content = lines.join("\n");
+  console.log();
+  console.log(
+    boxen(content, {
+      title: brand("Memory"),
+      titleAlignment: "left",
+      borderColor: "magenta",
+      padding: 1
+    })
+  );
+  console.log();
+}
+function formatAddResult(result, output = "text") {
+  if (output === "json") {
+    formatJson(result);
+    return;
+  }
+  if (output === "quiet") return;
+  const results = Array.isArray(result) ? result : result.results ?? [result];
+  if (!results.length) {
+    console.log(`  ${dim("No memories extracted.")}`);
+    return;
+  }
+  console.log();
+  for (const r of results) {
+    if (r.status === "PENDING") {
+      const eventId = (r.event_id ?? "").slice(0, 8);
+      const icon2 = accent(sym("\u29D7", "..."));
+      const parts2 = [`  ${icon2} ${dim("Queued".padEnd(10))}`, "Processing in background"];
+      if (eventId) parts2.push(dim(`(event ${eventId})`));
+      console.log(parts2.join("  "));
+      continue;
+    }
+    const event = r.event ?? "ADD";
+    const memory = r.memory ?? r.text ?? r.content ?? r.data ?? "";
+    const memId = (r.id ?? r.memory_id ?? "").slice(0, 8);
+    let icon;
+    let label;
+    if (event === "ADD") {
+      icon = success("+");
+      label = "Added";
+    } else if (event === "UPDATE") {
+      icon = accent("~");
+      label = "Updated";
+    } else if (event === "DELETE") {
+      icon = errorColor("-");
+      label = "Deleted";
+    } else if (event === "NOOP") {
+      icon = dim("\xB7");
+      label = "No change";
+    } else {
+      icon = dim("?");
+      label = event;
+    }
+    const parts = [`  ${icon} ${dim(label.padEnd(10))}`];
+    if (memory) parts.push(memory);
+    if (memId) parts.push(dim(`(${memId})`));
+    console.log(parts.join("  "));
+  }
+  console.log();
+}
+function formatJsonEnvelope(opts) {
+  const envelope = {
+    status: opts.status ?? "success",
+    command: opts.command
+  };
+  if (opts.durationMs !== void 0) envelope.duration_ms = opts.durationMs;
+  if (opts.scope !== void 0) envelope.scope = opts.scope;
+  if (opts.count !== void 0) envelope.count = opts.count;
+  if (opts.error) envelope.error = opts.error;
+  envelope.data = opts.data;
+  console.log(JSON.stringify(envelope, null, 2));
+}
+function printResultSummary(opts) {
+  const parts = [`${opts.count} result${opts.count !== 1 ? "s" : ""}`];
+  if (opts.page !== void 0) parts.push(`page ${opts.page}`);
+  if (opts.scopeIds) {
+    const scopeParts = Object.entries(opts.scopeIds).filter(([, v]) => v).map(([k, v]) => `${k.replace(/_/g, " ")}=${v}`);
+    if (scopeParts.length > 0) parts.push(scopeParts.join(", "));
+  }
+  if (opts.durationSecs !== void 0) parts.push(`${opts.durationSecs.toFixed(2)}s`);
+  console.log(`  ${dim(parts.join(" \xB7 "))}`);
+  console.log();
+}
+
+export {
+  formatMemoriesText,
+  formatMemoriesTable,
+  formatJson,
+  formatSingleMemory,
+  formatAddResult,
+  formatJsonEnvelope,
+  printResultSummary
+};