Fix broken /cli link in introduction.mdx

Generated-By: mintlify-agent
2026-03-31 00:07:47 +00:00
2243 changed files with 124604 additions and 192922 deletions
@@ -1,20 +0,0 @@
-{
-  "name": "mem0-plugins",
-  "interface": {
-    "displayName": "Mem0 Plugins"
-  },
-  "plugins": [
-    {
-      "name": "mem0",
-      "source": {
-        "source": "local",
-        "path": "./integrations/mem0-plugin"
-      },
-      "policy": {
-        "installation": "AVAILABLE",
-        "authentication": "ON_INSTALL"
-      },
-      "category": "Productivity"
-    }
-  ]
-}
@@ -10,9 +10,9 @@
  "plugins": [
    {
      "name": "mem0",
-      "source": "./integrations/mem0-plugin",
+      "source": "./mem0-plugin",
      "description": "Mem0 memory layer for AI applications. Add persistent memory, personalization, and semantic search to Claude workflows.",
-      "version": "0.2.14"
+      "version": "0.1.0"
    }
  ]
 }
@@ -1,20 +0,0 @@
-{
-  "name": "mem0-plugins",
-  "interface": {
-    "displayName": "Mem0 Plugins"
-  },
-  "plugins": [
-    {
-      "name": "mem0",
-      "source": {
-        "source": "local",
-        "path": "./integrations/mem0-plugin"
-      },
-      "policy": {
-        "installation": "AVAILABLE",
-        "authentication": "ON_INSTALL"
-      },
-      "category": "Productivity"
-    }
-  ]
-}
@@ -10,9 +10,9 @@
  "plugins": [
    {
      "name": "mem0",
-      "source": "./integrations/mem0-plugin",
+      "source": "./mem0-plugin",
      "description": "Mem0 memory layer for AI applications. Add persistent memory, personalization, and semantic search.",
-      "version": "0.2.14"
+      "version": "0.1.0"
    }
  ]
 }
@@ -9,10 +9,12 @@ body:
      label: Component
      description: Which part of mem0 is affected?
      options:
-        - Python SDK
+        - Core / Python SDK
        - TypeScript SDK
-        - Vector Store
-        - Plugin
+        - Vector Store (Qdrant, PGVector, Redis, Chroma, etc.)
+        - Graph Memory (Neo4j, Memgraph, etc.)
+        - Ollama / Local Models
+        - OpenClaw
        - REST API
        - Other
    validations:
@@ -9,11 +9,14 @@ body:
      label: Component
      description: Which part of mem0 does this relate to?
      options:
-        - Python SDK
+        - Core / Python SDK
        - TypeScript SDK
-        - Vector Store
-        - Plugin
+        - Vector Store (Qdrant, PGVector, Redis, Chroma, etc.)
+        - Graph Memory (Neo4j, Memgraph, etc.)
+        - Ollama / Local Models
+        - OpenClaw
        - REST API
+        - Benchmarks / Evals
        - Other
    validations:
      required: true
@@ -1,15 +1,18 @@
-policy:
-  - section:
-      - id: ['component']
-        block-list: ['Other']
-        label:
-          - name: 'sdk-python'
-            keys: ['Python SDK']
-          - name: 'sdk-typescript'
-            keys: ['TypeScript SDK']
-          - name: 'vector-store'
-            keys: ['Vector Store']
-          - name: 'plugin'
-            keys: ['Plugin']
-          - name: 'rest-api'
-            keys: ['REST API']
+# Maps dropdown selections to GitHub labels
+# Used by the advanced-issue-labeler GitHub Action
+
+component:
+  - label: "sdk-python"
+    matcher: "Core / Python SDK"
+  - label: "sdk-typescript"
+    matcher: "TypeScript SDK"
+  - label: "vector-store"
+    matcher: "Vector Store"
+  - label: "graph-memory"
+    matcher: "Graph Memory"
+  - label: "ollama"
+    matcher: "Ollama"
+  - label: "openclaw"
+    matcher: "OpenClaw"
+  - label: "rest-api"
+    matcher: "REST API"
@@ -1,40 +0,0 @@
-{
-  "language": {
-    "sdk-python": [
-      "python", "pip install", "pypi", "pyproject", "requirements.txt",
-      "from mem0", "import mem0", "traceback", "pydantic", "asyncmemory",
-      "poetry", "virtualenv", "venv", "conda", "pytest", "async def"
-    ],
-    "sdk-typescript": [
-      "typescript", "javascript", "pnpm", "yarn", "node.js", "nodejs",
-      "mem0-ts", "mem0ai/oss", "tsconfig", "await import",
-      "=> {", "undefined is not"
-    ]
-  },
-  "area": {
-    "plugin": [
-      "openclaw", "openclaw-mem0", "openclaw.json", "openclaw plugin",
-      "claude code", "opencode", "pi agent", "mem0-plugin",
-      "cursor plugin", "codex plugin", "editor plugin"
-    ],
-    "cli": ["mem0-cli", "@mem0/cli", "npx mem0", "command line"],
-    "vector-store": [
-      "pgvector", "pinecone", "chroma", "chromadb", "weaviate",
-      "milvus", "faiss", "vector store", "vectorstore",
-      "elasticsearch", "supabase", "azure ai search",
-      "s3 vectors", "mongodb"
-    ],
-    "integrations": [
-      "vercel ai", "vercel-ai-sdk", "@mem0/vercel-ai-provider",
-      "llamaindex", "crewai", "autogen", "langgraph"
-    ],
-    "rest-api": [
-      "rest api", "fastapi", "docker-compose", "/v1/memories",
-      "localhost:8000", "localhost:8888", "curl -x", "http endpoint"
-    ],
-    "documentation": [
-      "docs.mem0.ai", "documentation", "typo", "readme", "docstring", "broken link",
-      "issue on docs", "docs:", "link to the docs page", "issue with current documentation"
-    ]
-  }
-}
@@ -1,59 +0,0 @@
-sdk-python:
-  - changed-files:
-      - any-glob-to-any-file:
-          - 'mem0/**'
-          - 'tests/**'
-          - 'cli/python/**'
-          - 'pyproject.toml'
-          - 'poetry.lock'
-
-sdk-typescript:
-  - changed-files:
-      - any-glob-to-any-file:
-          - 'mem0-ts/**'
-          - 'cli/node/**'
-
-vector-store:
-  - changed-files:
-      - any-glob-to-any-file:
-          - 'mem0/vector_stores/**'
-          - 'mem0-ts/src/oss/src/vector_stores/**'
-
-rest-api:
-  - changed-files:
-      - any-glob-to-any-file: 'server/**'
-
-integrations:
-  - changed-files:
-      - any-glob-to-any-file: 'integrations/**'
-
-plugin:
-  - changed-files:
-      - all-globs-to-any-file:
-          - 'integrations/**'
-          - '!integrations/vercel-ai-sdk/**'
-      - any-glob-to-any-file:
-          - 'skills/**'
-          - '.agents/**'
-          - '.claude-plugin/**'
-          - '.codex-plugin/**'
-          - '.cursor-plugin/**'
-          - 'marketplace.json'
-
-cli:
-  - changed-files:
-      - any-glob-to-any-file: 'cli/**'
-
-documentation:
-  - changed-files:
-      - any-glob-to-any-file:
-          - 'docs/**'
-          - 'examples/**'
-          - '*.md'
-
-ci:
-  - changed-files:
-      - any-glob-to-any-file:
-          - '.github/**'
-          - 'scripts/**'
-          - '.pre-commit-config.yaml'
@@ -1,44 +0,0 @@
-const fs = require('fs');
-
-function componentLabels(keywords) {
-  return Object.values(keywords).flatMap(Object.keys);
-}
-
-function toMatcher(term) {
-  const escaped = term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-  const prefix = /^[a-z0-9]/i.test(term) ? '\\b' : '';
-  return new RegExp(prefix + escaped, 'i');
-}
-
-function scoreGroup(text, group) {
-  let winner = null;
-  let best = 0;
-  for (const [label, terms] of Object.entries(group)) {
-    const score = terms.reduce((n, term) => n + (toMatcher(term).test(text) ? 1 : 0), 0);
-    if (score > best) {
-      winner = label;
-      best = score;
-    }
-  }
-  return winner;
-}
-
-const UMBRELLA = { plugin: 'integrations' };
-
-function inferComponentLabels(text, keywords) {
-  if (!text) return [];
-  const labels = [scoreGroup(text, keywords.language), scoreGroup(text, keywords.area)].filter(
-    Boolean,
-  );
-  for (const label of labels.slice()) {
-    const parent = UMBRELLA[label];
-    if (parent && !labels.includes(parent)) labels.push(parent);
-  }
-  return labels;
-}
-
-function loadKeywords(file) {
-  return JSON.parse(fs.readFileSync(file, 'utf8'));
-}
-
-module.exports = { componentLabels, inferComponentLabels, loadKeywords };
@@ -1,102 +0,0 @@
-const assert = require('assert');
-const path = require('path');
-const { inferComponentLabels, loadKeywords } = require('./infer-component-labels.js');
-
-const keywords = loadKeywords(path.join(__dirname, '..', 'component-keywords.json'));
-
-const cases = [
-  {
-    number: 6210,
-    title: "but(anthropic): sampling parameters returns 400 error for new model",
-    body: "### Component\n\nCore / Python SDK\n\n### Description\n\n### Summary\n\nWhen using Anthropic latest models such as `claude-opus-4-7`, `claude-opus-4-8`, or `claude-sonnet-5`, Mem0 still sends sampling parameters like `temperature` / `top_p`. These models do not support those parameters, causing Anthropic API requests to fail.\n\nSee https://platform.claude.com/docs/en/about-claude/models/migration-guide\n\n### Steps to Reproduce\n\n```python\n  from mem0 import Memory\n\n  m = Memory.from_config({\n      \"llm\": {\n          \"provider\": \"anthropic\",\n          \"config\": {\n              \"model\": \"claude-opus-4-8\",\n              \"api_key\": \"your-anthropic-api-key\"\n          },\n      },\n      ...\n  })\n```\n\n### Expected Behavior\n\nMem0 should detect Anthropic models that do not support sampling parameters and omit temperature and top_p from the request.\n\nFor models that still support sampling parameters, such as claude-opus-4-6, claude-sonnet-4-6, and claude-haiku-4-5, Mem0 should continue sending supported sampling parameters till they're deprecated.\n\n### Actual Behavior\n\nMem0 includes temperature by default for Anthropic requests. With newer Anthropic models that do not support sampling parameters, the API request fails because unsupported parameters are sent.\n\n### Environment\n\n  - mem0 version: 2.0.11\n  - Python/Node version: Python 3.11\n  - OS: macOS\n",
-    expected: ["sdk-python"],
-  },
-  {
-    number: 5770,
-    title: "feat(ts-sdk): add FastEmbed embedding provider",
-    body: "## Summary\n\nThe Python SDK supports **FastEmbed** as an embedding provider, but the TypeScript OSS SDK (`mem0ai/oss`) does not. Add it to bring the TS SDK to parity.\n\n| | |\n|---|---|\n| Python reference | `mem0/embeddings/fastembed.py` |\n| Registered in (Python) | `mem0/utils/factory.py` (EmbedderFactory) |\n| Target file (TypeScript) | `mem0-ts/src/oss/src/embeddings/fastembed.ts` |\n| Suggested implementation | Use the `fastembed` npm package (ONNX local embeddings). |\n\n## Requirements\n\n- [ ] Implement `FastEmbedEmbedder` in `mem0-ts/src/oss/src/embeddings/fastembed.ts`, extending `Embedder` (`mem0-ts/src/oss/src/embeddings/base.ts`) and mirroring the Python provider's behavior (embed / embedBatch).\n- [ ] Register the `\"fastembed\"` provider in `mem0-ts/src/oss/src/utils/factory.ts` (EmbedderFactory).\n- [ ] Add config typing in `mem0-ts/src/oss/src/types/`.\n- [ ] Add a unit test under `mem0-ts/src/oss/src/tests/`.\n- [ ] Add `fastembed` to `mem0-ts/package.json` (optional/peer dependency, lazy-imported like other providers).\n- [ ] Update docs under `docs/` if this provider is user-facing.\n\n## Reference pattern\n\nMirror an existing TS provider: `embeddings/openai.ts`.\n\n## Notes\n\n`fastembed` (v2.x) is the JS port of Qdrant's FastEmbed — local/offline embeddings. Mirror the default model in `mem0/embeddings/fastembed.py`.\n\n---\n_Part of the TypeScript ↔ Python SDK provider-parity effort. One provider per issue (atomic)._\n",
-    expected: ["sdk-typescript"],
-  },
-  {
-    number: 3940,
-    title: "Milvus database will return distance not similarity score",
-    body: "### 🐛 Describe the bug\n\nMilvus database will return distance not similarity score\n\n## in milvus.py\n\ndef _parse_output(self, data: list):\n        \"\"\"\n        Parse the output data.\n\n        Args:\n            data (Dict): Output data.\n\n        Returns:\n            List[OutputData]: Parsed output data.\n        \"\"\"\n        memory = []\n\n        for value in data:\n            uid, score, metadata = (\n                value.get(\"id\"),\n                value.get(\"distance\"),  # here\n                value.get(\"entity\", {}).get(\"metadata\"),\n            )\n\n            memory_obj = OutputData(id=uid, score=score, payload=metadata)\n            memory.append(memory_obj)\n\n        return memory\n",
-    expected: ["vector-store"],
-  },
-  {
-    number: 5290,
-    title: "Recall search failed: Bad Request Using OpenAI Embedding Model",
-    body: "### Component\n\nOpenClaw\n\n### Description\n\n### Summary\nuse openclaw.json config:\n\n```json\n...\n\"embedder\": {\n              \"provider\": \"openai\",\n              \"config\": {\n                \"model\": \"bge-base-zh-v1.5\",\n                \"embedding_dims\": 1024,\n                \"embeddingDims\": 1024,\n                \"url\": \"https://xxxxxxxxx/v1\",\n                \"apiKey\": \"xxxxxxxxxxxx\"\n              }\n            },\n\"vectorStore\": {\n              \"provider\": \"qdrant\",\n              \"config\": {\n                \"url\": \"http://qdrant:6333\",\n                \"apiKey\": \"${QDRANT_API_KEY}\",\n                \"collectionName\": \"mem0\",\n                \"embeddingModelDims\": 1024\n              }\n            }\n```\n```\n\nopenclaw log info is：\n\n```\n23:14:20 Api key is used with unsecure connection.\n23:14:21 [mem0] Recall search failed: Bad Request\n23:14:21 [plugins] openclaw-mem0: skills-mode recall (strategy=smart) injecting 0 memories (~20 tokens)\n23:14:22 [ws] ⇄ res ✓ sessions.list 256ms conn=d1eb9bc4…17da id=201b8113…c9dc\n23:14:22 [ws] ⇄ res ✓ sessions.list 264ms conn=d1eb9bc4…17da id=4939f962…2f16\n23:14:34 [ws] ⇄ res ✓ sessions.list 250ms conn=d1eb9bc4…17da id=f7ad503f…baa6\n23:15:12 [mem0] **Recall search failed: Bad Request**\n23:15:12 [plugins] openclaw-mem0: skills-mode recall (strategy=smart) injecting 0 memories (~20 tokens)\n23:15:12 [ws] ⇄ res ✓ sessions.list 288ms conn=d1eb9bc4…17da id=9e20bb86…371e\n23:15:13 [ws] ⇄ res ✓ sessions.list 268ms conn=d1eb9bc4…17da id=3b49a2ad…7ada\n23:15:20 [ws] ⇄ res ✓ sessions.list 235ms conn=d1eb9bc4…17da id=a192da30…069f\n```\n\n### Actual Behavior\n\nembedding model response ok,response message has 1024 vectors,but the vectors are submitted to vector-db:qdrant with all zero vectors,and vectors has only 256 size.\n\n```http\nPOST /collections/mem0/points/search HTTP/1.1\nhost: qdrant:6333\nconnection: keep-alive\nuser-agent: qdrant-js/1.13.0\napi-key: xxxxxxxxxxxxxxxxxxxxxxxxxxxx\nContent-Type: application/json\nAccept: application/json\naccept-language: *\nsec-fetch-mode: cors\naccept-encoding: gzip, deflate\ncontent-length: 651\n\n{\"vector\":[0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0],\"limit\":120,\"offset\":0,\"filter\":{\"must\":[{\"key\":\"user_id\",\"match\":{\"value\":\"agent\"}}]},\"with_payload\":true,\"with_vector\":false}\n\n**HTTP/1.1 400 Bad Request**\ntransfer-encoding: chunked\ncontent-type: application/json\nvary: accept-encoding, Origin, Access-Control-Request-Method, Access-Control-Request-Headers\ncontent-encoding: gzip\n\n```\n\n### Expected Behavior\n\nembedding model response ok by tcpdump, response message has 1024 vectors,and this vectors are submitted to vector-db:qdrant with the same vectors,and vectors has also 1024 size.\n\n\n### Environment\n\n- openclaw-mem0 version: 1.0.11\n- qdrant: 1.13.6\n",
-    expected: ["plugin", "integrations"],
-  },
-  {
-    number: 3696,
-    title: "Cannot set expiration_date for memory in REST API server (Docker Compose)",
-    body: "### 🐛 Describe the bug\n\nI'm using docker compose to deploy a REST API server. When adding memory, I'm unable to set the expiration_date. Is this feature not supported?",
-    expected: ["rest-api"],
-  },
-  {
-    number: 6252,
-    title: "cursor: on_file_read_cursor.sh ignores auto_search / MEM0_AUTO_SEARCH",
-    body: "### Component\n\nCursor / mem0-plugin\n\n### Description\n\n`on_file_read_cursor.sh` never checks `MEM0_AUTO_SEARCH`. In Claude Code, #6065/#6071 added a guard on `on_file_read.sh`, but the Cursor PreToolUse variant still always calls `file_context.py` (and thus Platform search) once `MEM0_API_KEY` is set.\n\n### Expected\n\nWhen `auto_search: false` / `MEM0_AUTO_SEARCH=false`, `on_file_read_cursor.sh` should exit 0 without searching.\n\n### Actual\n\nTimeline search still runs.\n\n### Related\n\n#6065, #6071, #6250\n",
-    expected: ["plugin", "integrations"],
-  },
-  {
-    number: 6032,
-    title: "docs: fix typos and punctuation errors across docs",
-    body: "### Description\n\n### Page\nMultiple pages — see list below.\n\n### What's Wrong or Missing\n1. https://docs.mem0.ai/components/llms/overview — \"a llm\" should be \"an LLM\"\n2. https://docs.mem0.ai/components/vectordbs/dbs/azure — 2 comma splices + \"setup\" used as a verb (should be \"set up\")\n3. https://docs.mem0.ai/components/embedders/models/azure_openai — \"from the Azure.\" is an incomplete sentence\n4. https://docs.mem0.ai/components/llms/models/azure_openai — same incomplete \"from the Azure\" phrasing\n5. https://docs.mem0.ai/cookbooks/companions/voice-companion-openai — \"an important information\" (uncountable noun)\n6. https://docs.mem0.ai/cookbooks/essentials/exporting-memories — comma splice\n7. https://docs.mem0.ai/cookbooks/integrations/tavily-search — \"usecase\" should be \"use case\"\n8. https://docs.mem0.ai/cookbooks/overview — broken parallelism in bullet list\n9. README.md — \"Github App\" should be \"GitHub App\"\n10. https://docs.mem0.ai/platform/overview — table cell not capitalized like other rows\n\n### Suggested Fix\nApply the corrections listed above for each page. I will submit a PR soon addressing all of the issues mentioned.",
-    expected: ["documentation"],
-  },
-];
-
-const cliRegressionCase = {
-  number: 3144,
-  title: "Bug Report: Memory Score Does Not Match Expected Relevance in Local Search",
-  body: "### 🐛 Describe the bug\n\n#### Description\n\nWhen using the locally deployed `mem0` server, the returned memory `score` from the `search` interface does not align with the expected semantic relevance. In particular, irrelevant or less relevant memories sometimes receive higher scores than directly related ones.\n\n#### Reproduction Steps\n\n```python\nmem0 = mem0_client(mode=\"local\")\nprint(\"Mem0 client initialized successfully.\")\n\nprint(\"Adding memories...\")\nresult = mem0.add(messages=[\n    {\"role\": \"user\", \"content\": \"I like drinking coffee in the morning\"},\n    {\"role\": \"user\", \"content\": \"I enjoy reading books at night\"}\n], user_id=\"alice\")\nprint(\"Memory added:\", result)\n\nprint(\"Searching memories...\")\nsearch_result = mem0.search(query=\"coffee\", user_id=\"alice\", top_k=2)\nprint(\"Search results:\", search_result)\n```\n\n#### Actual Output\n\n```json\n{\n  \"results\": [\n    {\n      \"id\": \"5099b5be-c673-4f09-99de-a196f43b6476\",\n      \"memory\": \"Likes drinking coffee in the morning\",\n      \"score\": 0.5115111920687857\n    },\n    {\n      \"id\": \"08df5c51-c52b-4c45-a5b6-b3f864ea149a\",\n      \"memory\": \"Enjoys reading books at night\",\n      \"score\": 0.7755568273863331\n    }\n  ],\n  \"relations\": [\n    {\"source\": \"coffee\", \"relationship\": \"consumed_in\", \"destination\": \"morning\"},\n    {\"source\": \"user_id:_alice\", \"relationship\": \"likes\", \"destination\": \"coffee\"},\n    {\"source\": \"user_id:_alice\", \"relationship\": \"likes_drinking\", \"destination\": \"coffee\"},\n    {\"source\": \"user_id:_alice\", \"relationship\": \"in_time\", \"destination\": \"morning\"},\n    {\"source\": \"user_id:_alice\", \"relationship\": \"drinks_in\", \"destination\": \"morning\"}\n  ]\n}\n```\n\n#### Expected Behavior\n\nThe memory `\"Likes drinking coffee in the morning\"` should have a **higher score** than `\"Enjoys reading books at night\"` when querying for `\"coffee\"`, since it is directly semantically related.",
-};
-
-let failures = 0;
-
-function run(name, fn) {
-  try {
-    fn();
-    console.log(`PASS ${name}`);
-  } catch (err) {
-    failures++;
-    console.error(`FAIL ${name}: ${err.message}`);
-  }
-}
-
-for (const { number, title, body, expected } of cases) {
-  const text = `${title}
-
-${body}`;
-  run(`#${number}`, () => {
-    assert.deepStrictEqual(inferComponentLabels(text, keywords), expected);
-  });
-}
-
-run('#3144 cliKeywordPrefixSubstringRegression', () => {
-  const text = `${cliRegressionCase.title}
-
-${cliRegressionCase.body}`;
-  const inferred = inferComponentLabels(text, keywords);
-  assert.ok(!inferred.includes('cli'), `expected 'cli' absent (body contains 'Mem0 client', a substring of the removed 'mem0 cli' term), got ${JSON.stringify(inferred)}`);
-});
-
-run('noKeywordMatchReturnsEmptyArray', () => {
-  const text = 'The weather today is sunny and I went for a walk in the park with my dog.';
-  assert.deepStrictEqual(inferComponentLabels(text, keywords), []);
-});
-
-run('emptyStringReturnsEmptyArray', () => {
-  assert.deepStrictEqual(inferComponentLabels('', keywords), []);
-});
-
-if (failures > 0) {
-  console.error(`
-${failures} test(s) failed.`);
-  process.exit(1);
-}
-console.log(`
-All ${cases.length + 3} tests passed.`);
@@ -1,33 +1,17 @@
 name: Publish Python 🐍 distributions 📦 to PyPI and TestPyPI

-# Dispatched by release.yml (Release Router) when a release tagged v* is
-# published. Can also be dispatched manually to re-publish a tag.
 on:
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: 'Release tag to build and publish (e.g. v1.2.3)'
-        required: true
-        type: string
-      prerelease:
-        description: 'Unused for PyPI (pre-releases are expressed in the version itself); accepted for router uniformity'
-        required: false
-        type: boolean
-        default: false
+  release:
+    types: [published]

 jobs:
  build-n-publish:
    name: Build and publish Python 🐍 distributions 📦 to PyPI and TestPyPI
-    # Pure SDK version tags only (v1.2.3) — excludes package-prefixed tags
-    # like vercel-ai-v* that also start with 'v'
-    if: startsWith(inputs.tag, 'v') && !contains(inputs.tag, '-v')
    runs-on: ubuntu-latest
    permissions:
      id-token: write
    steps:
      - uses: actions/checkout@v2
-        with:
-          ref: ${{ inputs.tag }}

      - name: Set up Python
        uses: actions/setup-python@v2
@@ -54,6 +38,7 @@ jobs:
      #     packages_dir: dist/

      - name: Publish distribution 📦 to PyPI
+        if: startsWith(github.ref, 'refs/tags')
        uses: pypa/gh-action-pypi-publish@release/v1
        with:
          packages_dir: dist/
@@ -1,208 +0,0 @@
-name: CI Gate
-
-# Single required status check for all PRs.
-#
-# Path-filtered CI workflows can't be marked as required in branch
-# protection: on a PR that doesn't touch their paths they never report, and
-# the required check hangs at "Expected" forever. This gate solves that. It
-# runs on every PR, detects which packages changed, calls only the relevant
-# package CI workflows (as reusable workflows), and the final "CI Gate" job
-# reports the aggregate result — success when every invoked pipeline passed
-# (skipped pipelines are fine), failure when any failed.
-#
-# Branch protection should require exactly one status check: "CI Gate".
-#
-# Package CI workflows keep their own push-to-main and workflow_dispatch
-# triggers; only their pull_request triggers moved here. To wire in a new
-# package: add a filter under the `changes` job, a call job that `uses:` the
-# package workflow, and list the call job in the gate's `needs`.
-
-on:
-  pull_request:
-
-concurrency:
-  group: ci-gate-${{ github.event.pull_request.number }}
-  cancel-in-progress: true
-
-permissions:
-  contents: read
-  pull-requests: read
-
-jobs:
-  changes:
-    name: Detect changed packages
-    runs-on: ubuntu-latest
-    outputs:
-      python_sdk: ${{ steps.filter.outputs.python_sdk }}
-      ts_sdk: ${{ steps.filter.outputs.ts_sdk }}
-      cli_python: ${{ steps.filter.outputs.cli_python }}
-      cli_node: ${{ steps.filter.outputs.cli_node }}
-      openclaw: ${{ steps.filter.outputs.openclaw }}
-      mem0_plugin: ${{ steps.filter.outputs.mem0_plugin }}
-      opencode_plugin: ${{ steps.filter.outputs.opencode_plugin }}
-      pi_agent_plugin: ${{ steps.filter.outputs.pi_agent_plugin }}
-      n8n_nodes_mem0: ${{ steps.filter.outputs.n8n_nodes_mem0 }}
-      zapier_mem0: ${{ steps.filter.outputs.zapier_mem0 }}
-      docs_llms_txt: ${{ steps.filter.outputs.docs_llms_txt }}
-    steps:
-      - uses: dorny/paths-filter@v3
-        id: filter
-        with:
-          # Each filter mirrors the package workflow's old pull_request
-          # paths, plus the package workflow file itself and this gate file
-          # (changing either must re-exercise the pipeline).
-          filters: |
-            python_sdk:
-              - 'mem0/**'
-              - 'tests/**'
-              - 'pyproject.toml'
-              - '.github/workflows/ci.yml'
-              - '.github/workflows/ci-gate.yml'
-            ts_sdk:
-              - 'mem0-ts/**'
-              - '.github/workflows/ts-sdk-ci.yml'
-              - '.github/workflows/ci-gate.yml'
-            cli_python:
-              - 'cli/python/**'
-              - '.github/workflows/cli-python-ci.yml'
-              - '.github/workflows/ci-gate.yml'
-            cli_node:
-              - 'cli/node/**'
-              - '.github/workflows/cli-node-ci.yml'
-              - '.github/workflows/ci-gate.yml'
-            openclaw:
-              - 'integrations/openclaw/**'
-              - '.github/workflows/openclaw-checks.yml'
-              - '.github/workflows/ci-gate.yml'
-            mem0_plugin:
-              - 'integrations/mem0-plugin/**'
-              - '!integrations/mem0-plugin/.opencode-plugin/**'
-              - '.github/workflows/mem0-plugin-checks.yml'
-              - '.github/workflows/ci-gate.yml'
-            opencode_plugin:
-              - 'integrations/mem0-plugin/.opencode-plugin/**'
-              - '.github/workflows/opencode-plugin-checks.yml'
-              - '.github/workflows/ci-gate.yml'
-            pi_agent_plugin:
-              - 'integrations/pi-agent-plugin/**'
-              - '.github/workflows/pi-agent-plugin-checks.yml'
-              - '.github/workflows/ci-gate.yml'
-            n8n_nodes_mem0:
-              - 'integrations/n8n-nodes-mem0/**'
-              - '.github/workflows/n8n-nodes-mem0-checks.yml'
-            zapier_mem0:
-              - 'integrations/zapier-mem0/**'
-              - '.github/workflows/zapier-mem0-checks.yml'
-              - '.github/workflows/ci-gate.yml'
-            docs_llms_txt:
-              - 'docs/**/*.mdx'
-              - 'docs/llms.txt'
-              - 'scripts/check-llms-txt-coverage.py'
-              - 'scripts/llms-txt-ignore.txt'
-              - '.github/workflows/docs-llms-txt-check.yml'
-              - '.github/workflows/ci-gate.yml'
-
-  python-sdk:
-    name: Python SDK
-    needs: changes
-    if: needs.changes.outputs.python_sdk == 'true'
-    uses: ./.github/workflows/ci.yml
-    secrets: inherit
-
-  ts-sdk:
-    name: TypeScript SDK
-    needs: changes
-    if: needs.changes.outputs.ts_sdk == 'true'
-    uses: ./.github/workflows/ts-sdk-ci.yml
-    secrets: inherit
-
-  cli-python:
-    name: Python CLI
-    needs: changes
-    if: needs.changes.outputs.cli_python == 'true'
-    uses: ./.github/workflows/cli-python-ci.yml
-    secrets: inherit
-
-  cli-node:
-    name: Node CLI
-    needs: changes
-    if: needs.changes.outputs.cli_node == 'true'
-    uses: ./.github/workflows/cli-node-ci.yml
-    secrets: inherit
-
-  openclaw:
-    name: OpenClaw
-    needs: changes
-    if: needs.changes.outputs.openclaw == 'true'
-    uses: ./.github/workflows/openclaw-checks.yml
-    secrets: inherit
-
-  mem0-plugin:
-    name: Mem0 Plugin
-    needs: changes
-    if: needs.changes.outputs.mem0_plugin == 'true'
-    uses: ./.github/workflows/mem0-plugin-checks.yml
-    secrets: inherit
-
-  opencode-plugin:
-    name: OpenCode Plugin
-    needs: changes
-    if: needs.changes.outputs.opencode_plugin == 'true'
-    uses: ./.github/workflows/opencode-plugin-checks.yml
-    secrets: inherit
-
-  pi-agent-plugin:
-    name: Pi Agent Plugin
-    needs: changes
-    if: needs.changes.outputs.pi_agent_plugin == 'true'
-    uses: ./.github/workflows/pi-agent-plugin-checks.yml
-    secrets: inherit
-
-  n8n-nodes-mem0:
-    name: n8n Node
-    needs: changes
-    if: needs.changes.outputs.n8n_nodes_mem0 == 'true'
-    uses: ./.github/workflows/n8n-nodes-mem0-checks.yml
-  zapier-mem0:
-    name: Zapier App
-    needs: changes
-    if: needs.changes.outputs.zapier_mem0 == 'true'
-    uses: ./.github/workflows/zapier-mem0-checks.yml
-    secrets: inherit
-
-  docs-llms-txt:
-    name: docs llms.txt
-    needs: changes
-    if: needs.changes.outputs.docs_llms_txt == 'true'
-    uses: ./.github/workflows/docs-llms-txt-check.yml
-    secrets: inherit
-
-  gate:
-    name: CI Gate
-    needs:
-      - changes
-      - python-sdk
-      - ts-sdk
-      - cli-python
-      - cli-node
-      - openclaw
-      - mem0-plugin
-      - opencode-plugin
-      - pi-agent-plugin
-      - n8n-nodes-mem0
-      - zapier-mem0
-      - docs-llms-txt
-    if: always()
-    runs-on: ubuntu-latest
-    steps:
-      - name: Evaluate pipeline results
-        env:
-          NEEDS: ${{ toJSON(needs) }}
-        run: |
-          echo "$NEEDS" | jq -r 'to_entries[] | "\(.key): \(.value.result)"'
-          failed=$(echo "$NEEDS" | jq -r '[to_entries[] | select(.value.result == "failure" or .value.result == "cancelled") | .key] | join(", ")')
-          if [ -n "$failed" ]; then
-            echo "::error::Failing pipelines: $failed"
-            exit 1
-          fi
-          echo "All pipelines relevant to this change passed."
@@ -1,58 +1,28 @@
 name: ci

-# On PRs this is invoked by ci-gate.yml (the single required check);
-# push-to-main runs remain standalone.
 on:
  push:
    branches: [main]
-  workflow_call:
+    paths:
+      - 'mem0/**'
+      - 'tests/**'
+      - 'embedchain/**'
+      - '.github/workflows/**'
+      - 'pyproject.toml'
+  pull_request:
+    paths:
+      - 'mem0/**'
+      - 'tests/**'
+      - 'embedchain/**'

 jobs:
-  changelog_check:
-    if: github.event_name == 'pull_request'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Require CHANGELOG entry when Python SDK version changes
-        env:
-          BASE_SHA: ${{ github.event.pull_request.base.sha }}
-          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
-        run: |
-          set -euo pipefail
-
-          extract_version() {
-            python3 -c "import sys, re; m = re.search(r'^\s*version\s*=\s*\"([^\"]+)\"', sys.stdin.read(), re.M); print(m.group(1) if m else '')"
-          }
-
-          base_version=$(git show "$BASE_SHA:pyproject.toml" 2>/dev/null | extract_version || echo "")
-          head_version=$(extract_version < pyproject.toml)
-
-          echo "Base version: ${base_version:-<unknown>}"
-          echo "Head version: $head_version"
-
-          if [ -z "$base_version" ] || [ "$base_version" = "$head_version" ]; then
-            echo "pyproject.toml version unchanged — no CHANGELOG entry required."
-            exit 0
-          fi
-
-          echo "Detected version bump ${base_version} -> ${head_version}. Checking docs/changelog/sdk.mdx…"
-
-          if git diff --name-only "$BASE_SHA" "$HEAD_SHA" -- docs/changelog/sdk.mdx | grep -q .; then
-            echo "Changelog update present in docs/changelog/sdk.mdx ✅"
-          else
-            echo "::error file=pyproject.toml::pyproject.toml version changed from ${base_version} to ${head_version} but docs/changelog/sdk.mdx was not updated in this PR. Add a new <Update> entry under the Python tab for v${head_version}."
-            exit 1
-          fi
-
  check_changes:
    runs-on: ubuntu-latest
    outputs:
      mem0_changed: ${{ steps.filter.outputs.mem0 }}
+      embedchain_changed: ${{ steps.filter.outputs.embedchain }}
    steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v3
    - uses: dorny/paths-filter@v2
      id: filter
      with:
@@ -60,28 +30,25 @@ jobs:
          mem0:
            - 'mem0/**'
            - 'tests/**'
-            - '.github/workflows/ci.yml'
+            - '.github/workflows/**'
            - 'pyproject.toml'
+          embedchain:
+            - 'embedchain/**'

  build_mem0:
    needs: check_changes
+    if: needs.check_changes.outputs.mem0_changed == 'true'
    runs-on: ubuntu-latest
    strategy:
      matrix:
        python-version: ["3.10", "3.11", "3.12"]
    steps:
-      - name: Skip — no relevant changes
-        if: needs.check_changes.outputs.mem0_changed != 'true'
-        run: echo "No changes in mem0/, tests/, pyproject.toml, or ci.yml — skipping"
-      - uses: actions/checkout@v4
-        if: needs.check_changes.outputs.mem0_changed == 'true'
+      - uses: actions/checkout@v3
      - name: Set up Python ${{ matrix.python-version }}
-        if: needs.check_changes.outputs.mem0_changed == 'true'
        uses: actions/setup-python@v4
        with:
          python-version: ${{ matrix.python-version }}
      - name: Clean up disk space
-        if: needs.check_changes.outputs.mem0_changed == 'true'
        run: |
          df -h
          sudo rm -rf /usr/share/dotnet /usr/local/lib/android /opt/ghc /opt/hostedtoolcache/CodeQL
@@ -89,27 +56,61 @@ jobs:
          sudo docker builder prune -a
          df -h
      - name: Install Hatch
-        if: needs.check_changes.outputs.mem0_changed == 'true'
        run: pip install hatch
      - name: Load cached venv
-        if: needs.check_changes.outputs.mem0_changed == 'true'
        id: cached-hatch-dependencies
        uses: actions/cache@v3
        with:
          path: .venv
          key: venv-mem0-${{ runner.os }}-${{ hashFiles('**/pyproject.toml') }}
      - name: Install GEOS Libraries
-        if: needs.check_changes.outputs.mem0_changed == 'true'
        run: sudo apt-get update && sudo apt-get install -y libgeos-dev
      - name: Install dependencies
-        if: needs.check_changes.outputs.mem0_changed == 'true' && steps.cached-hatch-dependencies.outputs.cache-hit != 'true'
        run: |
          pip install --upgrade pip
          pip install -e ".[test,graph,vector_stores,llms,extras]"
-          pip install ruff==0.16.0
+          pip install ruff
+        if: steps.cached-hatch-dependencies.outputs.cache-hit != 'true'
      - name: Run Linting
-        if: needs.check_changes.outputs.mem0_changed == 'true'
        run: make lint
      - name: Run tests and generate coverage report
-        if: needs.check_changes.outputs.mem0_changed == 'true'
        run: make test
+
+  build_embedchain:
+    needs: check_changes
+    if: needs.check_changes.outputs.embedchain_changed == 'true'
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install Hatch
+        run: pip install hatch
+      - name: Load cached venv
+        id: cached-hatch-dependencies
+        uses: actions/cache@v3
+        with:
+          path: .venv
+          key: venv-embedchain-${{ runner.os }}-${{ hashFiles('**/pyproject.toml') }}
+      - name: Install dependencies
+        run: cd embedchain && make install_all
+        if: steps.cached-hatch-dependencies.outputs.cache-hit != 'true'
+      - name: Run Formatting
+        run: |
+          mkdir -p embedchain/.ruff_cache && chmod -R 777 embedchain/.ruff_cache
+          cd embedchain && hatch run format
+      - name: Lint with ruff
+        run: cd embedchain && make lint
+      - name: Run tests and generate coverage report
+        run: cd embedchain && make coverage
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v3
+        with:
+          file: coverage.xml
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
@@ -1,60 +0,0 @@
-name: Publish @mem0/cli 📦 to npm
-
-# Dispatched by release.yml (Release Router) when a release tagged
-# cli-node-v* is published. Can also be dispatched manually to re-publish
-# a tag.
-on:
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: 'Release tag to build and publish (e.g. cli-node-v0.2.0)'
-        required: true
-        type: string
-      prerelease:
-        description: 'Publish under the version preid dist-tag instead of latest'
-        required: false
-        type: boolean
-        default: false
-
-jobs:
-  build-n-publish:
-    name: Build and publish @mem0/cli 📦 to npm
-    if: startsWith(inputs.tag, 'cli-node-v')
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-    defaults:
-      run:
-        working-directory: cli/node
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'pnpm'
-          cache-dependency-path: cli/node/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Build
-        run: pnpm run build
-
-      - name: Publish to npm
-        run: |
-          if [ "${{ inputs.prerelease }}" = "true" ]; then
-            PREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")
-            npx npm@latest publish --provenance --access public --tag "$PREID"
-          else
-            npx npm@latest publish --provenance --access public
-          fi
@@ -1,99 +0,0 @@
-name: CLI Node CI
-
-# On PRs this is invoked by ci-gate.yml (the single required check);
-# push-to-main and manual runs remain standalone.
-on:
-  workflow_dispatch:
-  push:
-    branches: [main]
-    paths:
-      - 'cli/node/**'
-      - '.github/workflows/cli-node-ci.yml'
-  workflow_call:
-
-jobs:
-  lint:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: 'pnpm'
-          cache-dependency-path: cli/node/pnpm-lock.yaml
-
-      - name: Install dependencies
-        working-directory: cli/node
-        run: pnpm install --frozen-lockfile
-
-      - name: Lint
-        working-directory: cli/node
-        run: pnpm run lint
-
-      - name: Type check
-        working-directory: cli/node
-        run: pnpm run typecheck
-
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [20, 22]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
-
-      - name: Setup Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: 'pnpm'
-          cache-dependency-path: cli/node/pnpm-lock.yaml
-
-      - name: Install dependencies
-        working-directory: cli/node
-        run: pnpm install --frozen-lockfile
-
-      - name: Run tests
-        working-directory: cli/node
-        run: pnpm run test
-
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: 'pnpm'
-          cache-dependency-path: cli/node/pnpm-lock.yaml
-
-      - name: Install dependencies
-        working-directory: cli/node
-        run: pnpm install --frozen-lockfile
-
-      - name: Build
-        working-directory: cli/node
-        run: pnpm run build
-
-      - name: Verify dist output
-        run: |
-          test -f cli/node/dist/index.js || (echo "Build output missing: dist/index.js" && exit 1)
@@ -1,47 +0,0 @@
-name: Publish mem0-cli 🐍 distributions 📦 to PyPI
-
-# Dispatched by release.yml (Release Router) when a release tagged cli-v* is
-# published. Can also be dispatched manually to re-publish a tag.
-on:
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: 'Release tag to build and publish (e.g. cli-v0.2.0)'
-        required: true
-        type: string
-      prerelease:
-        description: 'Unused for PyPI (pre-releases are expressed in the version itself); accepted for router uniformity'
-        required: false
-        type: boolean
-        default: false
-
-jobs:
-  build-n-publish:
-    name: Build and publish mem0-cli 📦 to PyPI
-    if: startsWith(inputs.tag, 'cli-v')
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-    defaults:
-      run:
-        working-directory: cli/python
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.11'
-
-      - name: Install Hatch
-        run: pip install hatch
-
-      - name: Build a binary wheel and a source tarball
-        run: hatch build --clean
-
-      - name: Publish distribution 📦 to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          packages-dir: cli/python/dist/
@@ -1,78 +0,0 @@
-name: CLI Python CI
-
-# On PRs this is invoked by ci-gate.yml (the single required check);
-# push-to-main and manual runs remain standalone.
-on:
-  workflow_dispatch:
-  push:
-    branches: [main]
-    paths:
-      - 'cli/python/**'
-      - '.github/workflows/cli-python-ci.yml'
-  workflow_call:
-
-jobs:
-  lint:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.12'
-
-      - name: Install dev dependencies
-        working-directory: cli/python
-        run: pip install -e ".[dev]"
-
-      - name: Lint with ruff
-        working-directory: cli/python
-        run: ruff check .
-
-      - name: Check formatting
-        working-directory: cli/python
-        run: ruff format --check .
-
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: ["3.10", "3.11", "3.12"]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install dev dependencies
-        working-directory: cli/python
-        run: pip install -e ".[dev]"
-
-      - name: Run tests
-        working-directory: cli/python
-        run: pytest
-
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.12'
-
-      - name: Install Hatch
-        run: pip install hatch
-
-      - name: Build
-        working-directory: cli/python
-        run: hatch build --clean
-
-      - name: Verify dist output
-        run: |
-          ls cli/python/dist/*.whl || (echo "Wheel file missing" && exit 1)
-          ls cli/python/dist/*.tar.gz || (echo "Source dist missing" && exit 1)
@@ -1,42 +0,0 @@
-name: docs - llms.txt check
-
-# Blocks PRs that introduce new .mdx pages without a matching entry in
-# docs/llms.txt, or that link to pages that no longer exist. Contributors
-# must update docs/llms.txt in the same PR. Run locally with:
-#   python scripts/check-llms-txt-coverage.py           # read-only
-#   python scripts/check-llms-txt-coverage.py --write   # scaffold placeholders
-
-# On PRs this is invoked by ci-gate.yml (the single required check);
-# manual runs remain standalone.
-on:
-  workflow_call:
-  workflow_dispatch: {}
-
-permissions:
-  contents: read
-
-jobs:
-  check-llms-txt:
-    runs-on: ubuntu-24.04-arm
-    timeout-minutes: 2
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Verify docs/llms.txt coverage
-        run: |
-          if ! python3 scripts/check-llms-txt-coverage.py; then
-            echo ""
-            echo "::error title=llms.txt out of sync::docs/llms.txt does not match docs/**/*.mdx."
-            echo ""
-            echo "To fix:"
-            echo "  1. Run locally:  python scripts/check-llms-txt-coverage.py --write"
-            echo "     This appends placeholder entries under '## Unclassified - needs triage'."
-            echo "  2. For each placeholder:"
-            echo "       - replace [TODO: Platform|OSS|Both] with the correct scope tag"
-            echo "       - rewrite the description as 'Use when ...'"
-            echo "       - move the entry into the appropriate section"
-            echo "       - delete the '## Unclassified - needs triage' heading once empty"
-            echo "  3. Resolve any stale URLs listed above by updating or removing the link."
-            echo "  4. Commit the updated docs/llms.txt to this PR."
-            exit 1
-          fi
@@ -12,56 +12,28 @@ jobs:
  label:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
-
      - uses: stefanbuck/github-issue-parser@v3
        id: issue-parser
-        continue-on-error: true
        with:
          template-path: .github/ISSUE_TEMPLATE/bug_report.yml

      - uses: redhat-plumbers-in-action/advanced-issue-labeler@v3
-        continue-on-error: true
        with:
          issue-form: ${{ steps.issue-parser.outputs.jsonString }}
+          section: component
          token: ${{ secrets.GITHUB_TOKEN }}
          config-path: .github/advanced-issue-labeler.yml

-      - name: Infer component from text when the form was not used
-        uses: actions/github-script@v7
+      - uses: stefanbuck/github-issue-parser@v3
+        id: feature-parser
+        if: contains(github.event.issue.labels.*.name, 'enhancement')
        with:
-          script: |
-            const {
-              componentLabels,
-              inferComponentLabels,
-              loadKeywords,
-            } = require(`${process.env.GITHUB_WORKSPACE}/.github/scripts/infer-component-labels.js`);
+          template-path: .github/ISSUE_TEMPLATE/feature_request.yml

-            const { data: issue } = await github.rest.issues.get({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number,
-            });
-
-            const keywords = loadKeywords(`${process.env.GITHUB_WORKSPACE}/.github/component-keywords.json`);
-            const known = componentLabels(keywords);
-            const existing = issue.labels.map((label) => label.name || label);
-            if (existing.some((name) => known.includes(name))) {
-              core.info(`Component label already present: ${existing.join(', ')}`);
-              return;
-            }
-
-            const labels = inferComponentLabels(`${issue.title}\n\n${issue.body || ''}`, keywords);
-
-            if (labels.length === 0) {
-              core.info('No component could be inferred from the issue text');
-              return;
-            }
-
-            core.info(`Inferred: ${labels.join(', ')}`);
-            await github.rest.issues.addLabels({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.issue.number,
-              labels,
-            });
+      - uses: redhat-plumbers-in-action/advanced-issue-labeler@v3
+        if: contains(github.event.issue.labels.*.name, 'enhancement')
+        with:
+          issue-form: ${{ steps.feature-parser.outputs.jsonString }}
+          section: component
+          token: ${{ secrets.GITHUB_TOKEN }}
+          config-path: .github/advanced-issue-labeler.yml
@@ -1,58 +0,0 @@
-name: Mem0 Plugin Checks
-
-# On PRs this is invoked by ci-gate.yml (the single required check);
-# push-to-main and manual runs remain standalone.
-#
-# Covers the Python plugin (scripts/ + tests/). The nested .opencode-plugin/
-# is a separate package with its own workflow (opencode-plugin-checks.yml).
-on:
-  workflow_dispatch:
-  push:
-    branches: [main]
-    paths:
-      - 'integrations/mem0-plugin/**'
-      - '!integrations/mem0-plugin/.opencode-plugin/**'
-      - '.github/workflows/mem0-plugin-checks.yml'
-  workflow_call:
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.10", "3.11", "3.12"]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install dependencies
-        working-directory: integrations/mem0-plugin
-        run: |
-          pip install -r requirements.txt
-          pip install pytest
-
-      - name: Verify hook entry points are executable
-        working-directory: integrations/mem0-plugin
-        run: |
-          missing=$(find scripts -name '*.sh' ! -name '_*' ! -perm -u+x -print)
-          if [ -n "$missing" ]; then
-            echo "Hook entry points must be executable:"
-            echo "$missing"
-            exit 1
-          fi
-
-      - name: Check hook manifests are valid JSON
-        working-directory: integrations/mem0-plugin
-        run: |
-          for f in plugin.json mcp_config.json hooks.json hooks/*.json; do
-            jq empty "$f" || (echo "Invalid JSON: $f" && exit 1)
-          done
-
-      - name: Run tests
-        working-directory: integrations/mem0-plugin
-        run: pytest -q
@@ -1,60 +0,0 @@
-name: Publish n8n-nodes-mem0 📦 to npm
-
-# Dispatched by release.yml (Release Router) when a release tagged
-# n8n-nodes-mem0-v* is published. Can also be dispatched manually to
-# re-publish a tag.
-on:
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: 'Release tag to build and publish (e.g. n8n-nodes-mem0-v0.1.0)'
-        required: true
-        type: string
-      prerelease:
-        description: 'Publish under the version preid dist-tag instead of latest'
-        required: false
-        type: boolean
-        default: false
-
-jobs:
-  build-n-publish:
-    name: Build and publish n8n-nodes-mem0 📦 to npm
-    if: startsWith(inputs.tag, 'n8n-nodes-mem0-v')
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-    defaults:
-      run:
-        working-directory: integrations/n8n-nodes-mem0
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'pnpm'
-          cache-dependency-path: integrations/n8n-nodes-mem0/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile --ignore-scripts
-
-      - name: Build
-        run: pnpm run build
-
-      - name: Publish to npm
-        run: |
-          if [ "${{ inputs.prerelease }}" = "true" ]; then
-            PREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")
-            npx npm@latest publish --provenance --access public --tag "$PREID"
-          else
-            npx npm@latest publish --provenance --access public
-          fi
@@ -1,88 +0,0 @@
-name: n8n-nodes-mem0 checks
-
-# On PRs this is invoked by ci-gate.yml (the single required check);
-# push-to-main and manual runs remain standalone.
-on:
-  workflow_dispatch:
-  push:
-    branches: [main]
-    paths:
-      - 'integrations/n8n-nodes-mem0/**'
-      - '.github/workflows/n8n-nodes-mem0-checks.yml'
-  workflow_call:
-
-jobs:
-  lint:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: 'pnpm'
-          cache-dependency-path: integrations/n8n-nodes-mem0/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: cd integrations/n8n-nodes-mem0 && pnpm install --frozen-lockfile --ignore-scripts
-
-      - name: Lint
-        run: cd integrations/n8n-nodes-mem0 && pnpm run lint
-
-  test:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: 'pnpm'
-          cache-dependency-path: integrations/n8n-nodes-mem0/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: cd integrations/n8n-nodes-mem0 && pnpm install --frozen-lockfile --ignore-scripts
-
-      - name: Run tests
-        run: cd integrations/n8n-nodes-mem0 && pnpm test
-
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: 'pnpm'
-          cache-dependency-path: integrations/n8n-nodes-mem0/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: cd integrations/n8n-nodes-mem0 && pnpm install --frozen-lockfile --ignore-scripts
-
-      - name: Build
-        run: cd integrations/n8n-nodes-mem0 && pnpm run build
-
-      - name: Verify dist output exists
-        run: |
-          test -f integrations/n8n-nodes-mem0/dist/nodes/Mem0/Mem0.node.js || (echo "Build output missing: dist/nodes/Mem0/Mem0.node.js" && exit 1)
-          test -f integrations/n8n-nodes-mem0/dist/credentials/Mem0Api.credentials.js || (echo "Build output missing: dist/credentials/Mem0Api.credentials.js" && exit 1)
-          test -f integrations/n8n-nodes-mem0/dist/nodes/Mem0/mem0.svg || (echo "Build output missing: dist/nodes/Mem0/mem0.svg" && exit 1)
@@ -1,60 +0,0 @@
-name: Publish @mem0/openclaw-mem0 📦 to npm
-
-# Dispatched by release.yml (Release Router) when a release tagged
-# openclaw-v* is published. Can also be dispatched manually to re-publish
-# a tag.
-on:
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: 'Release tag to build and publish (e.g. openclaw-v0.5.0)'
-        required: true
-        type: string
-      prerelease:
-        description: 'Publish under the version preid dist-tag instead of latest'
-        required: false
-        type: boolean
-        default: false
-
-jobs:
-  build-n-publish:
-    name: Build and publish @mem0/openclaw-mem0 📦 to npm
-    if: startsWith(inputs.tag, 'openclaw-v')
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-    defaults:
-      run:
-        working-directory: integrations/openclaw
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'pnpm'
-          cache-dependency-path: integrations/openclaw/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Build
-        run: pnpm build
-
-      - name: Publish to npm
-        run: |
-          if [ "${{ inputs.prerelease }}" = "true" ]; then
-            PREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")
-            npx npm@latest publish --provenance --access public --tag "$PREID"
-          else
-            npx npm@latest publish --provenance --access public
-          fi
@@ -1,15 +1,16 @@
 name: openclaw checks

-# On PRs this is invoked by ci-gate.yml (the single required check);
-# push-to-main and manual runs remain standalone.
 on:
  workflow_dispatch:
  push:
    branches: [main]
    paths:
-      - 'integrations/openclaw/**'
+      - 'openclaw/**'
+      - '.github/workflows/openclaw-checks.yml'
+  pull_request:
+    paths:
+      - 'openclaw/**'
      - '.github/workflows/openclaw-checks.yml'
-  workflow_call:

 jobs:
  lint:
@@ -27,13 +28,13 @@ jobs:
        with:
          node-version: 20
          cache: 'pnpm'
-          cache-dependency-path: integrations/openclaw/pnpm-lock.yaml
+          cache-dependency-path: openclaw/pnpm-lock.yaml

      - name: Install dependencies
-        run: cd integrations/openclaw && pnpm install --frozen-lockfile
+        run: cd openclaw && pnpm install --frozen-lockfile

      - name: Type check
-        run: cd integrations/openclaw && pnpm exec tsc --noEmit
+        run: cd openclaw && pnpm exec tsc --noEmit

  test:
    runs-on: ubuntu-latest
@@ -53,20 +54,20 @@ jobs:
        with:
          node-version: ${{ matrix.node-version }}
          cache: 'pnpm'
-          cache-dependency-path: integrations/openclaw/pnpm-lock.yaml
+          cache-dependency-path: openclaw/pnpm-lock.yaml

      - name: Install dependencies
-        run: cd integrations/openclaw && pnpm install --frozen-lockfile
+        run: cd openclaw && pnpm install --frozen-lockfile

      - name: Run tests with coverage
-        run: cd integrations/openclaw && pnpm exec vitest run --coverage
+        run: cd openclaw && pnpm exec vitest run --coverage

      - name: Upload coverage to Codecov
        if: matrix.node-version == 20
        uses: codecov/codecov-action@v4
        with:
          flags: openclaw
-          directory: integrations/openclaw/coverage
+          directory: openclaw/coverage
        env:
          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

@@ -85,15 +86,15 @@ jobs:
        with:
          node-version: 20
          cache: 'pnpm'
-          cache-dependency-path: integrations/openclaw/pnpm-lock.yaml
+          cache-dependency-path: openclaw/pnpm-lock.yaml

      - name: Install dependencies
-        run: cd integrations/openclaw && pnpm install --frozen-lockfile
+        run: cd openclaw && pnpm install --frozen-lockfile

      - name: Build
-        run: cd integrations/openclaw && pnpm build
+        run: cd openclaw && pnpm build

      - name: Verify dist output exists
        run: |
-          test -f integrations/openclaw/dist/index.js || (echo "Build output missing: dist/index.js" && exit 1)
-          test -f integrations/openclaw/dist/index.d.ts || (echo "Build output missing: dist/index.d.ts" && exit 1)
+          test -f openclaw/dist/index.js || (echo "Build output missing: dist/index.js" && exit 1)
+          test -f openclaw/dist/index.d.ts || (echo "Build output missing: dist/index.d.ts" && exit 1)
@@ -1,58 +0,0 @@
-name: Publish @mem0/opencode-plugin 📦 to npm
-
-# Dispatched by release.yml (Release Router) when a release tagged
-# opencode-v* is published. Can also be dispatched manually to re-publish
-# a tag.
-on:
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: 'Release tag to build and publish (e.g. opencode-v0.2.0)'
-        required: true
-        type: string
-      prerelease:
-        description: 'Publish under the version preid dist-tag instead of latest'
-        required: false
-        type: boolean
-        default: false
-
-jobs:
-  build-n-publish:
-    name: Build and publish @mem0/opencode-plugin 📦 to npm
-    if: startsWith(inputs.tag, 'opencode-v')
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-    defaults:
-      run:
-        working-directory: integrations/mem0-plugin/.opencode-plugin
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}
-
-      - name: Install Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Build
-        run: bun run build
-
-      - name: Publish to npm
-        run: |
-          if [ "${{ inputs.prerelease }}" = "true" ]; then
-            PREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")
-            npx npm@latest publish --provenance --access public --tag "$PREID"
-          else
-            npx npm@latest publish --provenance --access public
-          fi
@@ -1,39 +0,0 @@
-name: opencode-plugin checks
-
-# On PRs this is invoked by ci-gate.yml (the single required check);
-# push-to-main and manual runs remain standalone.
-on:
-  workflow_dispatch:
-  push:
-    branches: [main]
-    paths:
-      - 'integrations/mem0-plugin/.opencode-plugin/**'
-      - '.github/workflows/opencode-plugin-checks.yml'
-  workflow_call:
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: integrations/mem0-plugin/.opencode-plugin
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install Bun
-        uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-
-      - name: Install dependencies
-        run: bun install --frozen-lockfile
-
-      - name: Type check
-        run: bun run type-check
-
-      - name: Build
-        run: bun run build
-
-      - name: Verify dist output exists
-        run: |
-          test -f dist/index.js || (echo "Build output missing: dist/index.js" && exit 1)
@@ -1,60 +0,0 @@
-name: Publish @mem0/pi-agent-plugin 📦 to npm
-
-# Dispatched by release.yml (Release Router) when a release tagged
-# pi-agent-v* is published. Can also be dispatched manually to re-publish
-# a tag.
-on:
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: 'Release tag to build and publish (e.g. pi-agent-v0.1.1)'
-        required: true
-        type: string
-      prerelease:
-        description: 'Publish under the version preid dist-tag instead of latest'
-        required: false
-        type: boolean
-        default: false
-
-jobs:
-  build-n-publish:
-    name: Build and publish @mem0/pi-agent-plugin 📦 to npm
-    if: startsWith(inputs.tag, 'pi-agent-v')
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-    defaults:
-      run:
-        working-directory: integrations/pi-agent-plugin
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'pnpm'
-          cache-dependency-path: integrations/pi-agent-plugin/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Build
-        run: pnpm build
-
-      - name: Publish to npm
-        run: |
-          if [ "${{ inputs.prerelease }}" = "true" ]; then
-            PREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")
-            npx npm@latest publish --provenance --access public --tag "$PREID"
-          else
-            npx npm@latest publish --provenance --access public
-          fi
@@ -1,92 +0,0 @@
-name: pi-agent-plugin checks
-
-# On PRs this is invoked by ci-gate.yml (the single required check);
-# push-to-main and manual runs remain standalone.
-on:
-  workflow_dispatch:
-  push:
-    branches: [main]
-    paths:
-      - 'integrations/pi-agent-plugin/**'
-      - '.github/workflows/pi-agent-plugin-checks.yml'
-  workflow_call:
-
-jobs:
-  lint:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: 'pnpm'
-          cache-dependency-path: integrations/pi-agent-plugin/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: cd integrations/pi-agent-plugin && pnpm install --frozen-lockfile
-
-      - name: Type check
-        run: cd integrations/pi-agent-plugin && pnpm exec tsc --noEmit
-
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [20, 22]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: Setup Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: 'pnpm'
-          cache-dependency-path: integrations/pi-agent-plugin/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: cd integrations/pi-agent-plugin && pnpm install --frozen-lockfile
-
-      - name: Run tests
-        run: cd integrations/pi-agent-plugin && pnpm exec vitest run
-
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 20
-          cache: 'pnpm'
-          cache-dependency-path: integrations/pi-agent-plugin/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: cd integrations/pi-agent-plugin && pnpm install --frozen-lockfile
-
-      - name: Build
-        run: cd integrations/pi-agent-plugin && pnpm build
-
-      - name: Verify dist output exists
-        run: |
-          test -f integrations/pi-agent-plugin/dist/index.js || (echo "Build output missing: dist/index.js" && exit 1)
-          test -f integrations/pi-agent-plugin/dist/index.d.ts || (echo "Build output missing: dist/index.d.ts" && exit 1)
-          test -f integrations/pi-agent-plugin/dist/entry.js || (echo "Build output missing: dist/entry.js" && exit 1)
-          test -f integrations/pi-agent-plugin/dist/entry.d.ts || (echo "Build output missing: dist/entry.d.ts" && exit 1)
@@ -1,64 +0,0 @@
-name: PR Labeler
-
-on:
-  pull_request_target:
-    types: [opened, synchronize, reopened, edited]
-
-concurrency:
-  group: pr-labeler-${{ github.event.pull_request.number }}
-  cancel-in-progress: true
-
-permissions:
-  contents: read
-  pull-requests: write
-  issues: read
-
-jobs:
-  label:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/labeler@v5
-        with:
-          repo-token: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Propagate labels from linked issues
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const allowed = new Set([
-              'sdk-python', 'sdk-typescript', 'vector-store', 'plugin',
-              'rest-api', 'documentation', 'ci', 'cli', 'integrations',
-            ]);
-            const umbrella = { plugin: 'integrations' };
-            const { repository } = await github.graphql(
-              `query ($owner: String!, $repo: String!, $number: Int!) {
-                repository(owner: $owner, name: $repo) {
-                  pullRequest(number: $number) {
-                    closingIssuesReferences(first: 20) {
-                      nodes { labels(first: 50) { nodes { name } } }
-                    }
-                  }
-                }
-              }`,
-              { owner: context.repo.owner, repo: context.repo.repo, number: context.issue.number },
-            );
-
-            const labels = new Set();
-            for (const issue of repository.pullRequest.closingIssuesReferences.nodes) {
-              for (const label of issue.labels.nodes) {
-                if (allowed.has(label.name)) labels.add(label.name);
-              }
-            }
-
-            for (const label of [...labels]) {
-              if (umbrella[label]) labels.add(umbrella[label]);
-            }
-
-            if (labels.size > 0) {
-              await github.rest.issues.addLabels({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: context.issue.number,
-                labels: [...labels],
-              });
-            }
@@ -1,69 +0,0 @@
-name: Release Router 🚦
-
-# Single entry point for all release publishing.
-#
-# Package CD workflows no longer listen to release events themselves — this
-# router inspects the release tag and dispatches only the matching pipeline,
-# so each release produces one routed run instead of one real run plus seven
-# skipped ones.
-#
-# Re-publishing a release (e.g. after fixing registry settings) does NOT
-# require deleting and recreating it anymore — manually dispatch the
-# package's CD workflow from the tag instead:
-#
-#   gh workflow run <package>-cd.yml --ref refs/tags/<tag> -f tag=<tag>
-#
-# Note: dispatching runs the workflow file as it exists at the given ref, so
-# this router can only dispatch tags created after the workflow_dispatch
-# conversion landed on main. For older tags, dispatch manually from main.
-
-on:
-  release:
-    types: [published]
-
-permissions:
-  actions: write
-
-jobs:
-  route:
-    name: Route ${{ github.event.release.tag_name }} to its CD pipeline
-    runs-on: ubuntu-latest
-    steps:
-      - name: Match tag prefix to CD workflow
-        id: match
-        env:
-          TAG: ${{ github.event.release.tag_name }}
-        run: |
-          # Specific package prefixes first; the bare v* (Python SDK) arm
-          # must stay last so prefixed tags that also start with 'v'
-          # (vercel-ai-v*) can never be routed to the Python pipeline.
-          case "$TAG" in
-            ts-v*)        workflow="ts-sdk-cd.yml" ;;
-            cli-node-v*)  workflow="cli-node-cd.yml" ;;
-            cli-v*)       workflow="cli-python-cd.yml" ;;
-            vercel-ai-v*) workflow="vercel-ai-cd.yml" ;;
-            openclaw-v*)  workflow="openclaw-cd.yml" ;;
-            opencode-v*)  workflow="opencode-plugin-cd.yml" ;;
-            pi-agent-v*)  workflow="pi-agent-plugin-cd.yml" ;;
-            n8n-nodes-mem0-v*) workflow="n8n-nodes-mem0-cd.yml" ;;
-            v*)           workflow="cd.yml" ;;
-            *)
-              echo "::error::Release tag '$TAG' does not match any known package prefix — nothing will be published. See the tag prefix table in AGENTS.md."
-              exit 1
-              ;;
-          esac
-          echo "workflow=$workflow" >> "$GITHUB_OUTPUT"
-          echo ":outbox_tray: Routed \`$TAG\` → \`$workflow\`" >> "$GITHUB_STEP_SUMMARY"
-
-      - name: Dispatch ${{ steps.match.outputs.workflow }}
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          TAG: ${{ github.event.release.tag_name }}
-        run: |
-          # --ref points at the tag so the dispatched run builds (and signs
-          # provenance for) the exact tagged commit.
-          gh workflow run "${{ steps.match.outputs.workflow }}" \
-            --repo "$GITHUB_REPOSITORY" \
-            --ref "refs/tags/$TAG" \
-            -f tag="$TAG" \
-            -f prerelease="${{ github.event.release.prerelease }}"
@@ -1,59 +0,0 @@
-name: Publish mem0ai 📦 to npm
-
-# Dispatched by release.yml (Release Router) when a release tagged ts-v* is
-# published. Can also be dispatched manually to re-publish a tag.
-on:
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: 'Release tag to build and publish (e.g. ts-v2.1.0)'
-        required: true
-        type: string
-      prerelease:
-        description: 'Publish under the version preid dist-tag instead of latest'
-        required: false
-        type: boolean
-        default: false
-
-jobs:
-  build-n-publish:
-    name: Build and publish mem0ai 📦 to npm
-    if: startsWith(inputs.tag, 'ts-v')
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-    defaults:
-      run:
-        working-directory: mem0-ts
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'pnpm'
-          cache-dependency-path: mem0-ts/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Build
-        run: pnpm run build
-
-      - name: Publish to npm
-        run: |
-          if [ "${{ inputs.prerelease }}" = "true" ]; then
-            PREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")
-            npx npm@latest publish --provenance --access public --tag "$PREID"
-          else
-            npx npm@latest publish --provenance --access public
-          fi
@@ -1,14 +1,14 @@
 name: TypeScript SDK CI

-# On PRs this is invoked by ci-gate.yml (the single required check);
-# push-to-main runs remain standalone.
 on:
  push:
    branches: [main]
    paths:
      - 'mem0-ts/**'
      - '.github/workflows/ts-sdk-ci.yml'
-  workflow_call:
+  pull_request:
+    paths:
+      - 'mem0-ts/**'

 jobs:
  check_changes:
@@ -24,42 +24,6 @@ jobs:
            ts_sdk:
              - 'mem0-ts/**'

-  changelog_check:
-    needs: check_changes
-    if: github.event_name == 'pull_request' && needs.check_changes.outputs.ts_sdk_changed == 'true'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Require CHANGELOG entry when SDK version changes
-        env:
-          BASE_SHA: ${{ github.event.pull_request.base.sha }}
-          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
-        run: |
-          set -euo pipefail
-
-          base_version=$(git show "$BASE_SHA:mem0-ts/package.json" 2>/dev/null | jq -r .version || echo "")
-          head_version=$(jq -r .version mem0-ts/package.json)
-
-          echo "Base version: ${base_version:-<unknown>}"
-          echo "Head version: $head_version"
-
-          if [ -z "$base_version" ] || [ "$base_version" = "$head_version" ]; then
-            echo "mem0-ts/package.json version unchanged — no CHANGELOG entry required."
-            exit 0
-          fi
-
-          echo "Detected version bump ${base_version} -> ${head_version}. Checking docs/changelog/sdk.mdx…"
-
-          if git diff --name-only "$BASE_SHA" "$HEAD_SHA" -- docs/changelog/sdk.mdx | grep -q .; then
-            echo "Changelog update present in docs/changelog/sdk.mdx ✅"
-          else
-            echo "::error file=mem0-ts/package.json::mem0-ts/package.json version changed from ${base_version} to ${head_version} but docs/changelog/sdk.mdx was not updated in this PR. Add a new <Update> entry under the TypeScript tab for v${head_version}."
-            exit 1
-          fi
-
  build_ts_sdk:
    needs: check_changes
    if: needs.check_changes.outputs.ts_sdk_changed == 'true'
@@ -1,60 +0,0 @@
-name: Publish @mem0/vercel-ai-provider 📦 to npm
-
-# Dispatched by release.yml (Release Router) when a release tagged
-# vercel-ai-v* is published. Can also be dispatched manually to re-publish
-# a tag.
-on:
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: 'Release tag to build and publish (e.g. vercel-ai-v2.0.7)'
-        required: true
-        type: string
-      prerelease:
-        description: 'Publish under the version preid dist-tag instead of latest'
-        required: false
-        type: boolean
-        default: false
-
-jobs:
-  build-n-publish:
-    name: Build and publish @mem0/vercel-ai-provider 📦 to npm
-    if: startsWith(inputs.tag, 'vercel-ai-v')
-    runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-    defaults:
-      run:
-        working-directory: integrations/vercel-ai-sdk
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 10
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22'
-          registry-url: 'https://registry.npmjs.org'
-          cache: 'pnpm'
-          cache-dependency-path: integrations/vercel-ai-sdk/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Build
-        run: pnpm run build
-
-      - name: Publish to npm
-        run: |
-          if [ "${{ inputs.prerelease }}" = "true" ]; then
-            PREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")
-            npx npm@latest publish --provenance --access public --tag "$PREID"
-          else
-            npx npm@latest publish --provenance --access public
-          fi
@@ -1,42 +0,0 @@
-name: Deploy zapier-mem0 to Zapier
-
-# Zapier apps deploy to Zapier's own platform (not npm), so this is NOT wired
-# into the npm release router (release.yml). It is manual workflow_dispatch
-# only and requires the ZAPIER_DEPLOY_KEY repo secret.
-#
-#   gh workflow run zapier-mem0-cd.yml --ref main
-on:
-  workflow_dispatch:
-
-jobs:
-  push:
-    name: Push zapier-mem0 to Zapier
-    runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: integrations/zapier-mem0
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: 'pnpm'
-          cache-dependency-path: integrations/zapier-mem0/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Build TypeScript
-        run: pnpm build
-
-      - name: Push to Zapier
-        env:
-          ZAPIER_DEPLOY_KEY: ${{ secrets.ZAPIER_DEPLOY_KEY }}
-        run: npx zapier-platform-cli@19 push
@@ -1,47 +0,0 @@
-name: zapier-mem0 checks
-
-# On PRs this is invoked by ci-gate.yml (the single required check);
-# push-to-main and manual runs remain standalone.
-#
-# CI compiles the TypeScript app, runs `zapier validate` (offline schema + style
-# checks) against the build, plus the offline jest unit suite (test/unit.test.ts —
-# mocked z.request, no network). The end-to-end jest suite is skipped here because
-# it hits the live Mem0 API — it runs locally with MEM0_API_KEY set (see README).
-on:
-  workflow_dispatch:
-  push:
-    branches: [main]
-    paths:
-      - 'integrations/zapier-mem0/**'
-      - '.github/workflows/zapier-mem0-checks.yml'
-  workflow_call:
-
-jobs:
-  validate:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: 'pnpm'
-          cache-dependency-path: integrations/zapier-mem0/pnpm-lock.yaml
-
-      - name: Install dependencies
-        run: cd integrations/zapier-mem0 && pnpm install --frozen-lockfile
-
-      - name: Build TypeScript
-        run: cd integrations/zapier-mem0 && pnpm build
-
-      - name: Validate Zapier app definition
-        run: cd integrations/zapier-mem0 && npx zapier-platform-cli@19 validate
-
-      - name: Run offline unit tests
-        run: cd integrations/zapier-mem0 && pnpm test:unit
@@ -4,10 +4,6 @@ __pycache__/
 *$py.class
 **/node_modules/

-# Self-hosted server local runtime state
-server/history/
-server/.env
-
 # C extensions
 *.so

@@ -19,8 +15,8 @@ dist/
 downloads/
 eggs/
 .eggs/
-/lib/
-/lib64/
+lib/
+lib64/
 parts/
 sdist/
 var/
@@ -170,6 +166,7 @@ cython_debug/
 # Database
 db
 test-db
+!embedchain/embedchain/core/db/

 .vscode
 .idea/
@@ -189,5 +186,3 @@ eval/
 qdrant_storage/
 .crossnote
 testing.ipynb
-.weave/
-
@@ -1,4 +0,0 @@
-[submodule "evaluation"]
-	path = evaluation
-	url = https://github.com/mem0ai/memory-benchmarks
-	branch = main
@@ -1,15 +0,0 @@
-{
-  "name": "mem0-plugins",
-  "version": "1",
-  "plugins": [
-    {
-      "id": "mem0",
-      "displayName": "Mem0",
-      "version": "0.1.0",
-      "description": "Persistent memory for Kimi Code. Remembers decisions, patterns, and preferences across sessions.",
-      "homepage": "https://mem0.ai",
-      "keywords": ["memory", "personalization", "mcp", "semantic-search"],
-      "source": "https://github.com/mem0ai/mem0/tree/main/integrations/mem0-plugin"
-    }
-  ]
-}
@@ -1,593 +0,0 @@
-# AGENTS.md
-
-This file provides context for AI coding assistants (Claude Code, Cursor, GitHub Copilot, Codex, etc.) working with the Mem0 repository.
-
-## Project Overview
-
-**Mem0** ("mem-zero") is an intelligent memory layer for AI agents and assistants. It provides persistent, personalized memory via both a hosted platform API and self-hosted open-source SDKs.
-
- **Repository**: https://github.com/mem0ai/mem0
- **Documentation**: https://docs.mem0.ai
- **License**: Apache-2.0
-
-## Repository Structure
-
-This is a **polyglot monorepo** containing Python and TypeScript packages, CLIs, servers, plugins, and documentation.
-
-### Key Directories
-
-| Directory | Description |
-|-----------|-------------|
-| `mem0/` | Core Python SDK (`mem0ai` on PyPI) — memory, LLMs, embeddings, vector stores, graphs, rerankers |
-| `mem0-ts/` | TypeScript SDK (`mem0ai` on npm) — client + OSS memory |
-| `cli/python/` | Python CLI (`mem0-cli` on PyPI) — Typer-based, entry point `mem0` |
-| `cli/node/` | Node CLI (`@mem0/cli` on npm) — Commander-based, entry point `mem0` |
-| `integrations/` | **Agent & editor integrations**, one directory per integration (see "Adding a New Integration") |
-| `integrations/mem0-plugin/` | AI editor plugins (Claude Code, Cursor, Codex) — MCP server connection, lifecycle hooks, skills. Contains nested `.opencode-plugin/` (`@mem0/opencode-plugin`) |
-| `integrations/openclaw/` | `@mem0/openclaw-mem0` — OpenClaw plugin for Claude Code / AI editors |
-| `integrations/pi-agent-plugin/` | `@mem0/pi-agent-plugin` — Pi Agent plugin |
-| `integrations/vercel-ai-sdk/` | `@mem0/vercel-ai-provider` — Vercel AI SDK memory provider |
-| `integrations/n8n-nodes-mem0/` | `@mem0/n8n-nodes-mem0` — n8n community node; add / search / get / update / delete memories |
-| `integrations/zapier-mem0/` | `@mem0/zapier` — Zapier Platform CLI app (deploys to Zapier, not npm); add / search / get / delete memories |
-| `server/` | FastAPI REST server for self-hosted Mem0 (Docker: FastAPI + PostgreSQL/pgvector + Neo4j) |
-| `skills/` | Claude Code skill definitions. Reference skills (SDK knowledge, always-on): `mem0/`, `mem0-cli/`, `mem0-vercel-ai-sdk/`. Pipeline skills (run on demand): `mem0-integrate/`, `mem0-test-integration/`, `mem0-oss-to-platform/` |
-| `docs/` | Documentation site (Mintlify) |
-| `tests/` | Python SDK tests (pytest) |
-| `evaluation/` | Submodule → [`mem0ai/memory-benchmarks`](https://github.com/mem0ai/memory-benchmarks) — benchmarking (LOCOMO, LongMemEval, BEAM) lives in that repo |
-| `examples/` | Sample projects & runnable demos — apps, Chrome extension, multi-agent patterns, and Jupyter notebooks (`notebooks/`) |
-| `pr-reviews/` | Pull request review materials |
-| `scripts/` | Repo-wide utility scripts (e.g., `check-llms-txt-coverage.py` for docs/llms.txt sync) |
-
-### Core Package Dependencies
-
-```
-mem0 (Python SDK)          mem0-ts (TypeScript SDK)
-├── mem0/memory/           ├── src/client/        (MemoryClient — hosted)
-├── mem0/llms/             └── src/oss/           (Memory — self-hosted)
-├── mem0/embeddings/           ├── src/llms/
-├── mem0/vector_stores/        ├── src/embeddings/
-├── mem0/graphs/               ├── src/vector_stores/
-└── mem0/reranker/             └── src/graphs/
-
-cli/python/ ──▶ mem0ai (optional, for OSS mode)
-cli/node/   ──▶ mem0ai (npm, for API calls)
-integrations/vercel-ai-sdk/ ──▶ ai, @ai-sdk/* providers
-integrations/openclaw/ ──▶ mem0ai (npm)
-```
-
-## Development Setup
-
-### Requirements
-
- **Python**: 3.9+ (3.10+ for CLI)
- **Node.js**: v18+ (v20 or v22 recommended)
- **pnpm**: v10+ (`npm install -g pnpm@10`) — used for all TypeScript packages
- **Hatch**: Python build/environment tool (`pip install hatch`)
- **Docker**: Required for `server/` development
-
-### Initial Setup
-
-```bash
-# Python SDK
-hatch shell dev_py_3_11           # creates environment with all deps
-pre-commit install                # install git hooks
-
-# TypeScript packages
-cd mem0-ts && pnpm install        # TS SDK
-cd cli/node && pnpm install       # Node CLI
-cd integrations/vercel-ai-sdk && pnpm install  # Vercel AI provider
-cd integrations/openclaw && pnpm install       # OpenClaw plugin
-```
-
-## Build, Lint, and Test Commands
-
-### Python SDK (`mem0/`)
-
-```bash
-# Environment setup (uses Hatch)
-hatch shell dev_py_3_11           # or dev_py_3_9, dev_py_3_10, dev_py_3_12
-
-# Linting and formatting
-make lint                          # ruff check
-make format                        # ruff format
-make sort                          # isort mem0/
-
-# Tests
-make test                          # pytest tests/
-make test-py-3.9                   # test specific Python version (3.9–3.12)
-
-# Build and publish
-make build                         # hatch build
-make publish                       # hatch publish
-```
-
- **Python:** 3.9, 3.10, 3.11, 3.12
- **Linter/formatter:** Ruff (line length **120**)
- **Import sorting:** isort (`profile = "black"`)
- **Test framework:** pytest (with pytest-mock, pytest-asyncio)
- **Pre-commit hooks:** ruff + isort — run `pre-commit install` before committing
-
-### TypeScript SDK (`mem0-ts/`)
-
-```bash
-cd mem0-ts
-pnpm install
-pnpm run build                     # tsup
-pnpm run test                      # jest (all tests)
-pnpm run test:unit                 # jest --coverage (unit tests only)
-pnpm run test:integration          # jest (integration tests, needs MEM0_API_KEY)
-pnpm run test:ci                   # jest --coverage --ci (CI mode)
-pnpm run test:watch                # jest watch mode
-```
-
- **Node:** 20, 22 (CI-tested)
- **Build:** tsup (CJS + ESM)
- **Test:** jest
- **Formatter:** prettier
-
-### Python CLI (`cli/python/`)
-
-```bash
-cd cli/python
-pip install -e ".[dev]"            # dev install with ruff + pytest
-ruff check .                       # lint
-ruff format .                      # format
-pytest                             # test
-hatch build                        # build
-```
-
- **Python:** 3.10+ (not 3.9)
- **Linter/formatter:** Ruff (line length **100** — different from root SDK)
- **Ruff rules:** E, F, I, W, UP, B, SIM, RUF (ignores E501, B008 for Typer patterns, SIM108)
- **Framework:** Typer + Rich + httpx
- **Entry point:** `mem0 = "mem0_cli.app:main"`
- **Source layout:** `src/mem0_cli/`
- **Optional dependency:** `mem0ai` (for OSS mode, via `[oss]` extra)
-
-### Node CLI (`cli/node/`)
-
-```bash
-cd cli/node
-pnpm install
-pnpm run build                     # tsup
-pnpm run lint                      # biome check src/
-pnpm run lint:fix                  # biome check --write src/
-pnpm run typecheck                 # tsc --noEmit
-pnpm run test                      # vitest run
-pnpm run test:watch                # vitest (watch mode)
-pnpm run dev                       # tsx src/index.ts (development)
-```
-
- **Node:** 18+ required
- **Build:** tsup (ESM)
- **Linter:** Biome (not ESLint, not Ruff)
- **Test:** vitest (not jest)
- **Framework:** Commander + Chalk + ora + cli-table3
-
-### Vercel AI SDK Provider (`integrations/vercel-ai-sdk/`)
-
-```bash
-cd integrations/vercel-ai-sdk
-pnpm install
-pnpm run build                     # tsup
-pnpm run lint                      # eslint
-pnpm run type-check                # tsc --noEmit
-pnpm run prettier-check            # prettier --check
-pnpm run test                      # jest
-pnpm run test:edge                 # vitest (edge runtime)
-pnpm run test:node                 # vitest (node runtime)
-```
-
- **Build:** tsup (CJS + ESM)
- **Lint:** ESLint + Prettier
- **Test:** jest + vitest (edge/node configs)
-
-### OpenClaw Plugin (`integrations/openclaw/`)
-
-```bash
-cd integrations/openclaw
-pnpm install
-pnpm run build                     # tsup
-pnpm run test                      # vitest run
-```
-
- **Build:** tsup (ESM)
- **Test:** vitest (with Codecov in CI)
- **Plugin manifest:** `openclaw.plugin.json`
-
-### Server (`server/`)
-
-```bash
-# Docker production build
-cd server
-make build                         # docker build -t mem0-api-server .
-make run_local                     # docker run -p 8000:8000 with .env
-
-# Docker Compose development (FastAPI + PostgreSQL/pgvector + Neo4j)
-cd server
-docker-compose up                  # starts all 3 services
-# mem0 API: localhost:8888
-# PostgreSQL: localhost:8432
-# Neo4j HTTP: localhost:8474, Bolt: localhost:8687
-```
-
- **Framework:** FastAPI with uvicorn (auto-reload in dev)
- **Services:** PostgreSQL with pgvector, Neo4j 5.x with APOC plugin
- **Hot reload:** Dev Dockerfile mounts `server/` and `mem0/` for live changes
-
-### Documentation (`docs/`)
-
-```bash
-make docs                          # or: cd docs && mintlify dev
-```
-
- **Framework:** Mintlify
- **API spec:** `docs/openapi.json`
- **Structure:** `api-reference/`, `open-source/`, `platform/`, `integrations/`, `cookbooks/`, `core-concepts/`
-
-### Evaluation / Benchmarking
-
-Benchmarking lives in the external [`mem0ai/memory-benchmarks`](https://github.com/mem0ai/memory-benchmarks) repo (LOCOMO + LongMemEval + BEAM). The in-repo `evaluation/` path is a **git submodule** pinned to that repo's `main` — populate it with `git submodule update --init evaluation` (or clone mem0 with `--recurse-submodules`), or clone the benchmarks repo standalone:
-
-```bash
-git clone https://github.com/mem0ai/memory-benchmarks.git
-cd memory-benchmarks
-pip install -r requirements.txt
-
-# Run a benchmark (Mem0 Cloud; use docker compose for OSS)
-python -m benchmarks.locomo.run --project-name my-test --backend cloud --mem0-api-key $MEM0_API_KEY
-python -m benchmarks.longmemeval.run --project-name my-test --backend cloud --mem0-api-key $MEM0_API_KEY --all-questions
-python -m benchmarks.beam.run --project-name my-test --backend cloud --mem0-api-key $MEM0_API_KEY --chat-sizes 100K --conversations 0-9
-```
-
-## Core APIs
-
-### Python
-
-| Function / Class | Purpose | Import |
-|-----------------|---------|--------|
-| `Memory` | Self-hosted memory (sync) | `from mem0 import Memory` |
-| `AsyncMemory` | Self-hosted memory (async) | `from mem0 import AsyncMemory` |
-| `MemoryClient` | Hosted platform client (sync) | `from mem0 import MemoryClient` |
-| `AsyncMemoryClient` | Hosted platform client (async) | `from mem0 import AsyncMemoryClient` |
-
-**Key `Memory` / `MemoryClient` methods:**
-
-| Method | Purpose |
-|--------|---------|
-| `add(messages, *, user_id, agent_id, run_id, metadata)` | Store a new memory |
-| `search(query, *, user_id, agent_id, run_id, limit, filters)` | Search memories |
-| `get(memory_id)` | Retrieve a single memory by ID |
-| `get_all(*, user_id, agent_id, run_id, limit)` | List all memories |
-| `update(memory_id, data)` | Update a memory |
-| `delete(memory_id)` | Delete a memory |
-| `delete_all(*, user_id, agent_id, run_id)` | Delete all memories |
-| `history(memory_id)` | Get change history for a memory |
-
-### TypeScript
-
-| Export | Purpose | Import |
-|--------|---------|--------|
-| `MemoryClient` | Hosted platform client | `import { MemoryClient } from 'mem0ai'` |
-| `Memory` | Self-hosted OSS memory | `import { Memory } from 'mem0ai/oss'` |
-
-## Import Patterns
-
-### Python
-
-| What | Import |
-|------|--------|
-| Core memory classes | `from mem0 import Memory, AsyncMemory` |
-| Platform client | `from mem0 import MemoryClient, AsyncMemoryClient` |
-| Configuration | `from mem0.configs.base import MemoryConfig` |
-| LLM providers | `from mem0.llms.<provider> import <ProviderLLM>` |
-| Embedding providers | `from mem0.embeddings.<provider> import <ProviderEmbedding>` |
-| Vector store providers | `from mem0.vector_stores.<provider> import <ProviderVectorStore>` |
-
-### TypeScript
-
-| What | Import |
-|------|--------|
-| Hosted client | `import { MemoryClient } from 'mem0ai'` |
-| OSS memory | `import { Memory } from 'mem0ai/oss'` |
-| Specific providers (OSS) | `import { OpenAIEmbedding } from 'mem0ai/oss'` |
-
-## Coding Standards
-
-### File Naming Conventions
-
- **Python source files:** `snake_case.py` (e.g., `azure_openai.py`, `cohere_reranker.py`)
- **Python test files:** `test_<module>.py` (e.g., `test_memory.py`, `test_main.py`)
- **TypeScript source files:** `snake_case.ts` (e.g., `azure_ai_search.ts`)
- **TypeScript test files:** `<module>.test.ts` (e.g., `memory.test.ts`)
- **Config/manifest files:** `kebab-case` (e.g., `openclaw.plugin.json`, `jest.config.js`)
-
-### Python Conventions
-
- **Provider pattern:** All providers (LLMs, embeddings, vector stores, graphs, rerankers) inherit from a `base.py` abstract class in their directory. Config classes live in `configs.py`.
- **Pydantic v2** for all data models and configuration.
- **Ruff** is the single linting and formatting tool — no black, no flake8.
-  - Root SDK: line length **120**
-  - Python CLI: line length **100** with extended rule set (UP, B, SIM, RUF)
- **isort** with `profile = "black"` for import sorting.
-
-### TypeScript Conventions
-
- **Build:** tsup across all packages.
- **Package manager:** pnpm everywhere (no npm, no yarn).
- **TypeScript strict mode** across all packages.
- **Linting varies by package:**
-
-| Package | Linter | Formatter | Test Framework |
-|---------|--------|-----------|---------------|
-| `mem0-ts/` | — | Prettier | jest |
-| `cli/node/` | Biome | Biome | vitest |
-| `integrations/vercel-ai-sdk/` | ESLint | Prettier | jest + vitest |
-| `integrations/openclaw/` | — | — | vitest |
-
-### Type Checking
-
-Always run type checking after modifying TypeScript code:
-
-```bash
-cd <package> && pnpm run typecheck    # or: tsc --noEmit
-```
-
-## Architecture
-
-### Provider Pattern
-
-The SDK uses a consistent plugin architecture across 5 categories. Each category has a `base.py` abstract class and concrete provider implementations:
-
-| Category | Count | Examples |
-|----------|-------|---------|
-| **LLMs** | 24 | OpenAI, Anthropic, AWS Bedrock, Azure OpenAI, Gemini, Groq, Ollama, Together, DeepSeek, vLLM, LiteLLM, LM Studio, xAI |
-| **Vector Stores** | 30 | Qdrant, Pinecone, Chroma, Weaviate, Milvus, MongoDB, Redis, Elasticsearch, pgvector, Supabase, Faiss, S3 Vectors |
-| **Embeddings** | 15 | OpenAI, Azure OpenAI, Gemini, HuggingFace, FastEmbed, Together, AWS Bedrock, Ollama, Vertex AI |
-| **Graph Stores** | 4 | Neo4j, Memgraph, Kuzu, Apache AGE |
-| **Rerankers** | 5 | Cohere, HuggingFace, LLM-based, Sentence Transformer, Zero Entropy |
-
-### Two Usage Modes
-
-Self-hosted `Memory` / `AsyncMemory` classes and hosted-platform `MemoryClient` — both in Python and TypeScript.
-
-### Graph Memory
-
-Optional layer on top of vector memory for relationship-aware retrieval. Configured via the `graph` section of `MemoryConfig`.
-
-### MCP Integration
-
-Model Context Protocol support in multiple places:
-
- **Remote:** MCP server at `mcp.mem0.ai`
- **Plugin:** MCP tools in `integrations/mem0-plugin/` — 9 tools: `add_memory`, `search_memories`, `get_memories`, `get_memory`, `update_memory`, `delete_memory`, `delete_all_memories`, `delete_entities`, `list_entities`
-
-### Plugin & Skills System
-
- `integrations/mem0-plugin/` provides integrations for Claude Code, Cursor, and Codex via MCP server connections and lifecycle hooks for automatic memory capture.
- `skills/` contains structured skill definitions for AI agents, split into two categories:
-  - **Reference skills** (always-on SDK knowledge): `mem0` (Python + TS SDKs, framework integrations), `mem0-cli` (terminal workflows), `mem0-vercel-ai-sdk` (Vercel AI provider).
-  - **Pipeline skills** (run on demand): `mem0-integrate` wires Mem0 into an existing repo via a TDD pipeline; `mem0-test-integration` verifies what the integrator produced on the same branch (the two are loosely coupled via `.mem0-integration/` artifacts); `mem0-oss-to-platform` migrates an existing project from Mem0 OSS to the hosted Platform SDK (plan, then execute on approval).
-
-### Adding a New Provider
-
-To add a new LLM, embedding, vector store, or reranker provider:
-
-1. Create `mem0/<category>/<provider_name>.py`
-2. Inherit from the abstract base class in `mem0/<category>/base.py`
-3. Add configuration to `mem0/<category>/configs.py` (if the category uses one)
-4. Register the provider in `mem0/<category>/__init__.py`
-5. Add tests in `tests/<category>/<provider_name>/`
-6. Add any new dependencies to the appropriate optional group in `pyproject.toml` (never to core `dependencies`)
-7. Follow the exact pattern of existing providers in the same category — match method signatures, error handling, and config structure
-
-### Adding a New Integration
-
-Agent/editor integrations live under `integrations/`. Each is a self-contained directory (its own `package.json`/lockfile, build, and tests). To add one:
-
-1. Create `integrations/<name>/` and build the integration there.
-2. If it publishes to a registry, set `repository.directory: "integrations/<name>"` in its `package.json` so npm provenance links to the correct subdirectory.
-3. Add CI/CD under `.github/workflows/` (`<name>-checks.yml`, `<name>-cd.yml`). Use `integrations/<name>` in `paths:` triggers, `working-directory`, and `cache-dependency-path`. Register the release tag prefix in the `case` block in `release.yml` (keep the bare `v*` arm last). Keep workflow **filenames** stable — npm OIDC trusted publishing is pinned to repo + workflow filename.
-4. If it is a Claude Code / editor marketplace plugin, register its path in the five `marketplace.json` files (root + `.claude-plugin/`, `.cursor-plugin/`, `.codex-plugin/`, `.agents/plugins/`).
-5. Document it under `docs/integrations/` and add the page to `docs/docs.json` and `docs/llms.txt`.
-6. Add rows to the "Key Directories" table and the CI/CD tables in this file.
-
-## CI/CD
-
-### CI Workflows (automated testing)
-
-PR testing is orchestrated by a single entry point: **`ci-gate.yml` (CI Gate)** runs on every PR, detects which packages changed, and invokes only the relevant package workflows below as reusable workflows (`workflow_call`). Its final **`CI Gate`** job aggregates the results (skipped pipelines pass; failed or cancelled ones fail) and is the **only status check that needs to be required** in branch protection. Package workflows keep their own push-to-main and manual triggers; their `pull_request` triggers moved into the gate's path filters.
-
-| Workflow | File | Standalone Triggers | Tests |
-|----------|------|---------------------|-------|
-| CI Gate | `ci-gate.yml` | All PRs | Routes to and aggregates the workflows below |
-| Python SDK | `ci.yml` | Push to main | Ruff lint + pytest on Python 3.10, 3.11, 3.12 |
-| TypeScript SDK | `ts-sdk-ci.yml` | Push to main (on `mem0-ts/`) | Prettier + build + jest on Node 20, 22 |
-| Python CLI | `cli-python-ci.yml` | Push to main (on `cli/python/`), manual | Ruff lint + pytest + hatch build on Python 3.10, 3.11, 3.12 |
-| Node CLI | `cli-node-ci.yml` | Push to main (on `cli/node/`), manual | Biome lint + tsc + vitest + tsup build on Node 20, 22 |
-| OpenClaw | `openclaw-checks.yml` | Push to main (on `integrations/openclaw/`), manual | tsc + vitest (with Codecov) + tsup build on Node 20, 22 |
-| Mem0 Plugin | `mem0-plugin-checks.yml` | Push to main (on `integrations/mem0-plugin/`, excluding `.opencode-plugin/`), manual | pytest + hook entry-point exec bits + JSON manifest validation on Python 3.10, 3.11, 3.12 |
-| OpenCode Plugin | `opencode-plugin-checks.yml` | Push to main (on `integrations/mem0-plugin/.opencode-plugin/`), manual | Bun: tsc type-check + build + dist artifact check |
-| Pi Agent Plugin | `pi-agent-plugin-checks.yml` | Push to main (on `integrations/pi-agent-plugin/`), manual | tsc + vitest + tsup build (dist artifact check) on Node 20, 22 |
-| n8n Node | `n8n-nodes-mem0-checks.yml` | Push to main (on `integrations/n8n-nodes-mem0/`), manual | ESLint (n8n-nodes-base) + tsc build (dist artifact check) on Node 20 |
-| Zapier App | `zapier-mem0-checks.yml` | Push to main (on `integrations/zapier-mem0/`), manual | build (tsc) + `zapier validate` + offline unit tests on Node 22 |
-| docs llms.txt | `docs-llms-txt-check.yml` | Manual | `docs/llms.txt` coverage check |
-
-When adding a new package CI workflow: give it `workflow_call` (plus `push`/`workflow_dispatch` as needed, but no `pull_request` trigger), then register it in `ci-gate.yml` — a path filter under the `changes` job, a call job, and an entry in the gate job's `needs` list.
-
-### CD Workflows (automated publishing)
-
-Publishing is routed through a single entry point: **`release.yml` (Release Router)** is the only workflow that listens to `release: published` events. It matches the release tag prefix and dispatches the corresponding package workflow via `workflow_dispatch`, so each release produces exactly one routed run (no skipped runs from the other pipelines).
-
-| Workflow | File | Tag Prefix | Target |
-|----------|------|------------|--------|
-| Release Router | `release.yml` | (all releases) | dispatches the matching workflow below |
-| Python SDK | `cd.yml` | `v*` | PyPI (`mem0ai`) |
-| TypeScript SDK | `ts-sdk-cd.yml` | `ts-v*` | npm (`mem0ai`) |
-| Python CLI | `cli-python-cd.yml` | `cli-v*` | PyPI (`mem0-cli`) |
-| Node CLI | `cli-node-cd.yml` | `cli-node-v*` | npm (`@mem0/cli`) |
-| Vercel AI SDK | `vercel-ai-cd.yml` | `vercel-ai-v*` | npm (`@mem0/vercel-ai-provider`) |
-| OpenClaw | `openclaw-cd.yml` | `openclaw-v*` | npm (`@mem0/openclaw-mem0`) |
-| OpenCode Plugin | `opencode-plugin-cd.yml` | `opencode-v*` | npm (`@mem0/opencode-plugin`) |
-| Pi Agent Plugin | `pi-agent-plugin-cd.yml` | `pi-agent-v*` | npm (`@mem0/pi-agent-plugin`) |
-| n8n Node | `n8n-nodes-mem0-cd.yml` | `n8n-nodes-mem0-v*` | npm (`@mem0/n8n-nodes-mem0`) |
-
- Package CD workflows are `workflow_dispatch`-only (inputs: `tag`, `prerelease`); they check out and build the given tag. Registry trusted-publisher settings stay pinned to each package's own workflow filename.
- All publishing uses **OIDC trusted publishing** — no tokens or secrets required.
- First publish of a new npm package must be done manually; OIDC works for subsequent versions.
- To re-publish a release (e.g. after a registry settings fix), do **not** delete/recreate the GitHub release — manually dispatch the package workflow instead: `gh workflow run <package>-cd.yml --ref refs/tags/<tag> -f tag=<tag>`.
- The **Zapier app** (`integrations/zapier-mem0`) deploys to Zapier's own platform, not npm, so it is **not** in the release router. Deploy it manually: `gh workflow run zapier-mem0-cd.yml --ref main` (requires the `ZAPIER_DEPLOY_KEY` secret).
- When adding a new package: add its CD workflow (`workflow_dispatch` with `tag`/`prerelease` inputs), then register its tag prefix in the `case` block in `release.yml`. Keep the bare `v*` arm last.
-
-### Utility Workflows
-
-| Workflow | File | Purpose |
-|----------|------|---------|
-| Issue Labeler | `issue-labeler.yml` | Automatic issue labeling |
-| PR Labeler | `pr-labeler.yml` | Path-based PR labeling plus propagating labels from linked issues |
-| Stale Bot | `stale.yml` | Marks stale issues and PRs |
-| llms.txt Check | `docs-llms-txt-check.yml` | Blocks PRs touching `docs/**/*.mdx` when `docs/llms.txt` is out of sync. Fix locally with `python scripts/check-llms-txt-coverage.py --write`. |
-
-## Task Completion Guidelines
-
-These guidelines outline typical artifacts for different task types. Use judgment to adapt based on scope and context.
-
-### Bug Fixes
-
-1. **Unit tests**: Add tests that would fail without the fix (regression tests)
-2. **Implementation**: Fix the bug
-3. **Manual verification**: Run the relevant test suite to confirm the fix
-4. **Lint**: Run the appropriate linter for the package you modified
-
-### New Features
-
-1. **Implementation**: Build the feature following existing patterns
-2. **Unit tests**: Comprehensive test coverage for new functionality
-3. **Documentation**: Update relevant docs in `docs/` for public APIs
-4. **Examples**: Add usage examples if the feature introduces new user-facing behavior
-5. **llms.txt**: Any new `.mdx` page under `docs/` must be linked in `docs/llms.txt` with a scope tag (`[Platform]` / `[OSS]` / `[Both]`) and a `Use when ...` description. The `docs-llms-txt-check.yml` workflow runs on every PR that touches docs and **fails the check** if the index is out of sync. To fix: run `python scripts/check-llms-txt-coverage.py --write` locally to scaffold placeholders under `## Unclassified - needs triage`, then replace the `[TODO: ...]` tags, rewrite descriptions as `Use when ...`, move entries into the right section, and delete the triage heading when empty.
-
-### New Provider (LLM / Embedding / Vector Store / Reranker)
-
-1. **Implementation**: Follow the "Adding a New Provider" steps above
-2. **Tests**: Add unit tests matching the pattern of existing providers
-3. **Configuration**: Add to the appropriate `configs.py` and `__init__.py`
-4. **Dependencies**: Add to the correct optional group in `pyproject.toml`
-5. **Documentation**: Add an integration guide in `docs/integrations/`
-
-### Refactoring / Internal Changes
-
- Unit tests for any changed behavior
- No documentation needed for internal-only changes
- Ensure all existing tests still pass
-
-### When to Deviate
-
-These are guidelines, not rigid rules. Adjust based on:
-
- **Scope**: Trivial fixes (typos, comments) may not need tests
- **Visibility**: Internal changes may not need documentation
- **Context**: Some changes span multiple categories — use judgment
-
-When uncertain about expected artifacts, ask for clarification.
-
-## Contributing Guidelines
-
-### Workflow
-
-1. Fork and clone the repository.
-2. Create a feature branch from `main` (e.g., `feature/my-new-feature`).
-3. Make your changes — add tests, docs, and examples as appropriate.
-4. Run linting and tests for every package you modified (see commands above).
-5. Run `pre-commit install` on first setup — hooks run ruff + isort automatically.
-6. Commit with a clear message following [Conventional Commits](https://www.conventionalcommits.org/) (e.g., `feat:`, `fix:`, `docs:`, `refactor:`).
-7. Push and open a Pull Request against `main`.
-
-### Pull Request Requirements
-
-Every PR must follow the repo's PR template (`.github/PULL_REQUEST_TEMPLATE.md`):
-
-1. **Linked Issue** — Reference the issue with `Closes #<number>`. If no issue exists, create one first or explain why in the description.
-2. **Description** — Explain what the PR does and why it's needed.
-3. **Type of Change** — Check the appropriate box:
-   - Bug fix / New feature / Breaking change / Refactor / Documentation update
-4. **Breaking Changes** — If applicable, describe what breaks and the migration path.
-5. **Test Coverage** — Check what applies:
-   - Added/updated unit tests
-   - Added/updated integration tests
-   - Tested manually (describe how)
-   - No tests needed (explain why)
-6. **Checklist** — All must be checked before merge:
-   - [ ] Code follows the project's style guidelines
-   - [ ] Self-review performed
-   - [ ] Tests added that prove the fix/feature works
-   - [ ] New and existing tests pass locally
-   - [ ] Documentation updated if needed
-
-### PR Description Template
-
-```markdown
-## Linked Issue
-
-Closes #<!-- issue number -->
-
-## Description
-
-<!-- What does this PR do? Why is it needed? -->
-
-## Type of Change
-
- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing functionality to change)
- [ ] Refactor (no functional changes)
- [ ] Documentation update
-
-## Breaking Changes
-
-N/A
-
-## Test Coverage
-
- [ ] I added/updated unit tests
- [ ] I added/updated integration tests
- [ ] I tested manually (describe below)
- [ ] No tests needed (explain why)
-
-## Checklist
-
- [ ] My code follows the project's style guidelines
- [ ] I have performed a self-review of my code
- [ ] I have added tests that prove my fix/feature works
- [ ] New and existing tests pass locally
- [ ] I have updated documentation if needed
-```
-
-### General Rules
-
- Follow existing code patterns — don't introduce new frameworks or abstractions without discussion.
- Version bumps go in `pyproject.toml` (Python) or `package.json` (TypeScript).
- For `server/` work, use Docker Compose for local development.
- Do NOT use `pip` or `conda` for dependency management — use `hatch` (see `docs/contributing/development.mdx`).
-
-### Contributing Guides
-
-| Task | Guide |
-|------|-------|
-| Code contributions | `docs/contributing/development.mdx` |
-| Documentation contributions | `docs/contributing/documentation.mdx` |
-| PR template | `.github/PULL_REQUEST_TEMPLATE.md` |
-| Bug reports | `.github/ISSUE_TEMPLATE/bug_report.yml` |
-| Feature requests | `.github/ISSUE_TEMPLATE/feature_request.yml` |
-| Documentation issues | `.github/ISSUE_TEMPLATE/documentation_issue.yml` |
-
-## Do NOT
-
- Modify CI/CD workflows without explicit approval.
- Add new Python dependencies to the core `dependencies` list in `pyproject.toml` without discussion — use optional dependency groups instead.
- Commit `.env` files, API keys, or credentials.
- Skip pre-commit hooks.
- Use npm or yarn in TypeScript packages — this repo uses pnpm exclusively.
- Use `require()` for imports in TypeScript — use ES module `import` syntax.
- Mix up linter configs: root Python SDK uses line-length 120, Python CLI uses 100, Node CLI uses Biome (not ESLint/Ruff).
- Change public APIs without updating documentation in `docs/`.
@@ -1 +0,0 @@
-AGENTS.md
@@ -1,178 +1,63 @@
-# Contributing to Mem0
+# Contributing to mem0

-First off, thank you for taking the time to contribute! 🎉 Mem0 is a
-community-driven project and we welcome contributions of all kinds — bug fixes,
-new features, documentation, examples, and integrations.
+Let us make contribution easy, collaborative and fun.

-Mem0 is a polyglot monorepo, and this guide covers contributing to both the
-**Python SDK** and the **TypeScript SDK** (and the rest of the repository).
+## Submit your Contribution through PR

-## Before You Start
+To make a contribution, follow these steps:

-### 1. Open an Issue First
+1. Fork and clone this repository
+2. Do the changes on your fork with dedicated feature branch `feature/f1`
+3. If you modified the code (new feature or bug-fix), please add tests for it
+4. Include proper documentation / docstring and examples to run the feature
+5. Ensure that all tests pass
+6. Submit a pull request

-**Always open an issue before opening a pull request.** This lets us discuss the
-change, avoid duplicate effort, and agree on the approach before you invest time
-in code.
+For more details about pull requests, please read [GitHub's guides](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request).

- Search [existing issues](https://github.com/mem0ai/mem0/issues) first to see if
-  your bug or idea already exists.
- If it doesn't, open a
-  [bug report](https://github.com/mem0ai/mem0/issues/new?template=bug_report.yml) or
-  [feature request](https://github.com/mem0ai/mem0/issues/new?template=feature_request.yml).
- For anything beyond a trivial fix, wait for a maintainer to confirm the approach
-  before starting significant work.

-Every pull request must link to an issue using `Closes #<issue-number>`.
+### 📦 Development Environment

-### 2. Sign the Contributor License Agreement (CLA)
-
-**We cannot accept or merge any pull request until you have signed our Contributor
-License Agreement (CLA).**
-
-When you open your first PR, the CLA bot will automatically comment with a link to
-sign. Signing takes less than a minute and only needs to be done once. Pull
-requests from contributors who have not signed the CLA will be blocked from
-merging.
-
-## Repository Layout
-
-The two most common contribution targets are the SDKs:
-
-| Package               | Path       | Language     | Package manager |
-| --------------------- | ---------- | ------------ | --------------- |
-| Python SDK (`mem0ai`) | `mem0/`    | Python 3.9+  | `hatch`         |
-| TypeScript SDK (`mem0ai`) | `mem0-ts/` | TypeScript | `pnpm`        |
-
-Other packages include the CLIs (`cli/python/`, `cli/node/`), integrations
-(`integrations/`), the self-hosted `server/`, and the docs site
-(`docs/`). See [AGENTS.md](./AGENTS.md) for a full map of the repository.
-
-## Development Workflow
-
-1. **Fork** the repository and **clone** your fork.
-2. Create a **feature branch** from `main` (e.g. `feature/my-new-feature` or
-   `fix/issue-1234`).
-3. Make your changes — add **tests**, **documentation**, and **examples** as
-   appropriate.
-4. Run **linting and tests** for every package you touched (see below).
-5. Commit using [Conventional Commits](https://www.conventionalcommits.org/)
-   (e.g. `feat:`, `fix:`, `docs:`, `refactor:`, `test:`).
-6. Push and open a **pull request** against `main`, linking the issue with
-   `Closes #<number>` and filling out the
-   [PR template](./.github/PULL_REQUEST_TEMPLATE.md).
-
-### Contributing to the Python SDK (`mem0/`)
-
-We use [`hatch`](https://hatch.pypa.io/latest/install/) to manage environments.
-**Do not use `pip` or `conda` for dependency management.**
+We use `hatch` for managing development environments. To set up:

 ```bash
-# Activate a dev environment (3.9 / 3.10 / 3.11 / 3.12)
-hatch shell dev_py_3_11
+# Activate environment for specific Python version:
+hatch shell dev_py_3_9   # Python 3.9
+hatch shell dev_py_3_10  # Python 3.10  
+hatch shell dev_py_3_11  # Python 3.11
+hatch shell dev_py_3_12  # Python 3.12

-# Install pre-commit hooks (runs ruff + isort on commit)
-pre-commit install
-
-# Lint, format, and sort imports
-make lint
-make format
-make sort
-
-# Run the test suite (run `make install_all` first if deps are missing)
+# The environment will automatically install all dev dependencies
+# Run tests within the activated shell:
 make test
 ```

- **Linter / formatter:** Ruff (line length **120**)
- **Import sorting:** isort (`profile = "black"`)
- **Tests:** pytest (in `tests/`)
+### 📌 Pre-commit

-See the full [Development guide](https://docs.mem0.ai/contributing/development) for
-environment details.
-
-### Contributing to the TypeScript SDK (`mem0-ts/`)
-
-We use [`pnpm`](https://pnpm.io/) (v10+) for all TypeScript packages. **Do not use
-`npm` or `yarn`.**
+To ensure our standards, make sure to install pre-commit before starting to contribute.

 ```bash
-cd mem0-ts
-pnpm install
-
-pnpm run build        # tsup (CJS + ESM)
-pnpm run test         # jest (all tests)
-pnpm run test:unit    # unit tests with coverage
+pre-commit install
 ```

- **Build:** tsup
- **Formatter:** Prettier
- **Tests:** jest
- Always run type checking after changes: `pnpm run typecheck` (or `tsc --noEmit`).
- Use ES module `import` syntax — never `require()`.
+### 🧪 Testing

-## Good Contribution Practices
+We use `pytest` to test our code across multiple Python versions. You can run tests using:

- **Keep PRs small and focused.** One logical change per PR is easier to review and
-  merge.
- **Follow existing patterns.** Match the style, structure, and conventions of the
-  code around you. Don't introduce new frameworks or abstractions without
-  discussion.
- **Write tests** that would fail without your change — regression tests for bugs,
-  coverage for new features.
- **Update documentation** in `docs/` for any user-facing change. New `.mdx` pages
-  must be added to `docs/llms.txt` (run
-  `python scripts/check-llms-txt-coverage.py --write` to scaffold entries).
- **Add examples** when introducing new user-facing behavior.
- **Run linters and tests locally** before pushing — CI re-runs them on every PR
-  via the CI Gate.
- **Never commit secrets** — no `.env` files, API keys, or credentials.
- **Don't add core dependencies lightly.** New Python dependencies belong in an
-  optional group in `pyproject.toml`, not the core `dependencies` list.
- **Be responsive** to review feedback and keep your branch up to date with `main`.
+```bash
+# Run tests with default Python version
+make test

-## Pull Request Checklist
+# Test specific Python versions:
+make test-py-3.9   # Python 3.9 environment
+make test-py-3.10  # Python 3.10 environment
+make test-py-3.11  # Python 3.11 environment
+make test-py-3.12  # Python 3.12 environment

-Before requesting review, make sure:
+# When using hatch shells, run tests with:
+make test  # After activating a shell with hatch shell test_XX
+```

- [ ] An issue exists and is linked with `Closes #<number>`
- [ ] You have signed the CLA
- [ ] Your code follows the project's style guidelines (lint passes)
- [ ] You performed a self-review of your changes
- [ ] Tests are added/updated and pass locally
- [ ] Documentation is updated if needed
-
-## Reporting Security Issues
-
-**Do not report security vulnerabilities through public issues or pull requests.**
-Please follow our [Security Policy](./SECURITY.md) to report them privately.
-
-## Releasing
-
-All packages are published automatically via GitHub Actions when a GitHub Release
-is created with the correct tag prefix.
-
-### Tag Prefixes
-
-| Package | Registry | Tag Prefix | Example |
-|---------|----------|------------|---------|
-| `mem0ai` (Python SDK) | PyPI | `v*` | `v0.1.31` |
-| `mem0-cli` (Python CLI) | PyPI | `cli-v*` | `cli-v0.2.1` |
-| `mem0ai` (TypeScript SDK) | npm | `ts-v*` | `ts-v2.4.6` |
-| `@mem0/cli` (Node CLI) | npm | `cli-node-v*` | `cli-node-v0.1.2` |
-| `@mem0/vercel-ai-provider` | npm | `vercel-ai-v*` | `vercel-ai-v2.0.6` |
-| `@mem0/openclaw-mem0` | npm | `openclaw-v*` | `openclaw-v1.0.1` |
-
-### How to Release
-
-1. Bump the version in `pyproject.toml` (Python) or `package.json` (Node)
-2. Create a [GitHub Release](https://github.com/mem0ai/mem0/releases/new) with the matching tag prefix
-3. The correct workflow will trigger automatically — verify in the [Actions tab](https://github.com/mem0ai/mem0/actions)
-
-### Publishing Details
-
- **PyPI packages** use OIDC trusted publishing via `pypa/gh-action-pypi-publish`
- **npm packages** use OIDC trusted publishing via npm CLI (>= 11.5.1) — no tokens or secrets required
- All workflows require `permissions: id-token: write` for OIDC authentication
- First publish of a new npm package must be done manually; OIDC works for subsequent versions
+Make sure that all tests pass across all supported Python versions before submitting a pull request.

 We look forward to your pull requests and can't wait to see your contributions!
@@ -266,7 +266,7 @@ config = MemoryConfig(
    graph_store=GraphStoreConfig(provider="neo4j", config={...}),  # optional
    history_db_path="~/.mem0/history.db",
    version="v1.1",
-    custom_instructions="Custom prompt...",
+    custom_fact_extraction_prompt="Custom prompt...",
    custom_update_memory_prompt="Custom prompt..."
 )
 ```
@@ -684,7 +684,7 @@ Conversation: {messages}
 """

 config = MemoryConfig(
-    custom_instructions=custom_extraction_prompt
+    custom_fact_extraction_prompt=custom_extraction_prompt
 )
 memory = Memory(config)
 ```
@@ -1026,8 +1026,7 @@ def get_user_preferences(user_id: str):
 ### AutoGen Integration

 ```python
-# Mem0Teachability lives in examples/notebooks/helper/ — see examples/notebooks/mem0-autogen.ipynb
-from helper.mem0_teachability import Mem0Teachability
+from cookbooks.helper.mem0_teachability import Mem0Teachability
 from mem0 import Memory

 # Add memory capability to AutoGen agents
@@ -1314,7 +1313,7 @@ async def delete_memory(memory_id: str):
 - **Documentation**: https://docs.mem0.ai
 - **GitHub Repository**: https://github.com/mem0ai/mem0
 - **Discord Community**: https://mem0.dev/DiG
- **Platform**: https://app.mem0.ai?utm_source=oss&utm_medium=llm
+- **Platform**: https://app.mem0.ai
 - **Research Paper**: https://mem0.ai/research
 - **Examples**: https://github.com/mem0ai/mem0/tree/main/examples

@@ -0,0 +1,221 @@
+# Migration Guide: Upgrading to mem0 1.0.0
+
+## TL;DR
+
+**What changed?** We simplified the API by removing confusing version parameters. Now everything returns a consistent format: `{"results": [...]}`.
+
+**What you need to do:**
+1. Upgrade: `pip install mem0ai==1.0.0`
+2. Remove `version` and `output_format` parameters from your code
+3. Update response handling to use `result["results"]` instead of treating responses as lists
+
+**Time needed:** ~5-10 minutes for most projects
+
+---
+
+## Quick Migration Guide
+
+### 1. Install the Update
+
+```bash
+pip install mem0ai==1.0.0
+```
+
+### 2. Update Your Code
+
+**If you're using the Memory API:**
+
+```python
+# Before
+memory = Memory(config=MemoryConfig(version="v1.1"))
+result = memory.add("I like pizza")
+
+# After
+memory = Memory()  # That's it - version is automatic now
+result = memory.add("I like pizza")
+```
+
+**If you're using the Client API:**
+
+```python
+# Before
+client.add(messages, output_format="v1.1")
+client.search(query, version="v2", output_format="v1.1")
+
+# After
+client.add(messages)  # Just remove those extra parameters
+client.search(query)
+```
+
+### 3. Update How You Handle Responses
+
+All responses now use the same format: a dictionary with `"results"` key.
+
+```python
+# Before - you might have done this
+result = memory.add("I like pizza")
+for item in result:  # Treating it as a list
+    print(item)
+
+# After - do this instead
+result = memory.add("I like pizza")
+for item in result["results"]:  # Access the results key
+    print(item)
+
+# Graph relations (if you use them)
+if "relations" in result:
+    for relation in result["relations"]:
+        print(relation)
+```
+
+---
+
+## Enhanced Message Handling
+
+The platform client (MemoryClient) now supports the same flexible message formats as the OSS version:
+
+```python
+from mem0 import MemoryClient
+
+client = MemoryClient(api_key="your-key")
+
+# All three formats now work:
+
+# 1. Single string (automatically converted to user message)
+client.add("I like pizza", user_id="alice")
+
+# 2. Single message dictionary
+client.add({"role": "user", "content": "I like pizza"}, user_id="alice")
+
+# 3. List of messages (conversation)
+client.add([
+    {"role": "user", "content": "I like pizza"},
+    {"role": "assistant", "content": "I'll remember that!"}
+], user_id="alice")
+```
+
+### Async Mode Configuration
+
+The `async_mode` parameter now defaults to `True` but can be configured:
+
+```python
+# Default behavior (async_mode=True)
+client.add(messages, user_id="alice")
+
+# Explicitly set async mode
+client.add(messages, user_id="alice", async_mode=True)
+
+# Disable async mode if needed
+client.add(messages, user_id="alice", async_mode=False)
+```
+
+**Note:** `async_mode=True` provides better performance for most use cases. Only set it to `False` if you have specific synchronous processing requirements.
+
+---
+
+## That's It!
+
+For most users, that's all you need to know. The changes are:
+- ✅ No more `version` or `output_format` parameters
+- ✅ Consistent `{"results": [...]}` response format
+- ✅ Cleaner, simpler API
+
+---
+
+## Common Issues
+
+**Getting `KeyError: 'results'`?**
+
+Your code is still treating the response as a list. Update it:
+```python
+# Change this:
+for memory in response:
+
+# To this:
+for memory in response["results"]:
+```
+
+**Getting `TypeError: unexpected keyword argument`?**
+
+You're still passing old parameters. Remove them:
+```python
+# Change this:
+client.add(messages, output_format="v1.1")
+
+# To this:
+client.add(messages)
+```
+
+**Seeing deprecation warnings?**
+
+Remove any explicit `version="v1.0"` from your config:
+```python
+# Change this:
+memory = Memory(config=MemoryConfig(version="v1.0"))
+
+# To this:
+memory = Memory()
+```
+
+---
+
+## What's New in 1.0.0
+
+- **Better vector stores:** Fixed OpenSearch and improved reliability across all stores
+- **Cleaner API:** One way to do things, no more confusing options
+- **Enhanced GCP support:** Better Vertex AI configuration options
+- **Flexible message input:** Platform client now accepts strings, dicts, and lists (aligned with OSS)
+- **Configurable async_mode:** Now defaults to `True` but users can override if needed
+
+---
+
+## Need Help?
+
+- Check [GitHub Issues](https://github.com/mem0ai/mem0/issues)
+- Read the [documentation](https://docs.mem0.ai/)
+- Open a new issue if you're stuck
+
+---
+
+## Advanced: Configuration Changes
+
+**If you configured vector stores with version:**
+
+```python
+# Before
+config = MemoryConfig(
+    version="v1.1",
+    vector_store=VectorStoreConfig(...)
+)
+
+# After
+config = MemoryConfig(
+    vector_store=VectorStoreConfig(...)
+)
+```
+
+---
+
+## Testing Your Migration
+
+Quick sanity check:
+
+```python
+from mem0 import Memory
+
+memory = Memory()
+
+# Add should return a dict with "results"
+result = memory.add("I like pizza", user_id="test")
+assert "results" in result
+
+# Search should return a dict with "results"
+search = memory.search("food", user_id="test")
+assert "results" in search
+
+# Get all should return a dict with "results"
+all_memories = memory.get_all(user_id="test")
+assert "results" in all_memories
+
+print("✅ Migration successful!")
+```
@@ -11,7 +11,7 @@ install:
 	hatch env create

 install_all:
-	pip install ruff==0.16.0 groq together boto3 litellm ollama chromadb weaviate weaviate-client sentence_transformers vertexai \
+	pip install ruff==0.6.9 groq together boto3 litellm ollama chromadb weaviate weaviate-client sentence_transformers vertexai \
 	            google-generativeai elasticsearch opensearch-py vecs "pinecone<7.0.0" pinecone-text faiss-cpu langchain-community \
 							upstash-vector azure-search-documents langchain-memgraph langchain-neo4j langchain-aws rank-bm25 pymochow pymongo psycopg kuzu databricks-sdk valkey

@@ -42,6 +42,9 @@ clean:
 test:
 	hatch run test

+test-py-3.9:
+	hatch run dev_py_3_9:test
+
 test-py-3.10:
 	hatch run dev_py_3_10:test

@@ -39,33 +39,18 @@
 </p>

 <p align="center">
-  <a href="https://mem0.ai/research"><strong>📄 Benchmarking Mem0's token-efficient memory algorithm →</strong></a>
+  <a href="https://mem0.ai/research"><strong>📄 Building Production-Ready AI Agents with Scalable Long-Term Memory →</strong></a>
+</p>
+<p align="center">
+  <strong>⚡ +26% Accuracy vs. OpenAI Memory • 🚀 91% Faster • 💰 90% Fewer Tokens</strong>
 </p>

-## New Memory Algorithm (April 2026)
+> **🎉 mem0ai v1.0.0 is now available!** This major release includes API modernization, improved vector store support, and enhanced GCP integration. [See migration guide →](MIGRATION_GUIDE_v1.0.md)

-| Benchmark | Old | New  | Tokens  | Latency p50  |
-| --- | --- | --- | --- | --- |
-| **LoCoMo** | 71.4 | **92.5** | 7.0K  | 0.88s  |
-| **LongMemEval** | 67.8 | **94.4** | 6.8K  | 1.09s  |
-| **BEAM (1M)** | — | **64.1** | 6.7K  | 1.00s  |
-| **BEAM (10M)** | — | **48.6** | 6.9K  | 1.05s  |
-
-All benchmarks run on the same production-representative model stack. Single-pass retrieval (one call, no agentic loops) at a top_200 retrieval budget. Scores reflect Mem0's managed platform, which includes proprietary optimizations not available in the open-source SDK; open-source users should expect directionally similar gains but not identical numbers.
-
-**What changed:**
- **Single-pass ADD-only extraction** -- one LLM call, no UPDATE/DELETE. Memories accumulate; nothing is overwritten.
- **Agent-generated facts are first-class** -- when an agent confirms an action, that information is now stored with equal weight.
- **Entity linking** -- entities are extracted, embedded, and linked across memories for retrieval boosting.
- **Multi-signal retrieval** -- semantic, BM25 keyword, and entity matching scored in parallel and fused.
- **Temporal Reasoning** -- time-aware retrieval that ranks the right dated instance for queries about current state, past events, and upcoming plans.
-
-See the [migration guide](https://docs.mem0.ai/migration/oss-v2-to-v3) for upgrade instructions. The [evaluation framework](https://github.com/mem0ai/memory-benchmarks) is open-sourced so anyone can reproduce the numbers.
-
-## Research Highlights
- **92.5 on LoCoMo** -- +21 points over the previous algorithm
- **94.4 on LongMemEval** -- +27 points, with 98.2 on assistant memory recall
- **64.1 on BEAM (1M)** -- production-scale memory evaluation at 1M tokens
+##  🔥 Research Highlights
+- **+26% Accuracy** over OpenAI Memory on the LOCOMO benchmark
+- **91% Faster Responses** than full-context, ensuring low-latency at scale
+- **90% Lower Token Usage** than full-context, cutting costs without compromise
 - [Read the full paper](https://mem0.ai/research)

 # Introduction
@@ -86,75 +71,28 @@ See the [migration guide](https://docs.mem0.ai/migration/oss-v2-to-v3) for upgra

 ## 🚀 Quickstart Guide <a name="quickstart"></a>

-### Sign up as an agent
+Choose between our hosted platform or self-hosted package:

-AI agents can mint a working Mem0 API key in under five seconds — no email, no dashboard, no OTP. Four commands end-to-end:
+### Hosted Platform

-```bash
-# 1. Install
-npm install -g @mem0/cli      # or: pip install mem0-cli
+Get up and running in minutes with automatic updates, analytics, and enterprise security.

-# 2. Sign up as an agent (replace `claude-code` with your name)
-mem0 init --agent --agent-caller claude-code
+1. Sign up on [Mem0 Platform](https://app.mem0.ai)
+2. Embed the memory layer via SDK or API keys

-# 3. Add a memory
-mem0 add "I am using mem0"
+### Self-Hosted (Open Source)

-# 4. Search
-mem0 search "am I using mem0"
-```
-
-The human owner can claim the account later with `mem0 init --email <their-email>` — same key, memories preserved. Full guide: [Sign up as an agent](https://docs.mem0.ai/platform/agent-signup).
-
-| | Library | Self-Hosted Server | Cloud Platform |
-|---|---------|-------------------|----------------|
-| **Best for** | Testing, prototyping | Teams running on their own infrastructure | Zero-ops production use |
-| **Setup** | `pip install mem0ai` | `docker compose up` | Sign up at [app.mem0.ai](https://app.mem0.ai?utm_source=oss&utm_medium=readme) |
-| **Dashboard** | -- | [Yes](https://docs.mem0.ai/open-source/setup) | Yes |
-| **Auth & API Keys** | -- | Yes | Yes |
-| **Advanced Features** | -- | Teasers | All included |
-
-Just testing? Use the library. Building for a team? Self-hosted. Want zero ops? Cloud.
-
-### Library (pip / npm)
+Install the sdk via pip:

 ```bash
 pip install mem0ai
 ```

-For enhanced hybrid search with BM25 keyword matching and entity extraction, install with NLP support:
-
-```bash
-pip install mem0ai[nlp]
-python -m spacy download en_core_web_sm
-```
-
 Install sdk via npm:
-
 ```bash
 npm install mem0ai
 ```

-### Self-Hosted Server
-
-> **Note:** Self-hosted auth is on by default. Upgrading from a pre-auth build? Set `ADMIN_API_KEY`, register an admin through the wizard, or `AUTH_DISABLED=true` for local dev only. See [upgrade notes](https://docs.mem0.ai/open-source/setup#upgrade-notes).
-
-```bash
-# Recommended: one command — start the stack, create an admin, issue the first API key.
-cd server && make bootstrap
-
-# Manual: start the stack and finish setup via the browser wizard.
-cd server && docker compose up -d    # http://localhost:3000
-```
-
-See the [self-hosted docs](https://docs.mem0.ai/open-source/overview) for configuration.
-
-### Cloud Platform
-
-1. Sign up on [Mem0 Platform](https://app.mem0.ai?utm_source=oss&utm_medium=readme)
-2. Embed the memory layer via SDK or API keys
-3. Using hosted Qdrant vectors? See the [Platform migration guide](https://docs.mem0.ai/migration/oss-to-platform) to import them into Mem0 Platform.
-
 ### CLI

 Manage memories from your terminal:
@@ -169,33 +107,9 @@ mem0 search "What does Alice prefer?" --user-id alice

 See the [CLI documentation](https://docs.mem0.ai/platform/cli) for the full command reference.

-### Agent Skills
-
-Teach your AI coding assistant (Claude Code, Codex, Cursor, Windsurf, OpenCode, OpenClaw, and any tool that supports the skills standard) how to build with Mem0. Two categories:
-
-**Reference skills — always on** (SDK knowledge loaded into the assistant's context):
-
-```bash
-npx skills add https://github.com/mem0ai/mem0 --skill mem0
-npx skills add https://github.com/mem0ai/mem0 --skill mem0-cli
-npx skills add https://github.com/mem0ai/mem0 --skill mem0-vercel-ai-sdk
-```
-
-**Pipeline skills — run on demand** (execute an end-to-end workflow in an existing repo):
-
-```bash
-npx skills add https://github.com/mem0ai/mem0 --skill mem0-integrate
-npx skills add https://github.com/mem0ai/mem0 --skill mem0-test-integration
-npx skills add https://github.com/mem0ai/mem0 --skill mem0-oss-to-platform
-```
-
-Use `/mem0-integrate` to wire Mem0 into an existing repo via a test-first pipeline, then `/mem0-test-integration` to verify. Use `/mem0-oss-to-platform` to migrate an existing project from Mem0 OSS to the hosted Platform SDK. See the [skills catalog](./skills/) or [Vibecoding with Mem0](https://docs.mem0.ai/vibecoding) for the full picture.
-
 ### Basic Usage

-Mem0 requires an LLM to function, with `gpt-5-mini` from OpenAI as the default. However, it supports a variety of LLMs; for details, refer to our [Supported LLMs documentation](https://docs.mem0.ai/components/llms/overview).
-
-Mem0 uses `text-embedding-3-small` from OpenAI as the default embedding model. For best results with hybrid search (semantic + keyword + entity boosting), we recommend using at least [Qwen 600M](https://huggingface.co/Alibaba-NLP/gte-Qwen2-1.5B-instruct) or a comparable embedding model. See [Supported Embeddings](https://docs.mem0.ai/components/embedders/overview) for configuration details.
+Mem0 requires an LLM to function, with `gpt-4.1-nano-2025-04-14 from OpenAI as the default. However, it supports a variety of LLMs; for details, refer to our [Supported LLMs documentation](https://docs.mem0.ai/components/llms/overview).

 First step is to instantiate the memory:

@@ -208,13 +122,13 @@ memory = Memory()

 def chat_with_memories(message: str, user_id: str = "default_user") -> str:
    # Retrieve relevant memories
-    relevant_memories = memory.search(query=message, filters={"user_id": user_id}, top_k=3)
+    relevant_memories = memory.search(query=message, user_id=user_id, limit=3)
    memories_str = "\n".join(f"- {entry['memory']}" for entry in relevant_memories["results"])

    # Generate Assistant response
    system_prompt = f"You are a helpful AI. Answer the question based on query and memories.\nUser Memories:\n{memories_str}"
    messages = [{"role": "system", "content": system_prompt}, {"role": "user", "content": message}]
-    response = openai_client.chat.completions.create(model="gpt-5-mini", messages=messages)
+    response = openai_client.chat.completions.create(model="gpt-4.1-nano-2025-04-14", messages=messages)
    assistant_response = response.choices[0].message.content

    # Create new memories from the conversation
@@ -248,7 +162,7 @@ For detailed integration steps, see the [Quickstart](https://docs.mem0.ai/quicks
 ## 📚 Documentation & Support

 - Full docs: https://docs.mem0.ai
- Community: [Discord](https://mem0.dev/DiG) · [X (formerly Twitter)](https://x.com/mem0ai)
+- Community: [Discord](https://mem0.dev/DiG) · [Twitter](https://x.com/mem0ai)
 - Contact: founders@mem0.ai

 ## Citation
@@ -266,4 +180,4 @@ We now have a paper you can cite:

 ## ⚖️ License

-Apache 2.0 — see the [LICENSE](https://github.com/mem0ai/mem0/blob/main/LICENSE) file for details.
+Apache 2.0 — see the [LICENSE](https://github.com/mem0ai/mem0/blob/main/LICENSE) file for details.
@@ -1,48 +0,0 @@
-# Security Policy
-
-We take the security of Mem0 and our community seriously. Thank you for helping
-keep Mem0 and its users safe by disclosing vulnerabilities responsibly.
-
-## Reporting a Vulnerability
-
-Please **do not** report security vulnerabilities through public GitHub issues,
-pull requests, or discussions.
-
-If you believe you have found a security vulnerability in Mem0, please report it
-privately through one of the following channels:
-
-1. **GitHub Private Vulnerability Reporting** — open a
-   [private security advisory](https://github.com/mem0ai/mem0/security/advisories/new)
-   directly on this repository.
-2. **Email** the maintainers at **support@mem0.ai** with the subject line:
-
-   `SECURITY: Mem0 vulnerability report`
-
-To help us triage and resolve the issue quickly, please include as much of the
-following as you can:
-
- Affected component or package (e.g. Python SDK, TypeScript SDK, server, CLI)
- Affected version, tag, or commit
- Clear, step-by-step reproduction instructions
- The security impact and a proof of concept, if available
- Any suggested fix or mitigation
-
-## Response Process
-
- We will acknowledge receipt of your report within **72 hours**.
- We will work with you privately to confirm the issue and assess its impact.
- Once a fix or mitigation is ready, we will coordinate a disclosure timeline
-  with you and credit you for the discovery, unless you prefer to remain anonymous.
-
-## Public Disclosure
-
-Please avoid sharing technical details of the vulnerability publicly until the
-maintainers have reviewed the issue and a fix or mitigation has been released. We
-are committed to resolving valid reports promptly and keeping you informed
-throughout the process.
-
-## Supported Versions
-
-We release security fixes against the latest published version of each package.
-Whenever possible, please reproduce the issue on the most recent release before
-reporting.
@@ -28,7 +28,7 @@ mem0 CLI is the official command-line interface for [mem0](https://mem0.ai) -- t
 ### Who is it for?

 - Developers integrating mem0 into their workflows
- AI agents that need persistent memory (the CLI is designed with `--json`/`--agent` global flags and `help --json` specifically for machine consumption)
+- AI agents that need persistent memory (the CLI is designed with `--output json` and `help --json` specifically for machine consumption)
 - DevOps/CI pipelines that need to manage memories programmatically

 ### Project Structure
@@ -79,7 +79,6 @@ Apache-2.0
 │           ├── init_cmd.py          # run_init (interactive wizard)
 │           ├── config_cmd.py        # cmd_config_show, cmd_config_get, cmd_config_set
 │           ├── entities.py          # cmd_entities_list, cmd_entities_delete
-│           ├── events_cmd.py        # cmd_event_list, cmd_event_status
 │           └── utils.py             # cmd_status, cmd_version, cmd_import
 └── node/
    ├── package.json                 # Node package config (tsup build)
@@ -89,7 +88,6 @@ Apache-2.0
        ├── config.ts                # Config loading/saving, env var overrides
        ├── branding.ts              # Colors, icons, banner, timedStatus, print helpers
        ├── output.ts                # Output formatting (text, json, table, quiet)
-        ├── state.ts                 # Agent mode flag (setAgentMode, isAgentMode)
        ├── help.ts                  # Rich-style help formatter (panels, command ordering)
        ├── backend/
        │   ├── index.ts             # Re-exports
@@ -100,7 +98,6 @@ Apache-2.0
            ├── init.ts              # runInit (interactive wizard)
            ├── config.ts            # cmdConfigShow, cmdConfigGet, cmdConfigSet
            ├── entities.ts          # cmdEntitiesList, cmdEntitiesDelete
-            ├── events.ts            # cmdEventList, cmdEventStatus
            └── utils.ts             # cmdStatus, cmdVersion, cmdImport
 ```

@@ -156,25 +153,8 @@ Interactive setup wizard for mem0 CLI.
 |-----------------|--------|----------|---------|------|
 | `--api-key`     | string | No       | -       | API key (skip prompt). |
 | `-u, --user-id` | string | No       | -       | Default user ID (skip prompt). |
-| `--email`       | string | No       | -       | Login via email verification code. |
-| `--code`        | string | No       | -       | Verification code (use with --email for non-interactive login). |
-| `--force`       | bool   | No       | false   | Overwrite existing config without confirmation. |

 **Behavior:**
-
-*Existing config protection:*
- If `~/.mem0/config.json` exists with an API key, the CLI warns and asks for confirmation before overwriting.
- In non-TTY mode, this is a hard error unless `--force` is passed.
- `--force` skips the confirmation in both TTY and non-TTY modes.
-
-*Email login flow (when `--email` is provided):*
- Sends a 6-digit verification code to the email via `POST /api/v1/auth/email_code/`.
- If `--code` is also provided, verifies immediately (fully non-interactive).
- If `--code` is not provided, prompts for the code interactively.
- On success: receives API key, org_id, project_id. Saves to config. Creates account if email is new.
- Cannot be combined with `--api-key`.
-
-*API key flow (existing behavior):*
 - If both `--api-key` and `--user-id` are provided, runs non-interactively (no prompts).
 - If running in a non-TTY without both flags, prints an error with usage hint and exits.
 - Interactive mode: prints banner, prompts for API key (masked with `*`), prompts for default user ID (default: `mem0-cli`), validates connection, saves config.
@@ -184,9 +164,6 @@ Interactive setup wizard for mem0 CLI.
 ```bash
 mem0 init
 mem0 init --api-key m0-xxx --user-id alice
-mem0 init --api-key m0-xxx --user-id alice --force
-mem0 init --email alice@company.com
-mem0 init --email alice@company.com --code 482901
 ```

 ---
@@ -710,114 +687,7 @@ mem0 entity delete --user-id alice --dry-run

 ---

-### 3.14 `event list`
-
-List recent background processing events.
-
-| Property         | Value |
-|------------------|-------|
-| Usage            | `mem0 event list [OPTIONS]` |
-| needsBackend     | Yes |
-| needsConfig      | Yes |
-| resolveIds       | No |
-| resolveGraph     | No |
-| confirmDangerous | No |
-| Output formats   | text (table), json |
-| Default output   | table |
-| API endpoint     | `GET /v1/events/` |
-
-**Options:**
-
-| Flag           | Type   | Default | Panel      | Help |
-|----------------|--------|---------|------------|------|
-| `-o, --output` | string | "table" | Output     | Output: text, json. |
-| `--api-key`    | string | -       | Connection | Override API key. |
-| `--base-url`   | string | -       | Connection | Override API base URL. |
-
-**Behavior:** Fetches all background events for the project. Displays as a table with columns: Event ID (first 8 chars), Type, Status (color-coded), Latency, Created. Status values: `PENDING` (accent), `SUCCEEDED` (green), `FAILED` (red), `PROCESSING` (yellow).
-
-**JSON output envelope:**
-```json
-{
-  "status": "success",
-  "command": "event list",
-  "count": 3,
-  "duration_ms": 87,
-  "data": [
-    { "id": "evt-abc", "event_type": "ADD", "status": "SUCCEEDED", "latency": 412.0, "created_at": "2026-01-01T10:00:00Z" }
-  ]
-}
-```
-
-**Examples:**
-```bash
-mem0 event list
-mem0 event list --output json
-```
-
---
-
-### 3.15 `event status`
-
-Get the status and results of a specific background event.
-
-| Property         | Value |
-|------------------|-------|
-| Usage            | `mem0 event status <event_id> [OPTIONS]` |
-| needsBackend     | Yes |
-| needsConfig      | Yes |
-| resolveIds       | No |
-| resolveGraph     | No |
-| confirmDangerous | No |
-| Output formats   | text, json |
-| Default output   | text |
-| API endpoint     | `GET /v1/events/{event_id}/` |
-
-**Arguments:**
-
-| Name       | Type   | Required | Help |
-|------------|--------|----------|------|
-| `event_id` | string | Yes      | Event ID to inspect. |
-
-**Options:**
-
-| Flag           | Type   | Default | Panel      | Help |
-|----------------|--------|---------|------------|------|
-| `-o, --output` | string | "text"  | Output     | Output: text, json. |
-| `--api-key`    | string | -       | Connection | Override API key. |
-| `--base-url`   | string | -       | Connection | Override API base URL. |
-
-**Behavior:** Fetches the event by ID and displays: Event ID, Type, Status (color-coded), Latency, Created, Updated, and a numbered list of result memories (event type, memory text, user_id, truncated memory ID). Displayed in a boxed panel (text) or JSON envelope.
-
-**JSON output envelope:**
-```json
-{
-  "status": "success",
-  "command": "event status",
-  "duration_ms": 65,
-  "data": {
-    "id": "evt-abc",
-    "event_type": "ADD",
-    "status": "SUCCEEDED",
-    "latency": 412.0,
-    "created_at": "2026-01-01T10:00:00Z",
-    "updated_at": "2026-01-01T10:00:01Z",
-    "results": [
-      { "id": "mem-xyz", "event": "ADD", "user_id": "alice", "memory": "User prefers dark mode" }
-    ]
-  }
-}
-```
-
-**Examples:**
-```bash
-mem0 event status evt-abc-123
-mem0 event status evt-abc-123 --output json
-```
-
---
-
-### 3.16 `status`
+### 3.14 `status`

 Check connectivity and authentication.

@@ -838,19 +708,20 @@ Check connectivity and authentication.
 | `--api-key`    | string | -       | Connection | Override API key. |
 | `--base-url`   | string | -       | Connection | Override API base URL. |

-**Behavior:** Validates connectivity by calling `GET /v1/ping/`. Displays connection status in a boxed panel (text) or JSON envelope. The ping endpoint is lightweight and does not require any entity scope.
+**Behavior:** If config has a default `user_id` or `agent_id`, validates by making a minimal `POST /v2/memories/` with `page=1&page_size=1`. Otherwise validates via `GET /v1/entities/`. Displays connection status in a boxed panel (text) or JSON envelope.

 **JSON output:**
 ```json
 {
  "status": "success",
  "command": "status",
-  "duration_ms": 112,
  "data": {
    "connected": true,
    "backend": "platform",
-    "base_url": "https://api.mem0.ai"
-  }
+    "base_url": "https://api.mem0.ai",
+    "latency_ms": 245
+  },
+  "duration_ms": 245
 }
 ```

@@ -862,7 +733,7 @@ mem0 status -o json

 ---

-### 3.17 `help`
+### 3.15 `help`

 Show help. Use `--json` for machine-readable output (for LLM agents).

@@ -922,9 +793,6 @@ The auth header name is `Authorization` and the scheme is `Token` (not Bearer).
 | Delete all      | `DELETE` | `/v1/memories/`               | -                | entity ID params        |
 | List entities   | `GET`    | `/v1/entities/`               | -                | -                       |
 | Delete entities | `DELETE` | `/v1/entities/`               | -                | entity ID params        |
-| List events     | `GET`    | `/v1/events/`                 | -                | -                       |
-| Get event       | `GET`    | `/v1/events/{event_id}/`      | -                | -                       |
-| Ping (status)   | `GET`    | `/v1/ping/`                   | -                | -                       |

 ### How Filters Are Built (`_buildFilters` / `_build_filters`)

@@ -1227,8 +1095,6 @@ For `PENDING` events, displays "Processing in background" with the event ID.

 ### 7.1 Supported Modes Per Command

-All commands also support `agent` mode via the global `--json`/`--agent` flag, which wraps output in a structured JSON envelope with sanitized fields.
-
 | Command        | text | json | table | quiet |
 |----------------|------|------|-------|-------|
 | add            | Y    | Y    | -     | Y     |
@@ -1243,16 +1109,12 @@ All commands also support `agent` mode via the global `--json`/`--agent` flag, w
 | config set     | (success msg) | - | - | -  |
 | entity list    | -    | Y    | Y (default) | -  |
 | entity delete  | Y    | Y    | -     | Y     |
-| event list     | Y (table) | Y | -  | -     |
-| event status   | Y    | Y    | -     | -     |
 | status         | Y    | Y    | -     | -     |
 | help           | Y    | Y (--json) | - | -   |

-### 7.2 JSON Envelope Format
+### 7.2 JSON Envelope Format (`formatJsonEnvelope`)

-There are two related envelope formats:
-
-**`formatJsonEnvelope`** — used by `config show`, `status`, and `import` for `--output json`:
+Used by `config show`, `status`, and `import` for structured JSON output:

 ```json
 {
@@ -1266,39 +1128,14 @@ There are two related envelope formats:
 }
 ```

-**`formatAgentEnvelope`** — used by all commands in agent mode (`--json`/`--agent`). Same structure, but `data` is passed through `sanitizeAgentData(command, data)` to project only the most relevant fields:
-
-| Command       | Fields in `data` |
-|---------------|-----------------|
-| add           | `[{id, memory, event}]` or `[{status, event_id}]` for PENDING |
-| search        | `[{id, memory, score, created_at, categories}]` |
-| list          | `[{id, memory, created_at, categories}]` |
-| get           | `{id, memory, created_at, updated_at, categories, metadata}` |
-| update        | `{id, memory}` |
-| delete        | (raw API response) |
-| entity list   | `[{name, type, count}]` |
-| event list    | `[{id, event_type, status, latency, created_at}]` |
-| event status  | `{id, event_type, status, latency, created_at, updated_at, results: [{id, event, user_id, memory}]}` |
-| status/config/import | (pass-through) |
-
-Error envelopes (on non-zero exit):
-```json
-{
-  "status": "error",
-  "command": "<command_name>",
-  "error": "Authentication failed. Your API key may be invalid or expired.",
-  "data": null
-}
-```
-
 Fields:
- `status`: `"success"` or `"error"`.
- `command`: The command name.
+- `status`: Always `"success"` (errors go to stderr before exit).
+- `command`: The command name (e.g. `"status"`, `"config show"`, `"import"`).
 - `duration_ms`: Optional, elapsed time in milliseconds.
- `scope`: Optional, active entity scope (omitted if empty).
+- `scope`: Optional, active entity scope.
 - `count`: Optional, result count.
- `error`: Only present when `status` is `"error"`.
- `data`: The primary payload (sanitized in agent mode).
+- `error`: Optional, error message string.
+- `data`: The primary payload.

 ### 7.3 Text Output

@@ -1369,16 +1206,6 @@ Destructive commands (`delete --all`, `delete --entity`, `entity delete`) requir
 - CI/CD pipelines
 - Scripting

-### Why `--json`/`--agent` global flags exist
-
-The `--json` and `--agent` flags (aliases of each other) activate agent mode globally. When set:
-1. All output becomes a structured JSON envelope (`{status, command, duration_ms, scope, count, data}`).
-2. The `data` field is sanitized via `sanitizeAgentData` — only the most relevant fields are included per command, reducing noise for agents parsing the output.
-3. All human-readable output (spinners, colors, banners, timing lines) is suppressed.
-4. Errors are emitted as JSON to stdout with a non-zero exit code, not to stderr as text.
-
-This is distinct from `--output json`, which returns the raw API response without sanitization.
-
 ### Why `--output json` is on every command

 Every data-returning command supports `--output json` (or `--json` for `help`). This enables machine consumption by AI agents and scripts. JSON output goes to stdout while human-readable spinners/timing go to stderr, so piping `mem0 list -o json | jq .` works cleanly.
@@ -2,8 +2,6 @@

 The official command-line interface for [mem0](https://mem0.ai) — the memory layer for AI agents. Works with the Mem0 Platform API. Available in Python and Node.js.

-> **For AI agents:** pass `--agent` (or `--json`) on any command for structured JSON output purpose-built for tool loops — sanitized fields, no colors or spinners, errors as JSON. See [Agent mode](#agent-mode) below.
-
 ## Installation

 ```bash
@@ -19,15 +17,9 @@ Both packages install a `mem0` binary with identical behavior.
 ## Quick start

 ```bash
-# Interactive setup wizard
+# Authenticate and save config
 mem0 init

-# Or login via email (get a new API key)
-mem0 init --email alice@company.com
-
-# Or authenticate with an existing API key
-mem0 init --api-key m0-xxx
-
 # Add a memory
 mem0 add "I prefer dark mode and use vim keybindings" --user-id alice

@@ -48,7 +40,7 @@ mem0 delete <memory-id>

 | Command | Description |
 |---------|-------------|
-| `mem0 init` | Setup wizard — login via email or configure API key manually |
+| `mem0 init` | Interactive setup wizard — configures API key and default user ID |
 | `mem0 add` | Add a memory from text, JSON messages, a file, or stdin |
 | `mem0 search` | Search memories using natural language |
 | `mem0 list` | List memories with optional filters and pagination |
@@ -57,43 +49,11 @@ mem0 delete <memory-id>
 | `mem0 delete` | Delete a memory, all memories for a scope, or an entity |
 | `mem0 import` | Bulk import memories from a JSON file |
 | `mem0 config` | View or modify CLI configuration |
-| `mem0 entity` | List or delete entities (users, agents, apps, runs) |
-| `mem0 event` | Inspect background processing events (bulk deletes, large add jobs) |
+| `mem0 entities` | List or delete entities (users, agents, apps) |
 | `mem0 status` | Verify API connection and display current project |
+| `mem0 version` | Print the CLI version |

-Run `mem0 <command> --help` for detailed usage on any command, or `mem0 --version` to print the CLI version.
-
-## Agent mode
-
-Pass `--agent` (or its alias `--json`) as a **global flag** on any command to get output designed for AI agent tool loops:
-
-```bash
-mem0 --agent search "user preferences" --user-id alice
-mem0 --agent add "User prefers dark mode" --user-id alice
-mem0 --agent list --user-id alice
-```
-
-Every command returns the same envelope shape:
-
-```json
-{
-  "status": "success",
-  "command": "search",
-  "duration_ms": 134,
-  "scope": { "user_id": "alice" },
-  "count": 2,
-  "data": [
-    { "id": "abc-123", "memory": "User prefers dark mode", "score": 0.97, "created_at": "2026-01-15", "categories": ["preferences"] }
-  ]
-}
-```
-
-What agent mode does differently from `--output json`:
- **Sanitized `data`**: only the fields an agent needs (id, memory, score, etc.) — no internal API noise
- **No human output**: spinners, colors, and banners are suppressed entirely
- **Errors as JSON**: errors go to stdout as `{"status": "error", "command": "...", "error": "..."}` with a non-zero exit code
-
-Use `mem0 help --json` to get the full command tree as JSON — useful for agents that need to self-discover available commands.
+Run `mem0 <command> --help` for detailed usage on any command.

 ## Output formats

@@ -102,10 +62,13 @@ Control how results are displayed with `--output`:
 | Format | Description |
 |--------|-------------|
 | `text` | Human-readable with colors and formatting (default) |
-| `json` | Structured JSON for piping to `jq` (raw API response) |
+| `json` | Structured JSON for piping to `jq` or agent consumption |
 | `table` | Tabular format (default for `list`) |
 | `quiet` | Minimal — just IDs or status codes |
-| `agent` | Structured JSON envelope with sanitized fields (set by `--agent`/`--json`) |
+
+```bash
+mem0 search "preferences" --user-id alice --output json | jq '.data.results[].memory'
+```

 ## Environment variables

@@ -207,11 +207,7 @@
        { "name": "immutable", "flags": ["--immutable"], "type": "boolean", "default": false, "help": "Prevent future updates." },
        { "name": "no_infer", "flags": ["--no-infer"], "type": "boolean", "default": false, "help": "Skip inference, store raw." },
        { "name": "expires", "flags": ["--expires"], "type": "string", "help": "Expiration date (YYYY-MM-DD)." },
-        { "name": "categories", "flags": ["--categories"], "type": "string", "help": "Not supported on add, use --custom-categories instead." },
-        { "name": "custom_instructions", "flags": ["--custom-instructions"], "type": "string", "help": "Custom instructions for fact extraction." },
-        { "name": "custom_categories", "flags": ["--custom-categories"], "type": "string", "help": "Custom categories as a JSON array of {name: description} objects." },
-        { "name": "structured_data_schema", "flags": ["--structured-data-schema"], "type": "string", "help": "Schema for structured data extraction, as JSON." },
-        { "name": "timestamp", "flags": ["--timestamp"], "type": "integer", "help": "Unix timestamp for the memory." },
+        { "name": "categories", "flags": ["--categories"], "type": "string", "help": "Categories (JSON array or comma-separated)." },
        { "name": "graph", "flags": ["--graph"], "type": "boolean", "default": false, "help": "Enable graph memory extraction.", "panel": "Scope" },
        { "name": "no_graph", "flags": ["--no-graph"], "type": "boolean", "default": false, "help": "Disable graph memory extraction.", "panel": "Scope" },
        { "name": "output", "flags": ["--output", "-o"], "type": "string", "default": "text", "help": "Output format: text, json, quiet.", "panel": "Output" }
@@ -248,9 +244,6 @@
        { "name": "keyword", "flags": ["--keyword"], "type": "boolean", "default": false, "help": "Use keyword search.", "panel": "Search" },
        { "name": "filter_json", "flags": ["--filter"], "type": "string", "help": "Advanced filter expression (JSON).", "panel": "Search" },
        { "name": "fields", "flags": ["--fields"], "type": "string", "help": "Specific fields to return (comma-separated).", "panel": "Search" },
-        { "name": "show_expired", "flags": ["--show-expired"], "type": "boolean", "default": false, "help": "Include expired memories.", "panel": "Search" },
-        { "name": "reference_date", "flags": ["--reference-date"], "type": "string", "help": "Reference date for relative queries (YYYY-MM-DD or unix timestamp).", "panel": "Search" },
-        { "name": "latest_only", "flags": ["--latest-only"], "type": "boolean", "default": false, "help": "Only return the latest version of each memory.", "panel": "Search" },
        { "name": "graph", "flags": ["--graph"], "type": "boolean", "default": false, "help": "Enable graph in search.", "panel": "Search" },
        { "name": "no_graph", "flags": ["--no-graph"], "type": "boolean", "default": false, "help": "Disable graph in search.", "panel": "Search" },
        { "name": "output", "flags": ["--output", "-o"], "type": "string", "default": "text", "help": "Output: text, json, table.", "panel": "Output" }
@@ -303,8 +296,6 @@
        { "name": "category", "flags": ["--category"], "type": "string", "help": "Filter by category.", "panel": "Filters" },
        { "name": "after", "flags": ["--after"], "type": "string", "help": "Created after (YYYY-MM-DD).", "panel": "Filters" },
        { "name": "before", "flags": ["--before"], "type": "string", "help": "Created before (YYYY-MM-DD).", "panel": "Filters" },
-        { "name": "show_expired", "flags": ["--show-expired"], "type": "boolean", "default": false, "help": "Include expired memories.", "panel": "Filters" },
-        { "name": "latest_only", "flags": ["--latest-only"], "type": "boolean", "default": false, "help": "Only return the latest version of each memory.", "panel": "Filters" },
        { "name": "graph", "flags": ["--graph"], "type": "boolean", "default": false, "help": "Enable graph in listing.", "panel": "Filters" },
        { "name": "no_graph", "flags": ["--no-graph"], "type": "boolean", "default": false, "help": "Disable graph in listing.", "panel": "Filters" },
        { "name": "output", "flags": ["--output", "-o"], "type": "string", "default": "table", "help": "Output: text, json, table.", "panel": "Output" }
@@ -338,8 +329,6 @@
      ],
      "options": [
        { "name": "metadata", "flags": ["--metadata", "-m"], "type": "string", "help": "Update metadata (JSON)." },
-        { "name": "expires", "flags": ["--expires"], "type": "string", "help": "Expiration date (YYYY-MM-DD)." },
-        { "name": "timestamp", "flags": ["--timestamp"], "type": "integer", "help": "Unix timestamp for the memory." },
        { "name": "output", "flags": ["--output", "-o"], "type": "string", "default": "text", "help": "Output: text, json, quiet.", "panel": "Output" }
      ],
      "apiEndpoint": "update"
@@ -367,7 +356,6 @@
        { "name": "all", "flags": ["--all"], "type": "boolean", "default": false, "help": "Delete all memories matching scope filters." },
        { "name": "entity", "flags": ["--entity"], "type": "boolean", "default": false, "help": "Delete the entity itself and all its memories (cascade)." },
        { "name": "project", "flags": ["--project"], "type": "boolean", "default": false, "help": "With --all: delete ALL memories project-wide." },
-        { "name": "delete_linked", "flags": ["--delete-linked"], "type": "boolean", "default": false, "help": "Also delete memories linked to this memory." },
        { "name": "dry_run", "flags": ["--dry-run"], "type": "boolean", "default": false, "help": "Show what would be deleted without deleting." },
        { "name": "force", "flags": ["--force"], "type": "boolean", "default": false, "help": "Skip confirmation." },
        { "name": "user_id", "flags": ["--user-id", "-u"], "type": "string", "help": "Scope to user.", "panel": "Scope" },
@@ -515,23 +503,15 @@
    },
    {
      "name": "init",
-      "description": "Setup wizard for mem0 CLI. Supports Agent Mode bootstrap (--agent), email login (--email), or manual API key (--api-key).",
-      "usage": "mem0 init [OPTIONS]",
+      "description": "Interactive setup wizard for mem0 CLI.",
+      "usage": "mem0 init",
      "needsBackend": false,
      "needsConfig": false,
      "resolveIds": false,
      "resolveGraph": false,
      "confirmDangerous": false,
      "arguments": [],
-      "options": [
-        { "name": "api-key", "flags": ["--api-key"], "type": "string", "default": null, "help": "API key (skip prompt)." },
-        { "name": "user-id", "flags": ["-u", "--user-id"], "type": "string", "default": null, "help": "Default user ID (skip prompt)." },
-        { "name": "email", "flags": ["--email"], "type": "string", "default": null, "help": "Login via email verification code." },
-        { "name": "code", "flags": ["--code"], "type": "string", "default": null, "help": "Verification code (use with --email for non-interactive login)." },
-        { "name": "force", "flags": ["--force"], "type": "boolean", "default": false, "help": "Overwrite existing config without confirmation." },
-        { "name": "agent", "flags": ["--agent"], "type": "boolean", "default": false, "help": "Bootstrap an unattended Agent Mode account (no email required)." },
-        { "name": "source", "flags": ["--source"], "type": "string", "default": null, "help": "Channel attribution for signup (e.g. github, hn, ph)." }
-      ]
+      "options": []
    },
    {
      "name": "status",
@@ -1,41 +0,0 @@
-# Node CLI (`cli/node/`)
-
-The `@mem0/cli` package on npm. Commander-based, entry point `mem0`.
-
-## Commands
-
-```bash
-pnpm install
-pnpm run build        # tsup (ESM)
-pnpm run lint         # biome check src/
-pnpm run lint:fix     # biome check --write src/
-pnpm run typecheck    # tsc --noEmit
-pnpm run test         # vitest run
-pnpm run test:watch
-pnpm run dev          # tsx src/index.ts
-```
-
-pnpm only. Never npm, never yarn.
-
-## Conventions
-
-> **Biome, not ESLint. vitest, not jest.** `mem0-ts/` uses Prettier + jest and
-> `integrations/vercel-ai-sdk/` uses ESLint + jest. Running those tools here produces
-> spurious diffs. Every toolchain in this repo is per-package.
-
- **Node 18+** required.
- **Build:** tsup, ESM output only.
- **Linter and formatter:** Biome, configured in `biome.json`.
- **Tests:** vitest.
- **TypeScript strict mode.** ES module `import` syntax only, never `require()`.
-
-Run `pnpm run typecheck` after every change.
-
-## Dependencies
-
-Commander + Chalk + ora + cli-table3, and `mem0ai` (npm) for API calls.
-
-## CI and release
-
- CI: `cli-node-ci.yml`, Biome + tsc + vitest + tsup build on Node 20 and 22.
- Release: tag prefix `cli-node-v*` dispatches `cli-node-cd.yml`, publishing to npm over OIDC.
@@ -1 +0,0 @@
-AGENTS.md
@@ -2,12 +2,10 @@

 The official command-line interface for [mem0](https://mem0.ai) — the memory layer for AI agents. TypeScript implementation.

-> **Built for AI agents.** Pass `--agent` (or `--json`) as a global flag on any command to get structured JSON output optimized for programmatic consumption — sanitized fields, no colors or spinners, and errors as JSON too.
-
 ## Prerequisites

 - Node.js **18+**
- pnpm (`npm install -g pnpm`) — for development only
+- pnpm (`npm install -g pnpm`)

 ## Installation

@@ -15,301 +13,22 @@ The official command-line interface for [mem0](https://mem0.ai) — the memory l
 npm install -g @mem0/cli
 ```

-## Quick start
+Or from source:

 ```bash
-# Interactive setup wizard
-mem0 init
+cd node
+pnpm install
+pnpm build
+pnpm link --global

-# Or login via email
-mem0 init --email alice@company.com
-
-# Or authenticate with an existing API key
-mem0 init --api-key m0-xxx
-
-# 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 for a user
-mem0 list --user-id alice
-
-# Get a specific memory
-mem0 get <memory-id>
-
-# Update a memory
-mem0 update <memory-id> "I switched to light mode"
-
-# Delete a memory
-mem0 delete <memory-id>
+# Now use it like a normal CLI
+mem0 --help
 ```

-## Commands
-
-### `mem0 init`
-
-Interactive setup wizard. Prompts for your API key and default user ID.
+## Running during development

 ```bash
-mem0 init
-mem0 init --api-key m0-xxx --user-id alice
-mem0 init --email alice@company.com
-```
-
-If an existing configuration is detected, the CLI asks for confirmation before overwriting. Use `--force` to skip the prompt (useful in CI/CD).
-
-```bash
-mem0 init --api-key m0-xxx --user-id alice --force
-```
-
-| Flag | Description |
-|------|-------------|
-| `--api-key` | API key (skip prompt) |
-| `-u, --user-id` | Default user ID (skip prompt) |
-| `--email` | Login via email verification code |
-| `--code` | Verification code (use with `--email` for non-interactive login) |
-| `--force` | Overwrite existing config without confirmation |
-
-### `mem0 add`
-
-Add a memory from text, a JSON messages array, a file, or stdin.
-
-```bash
-mem0 add "I prefer dark mode" --user-id alice
-mem0 add --file conversation.json --user-id alice
-echo "Loves hiking on weekends" | mem0 add --user-id alice
-```
-
-| Flag | Description |
-|------|-------------|
-| `-u, --user-id` | Scope to a user |
-| `--agent-id` | Scope to an agent |
-| `--messages` | Conversation messages as JSON |
-| `-f, --file` | Read messages from a JSON file |
-| `-m, --metadata` | Custom metadata as JSON |
-| `--categories` | Categories (JSON array or comma-separated) |
-| `--graph / --no-graph` | Enable or disable graph memory extraction |
-| `-o, --output` | Output format: `text`, `json`, `quiet` |
-
-### `mem0 search`
-
-Search memories using natural language.
-
-```bash
-mem0 search "dietary restrictions" --user-id alice
-mem0 search "preferred tools" --user-id alice --output json --top-k 5
-```
-
-| Flag | Description |
-|------|-------------|
-| `-u, --user-id` | Filter by user |
-| `-k, --top-k` | Number of results (default: 10) |
-| `--threshold` | Minimum similarity score (default: 0.3) |
-| `--rerank` | Enable reranking |
-| `--keyword` | Use keyword search instead of semantic |
-| `--filter` | Advanced filter expression (JSON) |
-| `--graph / --no-graph` | Enable or disable graph in search |
-| `-o, --output` | Output format: `text`, `json`, `table` |
-
-### `mem0 list`
-
-List memories with optional filters and pagination.
-
-```bash
-mem0 list --user-id alice
-mem0 list --user-id alice --category preferences --output json
-mem0 list --user-id alice --after 2024-01-01 --page-size 50
-```
-
-| Flag | Description |
-|------|-------------|
-| `-u, --user-id` | Filter by user |
-| `--page` | Page number (default: 1) |
-| `--page-size` | Results per page (default: 100) |
-| `--category` | Filter by category |
-| `--after` | Created after date (YYYY-MM-DD) |
-| `--before` | Created before date (YYYY-MM-DD) |
-| `-o, --output` | Output format: `text`, `json`, `table` |
-
-### `mem0 get`
-
-Retrieve a specific memory by ID.
-
-```bash
-mem0 get 7b3c1a2e-4d5f-6789-abcd-ef0123456789
-mem0 get 7b3c1a2e-4d5f-6789-abcd-ef0123456789 --output json
-```
-
-### `mem0 update`
-
-Update the text or metadata of an existing memory.
-
-```bash
-mem0 update <memory-id> "Updated preference text"
-mem0 update <memory-id> --metadata '{"priority": "high"}'
-echo "new text" | mem0 update <memory-id>
-```
-
-### `mem0 delete`
-
-Delete a single memory, all memories for a scope, or an entire entity.
-
-```bash
-# Delete a single memory
-mem0 delete <memory-id>
-
-# Delete all memories for a user
-mem0 delete --all --user-id alice --force
-
-# Delete all memories project-wide
-mem0 delete --all --project --force
-
-# Preview what would be deleted
-mem0 delete --all --user-id alice --dry-run
-```
-
-| Flag | Description |
-|------|-------------|
-| `--all` | Delete all memories matching scope filters |
-| `--entity` | Delete the entity and all its memories |
-| `--project` | With `--all`: delete all memories project-wide |
-| `--dry-run` | Preview without deleting |
-| `--force` | Skip confirmation prompt |
-
-### `mem0 import`
-
-Bulk import memories from a JSON file.
-
-```bash
-mem0 import data.json --user-id alice
-```
-
-The file should be a JSON array where each item has a `memory` (or `text` or `content`) field and optional `user_id`, `agent_id`, and `metadata` fields.
-
-### `mem0 config`
-
-View or modify the local CLI configuration.
-
-```bash
-mem0 config show              # Display current config (secrets redacted)
-mem0 config get api_key       # Get a specific value
-mem0 config set user_id bob   # Set a value
-```
-
-### `mem0 entity`
-
-List or delete entities (users, agents, apps, runs).
-
-```bash
-mem0 entity list users
-mem0 entity list agents --output json
-mem0 entity delete --user-id alice --force
-```
-
-### `mem0 event`
-
-Inspect background processing events created by async operations (e.g. bulk deletes, large add jobs).
-
-```bash
-# List recent events
-mem0 event list
-
-# Check the status of a specific event
-mem0 event status <event-id>
-```
-
-| Flag | Description |
-|------|-------------|
-| `-o, --output` | Output format: `text`, `json` |
-
-### `mem0 status`
-
-Verify your API connection and display the current project.
-
-```bash
-mem0 status
-```
-
-## Agent mode
-
-Pass `--agent` (or its alias `--json`) as a **global flag** on any command to get output designed for AI agent tool loops:
-
-```bash
-mem0 --agent search "user preferences" --user-id alice
-mem0 --agent add "User prefers dark mode" --user-id alice
-mem0 --agent list --user-id alice
-mem0 --agent delete --all --user-id alice --force
-```
-
-Every command returns the same envelope shape:
-
-```json
-{
-  "status": "success",
-  "command": "search",
-  "duration_ms": 134,
-  "scope": { "user_id": "alice" },
-  "count": 2,
-  "data": [
-    { "id": "abc-123", "memory": "User prefers dark mode", "score": 0.97, "created_at": "2026-01-15", "categories": ["preferences"] }
-  ]
-}
-```
-
-What agent mode does differently from `--output json`:
-
- **Sanitized `data`**: only the fields an agent needs (id, memory, score, etc.) — no internal API noise
- **No human output**: spinners, colors, and banners are suppressed entirely
- **Errors as JSON**: errors go to stdout as `{"status": "error", "command": "...", "error": "..."}` with a non-zero exit code
-
-Use `mem0 help --json` to get the full command tree as JSON — useful for agents that need to self-discover available commands.
-
-## Output formats
-
-Control how results are displayed with `--output`:
-
-| Format | Description |
-|--------|-------------|
-| `text` | Human-readable with colors and formatting (default) |
-| `json` | Structured JSON for piping to `jq` (raw API response) |
-| `table` | Tabular format (default for `list`) |
-| `quiet` | Minimal — just IDs or status codes |
-| `agent` | Structured JSON envelope with sanitized fields (set by `--agent`/`--json`) |
-
-## Global flags
-
-These flags are available on all commands:
-
-| Flag | Description |
-|------|-------------|
-| `--json` | Enable agent mode: structured JSON envelope output, no colors or spinners |
-| `--agent` | Alias for `--json` |
-| `--api-key` | Override the configured API key for this request |
-| `--base-url` | Override the configured API base URL for this request |
-| `-o, --output` | Set the output format |
-
-`mem0 --version` prints the CLI version. It is only valid before a subcommand, not after one.
-
-## 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`) |
-
-Environment variables take precedence over values in the config file, which take precedence over defaults.
-
-## Development
-
-```bash
-cd cli/node
+cd node
 pnpm install

 # Development mode (runs TypeScript directly, no build needed)
@@ -320,11 +39,36 @@ 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
 ```

-## Documentation
+## Quick Start

-Full documentation is available at [docs.mem0.ai/platform/cli](https://docs.mem0.ai/platform/cli).
+```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

@@ -51,7 +51,7 @@ pnpm link --global

 # Now use it like a normal CLI
 mem0 --help
-mem0 --version
+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`.
@@ -1,13 +1,13 @@
 {
  "name": "@mem0/cli",
-  "version": "0.2.12",
+  "version": "0.1.0",
  "description": "The official CLI for mem0 — the memory layer for AI agents",
  "type": "module",
  "bin": {
    "mem0": "./dist/index.js"
  },
  "scripts": {
-    "build": "tsup",
+    "build": "tsup src/index.ts --format esm --dts --clean",
    "dev": "tsx src/index.ts",
    "test": "vitest run",
    "test:watch": "vitest",
@@ -20,11 +20,6 @@
  },
  "license": "Apache-2.0",
  "author": "mem0.ai <founders@mem0.ai>",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/mem0ai/mem0",
-    "directory": "cli/node"
-  },
  "keywords": ["mem0", "memory", "ai", "agents", "cli"],
  "publishConfig": {
    "access": "public"
@@ -40,19 +35,8 @@
    "typescript": "^5.4.0",
    "tsup": "^8.0.0",
    "tsx": "^4.7.0",
-    "vite": "^6.0.0",
-    "vitest": "^4.1.0",
+    "vitest": "^1.5.0",
    "@biomejs/biome": "^1.7.0",
    "@types/node": "^20.0.0"
-  },
-  "pnpm": {
-    "overrides": {
-      "jws@4.0.0": "4.0.1",
-      "langsmith@<0.6.0": "^0.6.0",
-      "tar-fs@>=2.0.0 <2.1.4": "^2.1.4",
-      "picomatch@<2.3.2": "^2.3.2",
-      "esbuild": ">=0.28.1",
-      "postcss@<8.5.18": ">=8.5.18 <9.0.0"
-    }
  }
 }
@@ -1,14 +0,0 @@
-packages:
-  - '.'
-
-onlyBuiltDependencies:
-  - "@biomejs/biome"
-  - esbuild
-
-overrides:
-  jws@4.0.0: 4.0.1
-  langsmith@<0.6.0: ^0.6.0
-  tar-fs@>=2.0.0 <2.1.4: ^2.1.4
-  picomatch@<2.3.2: ^2.3.2
-  "esbuild": ">=0.28.1"
-  "postcss@<8.5.18": ">=8.5.18 <9.0.0"
@@ -1,32 +0,0 @@
-/**
- * Detect whether the CLI is being invoked from inside an AI-agent context.
- *
- * Used by `mem0 init` to auto-enter Agent Mode (Rule 3 bootstrap) when an
- * agent runtime env var is present. The return value is a context **trigger
- * only** — the canonical agent identity is self-declared by the agent via
- * `--agent-caller <name>` (Proof Editor-style) and never sniffed from env
- * vars to fill the `agent_caller` field on the APIKey row.
- *
- * Returns a short name or null. Honest reporting depends on `--agent-caller`;
- * this list is just enough to enable the zero-friction auto-bootstrap UX.
- */
-
-const AGENT_CALLER_ENV: ReadonlyArray<readonly [string, readonly string[]]> = [
-	["claude-code", ["CLAUDECODE", "CLAUDE_CODE"]],
-	["cursor", ["CURSOR_AGENT", "CURSOR_SESSION_ID"]],
-	["codex", ["CODEX_CLI", "OPENAI_CODEX"]],
-	["cline", ["CLINE_AGENT", "CLINE"]],
-	["continue", ["CONTINUE_AGENT", "CONTINUE_SESSION"]],
-	["aider", ["AIDER_SESSION"]],
-	["goose", ["GOOSE_AGENT"]],
-	["windsurf", ["WINDSURF_AGENT"]],
-] as const;
-
-export function detectAgentCaller(): string | null {
-	for (const [name, envVars] of AGENT_CALLER_ENV) {
-		if (envVars.some((v) => process.env[v])) {
-			return name;
-		}
-	}
-	return null;
-}
@@ -6,138 +6,110 @@ import type { Mem0Config } from "../config.js";
 import { PlatformBackend } from "./platform.js";

 export interface AddOptions {
-	userId?: string;
-	agentId?: string;
-	appId?: string;
-	runId?: string;
-	metadata?: Record<string, unknown>;
-	immutable?: boolean;
-	infer?: boolean;
-	expires?: string;
-	customInstructions?: string;
-	agentCustomInstructions?: string;
-	customCategories?: Record<string, string>[];
-	structuredDataSchema?: Record<string, unknown>;
-	timestamp?: number;
+  userId?: string;
+  agentId?: string;
+  appId?: string;
+  runId?: string;
+  metadata?: Record<string, unknown>;
+  immutable?: boolean;
+  infer?: boolean;
+  expires?: string;
+  categories?: string[];
+  enableGraph?: boolean;
 }

 export interface SearchOptions {
-	userId?: string;
-	agentId?: string;
-	appId?: string;
-	runId?: string;
-	topK?: number;
-	threshold?: number;
-	rerank?: boolean;
-	keyword?: boolean;
-	filters?: Record<string, unknown>;
-	fields?: string[];
-	showExpired?: boolean;
-	referenceDate?: string | number;
-	latestOnly?: boolean;
+  userId?: string;
+  agentId?: string;
+  appId?: string;
+  runId?: string;
+  topK?: number;
+  threshold?: number;
+  rerank?: boolean;
+  keyword?: boolean;
+  filters?: Record<string, unknown>;
+  fields?: string[];
+  enableGraph?: boolean;
 }

 export interface ListOptions {
-	userId?: string;
-	agentId?: string;
-	appId?: string;
-	runId?: string;
-	page?: number;
-	pageSize?: number;
-	category?: string;
-	after?: string;
-	before?: string;
-	showExpired?: boolean;
-	latestOnly?: boolean;
+  userId?: string;
+  agentId?: string;
+  appId?: string;
+  runId?: string;
+  page?: number;
+  pageSize?: number;
+  category?: string;
+  after?: string;
+  before?: string;
+  enableGraph?: boolean;
 }

 export interface DeleteOptions {
-	all?: boolean;
-	userId?: string;
-	agentId?: string;
-	appId?: string;
-	runId?: string;
-	deleteLinked?: boolean;
-}
-
-export interface UpdateOptions {
-	expirationDate?: string;
-	timestamp?: number;
+  all?: boolean;
+  userId?: string;
+  agentId?: string;
+  appId?: string;
+  runId?: string;
 }

 export interface EntityIds {
-	userId?: string;
-	agentId?: string;
-	appId?: string;
-	runId?: string;
+  userId?: string;
+  agentId?: string;
+  appId?: string;
+  runId?: string;
 }

 export interface Backend {
-	add(
-		content?: string,
-		messages?: Record<string, unknown>[],
-		opts?: AddOptions,
-	): Promise<Record<string, unknown>>;
+  add(
+    content?: string,
+    messages?: Record<string, unknown>[],
+    opts?: AddOptions,
+  ): Promise<Record<string, unknown>>;

-	search(
-		query: string,
-		opts?: SearchOptions,
-	): Promise<Record<string, unknown>[]>;
+  search(query: string, opts?: SearchOptions): Promise<Record<string, unknown>[]>;

-	get(memoryId: string): Promise<Record<string, unknown>>;
+  get(memoryId: string): Promise<Record<string, unknown>>;

-	listMemories(opts?: ListOptions): Promise<Record<string, unknown>[]>;
+  listMemories(opts?: ListOptions): Promise<Record<string, unknown>[]>;

-	update(
-		memoryId: string,
-		content?: string,
-		metadata?: Record<string, unknown>,
-		opts?: UpdateOptions,
-	): Promise<Record<string, unknown>>;
+  update(
+    memoryId: string,
+    content?: string,
+    metadata?: Record<string, unknown>,
+  ): Promise<Record<string, unknown>>;

-	delete(
-		memoryId?: string,
-		opts?: DeleteOptions,
-	): Promise<Record<string, unknown>>;
+  delete(memoryId?: string, opts?: DeleteOptions): Promise<Record<string, unknown>>;

-	deleteEntities(opts: EntityIds): Promise<Record<string, unknown>>;
+  deleteEntities(opts: EntityIds): Promise<Record<string, unknown>>;

-	ping(): Promise<Record<string, unknown>>;
+  status(opts?: { userId?: string; agentId?: string }): Promise<Record<string, unknown>>;

-	status(opts?: { userId?: string; agentId?: string }): Promise<
-		Record<string, unknown>
-	>;
-
-	entities(entityType: string): Promise<Record<string, unknown>[]>;
-
-	listEvents(): Promise<Record<string, unknown>[]>;
-
-	getEvent(eventId: string): Promise<Record<string, unknown>>;
+  entities(entityType: string): Promise<Record<string, unknown>[]>;
 }

 export class AuthError extends Error {
-	constructor(
-		message = "Authentication failed. Your API key may be invalid or expired.",
-	) {
-		super(message);
-		this.name = "AuthError";
-	}
+  constructor(message = "Authentication failed. Your API key may be invalid or expired.") {
+    super(message);
+    this.name = "AuthError";
+  }
 }

 export class NotFoundError extends Error {
-	constructor(path: string) {
-		super(`Resource not found: ${path}`);
-		this.name = "NotFoundError";
-	}
+  constructor(path: string) {
+    super(`Resource not found: ${path}`);
+    this.name = "NotFoundError";
+  }
 }

 export class APIError extends Error {
-	constructor(path: string, detail: string) {
-		super(`Bad request to ${path}: ${detail}`);
-		this.name = "APIError";
-	}
+  constructor(path: string, detail: string) {
+    super(`Bad request to ${path}: ${detail}`);
+    this.name = "APIError";
+  }
 }

 export function getBackend(config: Mem0Config): Backend {
-	return new PlatformBackend(config.platform);
+  return new PlatformBackend(config.platform);
 }
+
@@ -3,12 +3,5 @@
 */

 export { getBackend } from "./base.js";
-export type {
-	Backend,
-	AddOptions,
-	SearchOptions,
-	ListOptions,
-	DeleteOptions,
-	EntityIds,
-} from "./base.js";
+export type { Backend, AddOptions, SearchOptions, ListOptions, DeleteOptions, EntityIds } from "./base.js";
 export { AuthError, NotFoundError, APIError } from "./base.js";
@@ -3,426 +3,301 @@
 */

 import type { PlatformConfig } from "../config.js";
-import { captureNotice, isAgentMode } from "../state.js";
-import { CLI_VERSION } from "../version.js";
 import {
-	APIError,
-	type AddOptions,
-	AuthError,
-	type Backend,
-	type DeleteOptions,
-	type EntityIds,
-	type ListOptions,
-	NotFoundError,
-	type SearchOptions,
-	type UpdateOptions,
+  type AddOptions,
+  APIError,
+  AuthError,
+  type Backend,
+  type DeleteOptions,
+  type EntityIds,
+  type ListOptions,
+  NotFoundError,
+  type SearchOptions,
 } from "./base.js";

-function encodePathSegment(value: unknown): string {
-	return encodeURIComponent(String(value));
-}
-
 export class PlatformBackend implements Backend {
-	private baseUrl: string;
-	private headers: Record<string, string>;
+  private baseUrl: string;
+  private headers: Record<string, string>;

-	constructor(config: PlatformConfig) {
-		this.baseUrl = config.baseUrl.replace(/\/+$/, "");
-		this.headers = {
-			Authorization: `Token ${config.apiKey}`,
-			"Content-Type": "application/json",
-			"X-Mem0-Source": "cli",
-			"X-Mem0-Client-Language": "node",
-			"X-Mem0-Client-Version": CLI_VERSION,
-		};
-	}
+  constructor(config: PlatformConfig) {
+    this.baseUrl = config.baseUrl.replace(/\/+$/, "");
+    this.headers = {
+      Authorization: `Token ${config.apiKey}`,
+      "Content-Type": "application/json",
+    };
+  }

-	private async _request(
-		method: string,
-		path: string,
-		opts?: { json?: unknown; params?: Record<string, string> },
-	): Promise<unknown> {
-		let url = `${this.baseUrl}${path}`;
-		if (opts?.params) {
-			const qs = new URLSearchParams(opts.params).toString();
-			url += `?${qs}`;
-		}
+  private async _request(
+    method: string,
+    path: string,
+    opts?: { json?: unknown; params?: Record<string, string> },
+  ): Promise<unknown> {
+    let url = `${this.baseUrl}${path}`;
+    if (opts?.params) {
+      const qs = new URLSearchParams(opts.params).toString();
+      url += `?${qs}`;
+    }

-		const headers = {
-			...this.headers,
-			"X-Mem0-Caller-Type": isAgentMode() ? "agent" : "user",
-		};
+    const fetchOpts: RequestInit = {
+      method,
+      headers: this.headers,
+      signal: AbortSignal.timeout(30_000),
+    };
+    if (opts?.json) {
+      fetchOpts.body = JSON.stringify(opts.json);
+    }

-		const fetchOpts: RequestInit = {
-			method,
-			headers,
-			signal: AbortSignal.timeout(30_000),
-		};
-		if (opts?.json) {
-			fetchOpts.body = JSON.stringify(opts.json);
-		}
+    const resp = await fetch(url, fetchOpts);

-		const resp = await fetch(url, fetchOpts);
+    if (resp.status === 401) {
+      throw new AuthError();
+    }
+    if (resp.status === 404) {
+      throw new NotFoundError(path);
+    }
+    if (resp.status === 400) {
+      let detail: string;
+      try {
+        const body = await resp.json();
+        detail = (body as Record<string, string>).detail ?? resp.statusText;
+      } catch {
+        detail = resp.statusText;
+      }
+      throw new APIError(path, detail);
+    }
+    if (!resp.ok) {
+      throw new Error(`HTTP ${resp.status}: ${resp.statusText}`);
+    }
+    if (resp.status === 204) {
+      return {};
+    }
+    return resp.json();
+  }

-		if (resp.status === 401) {
-			throw new AuthError();
-		}
-		if (resp.status === 404) {
-			throw new NotFoundError(path);
-		}
-		if (resp.status === 400) {
-			let detail: string;
-			try {
-				const body = (await resp.json()) as Record<string, unknown>;
-				detail =
-					((body.detail ?? body.message ?? JSON.stringify(body)) as string) ??
-					resp.statusText;
-			} catch {
-				detail = resp.statusText;
-			}
-			throw new APIError(path, detail);
-		}
-		if (!resp.ok) {
-			let detail: string = resp.statusText;
-			try {
-				const body = (await resp.json()) as Record<string, unknown>;
-				detail = (body.detail ?? body.message ?? resp.statusText) as string;
-			} catch {
-				/* ignore */
-			}
-			throw new Error(`HTTP ${resp.status}: ${detail}`);
-		}
-		if (resp.status === 204) {
-			return {};
-		}
+  async add(
+    content?: string,
+    messages?: Record<string, unknown>[],
+    opts: AddOptions = {},
+  ): Promise<Record<string, unknown>> {
+    const payload: Record<string, unknown> = {};

-		const data = await resp.json();
+    if (messages) {
+      payload.messages = messages;
+    } else if (content) {
+      payload.messages = [{ role: "user", content }];
+    }

-		// Pull the unclaimed-Agent-Mode notice out of the body (or the header
-		// fallback for endpoints returning non-dict / non-dict-leading payloads)
-		// and stash for end-of-command surfacing.
-		let notice: string | null = null;
-		if (
-			data &&
-			typeof data === "object" &&
-			!Array.isArray(data) &&
-			"mem0_notice" in data
-		) {
-			notice = (data as Record<string, unknown>).mem0_notice as string;
-			// biome-ignore lint/performance/noDelete: intentional strip so downstream consumers don't see duplicate notice
-			delete (data as Record<string, unknown>).mem0_notice;
-		} else if (
-			Array.isArray(data) &&
-			data.length > 0 &&
-			typeof data[0] === "object" &&
-			data[0] !== null &&
-			"mem0_notice" in data[0]
-		) {
-			notice = (data[0] as Record<string, unknown>).mem0_notice as string;
-			// biome-ignore lint/performance/noDelete: see above.
-			delete (data[0] as Record<string, unknown>).mem0_notice;
-		}
-		if (!notice) {
-			notice = resp.headers.get("X-Mem0-Notice-Message") ?? null;
-		}
-		captureNotice(notice);
+    if (opts.userId) payload.user_id = opts.userId;
+    if (opts.agentId) payload.agent_id = opts.agentId;
+    if (opts.appId) payload.app_id = opts.appId;
+    if (opts.runId) payload.run_id = opts.runId;
+    if (opts.metadata) payload.metadata = opts.metadata;
+    if (opts.immutable) payload.immutable = true;
+    if (opts.infer === false) payload.infer = false;
+    if (opts.expires) payload.expiration_date = opts.expires;
+    if (opts.categories) payload.categories = opts.categories;
+    if (opts.enableGraph) payload.enable_graph = true;

-		return data;
-	}
+    return (await this._request("POST", "/v1/memories/", { json: payload })) as Record<
+      string,
+      unknown
+    >;
+  }

-	async add(
-		content?: string,
-		messages?: Record<string, unknown>[],
-		opts: AddOptions = {},
-	): Promise<Record<string, unknown>> {
-		const payload: Record<string, unknown> = {};
+  private _buildFilters(opts: {
+    userId?: string;
+    agentId?: string;
+    appId?: string;
+    runId?: string;
+    extraFilters?: Record<string, unknown>;
+  }): Record<string, unknown> | undefined {
+    // If caller passed a pre-built filter structure, use it directly
+    if (opts.extraFilters && ("AND" in opts.extraFilters || "OR" in opts.extraFilters)) {
+      return opts.extraFilters;
+    }

-		if (messages) {
-			payload.messages = messages;
-		} else if (content) {
-			payload.messages = [{ role: "user", content }];
-		}
+    const andConditions: Record<string, unknown>[] = [];
+    if (opts.userId) andConditions.push({ user_id: opts.userId });
+    if (opts.agentId) andConditions.push({ agent_id: opts.agentId });
+    if (opts.appId) andConditions.push({ app_id: opts.appId });
+    if (opts.runId) andConditions.push({ run_id: opts.runId });

-		if (opts.userId) payload.user_id = opts.userId;
-		if (opts.agentId) payload.agent_id = opts.agentId;
-		if (opts.appId) payload.app_id = opts.appId;
-		if (opts.runId) payload.run_id = opts.runId;
-		if (opts.metadata) payload.metadata = opts.metadata;
-		if (opts.immutable) payload.immutable = true;
-		if (opts.infer === false) payload.infer = false;
-		if (opts.expires) payload.expiration_date = opts.expires;
-		if (opts.customInstructions)
-			payload.custom_instructions = opts.customInstructions;
-		if (opts.agentCustomInstructions)
-			payload.agent_custom_instructions = opts.agentCustomInstructions;
-		if (opts.customCategories)
-			payload.custom_categories = opts.customCategories;
-		if (opts.structuredDataSchema)
-			payload.structured_data_schema = opts.structuredDataSchema;
-		if (opts.timestamp !== undefined) payload.timestamp = opts.timestamp;
-		payload.source = "CLI";
+    if (opts.extraFilters) {
+      for (const [k, v] of Object.entries(opts.extraFilters)) {
+        andConditions.push({ [k]: v });
+      }
+    }

-		return (await this._request("POST", "/v3/memories/add/", {
-			json: payload,
-		})) as Record<string, unknown>;
-	}
+    if (andConditions.length === 1) return andConditions[0];
+    if (andConditions.length > 1) return { AND: andConditions };
+    return undefined;
+  }

-	private _buildFilters(opts: {
-		userId?: string;
-		agentId?: string;
-		appId?: string;
-		runId?: string;
-		extraFilters?: Record<string, unknown>;
-	}): Record<string, unknown> | undefined {
-		// If caller passed a pre-built filter structure, use it directly
-		if (
-			opts.extraFilters &&
-			("AND" in opts.extraFilters || "OR" in opts.extraFilters)
-		) {
-			return opts.extraFilters;
-		}
+  async search(query: string, opts: SearchOptions = {}): Promise<Record<string, unknown>[]> {
+    const payload: Record<string, unknown> = {
+      query,
+      top_k: opts.topK ?? 10,
+      threshold: opts.threshold ?? 0.3,
+    };

-		const andConditions: Record<string, unknown>[] = [];
-		if (opts.userId) andConditions.push({ user_id: opts.userId });
-		if (opts.agentId) andConditions.push({ agent_id: opts.agentId });
-		if (opts.appId) andConditions.push({ app_id: opts.appId });
-		if (opts.runId) andConditions.push({ run_id: opts.runId });
+    const apiFilters = this._buildFilters({
+      userId: opts.userId,
+      agentId: opts.agentId,
+      appId: opts.appId,
+      runId: opts.runId,
+      extraFilters: opts.filters,
+    });
+    if (apiFilters) payload.filters = apiFilters;
+    if (opts.rerank) payload.rerank = true;
+    if (opts.keyword) payload.keyword_search = true;
+    if (opts.fields) payload.fields = opts.fields;
+    if (opts.enableGraph) payload.enable_graph = true;

-		if (opts.extraFilters) {
-			for (const [k, v] of Object.entries(opts.extraFilters)) {
-				andConditions.push({ [k]: v });
-			}
-		}
+    const result = (await this._request("POST", "/v2/memories/search/", {
+      json: payload,
+    })) as unknown;
+    if (Array.isArray(result)) return result;
+    const obj = result as Record<string, unknown>;
+    return (obj.results ?? obj.memories ?? []) as Record<string, unknown>[];
+  }

-		if (andConditions.length === 1) return andConditions[0];
-		if (andConditions.length > 1) return { AND: andConditions };
-		return undefined;
-	}
+  async get(memoryId: string): Promise<Record<string, unknown>> {
+    return (await this._request("GET", `/v1/memories/${memoryId}/`)) as Record<string, unknown>;
+  }

-	async search(
-		query: string,
-		opts: SearchOptions = {},
-	): Promise<Record<string, unknown>[]> {
-		const payload: Record<string, unknown> = {
-			query,
-			top_k: opts.topK ?? 10,
-			threshold: opts.threshold ?? 0.3,
-		};
+  async listMemories(opts: ListOptions = {}): Promise<Record<string, unknown>[]> {
+    const payload: Record<string, unknown> = {};
+    const params: Record<string, string> = {
+      page: String(opts.page ?? 1),
+      page_size: String(opts.pageSize ?? 100),
+    };

-		const apiFilters = this._buildFilters({
-			userId: opts.userId,
-			agentId: opts.agentId,
-			appId: opts.appId,
-			runId: opts.runId,
-			extraFilters: opts.filters,
-		});
-		if (apiFilters) payload.filters = apiFilters;
-		if (opts.rerank) payload.rerank = true;
-		if (opts.keyword) payload.keyword_search = true;
-		if (opts.fields) payload.fields = opts.fields;
-		if (opts.showExpired) payload.show_expired = true;
-		if (opts.referenceDate !== undefined)
-			payload.reference_date = opts.referenceDate;
-		if (opts.latestOnly) payload.latest_only = true;
-		payload.source = "CLI";
+    const extra: Record<string, unknown> = {};
+    if (opts.category) {
+      extra.categories = { contains: opts.category };
+    }
+    if (opts.after) {
+      extra.created_at = { ...(extra.created_at as Record<string, unknown> | undefined), gte: opts.after };
+    }
+    if (opts.before) {
+      extra.created_at = { ...(extra.created_at as Record<string, unknown> | undefined), lte: opts.before };
+    }

-		const result = (await this._request("POST", "/v3/memories/search/", {
-			json: payload,
-		})) as unknown;
-		if (Array.isArray(result)) return result;
-		const obj = result as Record<string, unknown>;
-		return (obj.results ?? obj.memories ?? []) as Record<string, unknown>[];
-	}
+    const apiFilters = this._buildFilters({
+      userId: opts.userId,
+      agentId: opts.agentId,
+      appId: opts.appId,
+      runId: opts.runId,
+      extraFilters: Object.keys(extra).length > 0 ? extra : undefined,
+    });
+    if (apiFilters) payload.filters = apiFilters;
+    if (opts.enableGraph) payload.enable_graph = true;

-	async get(memoryId: string): Promise<Record<string, unknown>> {
-		return (await this._request(
-			"GET",
-			`/v1/memories/${encodePathSegment(memoryId)}/`,
-			{
-				params: { source: "CLI" },
-			},
-		)) as Record<string, unknown>;
-	}
+    const result = (await this._request("POST", "/v2/memories/", { json: payload, params })) as unknown;
+    if (Array.isArray(result)) return result;
+    const obj = result as Record<string, unknown>;
+    return (obj.results ?? obj.memories ?? []) as Record<string, unknown>[];
+  }

-	async listMemories(
-		opts: ListOptions = {},
-	): Promise<Record<string, unknown>[]> {
-		const payload: Record<string, unknown> = {};
-		const params: Record<string, string> = {
-			page: String(opts.page ?? 1),
-			page_size: String(opts.pageSize ?? 100),
-		};
+  async update(
+    memoryId: string,
+    content?: string,
+    metadata?: Record<string, unknown>,
+  ): Promise<Record<string, unknown>> {
+    const payload: Record<string, unknown> = {};
+    if (content) payload.text = content;
+    if (metadata) payload.metadata = metadata;
+    return (await this._request("PUT", `/v1/memories/${memoryId}/`, {
+      json: payload,
+    })) as Record<string, unknown>;
+  }

-		const extra: Record<string, unknown> = {};
-		if (opts.category) {
-			extra.categories = { contains: opts.category };
-		}
-		if (opts.after) {
-			extra.created_at = {
-				...(extra.created_at as Record<string, unknown> | undefined),
-				gte: opts.after,
-			};
-		}
-		if (opts.before) {
-			extra.created_at = {
-				...(extra.created_at as Record<string, unknown> | undefined),
-				lte: opts.before,
-			};
-		}
+  async delete(
+    memoryId?: string,
+    opts: DeleteOptions = {},
+  ): Promise<Record<string, unknown>> {
+    if (opts.all) {
+      const params: Record<string, string> = {};
+      if (opts.userId) params.user_id = opts.userId;
+      if (opts.agentId) params.agent_id = opts.agentId;
+      if (opts.appId) params.app_id = opts.appId;
+      if (opts.runId) params.run_id = opts.runId;
+      return (await this._request("DELETE", "/v1/memories/", { params })) as Record<
+        string,
+        unknown
+      >;
+    }
+    if (memoryId) {
+      return (await this._request("DELETE", `/v1/memories/${memoryId}/`)) as Record<
+        string,
+        unknown
+      >;
+    }
+    throw new Error("Either memoryId or --all is required");
+  }

-		const apiFilters = this._buildFilters({
-			userId: opts.userId,
-			agentId: opts.agentId,
-			appId: opts.appId,
-			runId: opts.runId,
-			extraFilters: Object.keys(extra).length > 0 ? extra : undefined,
-		});
-		if (apiFilters) payload.filters = apiFilters;
-		if (opts.showExpired) payload.show_expired = true;
-		if (opts.latestOnly) payload.latest_only = true;
-		payload.source = "CLI";
+  async deleteEntities(opts: EntityIds): Promise<Record<string, unknown>> {
+    const params: Record<string, string> = {};
+    if (opts.userId) params.user_id = opts.userId;
+    if (opts.agentId) params.agent_id = opts.agentId;
+    if (opts.appId) params.app_id = opts.appId;
+    if (opts.runId) params.run_id = opts.runId;
+    if (Object.keys(params).length === 0) {
+      throw new Error("At least one entity ID is required for deleteEntities.");
+    }
+    return (await this._request("DELETE", "/v1/entities/", { params })) as Record<
+      string,
+      unknown
+    >;
+  }

-		const result = (await this._request("POST", "/v3/memories/", {
-			json: payload,
-			params,
-		})) as unknown;
-		if (Array.isArray(result)) return result;
-		const obj = result as Record<string, unknown>;
-		return (obj.results ?? obj.memories ?? []) as Record<string, unknown>[];
-	}
+  async status(
+    opts: { userId?: string; agentId?: string } = {},
+  ): Promise<Record<string, unknown>> {
+    try {
+      if (opts.userId || opts.agentId) {
+        const payload: Record<string, unknown> = {};
+        const statusParams: Record<string, string> = { page: "1", page_size: "1" };
+        const apiFilters = this._buildFilters({
+          userId: opts.userId,
+          agentId: opts.agentId,
+        });
+        if (apiFilters) payload.filters = apiFilters;
+        await this._request("POST", "/v2/memories/", { json: payload, params: statusParams });
+      } else {
+        await this._request("GET", "/v1/entities/");
+      }
+      return { connected: true, backend: "platform", base_url: this.baseUrl };
+    } catch (e) {
+      return {
+        connected: false,
+        backend: "platform",
+        error: e instanceof Error ? e.message : String(e),
+      };
+    }
+  }

-	async update(
-		memoryId: string,
-		content?: string,
-		metadata?: Record<string, unknown>,
-		opts: UpdateOptions = {},
-	): Promise<Record<string, unknown>> {
-		const payload: Record<string, unknown> = {};
-		if (content) payload.text = content;
-		if (metadata) payload.metadata = metadata;
-		if (opts.expirationDate) payload.expiration_date = opts.expirationDate;
-		if (opts.timestamp !== undefined) payload.timestamp = opts.timestamp;
-		payload.source = "CLI";
-		return (await this._request(
-			"PUT",
-			`/v1/memories/${encodePathSegment(memoryId)}/`,
-			{
-				json: payload,
-			},
-		)) as Record<string, unknown>;
-	}
+  async entities(entityType: string): Promise<Record<string, unknown>[]> {
+    const result = (await this._request("GET", "/v1/entities/")) as unknown;
+    let items: Record<string, unknown>[];
+    if (Array.isArray(result)) {
+      items = result;
+    } else {
+      items = ((result as Record<string, unknown>).results ?? []) as Record<string, unknown>[];
+    }

-	async delete(
-		memoryId?: string,
-		opts: DeleteOptions = {},
-	): Promise<Record<string, unknown>> {
-		if (opts.all) {
-			const params: Record<string, string> = { source: "CLI" };
-			if (opts.userId) params.user_id = opts.userId;
-			if (opts.agentId) params.agent_id = opts.agentId;
-			if (opts.appId) params.app_id = opts.appId;
-			if (opts.runId) params.run_id = opts.runId;
-			return (await this._request("DELETE", "/v1/memories/", {
-				params,
-			})) as Record<string, unknown>;
-		}
-		if (memoryId) {
-			const params: Record<string, string> = { source: "CLI" };
-			if (opts.deleteLinked) params.delete_linked = "true";
-			return (await this._request(
-				"DELETE",
-				`/v1/memories/${encodePathSegment(memoryId)}/`,
-				{ params },
-			)) as Record<string, unknown>;
-		}
-		throw new Error("Either memoryId or --all is required");
-	}
-
-	async deleteEntities(opts: EntityIds): Promise<Record<string, unknown>> {
-		// v2 endpoint: DELETE /v2/entities/{entity_type}/{entity_id}/
-		const typeMap: [string, string | undefined][] = [
-			["user", opts.userId],
-			["agent", opts.agentId],
-			["app", opts.appId],
-			["run", opts.runId],
-		];
-		const entities = typeMap.filter(([, v]) => v) as [string, string][];
-		if (entities.length === 0) {
-			throw new Error("At least one entity ID is required for deleteEntities.");
-		}
-		// Delete each provided entity via the v2 path-based endpoint. Key each
-		// response by entity type so a multi-entity delete (e.g. --user-id and
-		// --agent-id together) doesn't discard everything but the last result.
-		const results: Record<string, unknown> = {};
-		for (const [entityType, entityId] of entities) {
-			results[entityType] = (await this._request(
-				"DELETE",
-				`/v2/entities/${encodePathSegment(entityType)}/${encodePathSegment(entityId)}/`,
-				{ params: { source: "CLI" } },
-			)) as Record<string, unknown>;
-		}
-		return results;
-	}
-
-	async ping(): Promise<Record<string, unknown>> {
-		return (await this._request("GET", "/v1/ping/")) as Record<string, unknown>;
-	}
-
-	async status(
-		opts: { userId?: string; agentId?: string } = {},
-	): Promise<Record<string, unknown>> {
-		try {
-			await this.ping();
-			return { connected: true, backend: "platform", base_url: this.baseUrl };
-		} catch (e) {
-			return {
-				connected: false,
-				backend: "platform",
-				error: e instanceof Error ? e.message : String(e),
-			};
-		}
-	}
-
-	async entities(entityType: string): Promise<Record<string, unknown>[]> {
-		const result = (await this._request("GET", "/v1/entities/")) as unknown;
-		let items: Record<string, unknown>[];
-		if (Array.isArray(result)) {
-			items = result;
-		} else {
-			items = ((result as Record<string, unknown>).results ?? []) as Record<
-				string,
-				unknown
-			>[];
-		}
-
-		const typeMap: Record<string, string> = {
-			users: "user",
-			agents: "agent",
-			apps: "app",
-			runs: "run",
-		};
-		const targetType = typeMap[entityType];
-		if (targetType) {
-			items = items.filter(
-				(e) => (e.type as string | undefined)?.toLowerCase() === targetType,
-			);
-		}
-		return items;
-	}
-
-	async listEvents(): Promise<Record<string, unknown>[]> {
-		const result = (await this._request("GET", "/v1/events/")) as unknown;
-		if (Array.isArray(result)) return result;
-		return ((result as Record<string, unknown>).results ?? []) as Record<
-			string,
-			unknown
-		>[];
-	}
-
-	async getEvent(eventId: string): Promise<Record<string, unknown>> {
-		return (await this._request(
-			"GET",
-			`/v1/event/${encodePathSegment(eventId)}/`,
-		)) as Record<string, unknown>;
-	}
+    const typeMap: Record<string, string> = {
+      users: "user",
+      agents: "agent",
+      apps: "app",
+      runs: "run",
+    };
+    const targetType = typeMap[entityType];
+    if (targetType) {
+      items = items.filter(
+        (e) => (e.type as string | undefined)?.toLowerCase() === targetType,
+      );
+    }
+    return items;
+  }
 }
@@ -4,8 +4,10 @@

 import chalk from "chalk";
 import ora, { type Ora } from "ora";
-import { getCurrentCommand, isAgentMode } from "./state.js";
-import { CLI_VERSION } from "./version.js";
+import { createRequire } from "node:module";
+
+const _require = createRequire(import.meta.url);
+const PKG_VERSION: string = _require("../package.json").version;

 export const LOGO = `
 ███╗   ███╗███████╗███╗   ███╗ ██████╗      ██████╗██╗     ██╗
@@ -38,96 +40,75 @@ const dim = chalk.hex(DIM_COLOR);
 * plain-text for piped/non-TTY or NO_COLOR environments.
 */
 export function sym(fancy: string, plain: string): string {
-	if (!process.stdout.isTTY || process.env.NO_COLOR) return plain;
-	return fancy;
+  if (!process.stdout.isTTY || process.env.NO_COLOR) return plain;
+  return fancy;
 }

 export function printBanner(): void {
-	if (isAgentMode()) return;
-	const pad = 3; // horizontal padding each side (matches Rich's padding=(0, 2))
-	const logoLines = LOGO.trimEnd().split("\n");
-	const tagline = `  ${TAGLINE}`;
-	const subtitle = `Node.js SDK · v${CLI_VERSION}`;
-	const contentLines = ["", ...logoLines, "", tagline, ""];
+  const pad = 3; // horizontal padding each side (matches Rich's padding=(0, 2))
+  const logoLines = LOGO.trimEnd().split("\n");
+  const tagline = `  ${TAGLINE}`;
+  const subtitle = `Node.js SDK · v${PKG_VERSION}`;
+  const contentLines = ["", ...logoLines, "", tagline, ""];

-	// Compute inner width from longest content line + padding both sides
-	const maxContent = Math.max(...contentLines.map((l) => l.length));
-	const innerWidth = maxContent + pad * 2;
-	const totalWidth = innerWidth + 2; // + 2 for │ borders
+  // Compute inner width from longest content line + padding both sides
+  const maxContent = Math.max(...contentLines.map((l) => l.length));
+  const innerWidth = maxContent + pad * 2;
+  const totalWidth = innerWidth + 2; // + 2 for │ borders

-	const topBorder = brand(`╭${"─".repeat(totalWidth - 2)}╮`);
-	const subtitleFill = totalWidth - 2 - subtitle.length - 3; // 3 = "─ " before subtitle + "─" after
-	const bottomBorder = brand(
-		`╰${"─".repeat(subtitleFill)} ${dim(subtitle)} ${"─"}╯`,
-	);
+  const topBorder = brand(`╭${"─".repeat(totalWidth - 2)}╮`);
+  const subtitleFill = totalWidth - 2 - subtitle.length - 3; // 3 = "─ " before subtitle + "─" after
+  const bottomBorder = brand(`╰${"─".repeat(subtitleFill)} ${dim(subtitle)} ${"─"}╯`);

-	const body = contentLines.map((line) => {
-		const rightPad = innerWidth - pad - line.length;
-		return `${brand("│")}${" ".repeat(pad)}${brand.bold(line)}${" ".repeat(Math.max(rightPad, 0))}${brand("│")}`;
-	});
-	// Re-color tagline line with accent instead of brand.bold
-	const taglineIdx = body.length - 2; // second-to-last (before trailing empty line)
-	const taglineRightPad = innerWidth - pad - tagline.length;
-	body[taglineIdx] =
-		`${brand("│")}${" ".repeat(pad)}${accent(tagline)}${" ".repeat(Math.max(taglineRightPad, 0))}${brand("│")}`;
+  const body = contentLines.map((line) => {
+    const rightPad = innerWidth - pad - line.length;
+    return `${brand("│")}${" ".repeat(pad)}${brand.bold(line)}${" ".repeat(Math.max(rightPad, 0))}${brand("│")}`;
+  });
+  // Re-color tagline line with accent instead of brand.bold
+  const taglineIdx = body.length - 2; // second-to-last (before trailing empty line)
+  const taglineRightPad = innerWidth - pad - tagline.length;
+  body[taglineIdx] = `${brand("│")}${" ".repeat(pad)}${accent(tagline)}${" ".repeat(Math.max(taglineRightPad, 0))}${brand("│")}`;

-	console.log(topBorder);
-	for (const line of body) console.log(line);
-	console.log(bottomBorder);
+  console.log(topBorder);
+  for (const line of body) console.log(line);
+  console.log(bottomBorder);
 }

 export function printSuccess(message: string): void {
-	if (isAgentMode()) return;
-	console.log(`${success(sym("✓", "[ok]"))} ${message}`);
+  console.log(`${success(sym("✓", "[ok]"))} ${message}`);
 }

 export function printError(message: string, hint?: string): void {
-	if (isAgentMode()) {
-		const envelope = {
-			status: "error",
-			command: getCurrentCommand(),
-			error: message,
-			data: null,
-		};
-		console.log(JSON.stringify(envelope));
-		return;
-	}
-	console.error(`${error(`${sym("✗", "[error]")} Error:`)} ${message}`);
-	const resolvedHint =
-		hint ??
-		(message.includes("Authentication failed")
-			? `Run ${brand("mem0 init")} to reconfigure your API key · https://app.mem0.ai/dashboard/api-keys?utm_source=oss&utm_medium=cli-node`
-			: undefined);
-	if (resolvedHint) {
-		console.error(`  ${dim(resolvedHint)}`);
-	}
+  console.error(`${error(sym("✗", "[error]") + " Error:")} ${message}`);
+  if (hint) {
+    console.error(`  ${dim(hint)}`);
+  }
 }

 export function printWarning(message: string): void {
-	console.error(`${warning(sym("⚠", "[warn]"))} ${message}`);
+  console.error(`${warning(sym("⚠", "[warn]"))} ${message}`);
 }

 export function printInfo(message: string): void {
-	if (isAgentMode()) return;
-	console.error(`${brand(sym("◆", "*"))} ${message}`);
+  console.log(`${brand(sym("◆", "*"))} ${message}`);
 }

 export function printScope(ids: Record<string, string | undefined>): void {
-	if (isAgentMode()) return;
-	const parts: string[] = [];
-	for (const [key, val] of Object.entries(ids)) {
-		if (val) {
-			parts.push(`${key}=${val}`);
-		}
-	}
-	if (parts.length > 0) {
-		console.error(`  ${dim(`Scope: ${parts.join(", ")}`)}`);
-	}
+  const parts: string[] = [];
+  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(", ")}`)}`);
+  }
 }

 export interface TimedStatusContext {
-	successMsg: string;
-	errorMsg: string;
+  successMsg: string;
+  errorMsg: string;
 }

 /**
@@ -135,37 +116,29 @@ export interface TimedStatusContext {
 * Equivalent to Python's timed_status context manager.
 */
 export async function timedStatus<T>(
-	message: string,
-	fn: (ctx: TimedStatusContext) => Promise<T>,
+  message: string,
+  fn: (ctx: TimedStatusContext) => Promise<T>,
 ): Promise<T> {
-	if (isAgentMode()) {
-		const ctx: TimedStatusContext = { successMsg: "", errorMsg: "" };
-		return fn(ctx);
-	}
-	const ctx: TimedStatusContext = { successMsg: "", errorMsg: "" };
-	const spinner = ora({
-		text: dim(message),
-		color: "yellow",
-		stream: process.stderr,
-	}).start();
-	const start = performance.now();
+  const ctx: TimedStatusContext = { 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) / 1000).toFixed(2);
-		spinner.stop();
-		if (ctx.successMsg) {
-			console.error(`${success("✓")} ${ctx.successMsg} (${elapsed}s)`);
-		}
-		return result;
-	} catch (err) {
-		const elapsed = ((performance.now() - start) / 1000).toFixed(2);
-		spinner.stop();
-		if (ctx.errorMsg) {
-			printError(`${ctx.errorMsg} (${elapsed}s)`);
-		}
-		throw err;
-	}
+  try {
+    const result = await fn(ctx);
+    const elapsed = ((performance.now() - start) / 1000).toFixed(2);
+    spinner.stop();
+    if (ctx.successMsg) {
+      console.error(`${success("✓")} ${ctx.successMsg} (${elapsed}s)`);
+    }
+    return result;
+  } catch (err) {
+    const elapsed = ((performance.now() - start) / 1000).toFixed(2);
+    spinner.stop();
+    if (ctx.errorMsg) {
+      console.error(`${error("✗ Error:")} ${ctx.errorMsg} (${elapsed}s)`);
+    }
+    throw err;
+  }
 }

 /** Format helpers using brand colors for external use. */
@@ -1,285 +0,0 @@
-/**
- * Agent Mode commands — bootstrap (unattended signup) and OTP-based claim.
- */
-
-import readline from "node:readline";
-import { colors, printError, printInfo, printSuccess } from "../branding.js";
-import { type Mem0Config, saveConfig } from "../config.js";
-
-const { brand, dim } = colors;
-
-const SOURCE_HEADERS = {
-	"X-Mem0-Source": "cli",
-	"X-Mem0-Client-Language": "node",
-} as const;
-
-export interface BootstrapEnvelope {
-	api_key: string;
-	default_user_id: string;
-	org_id: string;
-	project_id: string;
-	mcp_url?: string;
-	smoke_test_url?: string;
-	claim_command?: string;
-	mem0_notice?: string;
-}
-
-function isValidEnvelope(v: unknown): v is BootstrapEnvelope {
-	return (
-		!!v &&
-		typeof v === "object" &&
-		typeof (v as BootstrapEnvelope).api_key === "string" &&
-		(v as BootstrapEnvelope).api_key.length > 0 &&
-		typeof (v as BootstrapEnvelope).default_user_id === "string" &&
-		(v as BootstrapEnvelope).default_user_id.length > 0
-	);
-}
-
-/**
- * POST /api/v1/auth/agent_mode/ and mutate config in place.
- *
- * @param config - Mem0Config mutated in place with the new platform values.
- * @param source - `--source` flag passthrough (analytics tag, free-form).
- * @param agentCaller - Self-declared agent identity passed via `--agent-caller`
- *   (e.g. `claude-code`, `cursor`). May be null when the caller omitted the
- *   flag; the agent can backfill later via `mem0 identify <name>`. Sent to the
- *   backend in the request body and saved into `platform.agentCaller` for
- *   local introspection.
- */
-export async function bootstrapViaBackend(
-	config: Mem0Config,
-	{
-		source,
-		agentCaller,
-	}: { source?: string | null; agentCaller?: string | null } = {},
-): Promise<void> {
-	const baseUrl = (config.platform.baseUrl || "https://api.mem0.ai").replace(
-		/\/+$/,
-		"",
-	);
-	const body: Record<string, unknown> = {};
-	if (source) body.source = source;
-	if (agentCaller) body.agent_caller = agentCaller;
-
-	let resp: Response;
-	try {
-		resp = await fetch(`${baseUrl}/api/v1/auth/agent_mode/`, {
-			method: "POST",
-			headers: {
-				...SOURCE_HEADERS,
-				"Content-Type": "application/json",
-			},
-			body: JSON.stringify(body),
-			signal: AbortSignal.timeout(30_000),
-		});
-	} catch (err) {
-		printError(
-			`Network error contacting Mem0: ${err instanceof Error ? err.message : String(err)}`,
-		);
-		process.exit(1);
-	}
-
-	if (resp.status === 429) {
-		printError("Rate-limited. Try again in a few minutes.");
-		process.exit(1);
-	}
-	if (resp.status === 503) {
-		printError("Agent Mode is temporarily disabled. Try again later.");
-		process.exit(1);
-	}
-	if (!resp.ok) {
-		let detail: string = resp.statusText;
-		try {
-			const errBody = (await resp.json()) as {
-				error?: string;
-				detail?: string;
-			};
-			detail = errBody.error ?? errBody.detail ?? resp.statusText;
-		} catch {
-			/* leave detail as statusText */
-		}
-		// Backend's @ratelimit decorator raises PermissionDenied, which DRF
-		// translates to a generic 403 "You do not have permission to perform
-		// this action." That's opaque — surface it as the rate-limit message
-		// it actually is.
-		if (resp.status === 403 && /permission/i.test(detail)) {
-			printError(
-				"Daily Agent Mode signup limit reached for this network (5/day). Try again from a different IP or after midnight UTC.",
-			);
-			process.exit(1);
-		}
-		printError(`Bootstrap failed: ${detail}`);
-		process.exit(1);
-	}
-
-	const envelope = (await resp.json()) as BootstrapEnvelope;
-	if (!isValidEnvelope(envelope)) {
-		// Defend against partial/malformed backend responses (e.g. {api_key: null}).
-		// Without this guard, the typed `string` field is silently set to
-		// undefined/null and persisted, producing confusing downstream errors.
-		printError(
-			"Bootstrap response missing required fields — please update the CLI.",
-		);
-		process.exit(1);
-	}
-
-	config.platform.apiKey = envelope.api_key;
-	config.platform.baseUrl = baseUrl;
-	config.platform.agentMode = true;
-	config.platform.createdVia = "agent_mode";
-	config.platform.agentCaller = agentCaller ?? "";
-	config.platform.claimedAt = "";
-	config.platform.defaultUserId = envelope.default_user_id;
-	// Adopt the slug-derived user_id as the default scope for memory ops.
-	config.defaults.userId = envelope.default_user_id;
-	saveConfig(config);
-
-	printSuccess(
-		`Agent Mode active. Default user_id: ${envelope.default_user_id}`,
-	);
-	if (envelope.mem0_notice) {
-		console.log(`\n\x1b[33m🔔 ${envelope.mem0_notice}\x1b[0m\n`);
-	} else {
-		// Fallback for older backends without the unified notice field.
-		const claimCmd = envelope.claim_command ?? "mem0 init --email <your-email>";
-		console.log(`  ${dim(`To claim this account later: ${claimCmd}`)}`);
-	}
-
-	if (!agentCaller) {
-		console.log(
-			`  ${dim("If you are an AI agent, identify yourself: `mem0 identify <your-name>` (e.g. claude-code, cursor).")}`,
-		);
-	}
-}
-
-/**
- * Claim an existing Agent Mode account via OTP — no browser, no polling.
- *
- * Hits /api/v1/auth/email_code/ to send a verification code, prompts for it
- * interactively (or accepts via `code`), then sends it to /verify/ alongside
- * `agent_mode_api_key`. Backend's verify_email_code runs upgrade-in-place
- * inline and returns the claim result.
- */
-export async function claimViaOtp(
-	config: Mem0Config,
-	{ email, code }: { email: string; code?: string },
-): Promise<void> {
-	const baseUrl = (config.platform.baseUrl || "https://api.mem0.ai").replace(
-		/\/+$/,
-		"",
-	);
-	if (!config.platform.apiKey || !config.platform.agentMode) {
-		printError(
-			"This command requires an active Agent Mode config. Run `mem0 init` first.",
-		);
-		process.exit(1);
-	}
-
-	const rawKey = config.platform.apiKey;
-
-	// Step 1: request OTP (unless --code was supplied)
-	if (!code) {
-		const sendResp = await fetch(`${baseUrl}/api/v1/auth/email_code/`, {
-			method: "POST",
-			headers: { ...SOURCE_HEADERS, "Content-Type": "application/json" },
-			body: JSON.stringify({ email }),
-			signal: AbortSignal.timeout(30_000),
-		});
-		if (sendResp.status === 429) {
-			printError("Too many attempts. Try again in a few minutes.");
-			process.exit(1);
-		}
-		if (!sendResp.ok) {
-			let detail: string = sendResp.statusText;
-			try {
-				const errBody = (await sendResp.json()) as { error?: string };
-				if (errBody.error) detail = errBody.error;
-			} catch {
-				/* leave as statusText */
-			}
-			printError(`Failed to send code: ${detail}`);
-			process.exit(1);
-		}
-
-		printSuccess(`Verification code sent to ${email}. Check your inbox.`);
-
-		if (!process.stdin.isTTY) {
-			printError(
-				"No --code provided and terminal is non-interactive.",
-				`Re-run: mem0 init --email ${email} --code <code>`,
-			);
-			process.exit(1);
-		}
-
-		console.log();
-		code = await promptLine(`  ${brand("Verification Code")}`);
-		if (!code) {
-			printError("Code is required.");
-			process.exit(1);
-		}
-	}
-
-	// Step 2: verify + claim atomically
-	const verifyResp = await fetch(`${baseUrl}/api/v1/auth/email_code/verify/`, {
-		method: "POST",
-		headers: { ...SOURCE_HEADERS, "Content-Type": "application/json" },
-		body: JSON.stringify({
-			email,
-			code: code.trim(),
-			agent_mode_api_key: rawKey,
-		}),
-		signal: AbortSignal.timeout(30_000),
-	});
-
-	if (!verifyResp.ok) {
-		let detail: string = verifyResp.statusText;
-		let errCode = "";
-		try {
-			const errBody = (await verifyResp.json()) as {
-				error?: string;
-				code?: string;
-			};
-			if (errBody.error) detail = errBody.error;
-			if (errBody.code) errCode = errBody.code;
-		} catch {
-			/* leave as statusText */
-		}
-		printError(`Claim failed: ${detail}`);
-		if (errCode === "email_already_claimed") {
-			console.log(
-				`  ${dim("Tip: this email already has a Mem0 account. Sign in at app.mem0.ai with your existing credentials.")}`,
-			);
-		}
-		process.exit(1);
-	}
-
-	const claimBody = (await verifyResp.json()) as {
-		claimed?: boolean;
-		claimed_at?: string;
-	};
-	if (!claimBody.claimed) {
-		printError(`Unexpected verify response: ${JSON.stringify(claimBody)}`);
-		process.exit(1);
-	}
-
-	config.platform.agentMode = false;
-	config.platform.claimedAt = claimBody.claimed_at ?? new Date().toISOString();
-	config.platform.userEmail = email;
-	config.platform.createdVia = "email";
-	saveConfig(config);
-
-	printSuccess(`Agent claimed to ${email}. Your API key is unchanged.`);
-}
-
-function promptLine(label: string): Promise<string> {
-	const rl = readline.createInterface({
-		input: process.stdin,
-		output: process.stdout,
-	});
-	return new Promise((resolve) => {
-		rl.question(`${label}: `, (answer) => {
-			rl.close();
-			resolve(answer.trim());
-		});
-	});
-}
@@ -1,147 +0,0 @@
-/**
- * `mem0 agent-rush <add|search> "..."` — wraps the AGENTRUSH platform endpoints.
- * Project routing is implicit (server-side); zero flags needed.
- */
-
-import readline from "node:readline";
-import { colors, printError, printSuccess } from "../branding.js";
-import { loadConfig, saveConfig } from "../config.js";
-import { CLI_VERSION } from "../version.js";
-
-const PII_WARNING = [
-	"",
-	"⚠️  AGENTRUSH memories are PUBLIC — visible to any other player.",
-	"   Do not include real names, emails, secrets, work content, or PII.",
-	"",
-].join("\n");
-
-const ERROR_HINTS: Record<string, string> = {
-	agentrush_search_first:
-		"Run 3 'mem0 agent-rush search' commands before adding.",
-	agentrush_search_quota: "You've used your 3 lifetime searches.",
-	agentrush_add_quota: "You've used your 3 lifetime adds.",
-	agentrush_not_agent_mode:
-		"Re-run 'mem0 init --agent' to bootstrap an agent-mode key.",
-	agentrush_length: "Memory text must be 50-1000 characters.",
-	agentrush_no_urls: "URLs are not allowed.",
-	agentrush_blocklist: "Content contains a blocked term.",
-	agentrush_global_quota: "Event-wide cap reached. Try again later.",
-	agentrush_not_provisioned:
-		"AGENTRUSH is not provisioned in this environment.",
-};
-
-async function callEndpoint(
-	path: string,
-	body: Record<string, unknown>,
-): Promise<unknown> {
-	const config = loadConfig();
-	const baseUrl = (config.platform?.baseUrl ?? "https://api.mem0.ai").replace(
-		/\/+$/,
-		"",
-	);
-
-	if (!config.platform?.apiKey) {
-		printError("Not initialized. Run `mem0 init --agent` first.");
-		process.exit(1);
-	}
-
-	const resp = await fetch(`${baseUrl}${path}`, {
-		method: "POST",
-		headers: {
-			Authorization: `Token ${config.platform.apiKey}`,
-			"Content-Type": "application/json",
-			"X-Mem0-Source": "cli",
-			"X-Mem0-Client-Language": "node",
-			"X-Mem0-Client-Version": CLI_VERSION,
-			"X-Mem0-Mode": "agent-rush",
-		},
-		body: JSON.stringify(body),
-		signal: AbortSignal.timeout(30_000),
-	});
-
-	const json = await resp.json().catch(() => ({}));
-
-	if (!resp.ok) {
-		const code =
-			(json as { error?: { code?: string } }).error?.code ?? "unknown";
-		printError(`AGENTRUSH error: ${code}`);
-		if (ERROR_HINTS[code]) {
-			console.log(`  ${colors.dim(ERROR_HINTS[code])}`);
-		}
-		process.exit(1);
-	}
-
-	return json;
-}
-
-function promptLine(question: string): Promise<string> {
-	const rl = readline.createInterface({
-		input: process.stdin,
-		output: process.stdout,
-	});
-	return new Promise((resolve) => {
-		rl.question(question, (answer) => {
-			rl.close();
-			resolve(answer.trim());
-		});
-	});
-}
-
-/**
- * Ensure the human has acknowledged that AGENTRUSH memories are PUBLIC.
- *
- * Interactive (TTY): show the prompt; on "y" persist `agentRush.acknowledgedAt`
- * so we never ask the same machine twice. On anything else, abort.
- *
- * Non-interactive (agent invocation, no TTY): print the warning to stderr
- * for the human reading the agent's transcript and proceed — agents can't
- * answer y/N prompts.
- */
-async function ensureWarningAcknowledged(): Promise<void> {
-	const config = loadConfig();
-	if (config.agentRush?.acknowledgedAt) return;
-
-	if (!process.stdin.isTTY || !process.stdout.isTTY) {
-		// Agent context: surface the warning to stderr, don't block.
-		console.error(PII_WARNING);
-		return;
-	}
-
-	console.log(PII_WARNING);
-	const answer = (await promptLine("   Continue? [y/N]: ")).toLowerCase();
-	if (answer !== "y" && answer !== "yes") {
-		printError("Aborted.");
-		process.exit(1);
-	}
-
-	config.agentRush.acknowledgedAt = new Date().toISOString();
-	saveConfig(config);
-}
-
-export async function cmdAgentRushAdd(content: string): Promise<void> {
-	await ensureWarningAcknowledged();
-	const result = await callEndpoint("/v1/agent-rush/memories/", { content });
-	printSuccess(
-		`Memory submitted (event_id: ${(result as { event_id?: string }).event_id ?? "?"})`,
-	);
-}
-
-export async function cmdAgentRushSearch(query: string): Promise<void> {
-	const result = (await callEndpoint("/v1/agent-rush/memories/search/", {
-		query,
-	})) as {
-		results?: Array<{ memory?: string }>;
-		memories?: Array<{ memory?: string }>;
-	};
-
-	const memories = result.results ?? result.memories ?? [];
-
-	if (memories.length === 0) {
-		console.log(colors.dim("(no results)"));
-		return;
-	}
-
-	memories.slice(0, 5).forEach((m, i) => {
-		console.log(`  ${i + 1}. ${m.memory ?? JSON.stringify(m)}`);
-	});
-}
@@ -3,107 +3,88 @@
 */

 import Table from "cli-table3";
-import { colors, printError, printSuccess } from "../branding.js";
+import { printError, printSuccess, colors } from "../branding.js";
 import {
-	getNestedValue,
-	loadConfig,
-	redactKey,
-	saveConfig,
-	setNestedValue,
+  getNestedValue,
+  loadConfig,
+  redactKey,
+  saveConfig,
+  setNestedValue,
 } from "../config.js";
-import { formatAgentEnvelope, formatJsonEnvelope } from "../output.js";
-import { isAgentMode, setCurrentCommand } from "../state.js";
+import { formatJsonEnvelope } from "../output.js";

 const { brand, accent, dim } = colors;

 export function cmdConfigShow(opts: { output?: string } = {}): void {
-	setCurrentCommand("config show");
-	const config = loadConfig();
+  const config = loadConfig();

-	if (opts.output === "agent" || opts.output === "json") {
-		formatAgentEnvelope({
-			command: "config show",
-			data: {
-				defaults: {
-					user_id: config.defaults.userId || null,
-					agent_id: config.defaults.agentId || null,
-					app_id: config.defaults.appId || null,
-					run_id: config.defaults.runId || null,
-				},
-				platform: {
-					api_key: redactKey(config.platform.apiKey),
-					base_url: config.platform.baseUrl,
-				},
-			},
-		});
-		return;
-	}
+  if (opts.output === "json") {
+    formatJsonEnvelope({
+      command: "config show",
+      data: {
+        defaults: {
+          user_id: config.defaults.userId || null,
+          agent_id: config.defaults.agentId || null,
+          app_id: config.defaults.appId || null,
+          run_id: config.defaults.runId || null,
+          enable_graph: config.defaults.enableGraph,
+        },
+        platform: {
+          api_key: redactKey(config.platform.apiKey),
+          base_url: config.platform.baseUrl,
+        },
+      },
+    });
+    return;
+  }

-	console.log();
-	console.log(`  ${brand("◆ mem0 Configuration")}\n`);
+  console.log();
+  console.log(`  ${brand("◆ mem0 Configuration")}\n`);

-	const table = new Table({
-		head: [accent("Key"), accent("Value")],
-		style: { head: [], border: [] },
-	});
+  const table = new Table({
+    head: [accent("Key"), accent("Value")],
+    style: { head: [], border: [] },
+  });

-	// Defaults
-	table.push(["defaults.user_id", config.defaults.userId || dim("(not set)")]);
-	table.push([
-		"defaults.agent_id",
-		config.defaults.agentId || dim("(not set)"),
-	]);
-	table.push(["defaults.app_id", config.defaults.appId || dim("(not set)")]);
-	table.push(["defaults.run_id", config.defaults.runId || dim("(not set)")]);
-	table.push(["", ""]);
+  // Defaults
+  table.push(["defaults.user_id", config.defaults.userId || dim("(not set)")]);
+  table.push(["defaults.agent_id", config.defaults.agentId || dim("(not set)")]);
+  table.push(["defaults.app_id", config.defaults.appId || dim("(not set)")]);
+  table.push(["defaults.run_id", config.defaults.runId || dim("(not set)")]);
+  table.push(["defaults.enable_graph", String(config.defaults.enableGraph)]);
+  table.push(["", ""]);

-	// Platform
-	table.push(["platform.api_key", redactKey(config.platform.apiKey)]);
-	table.push(["platform.base_url", config.platform.baseUrl]);
+  // Platform
+  table.push(["platform.api_key", redactKey(config.platform.apiKey)]);
+  table.push(["platform.base_url", config.platform.baseUrl]);

-	console.log(table.toString());
-	console.log();
+  console.log(table.toString());
+  console.log();
 }

 export function cmdConfigGet(key: string): void {
-	setCurrentCommand("config get");
-	const config = loadConfig();
-	const value = getNestedValue(config, key);
+  const config = loadConfig();
+  const value = getNestedValue(config, key);

-	if (value === undefined) {
-		printError(`Unknown config key: ${key}`);
-	} else {
-		// Redact secrets
-		const displayValue =
-			key.includes("api_key") || key.split(".").pop() === "key"
-				? redactKey(String(value))
-				: String(value);
-		if (isAgentMode()) {
-			formatAgentEnvelope({
-				command: "config get",
-				data: { key, value: displayValue },
-			});
-		} else {
-			console.log(displayValue);
-		}
-	}
+  if (value === undefined) {
+    printError(`Unknown config key: ${key}`);
+  } else {
+    // Redact secrets
+    if (key.includes("api_key") || key.split(".").pop() === "key") {
+      console.log(redactKey(String(value)));
+    } else {
+      console.log(String(value));
+    }
+  }
 }

 export function cmdConfigSet(key: string, value: string): void {
-	setCurrentCommand("config set");
-	const config = loadConfig();
-	if (setNestedValue(config, key, value)) {
-		saveConfig(config);
-		const display = key.includes("key") ? redactKey(value) : value;
-		if (isAgentMode()) {
-			formatAgentEnvelope({
-				command: "config set",
-				data: { key, value: display },
-			});
-		} else {
-			printSuccess(`${key} = ${display}`);
-		}
-	} else {
-		printError(`Unknown config key: ${key}`);
-	}
+  const config = loadConfig();
+  if (setNestedValue(config, key, value)) {
+    saveConfig(config);
+    const display = key.includes("key") ? redactKey(value) : value;
+    printSuccess(`${key} = ${display}`);
+  } else {
+    printError(`Unknown config key: ${key}`);
+  }
 }
@@ -4,165 +4,136 @@

 import readline from "node:readline";
 import Table from "cli-table3";
+import { printError, printInfo, printSuccess, timedStatus, colors } from "../branding.js";
 import type { Backend } from "../backend/base.js";
-import {
-	colors,
-	printError,
-	printInfo,
-	printSuccess,
-	timedStatus,
-} from "../branding.js";
-import { formatAgentEnvelope, formatJson } from "../output.js";
-import { setCurrentCommand } from "../state.js";
+import { formatJson } from "../output.js";

 const { brand, accent, dim } = colors;

 const VALID_TYPES = new Set(["users", "agents", "apps", "runs"]);

 export async function cmdEntitiesList(
-	backend: Backend,
-	entityType: string,
-	opts: { output: string },
+  backend: Backend,
+  entityType: string,
+  opts: { output: string },
 ): Promise<void> {
-	setCurrentCommand("entity list");
-	if (!VALID_TYPES.has(entityType)) {
-		printError(
-			`Invalid entity type: ${entityType}. Use: ${[...VALID_TYPES].join(", ")}`,
-		);
-		process.exit(1);
-	}
+  if (!VALID_TYPES.has(entityType)) {
+    printError(`Invalid entity type: ${entityType}. Use: ${[...VALID_TYPES].join(", ")}`);
+    process.exit(1);
+  }

-	const start = performance.now();
-	let results: Record<string, unknown>[];
-	try {
-		results = await timedStatus(`Fetching ${entityType}...`, async () => {
-			return backend.entities(entityType);
-		});
-	} catch (e) {
-		printError(
-			e instanceof Error ? e.message : String(e),
-			"This feature may require the mem0 Platform.",
-		);
-		process.exit(1);
-	}
-	const elapsed = (performance.now() - start) / 1000;
+  const start = performance.now();
+  let results: Record<string, unknown>[];
+  try {
+    results = await timedStatus(`Fetching ${entityType}...`, async () => {
+      return backend.entities(entityType);
+    });
+  } catch (e) {
+    printError(
+      e instanceof Error ? e.message : String(e),
+      "This feature may require the mem0 Platform.",
+    );
+    process.exit(1);
+  }
+  const elapsed = (performance.now() - start) / 1000;

-	if (opts.output === "agent" || opts.output === "json") {
-		formatAgentEnvelope({
-			command: "entity list",
-			data: results,
-			count: results.length,
-			durationMs: Math.round(elapsed * 1000),
-		});
-		return;
-	}
+  if (opts.output === "json") {
+    formatJson(results);
+    return;
+  }

-	if (!results.length) {
-		printInfo(`No ${entityType} found.`);
-		return;
-	}
+  if (!results.length) {
+    printInfo(`No ${entityType} found.`);
+    return;
+  }

-	const table = new Table({
-		head: [accent("Name / ID"), accent("Created")],
-		style: { head: [], border: [] },
-	});
+  const table = new Table({
+    head: [accent("Name / ID"), accent("Created")],
+    style: { head: [], border: [] },
+  });

-	for (const entity of results) {
-		const name = String(entity.name ?? entity.id ?? "—");
-		const created = String(entity.created_at ?? "—").slice(0, 10);
-		table.push([name, created]);
-	}
+  for (const entity of results) {
+    const name = String(entity.name ?? entity.id ?? "—");
+    const created = String(entity.created_at ?? "—").slice(0, 10);
+    table.push([name, created]);
+  }

-	console.log();
-	console.log(table.toString());
-	console.log(
-		`  ${dim(`${results.length} ${entityType} (${elapsed.toFixed(2)}s)`)}`,
-	);
-	console.log();
+  console.log();
+  console.log(table.toString());
+  console.log(`  ${dim(`${results.length} ${entityType} (${elapsed.toFixed(2)}s)`)}`);
+  console.log();
 }

 export async function cmdEntitiesDelete(
-	backend: Backend,
-	opts: {
-		userId?: string;
-		agentId?: string;
-		appId?: string;
-		runId?: string;
-		dryRun?: boolean;
-		force: boolean;
-		output: string;
-	},
+  backend: Backend,
+  opts: {
+    userId?: string;
+    agentId?: string;
+    appId?: string;
+    runId?: string;
+    dryRun?: boolean;
+    force: boolean;
+    output: string;
+  },
 ): Promise<void> {
-	setCurrentCommand("entity delete");
-	const { isAgentMode } = await import("../state.js");
-	if (isAgentMode() && !opts.force) {
-		printError("Destructive operation requires --force in agent mode.");
-		process.exit(1);
-	}
-	if (!opts.userId && !opts.agentId && !opts.appId && !opts.runId) {
-		printError(
-			"Provide at least one of --user-id, --agent-id, --app-id, --run-id.",
-		);
-		process.exit(1);
-	}
+  if (!opts.userId && !opts.agentId && !opts.appId && !opts.runId) {
+    printError("Provide at least one of --user-id, --agent-id, --app-id, --run-id.");
+    process.exit(1);
+  }

-	const scopeParts: string[] = [];
-	if (opts.userId) scopeParts.push(`user=${opts.userId}`);
-	if (opts.agentId) scopeParts.push(`agent=${opts.agentId}`);
-	if (opts.appId) scopeParts.push(`app=${opts.appId}`);
-	if (opts.runId) scopeParts.push(`run=${opts.runId}`);
-	const scope = scopeParts.join(", ");
+  if (opts.dryRun) {
+    const scopeParts: string[] = [];
+    if (opts.userId) scopeParts.push(`user=${opts.userId}`);
+    if (opts.agentId) scopeParts.push(`agent=${opts.agentId}`);
+    if (opts.appId) scopeParts.push(`app=${opts.appId}`);
+    if (opts.runId) scopeParts.push(`run=${opts.runId}`);
+    printInfo(`Would delete entity ${scopeParts.join(", ")} and all its memories.`);
+    printInfo("No changes made.");
+    return;
+  }

-	if (opts.dryRun) {
-		printInfo(`Would delete entity ${scope} and all its memories.`);
-		printInfo("No changes made.");
-		return;
-	}
+  if (!opts.force) {
+    const scopeParts: string[] = [];
+    if (opts.userId) scopeParts.push(`user=${opts.userId}`);
+    if (opts.agentId) scopeParts.push(`agent=${opts.agentId}`);
+    if (opts.appId) scopeParts.push(`app=${opts.appId}`);
+    if (opts.runId) scopeParts.push(`run=${opts.runId}`);
+    const scope = scopeParts.join(", ");

-	if (!opts.force) {
-		const rl = readline.createInterface({
-			input: process.stdin,
-			output: process.stdout,
-		});
-		const answer = await new Promise<string>((resolve) => {
-			rl.question(
-				`\n  \u26a0  Delete entity ${scope} AND all its memories? This cannot be undone. [y/N] `,
-				resolve,
-			);
-		});
-		rl.close();
-		if (answer.toLowerCase() !== "y") {
-			printInfo("Cancelled.");
-			process.exit(0);
-		}
-	}
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise<string>((resolve) => {
+      rl.question(
+        `\n  \u26a0  Delete entity ${scope} AND all its memories? This cannot be undone. [y/N] `,
+        resolve,
+      );
+    });
+    rl.close();
+    if (answer.toLowerCase() !== "y") {
+      printInfo("Cancelled.");
+      process.exit(0);
+    }
+  }

-	const start = performance.now();
-	let result: Record<string, unknown>;
-	try {
-		result = await timedStatus("Deleting entity...", async () => {
-			return backend.deleteEntities({
-				userId: opts.userId,
-				agentId: opts.agentId,
-				appId: opts.appId,
-				runId: opts.runId,
-			});
-		});
-	} catch (e) {
-		printError(e instanceof Error ? e.message : String(e));
-		process.exit(1);
-	}
-	const elapsed = (performance.now() - start) / 1000;
+  const start = performance.now();
+  let result: Record<string, unknown>;
+  try {
+    result = await timedStatus("Deleting entity...", async () => {
+      return backend.deleteEntities({
+        userId: opts.userId,
+        agentId: opts.agentId,
+        appId: opts.appId,
+        runId: opts.runId,
+      });
+    });
+  } catch (e) {
+    printError(e instanceof Error ? e.message : String(e));
+    process.exit(1);
+  }
+  const elapsed = (performance.now() - start) / 1000;

-	if (opts.output === "agent") {
-		formatAgentEnvelope({
-			command: "entity delete",
-			data: { deleted: true },
-			durationMs: Math.round(elapsed * 1000),
-		});
-	} else if (opts.output === "json") {
-		formatJson(result);
-	} else if (opts.output !== "quiet") {
-		printSuccess(`Entity deleted with all memories (${elapsed.toFixed(2)}s)`);
-	}
+  if (opts.output === "json") {
+    formatJson(result);
+  } else if (opts.output !== "quiet") {
+    printSuccess(`Entity deleted with all memories (${elapsed.toFixed(2)}s)`);
+  }
 }
@@ -1,169 +0,0 @@
-/**
- * Event commands: list and status.
- */
-
-import boxen from "boxen";
-import Table from "cli-table3";
-import type { Backend } from "../backend/base.js";
-import { colors, printError, printInfo, timedStatus } from "../branding.js";
-import { formatAgentEnvelope, formatJson } from "../output.js";
-import { setCurrentCommand } from "../state.js";
-
-const { brand, accent, success, error: errorColor, warning, dim } = colors;
-
-function statusStyled(status: string): string {
-	switch (status.toUpperCase()) {
-		case "SUCCEEDED":
-			return success("SUCCEEDED");
-		case "PENDING":
-			return accent("PENDING");
-		case "FAILED":
-			return errorColor("FAILED");
-		case "PROCESSING":
-			return warning("PROCESSING");
-		default:
-			return status;
-	}
-}
-
-export async function cmdEventList(
-	backend: Backend,
-	opts: { output: string },
-): Promise<void> {
-	setCurrentCommand("event list");
-	const start = performance.now();
-	let results: Record<string, unknown>[];
-	try {
-		results = await timedStatus("Fetching events...", async () => {
-			return backend.listEvents();
-		});
-	} catch (e) {
-		printError(e instanceof Error ? e.message : String(e));
-		process.exit(1);
-	}
-	const elapsed = (performance.now() - start) / 1000;
-
-	if (opts.output === "agent" || opts.output === "json") {
-		formatAgentEnvelope({
-			command: "event list",
-			data: results,
-			count: results.length,
-			durationMs: Math.round(elapsed * 1000),
-		});
-		return;
-	}
-
-	if (results.length === 0) {
-		console.log();
-		printInfo("No events found.");
-		console.log();
-		return;
-	}
-
-	const table = new Table({
-		head: [
-			accent("Event ID"),
-			accent("Type"),
-			accent("Status"),
-			accent("Latency"),
-			accent("Created"),
-		],
-		colWidths: [12, 14, 14, 10, 22],
-		wordWrap: true,
-		style: { head: [], border: [] },
-	});
-
-	for (const ev of results) {
-		const evId = String(ev.id ?? "").slice(0, 8);
-		const evType = String(ev.event_type ?? "—");
-		const status = String(ev.status ?? "—");
-		const latency = ev.latency as number | undefined;
-		const latencyStr = latency !== undefined ? `${Math.round(latency)}ms` : "—";
-		const created = String(ev.created_at ?? "—")
-			.slice(0, 19)
-			.replace("T", " ");
-		table.push([dim(evId), evType, statusStyled(status), latencyStr, created]);
-	}
-
-	console.log();
-	console.log(table.toString());
-	console.log(
-		`  ${dim(`${results.length} event${results.length !== 1 ? "s" : ""}`)}`,
-	);
-	console.log();
-}
-
-export async function cmdEventStatus(
-	backend: Backend,
-	eventId: string,
-	opts: { output: string },
-): Promise<void> {
-	setCurrentCommand("event status");
-	const start = performance.now();
-	let ev: Record<string, unknown>;
-	try {
-		ev = await timedStatus("Fetching event...", async () => {
-			return backend.getEvent(eventId);
-		});
-	} catch (e) {
-		printError(e instanceof Error ? e.message : String(e));
-		process.exit(1);
-	}
-	const elapsed = (performance.now() - start) / 1000;
-
-	if (opts.output === "agent" || opts.output === "json") {
-		formatAgentEnvelope({
-			command: "event status",
-			data: ev,
-			durationMs: Math.round(elapsed * 1000),
-		});
-		return;
-	}
-
-	const status = String(ev.status ?? "—");
-	const evType = String(ev.event_type ?? "—");
-	const latency = ev.latency as number | undefined;
-	const latencyStr = latency !== undefined ? `${Math.round(latency)}ms` : "—";
-	const created = String(ev.created_at ?? "—")
-		.slice(0, 19)
-		.replace("T", " ");
-	const updated = String(ev.updated_at ?? "—")
-		.slice(0, 19)
-		.replace("T", " ");
-	const results = ev.results as Record<string, unknown>[] | undefined;
-
-	const lines: string[] = [];
-	lines.push(`  ${dim("Event ID:")}     ${eventId}`);
-	lines.push(`  ${dim("Type:")}         ${evType}`);
-	lines.push(`  ${dim("Status:")}       ${statusStyled(status)}`);
-	lines.push(`  ${dim("Latency:")}      ${latencyStr}`);
-	lines.push(`  ${dim("Created:")}      ${created}`);
-	lines.push(`  ${dim("Updated:")}      ${updated}`);
-
-	if (results && results.length > 0) {
-		lines.push("");
-		lines.push(`  ${dim(`Results (${results.length}):`)}`);
-		for (const r of results) {
-			const memId = String(r.id ?? "").slice(0, 8);
-			const data = r.data as Record<string, unknown> | undefined;
-			const memory = data?.memory ? String(data.memory) : "";
-			const evName = String(r.event ?? "");
-			const user = String(r.user_id ?? "");
-			let detail = `${evName}  ${memory}`;
-			if (user) detail += `  ${dim(`(user_id=${user})`)}`;
-			lines.push(`    ${success("·")} ${detail}  ${dim(`(${memId})`)}`);
-		}
-	}
-
-	const content = lines.join("\n");
-	console.log();
-	console.log(
-		boxen(content, {
-			title: brand("Event Status"),
-			titleAlignment: "left",
-			borderColor: "magenta",
-			padding: 1,
-		}),
-	);
-	console.log();
-}
@@ -1,75 +0,0 @@
-/**
- * mem0 identify — declare which agent owns the current agent-mode key.
- *
- * Used when `mem0 init --agent` ran without --agent-caller, so the backend
- * saved agent_caller=NULL. The agent re-runs `mem0 identify <name>` to PATCH
- * its own row with its real identity. Idempotent.
- */
-
-import { printError, printSuccess } from "../branding.js";
-import { loadConfig, saveConfig } from "../config.js";
-
-const SOURCE_HEADERS = {
-	"X-Mem0-Source": "cli",
-	"X-Mem0-Client-Language": "node",
-} as const;
-
-export async function runIdentify(name: string): Promise<void> {
-	const config = loadConfig();
-	if (!config.platform.apiKey) {
-		printError("No API key configured. Run `mem0 init --agent` first.");
-		process.exit(1);
-	}
-	if (!config.platform.agentMode) {
-		printError("This command only works on unclaimed agent-mode keys.");
-		process.exit(1);
-	}
-
-	const clean = (name ?? "").trim();
-	if (!clean) {
-		printError("Agent name is required.");
-		process.exit(1);
-	}
-
-	const baseUrl = (config.platform.baseUrl || "https://api.mem0.ai").replace(
-		/\/+$/,
-		"",
-	);
-
-	let resp: Response;
-	try {
-		resp = await fetch(`${baseUrl}/api/v1/auth/agent_mode/caller/`, {
-			method: "PATCH",
-			headers: {
-				...SOURCE_HEADERS,
-				Authorization: `Token ${config.platform.apiKey}`,
-				"Content-Type": "application/json",
-			},
-			body: JSON.stringify({ agent_caller: clean }),
-			signal: AbortSignal.timeout(30_000),
-		});
-	} catch (err) {
-		printError(
-			`Network error: ${err instanceof Error ? err.message : String(err)}`,
-		);
-		process.exit(1);
-	}
-
-	if (!resp.ok) {
-		let detail: string = resp.statusText;
-		try {
-			const body = (await resp.json()) as { error?: string };
-			if (body.error) detail = body.error;
-		} catch {
-			/* leave as statusText */
-		}
-		printError(`Identify failed: ${detail}`);
-		process.exit(1);
-	}
-
-	const body = (await resp.json()) as { agent_caller?: string };
-	const canonical = body.agent_caller ?? clean;
-	config.platform.agentCaller = canonical;
-	saveConfig(config);
-	printSuccess(`Identified as ${canonical}.`);
-}
@@ -2,611 +2,181 @@
 * mem0 init — interactive setup wizard.
 */

-import fs from "node:fs";
 import readline from "node:readline";
-import { PlatformBackend } from "../backend/platform.js";
 import {
-	colors,
-	printBanner,
-	printError,
-	printInfo,
-	printSuccess,
+  printBanner,
+  printError,
+  printInfo,
+  printSuccess,
+  colors,
 } from "../branding.js";
-import {
-	CONFIG_FILE,
-	DEFAULT_BASE_URL,
-	type Mem0Config,
-	createDefaultConfig,
-	loadConfig,
-	redactKey,
-	saveConfig,
-} from "../config.js";
-import { formatJsonEnvelope } from "../output.js";
-import { isAgentMode } from "../state.js";
+import { type Mem0Config, createDefaultConfig, saveConfig } from "../config.js";
+import { PlatformBackend } from "../backend/platform.js";

 const { brand, dim } = colors;

-const EMAIL_RE = /^[^@\s]+@[^@\s]+\.[^@\s]+$/;
-
-function validateEmail(email: string): void {
-	if (!EMAIL_RE.test(email)) {
-		printError(`Invalid email address: ${JSON.stringify(email)}`);
-		process.exit(1);
-	}
-}
-
-/** @internal — exported for unit tests. */
-export async function pingKey(
-	apiKey: string,
-	baseUrl: string,
-	timeoutMs = 5000,
-): Promise<boolean> {
-	// Returns false ONLY on a definitive "invalid key" signal (HTTP 401/403).
-	// Network errors, timeouts, and 5xx responses return true so we prefer
-	// reusing an existing key over silently minting a new shadow on a transient
-	// blip (which would also clobber config + plugin-sync targets).
-	try {
-		const resp = await fetch(`${baseUrl.replace(/\/+$/, "")}/v1/ping/`, {
-			headers: { Authorization: `Token ${apiKey}` },
-			signal: AbortSignal.timeout(timeoutMs),
-		});
-		return resp.status !== 401 && resp.status !== 403;
-	} catch {
-		return true; // unknown — prefer reuse
-	}
-}
-
-async function maybeIdentify(
-	key: string,
-	baseUrl: string,
-	agentCaller: string | undefined,
-): Promise<void> {
-	// Best-effort PATCH agent_caller when --agent-caller is supplied on a
-	// reused key. Silent no-op on any failure — reuse must not break.
-	if (!agentCaller) return;
-	try {
-		const resp = await fetch(
-			`${baseUrl.replace(/\/+$/, "")}/api/v1/auth/agent_mode/caller/`,
-			{
-				method: "PATCH",
-				headers: {
-					Authorization: `Token ${key}`,
-					"Content-Type": "application/json",
-				},
-				body: JSON.stringify({ agent_caller: agentCaller }),
-				signal: AbortSignal.timeout(10_000),
-			},
-		);
-		if (resp.ok) {
-			try {
-				const body = (await resp.json()) as { agent_caller?: string };
-				if (fs.existsSync(CONFIG_FILE)) {
-					const cfg = loadConfig();
-					cfg.platform.agentCaller = body.agent_caller ?? agentCaller;
-					saveConfig(cfg);
-				}
-			} catch {
-				/* swallow — best effort */
-			}
-		}
-	} catch {
-		/* swallow — best effort */
-	}
-}
-
-async function emailLogin(
-	email: string,
-	code: string | undefined,
-	baseUrl: string,
-): Promise<Record<string, unknown>> {
-	const url = baseUrl.replace(/\/+$/, "");
-	let codeValue = code;
-
-	const sourceHeaders = {
-		"Content-Type": "application/json",
-		"X-Mem0-Source": "cli",
-		"X-Mem0-Client-Language": "node",
-	};
-
-	if (!codeValue) {
-		const resp = await fetch(`${url}/api/v1/auth/email_code/`, {
-			method: "POST",
-			headers: sourceHeaders,
-			body: JSON.stringify({ email }),
-			signal: AbortSignal.timeout(30_000),
-		});
-		if (resp.status === 429) {
-			printError("Too many attempts. Try again in a few minutes.");
-			process.exit(1);
-		}
-		if (!resp.ok) {
-			let detail: string;
-			try {
-				const body = (await resp.json()) as Record<string, unknown>;
-				detail = (body.error ?? body.detail ?? resp.statusText) as string;
-			} catch {
-				detail = resp.statusText;
-			}
-			printError(`Failed to send code: ${detail}`);
-			process.exit(1);
-		}
-
-		printSuccess("Verification code sent! Check your email.");
-
-		if (!process.stdin.isTTY) {
-			printError(
-				"No --code provided and terminal is non-interactive.",
-				"Run: mem0 init --email <email> --code <code>",
-			);
-			process.exit(1);
-		}
-
-		console.log();
-		const entered = await promptLine(`  ${brand("Verification Code")}`);
-		if (!entered) {
-			printError("Code is required.");
-			process.exit(1);
-		}
-		codeValue = entered;
-	}
-
-	const verifyResp = await fetch(`${url}/api/v1/auth/email_code/verify/`, {
-		method: "POST",
-		headers: sourceHeaders,
-		body: JSON.stringify({ email, code: codeValue.trim() }),
-		signal: AbortSignal.timeout(30_000),
-	});
-	if (verifyResp.status === 429) {
-		printError("Too many attempts. Try again in a few minutes.");
-		process.exit(1);
-	}
-	if (!verifyResp.ok) {
-		let detail: string;
-		try {
-			const body = (await verifyResp.json()) as Record<string, unknown>;
-			detail = (body.error ?? body.detail ?? verifyResp.statusText) as string;
-		} catch {
-			detail = verifyResp.statusText;
-		}
-		printError(`Verification failed: ${detail}`);
-		process.exit(1);
-	}
-
-	return verifyResp.json() as Promise<Record<string, unknown>>;
-}
-
 function promptSecret(label: string): Promise<string> {
-	return new Promise((resolve, reject) => {
-		process.stdout.write(label);
+  return new Promise((resolve, reject) => {
+    process.stdout.write(label);

-		if (process.stdin.isTTY) {
-			process.stdin.setRawMode(true);
-		}
-		process.stdin.resume();
-		process.stdin.setEncoding("utf-8");
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+    }
+    process.stdin.resume();
+    process.stdin.setEncoding("utf-8");

-		const chars: string[] = [];
+    const chars: string[] = [];

-		const onData = (key: string) => {
-			for (const ch of key) {
-				if (ch === "\r" || ch === "\n") {
-					cleanup();
-					process.stdout.write("\n");
-					resolve(chars.join(""));
-					return;
-				}
-				if (ch === "\x03") {
-					cleanup();
-					reject(new Error("Interrupted"));
-					return;
-				}
-				if (ch === "\x7f" || ch === "\x08") {
-					// backspace
-					if (chars.length > 0) {
-						chars.pop();
-						process.stdout.write("\b \b");
-					}
-				} else if (ch === "\x15") {
-					// Ctrl+U — clear line
-					process.stdout.write("\b \b".repeat(chars.length));
-					chars.length = 0;
-				} else if (ch >= " ") {
-					chars.push(ch);
-					process.stdout.write("*");
-				}
-			}
-		};
+    const onData = (key: string) => {
+      for (const ch of key) {
+        if (ch === "\r" || ch === "\n") {
+          cleanup();
+          process.stdout.write("\n");
+          resolve(chars.join(""));
+          return;
+        }
+        if (ch === "\x03") {
+          cleanup();
+          reject(new Error("Interrupted"));
+          return;
+        }
+        if (ch === "\x7f" || ch === "\x08") {
+          // backspace
+          if (chars.length > 0) {
+            chars.pop();
+            process.stdout.write("\b \b");
+          }
+        } else if (ch === "\x15") {
+          // Ctrl+U — clear line
+          process.stdout.write("\b \b".repeat(chars.length));
+          chars.length = 0;
+        } else if (ch >= " ") {
+          chars.push(ch);
+          process.stdout.write("*");
+        }
+      }
+    };

-		const cleanup = () => {
-			process.stdin.removeListener("data", onData);
-			if (process.stdin.isTTY) {
-				process.stdin.setRawMode(false);
-			}
-			process.stdin.pause();
-		};
+    const cleanup = () => {
+      process.stdin.removeListener("data", onData);
+      if (process.stdin.isTTY) {
+        process.stdin.setRawMode(false);
+      }
+      process.stdin.pause();
+    };

-		process.stdin.on("data", onData);
-	});
+    process.stdin.on("data", onData);
+  });
 }

 function promptLine(label: string, defaultValue?: string): Promise<string> {
-	const rl = readline.createInterface({
-		input: process.stdin,
-		output: process.stdout,
-	});
-	const prompt = defaultValue ? `${label} [${defaultValue}]: ` : `${label}: `;
-	return new Promise((resolve) => {
-		rl.question(prompt, (answer) => {
-			rl.close();
-			resolve(answer.trim() || defaultValue || "");
-		});
-	});
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const prompt = defaultValue ? `${label} [${defaultValue}]: ` : `${label}: `;
+  return new Promise((resolve) => {
+    rl.question(prompt, (answer) => {
+      rl.close();
+      resolve(answer.trim() || defaultValue || "");
+    });
+  });
 }

 async function setupPlatform(config: Mem0Config): Promise<void> {
-	console.log();
-	console.log(
-		`  ${dim("Get your API key at https://app.mem0.ai/dashboard/api-keys?utm_source=oss&utm_medium=cli-node")}`,
-	);
-	console.log();
+  console.log();
+  console.log(`  ${dim("Get your API key at https://app.mem0.ai/dashboard/api-keys")}`);
+  console.log();

-	process.stdout.write(`  ${brand("API Key")}: `);
-	const apiKey = await promptSecret("");
-	if (!apiKey) {
-		printError("API key is required.");
-		process.exit(1);
-	}
-	config.platform.apiKey = apiKey;
-	config.platform.createdVia = "api_key";
+  process.stdout.write(`  ${brand("API Key")}: `);
+  const apiKey = await promptSecret("");
+  if (!apiKey) {
+    printError("API key is required.");
+    process.exit(1);
+  }
+  config.platform.apiKey = apiKey;
 }

 async function setupDefaults(config: Mem0Config): Promise<void> {
-	console.log();
-	printInfo("Set default entity IDs (press Enter to skip).\n");
+  console.log();
+  printInfo("Set default entity IDs (press Enter to skip).\n");

-	const _systemUser = process.env.USER || process.env.USERNAME || "mem0-cli";
-	const userId = await promptLine(
-		`  ${brand("Default User ID")} ${dim("(recommended)")}`,
-		_systemUser,
-	);
-	if (userId) config.defaults.userId = userId;
+  const userId = await promptLine(`  ${brand("Default User ID")} ${dim("(recommended)")}`, "mem0-cli");
+  if (userId) config.defaults.userId = userId;
 }

 async function validatePlatform(config: Mem0Config): Promise<void> {
-	console.log();
-	printInfo("Validating connection...");
-	try {
-		const backend = new PlatformBackend(config.platform);
-		const status = await backend.status({
-			userId: config.defaults.userId || undefined,
-			agentId: config.defaults.agentId || undefined,
-		});
-		if (status.connected) {
-			printSuccess("Connected to mem0 Platform!");
-			// Cache user_email from ping response for telemetry distinct_id
-			try {
-				const pingData = (await backend.ping()) as Record<string, unknown>;
-				const userEmail = pingData?.user_email as string | undefined;
-				if (userEmail) {
-					config.platform.userEmail = userEmail;
-				}
-			} catch {
-				/* ignore — telemetry ID will fall back to API key hash */
-			}
-		} else {
-			printError(
-				`Could not connect: ${status.error ?? "Unknown error"}`,
-				"Visit https://app.mem0.ai/dashboard/api-keys?utm_source=oss&utm_medium=cli-node to get a new key, or run mem0 init again.",
-			);
-		}
-	} catch (e) {
-		printError(`Connection test failed: ${e instanceof Error ? e.message : e}`);
-	}
+  console.log();
+  printInfo("Validating connection...");
+  try {
+    const backend = new PlatformBackend(config.platform);
+    const status = await backend.status({
+      userId: config.defaults.userId || undefined,
+      agentId: config.defaults.agentId || undefined,
+    });
+    if (status.connected) {
+      printSuccess("Connected to mem0 Platform!");
+    } else {
+      printError(
+        `Could not connect: ${status.error ?? "Unknown error"}`,
+        "Check your API key and try again.",
+      );
+    }
+  } catch (e) {
+    printError(`Connection test failed: ${e instanceof Error ? e.message : e}`);
+  }
 }

-export async function runInit(
-	opts: {
-		apiKey?: string;
-		userId?: string;
-		email?: string;
-		code?: string;
-		force?: boolean;
-		agent?: boolean;
-		source?: string;
-		agentCaller?: string;
-	} = {},
-): Promise<void> {
-	const { detectAgentCaller } = await import("../agent-detect.js");
-	const { bootstrapViaBackend, claimViaOtp } = await import("./agent-mode.js");
-	const { isAgentMode } = await import("../state.js");
-	const { captureEvent } = await import("../telemetry.js");
+export async function runInit(opts: { apiKey?: string; userId?: string } = {}): Promise<void> {
+  const config = createDefaultConfig();

-	const fireInit = (
-		mode: "agent" | "email" | "api_key" | "existing_key",
-		claimed = false,
-	) => {
-		const props: Record<string, unknown> = { command: "init", mode };
-		// Self-declared via --agent-caller; not sniffed from env vars.
-		if (opts.agentCaller) props.agent_caller = opts.agentCaller;
-		if (opts.source) props.signup_source = opts.source;
-		if (claimed) props.claimed_agent_mode = true;
-		captureEvent("cli.init", props);
-	};
+  // Non-interactive: both flags provided
+  if (opts.apiKey && opts.userId) {
+    config.platform.apiKey = opts.apiKey;
+    config.defaults.userId = opts.userId;
+    await validatePlatform(config);
+    saveConfig(config);
+    printSuccess("Configuration saved to ~/.mem0/config.json");
+    return;
+  }

-	const config = createDefaultConfig();
-	const savedConfig = loadConfig();
-	const baseUrl =
-		process.env.MEM0_BASE_URL ||
-		savedConfig.platform.baseUrl ||
-		DEFAULT_BASE_URL;
-	config.platform.baseUrl = baseUrl;
+  // Non-TTY without full flags: error with usage hint
+  if (!process.stdin.isTTY && (!opts.apiKey || !opts.userId)) {
+    printError(
+      "Non-interactive terminal detected and missing required flags.",
+      "Usage: mem0 init --api-key <key> --user-id <id>",
+    );
+    process.exit(1);
+  }

-	// Guards
-	if (opts.code && !opts.email) {
-		printError("--code requires --email.");
-		process.exit(1);
-	}
-	if (opts.email && opts.apiKey) {
-		printError("Cannot use both --api-key and --email.");
-		process.exit(1);
-	}
+  printBanner();
+  console.log();
+  printInfo("Welcome! Let's set up your mem0 CLI.\n");

-	// ── Claim flow: --email against an existing agent-mode config ───────────
-	if (
-		opts.email &&
-		fs.existsSync(CONFIG_FILE) &&
-		savedConfig.platform.agentMode &&
-		savedConfig.platform.apiKey
-	) {
-		const email = opts.email.trim().toLowerCase();
-		validateEmail(email);
-		printInfo(`Claiming Agent Mode account to ${email}...`);
-		await claimViaOtp(savedConfig, { email, code: opts.code });
-		fireInit("email", true);
-		return;
-	}
+  // Use provided API key or prompt
+  if (opts.apiKey) {
+    config.platform.apiKey = opts.apiKey;
+  } else {
+    await setupPlatform(config);
+  }

-	// ── Agent Mode path runs BEFORE the existing-config guard ──────────────
-	// Rule 1/2 will REUSE a valid existing key (not overwrite), so we must
-	// short-circuit before the guard prompts the user about overwriting.
-	// Rule 3 only mints when there's no valid key to reuse — in that case
-	// overwriting is what the user wants.
-	const agentCtx =
-		opts.agent === true || isAgentMode() || detectAgentCaller() !== null;
-	if (!opts.apiKey && !opts.email && agentCtx) {
-		const emitReuseEnvelope = (source: "env" | "config") => {
-			if (isAgentMode()) {
-				formatJsonEnvelope({
-					command: "init",
-					data: {
-						api_key_saved: false,
-						api_key_source: source,
-						agent_mode: false,
-						message:
-							"Existing Mem0 API key found and reused. No Agent Mode key was created.",
-					},
-				});
-			} else {
-				printSuccess(
-					source === "env"
-						? "Existing MEM0_API_KEY is valid; reusing it. No new Agent Mode key was minted."
-						: "Existing API key in config is valid; reusing it. No new Agent Mode key was minted.",
-				);
-			}
-		};
-		// Rule 1: env MEM0_API_KEY valid → reuse, no new key.
-		const envKey = (process.env.MEM0_API_KEY || "").trim();
-		if (envKey && (await pingKey(envKey, baseUrl))) {
-			await maybeIdentify(envKey, baseUrl, opts.agentCaller);
-			emitReuseEnvelope("env");
-			fireInit("existing_key");
-			return;
-		}
-		// Rule 2: existing config api_key valid → reuse.
-		if (
-			savedConfig.platform.apiKey &&
-			(await pingKey(savedConfig.platform.apiKey, baseUrl))
-		) {
-			await maybeIdentify(
-				savedConfig.platform.apiKey,
-				baseUrl,
-				opts.agentCaller,
-			);
-			emitReuseEnvelope("config");
-			fireInit("existing_key");
-			return;
-		}
-		// Rule 3: mint a fresh shadow (no valid key to reuse).
-		// agent_caller is self-declared via --agent-caller (Proof Editor-style),
-		// not derived from env-var sniffing. detectAgentCaller() above is still
-		// used as a context trigger (does this look like an agent?) but never
-		// to fill identity.
-		await bootstrapViaBackend(config, {
-			source: opts.source ?? null,
-			agentCaller: opts.agentCaller ?? null,
-		});
-		fireInit("agent");
-		return;
-	}
+  // Use provided user ID or prompt
+  if (opts.userId) {
+    config.defaults.userId = opts.userId;
+  } else {
+    await setupDefaults(config);
+  }

-	// Warn if an existing config with an API key would be overwritten
-	if (
-		!opts.force &&
-		fs.existsSync(CONFIG_FILE) &&
-		savedConfig.platform.apiKey
-	) {
-		console.log(
-			`\n  ${brand("Existing configuration found")} ${dim(`(API key: ${redactKey(savedConfig.platform.apiKey)})`)}`,
-		);
-		if (process.stdin.isTTY) {
-			const rl = readline.createInterface({
-				input: process.stdin,
-				output: process.stdout,
-			});
-			const answer = await new Promise<string>((resolve) => {
-				rl.question(
-					"  Overwrite existing config? This cannot be undone. [y/N] ",
-					resolve,
-				);
-			});
-			rl.close();
-			if (answer.toLowerCase() !== "y") {
-				printInfo("Cancelled. Use --force to skip this check.");
-				process.exit(0);
-			}
-		} else {
-			printError(
-				"Existing config would be overwritten.",
-				"Use --force to overwrite.",
-			);
-			process.exit(1);
-		}
-	}
+  await validatePlatform(config);

-	// ── Email login flow ──────────────────────────────────────────────────────
-	if (opts.email) {
-		const email = opts.email.trim().toLowerCase();
-		validateEmail(email);
-
-		printBanner();
-		console.log();
-		printInfo(`Logging in as ${email}...\n`);
-
-		const result = await emailLogin(email, opts.code, baseUrl);
-
-		const apiKeyVal = result.api_key as string | undefined;
-		if (!apiKeyVal) {
-			printError(
-				"Auth succeeded but no API key was returned. Contact support.",
-			);
-			process.exit(1);
-		}
-
-		config.platform.apiKey = apiKeyVal;
-		config.platform.baseUrl = baseUrl;
-		config.platform.userEmail = email;
-		config.platform.createdVia = "email";
-		config.defaults.userId =
-			opts.userId || process.env.USER || process.env.USERNAME || "mem0-cli";
-
-		saveConfig(config);
-		console.log();
-		printSuccess("Authenticated! Configuration saved to ~/.mem0/config.json");
-		console.log();
-		console.log(`  ${dim("Get started:")}`);
-		console.log(`  ${dim('  mem0 add "I prefer dark mode"')}`);
-		console.log(`  ${dim('  mem0 search "preferences"')}`);
-		console.log();
-		return;
-	}
-
-	// ── API key flow ──────────────────────────────────────────────────────────
-	// (Agent Mode branch runs earlier — see above, before the existing-config
-	// guard, so Rules 1/2 can REUSE a valid key without prompting overwrite.)
-
-	// Non-TTY: resolve defaults so partial flags work in pipelines / CI
-	if (!process.stdin.isTTY) {
-		if (!opts.apiKey) {
-			printError(
-				"Non-interactive terminal detected and --api-key is required.",
-				"Usage: mem0 init --api-key <key>, --email <addr>, or --agent for unattended Agent Mode bootstrap.",
-			);
-			process.exit(1);
-		}
-		opts.userId =
-			opts.userId || process.env.USER || process.env.USERNAME || "mem0-cli";
-	}
-
-	// Non-interactive: both flags provided
-	if (opts.apiKey && opts.userId) {
-		config.platform.apiKey = opts.apiKey;
-		config.platform.createdVia = "api_key";
-		config.defaults.userId = opts.userId;
-		await validatePlatform(config);
-		saveConfig(config);
-		printSuccess("Configuration saved to ~/.mem0/config.json");
-		return;
-	}
-
-	printBanner();
-	console.log();
-	printInfo("Welcome! Let's set up your mem0 CLI.\n");
-
-	// Use provided API key or prompt
-	if (opts.apiKey) {
-		config.platform.apiKey = opts.apiKey;
-	} else {
-		console.log(`  ${brand("How would you like to authenticate?")}`);
-		console.log(`  ${dim("1.")} Login with email ${dim("(recommended)")}`);
-		console.log(`  ${dim("2.")} Enter API key manually`);
-		console.log();
-
-		const choice = await promptLine(`  ${brand("Choose")} [1/2]`, "1");
-
-		if (choice === "1") {
-			console.log();
-			const emailAddr = await promptLine(`  ${brand("Email")}`);
-			if (!emailAddr) {
-				printError("Email is required.");
-				process.exit(1);
-			}
-
-			const email = emailAddr.trim().toLowerCase();
-			validateEmail(email);
-			printInfo(`Logging in as ${email}...\n`);
-
-			const result = await emailLogin(email, undefined, baseUrl);
-
-			const apiKeyVal = result.api_key as string | undefined;
-			if (!apiKeyVal) {
-				printError(
-					"Auth succeeded but no API key was returned. Contact support.",
-				);
-				process.exit(1);
-			}
-
-			config.platform.apiKey = apiKeyVal;
-			config.platform.baseUrl = baseUrl;
-			config.platform.userEmail = email;
-			config.platform.createdVia = "email";
-			config.defaults.userId =
-				opts.userId || process.env.USER || process.env.USERNAME || "mem0-cli";
-
-			saveConfig(config);
-			console.log();
-			printSuccess("Authenticated! Configuration saved to ~/.mem0/config.json");
-			console.log();
-			console.log(`  ${dim("Get started:")}`);
-			console.log(`  ${dim('  mem0 add "I prefer dark mode"')}`);
-			console.log(`  ${dim('  mem0 search "preferences"')}`);
-			console.log();
-			return;
-		}
-
-		// choice === "2": fall through to API key prompt
-		await setupPlatform(config);
-	}
-
-	// Use provided user ID or prompt
-	if (opts.userId) {
-		config.defaults.userId = opts.userId;
-	} else {
-		await setupDefaults(config);
-	}
-
-	await validatePlatform(config);
-
-	saveConfig(config);
-	console.log();
-	printSuccess("Configuration saved to ~/.mem0/config.json");
-	console.log();
-	console.log(`  ${dim("Get started:")}`);
-	if (config.defaults.userId) {
-		console.log(`  ${dim('  mem0 add "I prefer dark mode"')}`);
-		console.log(`  ${dim('  mem0 search "preferences"')}`);
-	} else {
-		console.log(`  ${dim('  mem0 add "I prefer dark mode" --user-id alice')}`);
-		console.log(`  ${dim('  mem0 search "preferences" --user-id alice')}`);
-	}
-	console.log();
+  saveConfig(config);
+  console.log();
+  printSuccess("Configuration saved to ~/.mem0/config.json");
+  console.log();
+  console.log(`  ${dim("Get started:")}`);
+  if (config.defaults.userId) {
+    console.log(`  ${dim('  mem0 add "I prefer dark mode"')}`);
+    console.log(`  ${dim('  mem0 search "preferences"')}`);
+  } else {
+    console.log(`  ${dim('  mem0 add "I prefer dark mode" --user-id alice')}`);
+    console.log(`  ${dim('  mem0 search "preferences" --user-id alice')}`);
+  }
+  console.log();
 }
@@ -1,150 +1,139 @@
 /**
- * Utility commands: status, import.
+ * Utility commands: status, version, import.
 */

 import fs from "node:fs";
-import boxen from "boxen";
+import { createRequire } from "node:module";
+import { printError, printSuccess, timedStatus, colors } from "../branding.js";
 import type { Backend } from "../backend/base.js";
-import { colors, printError, printSuccess, timedStatus } from "../branding.js";
-import { formatAgentEnvelope, formatJsonEnvelope } from "../output.js";
-import { setCurrentCommand } from "../state.js";
+import { formatJsonEnvelope } from "../output.js";
+import boxen from "boxen";

 const { brand, dim, success, error: errorColor } = colors;

+const _require = createRequire(import.meta.url);
+const VERSION: string = _require("../../package.json").version;
+
 export async function cmdStatus(
-	backend: Backend,
-	opts: { userId?: string; agentId?: string; output?: string } = {},
+  backend: Backend,
+  opts: { userId?: string; agentId?: string; output?: string } = {},
 ): Promise<void> {
-	setCurrentCommand("status");
-	const start = performance.now();
-	let result: Record<string, unknown>;
-	try {
-		result = await timedStatus("Checking connection...", async () => {
-			return backend.status({ userId: opts.userId, agentId: opts.agentId });
-		});
-	} catch (e) {
-		result = {
-			connected: false,
-			error: e instanceof Error ? e.message : String(e),
-		};
-	}
-	const elapsed = (performance.now() - start) / 1000;
+  const start = performance.now();
+  let result: Record<string, unknown>;
+  try {
+    result = await timedStatus("Checking connection...", async () => {
+      return backend.status({ userId: opts.userId, agentId: opts.agentId });
+    });
+  } catch (e) {
+    result = { connected: false, error: e instanceof Error ? e.message : String(e) };
+  }
+  const elapsed = (performance.now() - start) / 1000;

-	if (opts.output === "agent" || opts.output === "json") {
-		formatAgentEnvelope({
-			command: "status",
-			data: {
-				connected: result.connected,
-				backend: result.backend ?? null,
-				base_url: result.base_url ?? null,
-			},
-			durationMs: Math.round(elapsed * 1000),
-		});
-		return;
-	}
+  if (opts.output === "json") {
+    formatJsonEnvelope({
+      command: "status",
+      data: {
+        connected: result.connected,
+        backend: result.backend ?? null,
+        base_url: result.base_url ?? null,
+        latency_ms: Math.round(elapsed * 1000),
+      },
+      durationMs: Math.round(elapsed * 1000),
+    });
+    return;
+  }

-	const lines: string[] = [];
-	if (result.connected) {
-		lines.push(`  ${success("\u25cf")} Connected`);
-	} else {
-		lines.push(`  ${errorColor("\u25cf")} Disconnected`);
-	}
+  const lines: string[] = [];
+  if (result.connected) {
+    lines.push(`  ${success("\u25cf")} Connected`);
+  } else {
+    lines.push(`  ${errorColor("\u25cf")} Disconnected`);
+  }

-	lines.push(`  ${dim("Backend:")}  ${result.backend ?? "?"}`);
-	if (result.base_url) {
-		lines.push(`  ${dim("API URL:")}  ${result.base_url}`);
-	}
-	if (result.error) {
-		lines.push(`  ${errorColor("Error:")}    ${result.error}`);
-		if (String(result.error).includes("Authentication failed")) {
-			lines.push("");
-			lines.push(
-				`  ${dim("Run")} ${brand("mem0 init")} ${dim("to reconfigure your API key")}`,
-			);
-			lines.push(
-				`  ${dim("Get a key at")} ${brand("https://app.mem0.ai/dashboard/api-keys?utm_source=oss&utm_medium=cli-node")}`,
-			);
-		}
-	}
-	lines.push(`  ${dim("Latency:")}  ${elapsed.toFixed(2)}s`);
+  lines.push(`  ${dim("Backend:")}  ${result.backend ?? "?"}`);
+  if (result.base_url) {
+    lines.push(`  ${dim("API URL:")}  ${result.base_url}`);
+  }
+  if (result.error) {
+    lines.push(`  ${errorColor("Error:")}    ${result.error}`);
+  }
+  lines.push(`  ${dim("Latency:")}  ${elapsed.toFixed(2)}s`);

-	const content = lines.join("\n");
-	console.log();
-	console.log(
-		boxen(content, {
-			title: brand("Connection Status"),
-			titleAlignment: "left",
-			borderColor: "magenta",
-			padding: 1,
-		}),
-	);
-	console.log();
+  const content = lines.join("\n");
+  console.log();
+  console.log(
+    boxen(content, {
+      title: brand("Connection Status"),
+      titleAlignment: "left",
+      borderColor: "magenta",
+      padding: 1,
+    }),
+  );
+  console.log();
+}
+
+export function cmdVersion(): void {
+  console.log(`  ${brand("◆ Mem0")} CLI v${VERSION}`);
 }

 export async function cmdImport(
-	backend: Backend,
-	filePath: string,
-	opts: { userId?: string; agentId?: string; output?: string },
+  backend: Backend,
+  filePath: string,
+  opts: { userId?: string; agentId?: string; output?: string },
 ): Promise<void> {
-	setCurrentCommand("import");
-	let data: Record<string, unknown>[];
-	try {
-		const raw = fs.readFileSync(filePath, "utf-8");
-		const parsed = JSON.parse(raw);
-		data = Array.isArray(parsed) ? parsed : [parsed];
-	} catch (e) {
-		printError(`Failed to read file: ${e instanceof Error ? e.message : e}`);
-		process.exit(1);
-	}
+  let data: Record<string, unknown>[];
+  try {
+    const raw = fs.readFileSync(filePath, "utf-8");
+    const parsed = JSON.parse(raw);
+    data = Array.isArray(parsed) ? parsed : [parsed];
+  } catch (e) {
+    printError(`Failed to read file: ${e instanceof Error ? e.message : e}`);
+    process.exit(1);
+  }

-	let added = 0;
-	let failed = 0;
-	const start = performance.now();
+  let added = 0;
+  let failed = 0;
+  const start = performance.now();

-	for (let i = 0; i < data.length; i++) {
-		const item = data[i];
-		const content = (item.memory ?? item.text ?? item.content ?? "") as string;
-		if (!content) {
-			failed++;
-			continue;
-		}
+  for (let i = 0; i < data.length; i++) {
+    const item = data[i];
+    const content = (item.memory ?? item.text ?? item.content ?? "") as string;
+    if (!content) {
+      failed++;
+      continue;
+    }

-		try {
-			await backend.add(content, undefined, {
-				userId: opts.userId ?? (item.user_id as string | undefined),
-				agentId: opts.agentId ?? (item.agent_id as string | undefined),
-				metadata: item.metadata as Record<string, unknown> | undefined,
-			});
-			added++;
-		} catch {
-			failed++;
-		}
+    try {
+      await backend.add(content, undefined, {
+        userId: opts.userId ?? (item.user_id as string | undefined),
+        agentId: opts.agentId ?? (item.agent_id as string | undefined),
+        metadata: item.metadata as Record<string, unknown> | undefined,
+      });
+      added++;
+    } catch {
+      failed++;
+    }

-		// Simple progress indicator
-		if ((i + 1) % 10 === 0 || i === data.length - 1) {
-			process.stdout.write(
-				`\r  ${dim(`Importing memories... ${i + 1}/${data.length}`)}`,
-			);
-		}
-	}
+    // Simple progress indicator
+    if ((i + 1) % 10 === 0 || i === data.length - 1) {
+      process.stdout.write(`\r  ${dim(`Importing memories... ${i + 1}/${data.length}`)}`);
+    }
+  }

-	const elapsed = (performance.now() - start) / 1000;
-	console.log(); // Clear progress line
+  const elapsed = (performance.now() - start) / 1000;
+  console.log(); // Clear progress line

-	if (opts.output === "agent" || opts.output === "json") {
-		formatAgentEnvelope({
-			command: "import",
-			data: {
-				added,
-				failed,
-			},
-			durationMs: Math.round(elapsed * 1000),
-		});
-		return;
-	}
+  if (opts.output === "json") {
+    formatJsonEnvelope({
+      command: "import",
+      data: { added, failed, duration_s: parseFloat(elapsed.toFixed(2)) },
+      durationMs: Math.round(elapsed * 1000),
+    });
+    return;
+  }

-	printSuccess(`Imported ${added} memories (${elapsed.toFixed(2)}s)`);
-	if (failed > 0) {
-		printError(`${failed} memories failed to import.`);
-	}
+  printSuccess(`Imported ${added} memories (${elapsed.toFixed(2)}s)`);
+  if (failed > 0) {
+    printError(`${failed} memories failed to import.`);
+  }
 }
@@ -1,18 +0,0 @@
-/**
- * `mem0 whoami` — print the active agent's default_user_id (AGENTRUSH identifier).
- * Reads from local config; no network call.
- */
-
-import { colors, printError, printInfo } from "../branding.js";
-import { loadConfig } from "../config.js";
-
-export async function cmdWhoami(): Promise<void> {
-	const config = loadConfig();
-	const sessionId = config.platform?.defaultUserId;
-	if (!sessionId) {
-		printError("No default_user_id found. Run `mem0 init --agent` first.");
-		process.exit(1);
-	}
-	console.log(`Your AGENTRUSH identifier:  ${colors.brand(sessionId)}`);
-	printInfo("Find your row at https://mem0.ai/agentrush");
-}
@@ -18,215 +18,142 @@ export const DEFAULT_BASE_URL = "https://api.mem0.ai";
 export const CONFIG_VERSION = 1;

 export interface PlatformConfig {
-	apiKey: string;
-	baseUrl: string;
-	userEmail: string;
-	// Agent Mode (unclaimed-shadow signup)
-	agentMode: boolean; // true while the key is an unclaimed agent-mode key
-	createdVia: string; // "agent_mode" | "email" | "api_key" | "existing_key"
-	agentCaller: string; // canonical agent name when createdVia === "agent_mode" (e.g. "claude-code")
-	claimedAt: string; // ISO timestamp once the agent has been claimed
-	defaultUserId: string; // `user_<slug>` returned by bootstrap; auto-default scope
+  apiKey: string;
+  baseUrl: string;
 }

 export interface DefaultsConfig {
-	userId: string;
-	agentId: string;
-	appId: string;
-	runId: string;
-}
-
-export interface TelemetryConfig {
-	anonymousId: string;
-}
-
-export interface AgentRushConfig {
-	// ISO timestamp the human acknowledged the "memories are public" warning.
-	// Empty until first interactive `mem0 agent-rush add`.
-	acknowledgedAt: string;
+  userId: string;
+  agentId: string;
+  appId: string;
+  runId: string;
+  enableGraph: boolean;
 }

 export interface Mem0Config {
-	version: number;
-	defaults: DefaultsConfig;
-	platform: PlatformConfig;
-	telemetry: TelemetryConfig;
-	agentRush: AgentRushConfig;
+  version: number;
+  defaults: DefaultsConfig;
+  platform: PlatformConfig;
 }

 export function createDefaultConfig(): Mem0Config {
-	return {
-		version: CONFIG_VERSION,
-		defaults: {
-			userId: "",
-			agentId: "",
-			appId: "",
-			runId: "",
-		},
-		platform: {
-			apiKey: "",
-			baseUrl: DEFAULT_BASE_URL,
-			userEmail: "",
-			agentMode: false,
-			createdVia: "",
-			agentCaller: "",
-			claimedAt: "",
-			defaultUserId: "",
-		},
-		telemetry: {
-			anonymousId: "",
-		},
-		agentRush: {
-			acknowledgedAt: "",
-		},
-	};
+  return {
+    version: CONFIG_VERSION,
+    defaults: {
+      userId: "",
+      agentId: "",
+      appId: "",
+      runId: "",
+      enableGraph: false,
+    },
+    platform: {
+      apiKey: "",
+      baseUrl: DEFAULT_BASE_URL,
+    },
+  };
 }

 export function ensureConfigDir(): string {
-	fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
-	return CONFIG_DIR;
+  fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+  return CONFIG_DIR;
 }

 export function loadConfig(): Mem0Config {
-	const config = createDefaultConfig();
+  const config = createDefaultConfig();

-	if (fs.existsSync(CONFIG_FILE)) {
-		const raw = fs.readFileSync(CONFIG_FILE, "utf-8");
-		const data = JSON.parse(raw);
+  if (fs.existsSync(CONFIG_FILE)) {
+    const raw = fs.readFileSync(CONFIG_FILE, "utf-8");
+    const data = JSON.parse(raw);

-		config.version = data.version ?? CONFIG_VERSION;
+    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;
-		config.platform.userEmail = plat.user_email ?? "";
-		config.platform.agentMode = Boolean(plat.agent_mode ?? false);
-		config.platform.createdVia = plat.created_via ?? "";
-		config.platform.agentCaller = plat.agent_caller ?? "";
-		config.platform.claimedAt = plat.claimed_at ?? "";
-		config.platform.defaultUserId = plat.default_user_id ?? "";
+    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 ?? "";
-		const telemetry = data.telemetry ?? {};
-		config.telemetry.anonymousId = telemetry.anonymous_id ?? "";
-		const agentRush = data.agent_rush ?? {};
-		config.agentRush.acknowledgedAt = agentRush.acknowledged_at ?? "";
-	}
+    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;
+  }

-	// Environment variable overrides
-	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;
-	return config;
+  // Environment variable overrides
+  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;
 }

 export function saveConfig(config: Mem0Config): void {
-	ensureConfigDir();
+  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,
-		},
-		platform: {
-			api_key: config.platform.apiKey,
-			base_url: config.platform.baseUrl,
-			user_email: config.platform.userEmail,
-			agent_mode: config.platform.agentMode,
-			created_via: config.platform.createdVia,
-			agent_caller: config.platform.agentCaller,
-			claimed_at: config.platform.claimedAt,
-			default_user_id: config.platform.defaultUserId,
-		},
-		telemetry: {
-			anonymous_id: config.telemetry.anonymousId,
-		},
-		agent_rush: {
-			acknowledged_at: config.agentRush.acknowledgedAt,
-		},
-	};
+  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, 0o600);
-
-	// Propagate api_key to ecosystem touchpoints (Claude plugin env injection,
-	// shell rc exports). Idempotent — updates only EXISTING entries; never
-	// creates new ones. Best-effort: errors swallowed so config.json is
-	// always authoritative, never blocked by plugin-state issues.
-	if (config.platform.apiKey) {
-		try {
-			// eslint-disable-next-line @typescript-eslint/no-require-imports
-			const { syncApiKey } = require("./plugin-sync.js");
-			syncApiKey(config.platform.apiKey);
-		} catch {
-			/* swallow */
-		}
-	}
+  fs.writeFileSync(CONFIG_FILE, JSON.stringify(data, null, 2));
+  fs.chmodSync(CONFIG_FILE, 0o600);
 }

 export function redactKey(key: string): string {
-	if (!key) return "(not set)";
-	if (key.length <= 8) return `${key.slice(0, 2)}***`;
-	return `${key.slice(0, 4)}...${key.slice(-4)}`;
+  if (!key) return "(not set)";
+  if (key.length <= 8) return key.slice(0, 2) + "***";
+  return key.slice(0, 4) + "..." + key.slice(-4);
 }

 /** Key map from dotted config path to the config object fields. */
 const KEY_MAP: Record<string, [keyof Mem0Config, string]> = {
-	"platform.api_key": ["platform", "apiKey"],
-	"platform.base_url": ["platform", "baseUrl"],
-	"platform.user_email": ["platform", "userEmail"],
-	"defaults.user_id": ["defaults", "userId"],
-	"defaults.agent_id": ["defaults", "agentId"],
-	"defaults.app_id": ["defaults", "appId"],
-	"defaults.run_id": ["defaults", "runId"],
-	// Short-form aliases
-	api_key: ["platform", "apiKey"],
-	base_url: ["platform", "baseUrl"],
-	user_email: ["platform", "userEmail"],
-	user_id: ["defaults", "userId"],
-	agent_id: ["defaults", "agentId"],
-	app_id: ["defaults", "appId"],
-	run_id: ["defaults", "runId"],
+  "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"],
 };

 export function getNestedValue(config: Mem0Config, dottedKey: string): unknown {
-	const mapping = KEY_MAP[dottedKey];
-	if (!mapping) return undefined;
-	const [section, field] = mapping;
-	return (config[section] as unknown as Record<string, unknown>)[field];
+  const mapping = KEY_MAP[dottedKey];
+  if (!mapping) return undefined;
+  const [section, field] = mapping;
+  return (config[section] as unknown as Record<string, unknown>)[field];
 }

-export function setNestedValue(
-	config: Mem0Config,
-	dottedKey: string,
-	value: string,
-): boolean {
-	const mapping = KEY_MAP[dottedKey];
-	if (!mapping) return false;
-	const [section, field] = mapping;
-	const obj = config[section] as unknown as Record<string, unknown>;
+export function setNestedValue(config: Mem0Config, dottedKey: string, value: string): boolean {
+  const mapping = KEY_MAP[dottedKey];
+  if (!mapping) return false;
+  const [section, field] = mapping;
+  const obj = config[section] as unknown as Record<string, unknown>;

-	const current = obj[field];
-	if (typeof current === "boolean") {
-		obj[field] = ["true", "1", "yes"].includes(value.toLowerCase());
-	} else if (typeof current === "number") {
-		obj[field] = Number.parseInt(value, 10);
-	} else {
-		obj[field] = value;
-	}
-	return true;
+  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;
 }
@@ -1,2 +0,0 @@
-/** Injected by tsup at build time from package.json version field. Undefined in dev/test. */
-declare const __CLI_VERSION__: string | undefined;
@@ -4,40 +4,40 @@
 */

 import chalk from "chalk";
-import type { Argument, Command, Help, Option } from "commander";
+import type { Command, Help, Option, Argument } from "commander";
 // Colors imported from chalk directly to match Typer/Rich defaults

 // ── Colors (matching Typer/Rich defaults) ────────────────────────────────

-const cyanBold = chalk.cyan.bold; // option flags, command names
-const greenBold = chalk.green.bold; // switch flags (boolean --force etc)
-const yellowBold = chalk.yellow.bold; // metavar <value>
-const yellow = chalk.yellow; // "Usage:" label
-const bold = chalk.bold; // command name in usage
-const dim = chalk.dim; // defaults, descriptions
-const dimBorder = chalk.dim; // panel borders
+const cyanBold = chalk.cyan.bold;       // option flags, command names
+const greenBold = chalk.green.bold;     // switch flags (boolean --force etc)
+const yellowBold = chalk.yellow.bold;   // metavar <value>
+const yellow = chalk.yellow;            // "Usage:" label
+const bold = chalk.bold;                // command name in usage
+const dim = chalk.dim;                  // defaults, descriptions
+const dimBorder = chalk.dim;            // panel borders

 // ── Strip ANSI ───────────────────────────────────────────────────────────

-// biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape sequence is intentional
+// eslint-disable-next-line no-control-regex
 const ANSI_RE = /\x1b\[[0-9;]*m/g;

 function stripAnsi(str: string): number {
-	return str.replace(ANSI_RE, "").length;
+  return str.replace(ANSI_RE, "").length;
 }

 // ── Command display order (matches Python CLI) ──────────────────────────

 /** Commands grouped into panels, matching Python CLI's rich_help_panel. */
 const COMMAND_GROUPS: { panel: string; commands: string[] }[] = [
-	{
-		panel: "Memory",
-		commands: ["add", "search", "get", "list", "update", "delete"],
-	},
-	{
-		panel: "Management",
-		commands: ["init", "status", "import", "help", "entity", "event", "config"],
-	},
+  {
+    panel: "Memory",
+    commands: ["add", "search", "get", "list", "update", "delete"],
+  },
+  {
+    panel: "Management",
+    commands: ["init", "status", "import", "help", "entity", "config"],
+  },
 ];

 /** Flat order derived from COMMAND_GROUPS. */
@@ -46,88 +46,88 @@ const COMMAND_ORDER: string[] = COMMAND_GROUPS.flatMap((g) => g.commands);
 // ── Option-to-panel mapping (derived from Python's rich_help_panel) ─────

 const OPTION_PANELS: Record<string, Record<string, string>> = {
-	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",
-	},
+  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",
+  },
 };

 const PANEL_ORDER: string[] = [
-	"Scope",
-	"Search",
-	"Pagination",
-	"Filters",
-	"Output",
-	"Connection",
+  "Scope",
+  "Search",
+  "Pagination",
+  "Filters",
+  "Output",
+  "Connection",
 ];

 // ── Panel rendering ─────────────────────────────────────────────────────
@@ -141,238 +141,234 @@ const PANEL_ORDER: string[] = [
 * ╰────────────────────────────────╯
 * ```
 */
-function renderPanel(title: string, rows: string[], width: number): string {
-	if (rows.length === 0) return "";
+function renderPanel(
+  title: string,
+  rows: string[],
+  width: number,
+): string {
+  if (rows.length === 0) return "";

-	// Inner width is total width minus the two border chars
-	const inner = width - 2;
+  // Inner width is total width minus the two border chars
+  const inner = width - 2;

-	// Top border: ╭─ Title ─...─╮
-	const titleStr = ` ${title} `;
-	const fillLen = Math.max(0, inner - 1 - titleStr.length);
-	const topLine =
-		dimBorder("╭─") +
-		dimBorder(titleStr) +
-		dimBorder("─".repeat(fillLen)) +
-		dimBorder("╮");
+  // Top border: ╭─ Title ─...─╮
+  const titleStr = ` ${title} `;
+  const fillLen = Math.max(0, inner - 1 - titleStr.length);
+  const topLine =
+    dimBorder("╭─") +
+    dimBorder(titleStr) +
+    dimBorder("─".repeat(fillLen)) +
+    dimBorder("╮");

-	// Bottom border: ╰─...─╯
-	const bottomLine =
-		dimBorder("╰") + dimBorder("─".repeat(inner)) + dimBorder("╯");
+  // Bottom border: ╰─...─╯
+  const bottomLine = dimBorder("╰") + dimBorder("─".repeat(inner)) + dimBorder("╯");

-	// Content rows
-	const contentLines = rows.map((row) => {
-		const visLen = stripAnsi(row);
-		const pad = Math.max(0, inner - 1 - visLen);
-		return `${dimBorder("│")} ${row}${" ".repeat(pad)}${dimBorder("│")}`;
-	});
+  // Content rows
+  const contentLines = rows.map((row) => {
+    const visLen = stripAnsi(row);
+    const pad = Math.max(0, inner - 1 - visLen);
+    return dimBorder("│") + " " + row + " ".repeat(pad) + dimBorder("│");
+  });

-	return [topLine, ...contentLines, bottomLine].join("\n");
+  return [topLine, ...contentLines, bottomLine].join("\n");
 }

 // ── Format an option term (short + long) ────────────────────────────────

 function formatOptionTerm(opt: Option): string {
-	const parts: string[] = [];
-	if (opt.short) parts.push(opt.short);
-	if (opt.long) parts.push(opt.long);
-	let term = parts.join(", ");
+  const parts: string[] = [];
+  if (opt.short) parts.push(opt.short);
+  if (opt.long) parts.push(opt.long);
+  let term = parts.join(", ");

-	// Append value placeholder for non-boolean options
-	if (opt.flags) {
-		const match = opt.flags.match(/<[^>]+>|\[[^\]]+\]/);
-		if (match) {
-			term += ` ${match[0]}`;
-		}
-	}
-	return term;
+  // Append value placeholder for non-boolean options
+  if (opt.flags) {
+    const match = opt.flags.match(/<[^>]+>|\[[^\]]+\]/);
+    if (match) {
+      term += " " + match[0];
+    }
+  }
+  return term;
 }

 // ── Get the long flag name for panel lookup ─────────────────────────────

 function getLongFlag(opt: Option): string {
-	if (opt.long) return opt.long;
-	return opt.short || "";
+  if (opt.long) return opt.long;
+  return opt.short || "";
 }

 // ── Format a default value ──────────────────────────────────────────────

 function formatDefault(opt: Option): string {
-	if (opt.defaultValue !== undefined && opt.defaultValue !== false) {
-		return dim(` [default: ${opt.defaultValue}]`);
-	}
-	return "";
+  if (opt.defaultValue !== undefined && opt.defaultValue !== false) {
+    return dim(` [default: ${opt.defaultValue}]`);
+  }
+  return "";
 }

 // ── The main help formatter ─────────────────────────────────────────────

 export function richFormatHelp(cmd: Command, helper: Help): string {
-	const width = process.stdout.columns || 80;
-	const lines: string[] = [];
+  const width = process.stdout.columns || 80;
+  const lines: string[] = [];

-	const isRoot = !cmd.parent;
+  const isRoot = !cmd.parent;

-	// ── Usage line ──
-	const usage = helper.commandUsage(cmd);
-	lines.push("");
-	if (isRoot) {
-		// Root: "Usage: mem0 <command> [options]" — <command> yellow, [options] bold
-		lines.push(
-			` ${yellow("Usage:")} ${bold(cmd.name())} ${yellow("<command>")} ${bold("[options]")}`,
-		);
-	} else {
-		// Subcommands: split into command path (bold) and args (yellow)
-		const usageParts = usage.split(" ");
-		const cmdPath: string[] = [];
-		const argParts: string[] = [];
-		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("");
+  // ── Usage line ──
+  const usage = helper.commandUsage(cmd);
+  lines.push("");
+  if (isRoot) {
+    // Root: "Usage: mem0 <command> [options]" — <command> yellow, [options] bold
+    lines.push(` ${yellow("Usage:")} ${bold(cmd.name())} ${yellow("<command>")} ${bold("[options]")}`);
+  } else {
+    // Subcommands: split into command path (bold) and args (yellow)
+    const usageParts = usage.split(" ");
+    const cmdPath: string[] = [];
+    const argParts: string[] = [];
+    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("");

-	// ── Description ──
-	const desc = helper.commandDescription(cmd);
-	if (desc) {
-		// Split multi-line descriptions (e.g., title + tagline)
-		const descLines = desc.split("\n");
-		for (let i = 0; i < descLines.length; i++) {
-			const dLine = descLines[i];
-			// First line is the title, subsequent non-empty lines are tagline (dimmed)
-			if (i === 0 || dLine.trim() === "") {
-				lines.push(` ${dLine}`);
-			} else {
-				lines.push(` ${dim(dLine)}`);
-			}
-		}
-		lines.push("");
-	}
+  // ── Description ──
+  const desc = helper.commandDescription(cmd);
+  if (desc) {
+    // Split multi-line descriptions (e.g., title + tagline)
+    const descLines = desc.split("\n");
+    for (let i = 0; i < descLines.length; i++) {
+      const dLine = descLines[i];
+      // First line is the title, subsequent non-empty lines are tagline (dimmed)
+      if (i === 0 || dLine.trim() === "") {
+        lines.push(` ${dLine}`);
+      } else {
+        lines.push(` ${dim(dLine)}`);
+      }
+    }
+    lines.push("");
+  }

-	// ── Arguments panel (subcommands only) ──
-	if (!isRoot) {
-		const visibleArgs = helper.visibleArguments(cmd);
-		if (visibleArgs.length > 0) {
-			const maxLen = Math.max(
-				...visibleArgs.map((a: Argument) => a.name().length),
-			);
-			const argRows = visibleArgs.map((a: Argument) => {
-				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);
-		}
-	}
+  // ── Arguments panel (subcommands only) ──
+  if (!isRoot) {
+    const visibleArgs = helper.visibleArguments(cmd);
+    if (visibleArgs.length > 0) {
+      const maxLen = Math.max(...visibleArgs.map((a: Argument) => a.name().length));
+      const argRows = visibleArgs.map((a: Argument) => {
+        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);
+    }
+  }

-	// ── Collect options (grouped into panels for subcommands) ──
-	const visibleOpts = helper.visibleOptions(cmd);
-	const cmdName = cmd.name();
-	const panelMap =
-		!isRoot && OPTION_PANELS[cmdName] ? OPTION_PANELS[cmdName] : {};
+  // ── Collect options (grouped into panels for subcommands) ──
+  const visibleOpts = helper.visibleOptions(cmd);
+  const cmdName = cmd.name();
+  const panelMap = (!isRoot && OPTION_PANELS[cmdName]) ? OPTION_PANELS[cmdName] : {};

-	const grouped: Record<string, Option[]> = { Options: [] };
-	for (const panelName of PANEL_ORDER) {
-		grouped[panelName] = [];
-	}
+  const grouped: Record<string, Option[]> = { 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);
-		}
-	}
+  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);
+    }
+  }

-	// ── Collect commands ──
-	const visibleCmds = helper.visibleCommands(cmd);
+  // ── Collect commands ──
+  const visibleCmds = helper.visibleCommands(cmd);

-	if (isRoot) {
-		// ROOT: Options first, then command groups (matches Python/Typer ordering)
-		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 is Command => c !== undefined);
-				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 {
-		// SUBCOMMANDS: Options/panels first, then sub-subcommands
-		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);
-			}
-		}
-		// Sub-subcommands (e.g., config show/get/set, entity list/delete)
-		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);
-		}
-	}
+  if (isRoot) {
+    // ROOT: Options first, then command groups (matches Python/Typer ordering)
+    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 is Command => c !== undefined);
+        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 {
+    // SUBCOMMANDS: Options/panels first, then sub-subcommands
+    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);
+      }
+    }
+    // Sub-subcommands (e.g., config show/get/set, entity list/delete)
+    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");
+  lines.push("");
+  return lines.join("\n");
 }

 // ── Format option rows with aligned columns ─────────────────────────────

 function formatOptionRows(opts: Option[]): string[] {
-	const terms = opts.map((o) => formatOptionTerm(o));
-	const maxTermLen = Math.max(...terms.map((t) => t.length));
+  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}`;
-	});
+  return opts.map((opt, i) => {
+    const term = cyanBold(terms[i].padEnd(maxTermLen));
+    const desc = opt.description || "";
+    const def = formatDefault(opt);
+    return ` ${term}  ${desc}${def}`;
+  });
 }

 // ── Sort commands by COMMAND_ORDER ──────────────────────────────────────

 function sortCommands(cmds: Command[]): Command[] {
-	return [...cmds].sort((a, b) => {
-		const ai = COMMAND_ORDER.indexOf(a.name());
-		const bi = COMMAND_ORDER.indexOf(b.name());
-		// Unknown commands go to end, preserving original order
-		const aIdx = ai === -1 ? COMMAND_ORDER.length : ai;
-		const bIdx = bi === -1 ? COMMAND_ORDER.length : bi;
-		return aIdx - bIdx;
-	});
+  return [...cmds].sort((a, b) => {
+    const ai = COMMAND_ORDER.indexOf(a.name());
+    const bi = COMMAND_ORDER.indexOf(b.name());
+    // Unknown commands go to end, preserving original order
+    const aIdx = ai === -1 ? COMMAND_ORDER.length : ai;
+    const bIdx = bi === -1 ? COMMAND_ORDER.length : bi;
+    return aIdx - bIdx;
+  });
 }
@@ -2,410 +2,229 @@
 * Output formatting for mem0 CLI — text, JSON, table, quiet modes.
 */

-import boxen from "boxen";
 import Table from "cli-table3";
+import boxen from "boxen";
 import { colors, sym } from "./branding.js";
-import { takeNotice } from "./state.js";

 const { brand, accent, success, error: errorColor, dim } = colors;

 function formatDate(dtStr?: string): string | undefined {
-	if (!dtStr) return undefined;
-	try {
-		const dt = new Date(dtStr.replace("Z", "+00:00"));
-		return dt.toISOString().slice(0, 10);
-	} catch {
-		return dtStr?.slice(0, 10);
-	}
+  if (!dtStr) return undefined;
+  try {
+    const dt = new Date(dtStr.replace("Z", "+00:00"));
+    return dt.toISOString().slice(0, 10);
+  } catch {
+    return dtStr?.slice(0, 10);
+  }
 }

 export function formatMemoriesText(
-	memories: Record<string, unknown>[],
-	title = "memories",
+  memories: Record<string, unknown>[],
+  title = "memories",
 ): void {
-	const count = memories.length;
-	console.log(`\n${brand(`Found ${count} ${title}:`)}\n`);
+  const count = memories.length;
+  console.log(`\n${brand(`Found ${count} ${title}:`)}\n`);

-	for (let i = 0; i < memories.length; i++) {
-		const mem = memories[i];
-		const memoryText = (mem.memory ?? mem.text ?? "") as string;
-		const memId = ((mem.id as string) ?? "").slice(0, 8);
-		const score = mem.score as number | undefined;
-		const created = formatDate(mem.created_at as string | undefined);
-		let category: string | undefined;
-		const cats = mem.categories;
-		if (Array.isArray(cats)) {
-			category = cats[0] as string | undefined;
-		}
+  for (let i = 0; i < memories.length; i++) {
+    const mem = memories[i];
+    const memoryText = (mem.memory ?? mem.text ?? "") as string;
+    const memId = ((mem.id as string) ?? "").slice(0, 8);
+    const score = mem.score as number | undefined;
+    const created = formatDate(mem.created_at as string | undefined);
+    let category: string | undefined;
+    const cats = mem.categories;
+    if (Array.isArray(cats)) {
+      category = cats[0] as string | undefined;
+    }

-		console.log(`  ${i + 1}. ${memoryText}`);
+    console.log(`  ${i + 1}. ${memoryText}`);

-		const details: string[] = [];
-		if (score !== undefined) details.push(`Score: ${score.toFixed(2)}`);
-		if (memId) details.push(`ID: ${memId}`);
-		if (created) details.push(`Created: ${created}`);
-		if (category) details.push(`Category: ${category}`);
+    const details: string[] = [];
+    if (score !== undefined) 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(" · "))}`);
-		}
-		console.log();
-	}
+    if (details.length > 0) {
+      console.log(`     ${dim(details.join(" · "))}`);
+    }
+    console.log();
+  }
 }

-export function formatMemoriesTable(
-	memories: Record<string, unknown>[],
-	opts: { showScore?: boolean } = {},
-): void {
-	const head = opts.showScore
-		? [
-				accent("ID"),
-				accent("Score"),
-				accent("Memory"),
-				accent("Category"),
-				accent("Created"),
-			]
-		: [accent("ID"), accent("Memory"), accent("Category"), accent("Created")];
-	const colWidths = opts.showScore ? [38, 8, 40, 16, 14] : [38, 40, 16, 14];
-	const table = new Table({
-		head,
-		colWidths,
-		wordWrap: true,
-		style: { head: [], border: [] },
-	});
+export function formatMemoriesTable(memories: Record<string, unknown>[]): void {
+  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 as string) ?? "";
-		let memoryText = (mem.memory ?? mem.text ?? "") as string;
-		if (memoryText.length > 60) {
-			memoryText = `${memoryText.slice(0, 57)}...`;
-		}
-		const categories = mem.categories;
-		const cat =
-			Array.isArray(categories) && categories.length > 0
-				? categories.length > 1
-					? `${categories[0]} (+${categories.length - 1})`
-					: (categories[0] as string)
-				: "—";
-		const created = formatDate(mem.created_at as string | undefined) ?? "—";
-		if (opts.showScore) {
-			const score = mem.score as number | undefined;
-			const scoreStr = score !== undefined ? score.toFixed(2) : "—";
-			table.push([dim(memId), scoreStr, memoryText, cat, created]);
-		} else {
-			table.push([dim(memId), memoryText, cat, created]);
-		}
-	}
+  for (const mem of memories) {
+    const memId = ((mem.id as string) ?? "").slice(0, 8);
+    let memoryText = (mem.memory ?? mem.text ?? "") as string;
+    if (memoryText.length > 60) {
+      memoryText = memoryText.slice(0, 57) + "...";
+    }
+    const categories = mem.categories;
+    const cat =
+      Array.isArray(categories) && categories.length > 0
+        ? (categories[0] as string)
+        : "—";
+    const created = formatDate(mem.created_at as string | undefined) ?? "—";
+    table.push([dim(memId), memoryText, cat, created]);
+  }

-	console.log();
-	console.log(table.toString());
-	console.log();
+  console.log();
+  console.log(table.toString());
+  console.log();
 }

 export function formatJson(data: unknown): void {
-	console.log(JSON.stringify(data, null, 2));
+  console.log(JSON.stringify(data, null, 2));
 }

 export function formatSingleMemory(
-	mem: Record<string, unknown>,
-	output = "text",
+  mem: Record<string, unknown>,
+  output = "text",
 ): void {
-	if (output === "json") {
-		formatJson(mem);
-		return;
-	}
+  if (output === "json") {
+    formatJson(mem);
+    return;
+  }

-	const memoryText = (mem.memory ?? mem.text ?? "") as string;
-	const memId = (mem.id ?? "") as string;
+  const memoryText = (mem.memory ?? mem.text ?? "") as string;
+  const memId = (mem.id ?? "") as string;

-	const lines: string[] = [];
-	lines.push(`  ${memoryText}`);
-	lines.push("");
+  const lines: string[] = [];
+  lines.push(`  ${memoryText}`);
+  lines.push("");

-	if (memId) lines.push(`  ${dim("ID:")}         ${memId}`);
-	const created = formatDate(mem.created_at as string | undefined);
-	if (created) lines.push(`  ${dim("Created:")}    ${created}`);
-	const updated = formatDate(mem.updated_at as string | undefined);
-	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}`);
-	}
+  if (memId) lines.push(`  ${dim("ID:")}         ${memId}`);
+  const created = formatDate(mem.created_at as string | undefined);
+  if (created) lines.push(`  ${dim("Created:")}    ${created}`);
+  const updated = formatDate(mem.updated_at as string | undefined);
+  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();
+  const content = lines.join("\n");
+  console.log();
+  console.log(
+    boxen(content, {
+      title: brand("Memory"),
+      titleAlignment: "left",
+      borderColor: "magenta",
+      padding: 1,
+    }),
+  );
+  console.log();
 }

 export function formatAddResult(
-	result: Record<string, unknown> | Record<string, unknown>[],
-	output = "text",
+  result: Record<string, unknown> | Record<string, unknown>[],
+  output = "text",
 ): void {
-	if (output === "json") {
-		formatJson(result);
-		return;
-	}
-	if (output === "quiet") return;
+  if (output === "json") {
+    formatJson(result);
+    return;
+  }
+  if (output === "quiet") return;

-	const results: Record<string, unknown>[] = Array.isArray(result)
-		? result
-		: ((result.results as Record<string, unknown>[]) ?? [result]);
+  const results: Record<string, unknown>[] = Array.isArray(result)
+    ? result
+    : ((result.results as Record<string, unknown>[]) ?? [result]);

-	if (!results.length) {
-		console.log(`  ${dim("No memories extracted.")}`);
-		return;
-	}
+  if (!results.length) {
+    console.log(`  ${dim("No memories extracted.")}`);
+    return;
+  }

-	console.log();
-	const seenPendingEvents = new Set<string>();
-	for (const r of results) {
-		// Detect async PENDING response
-		if (r.status === "PENDING") {
-			const eventId = (r.event_id as string) ?? "";
-			// Deduplicate PENDING entries with the same event_id
-			if (eventId && seenPendingEvents.has(eventId)) continue;
-			if (eventId) seenPendingEvents.add(eventId);
-			const icon = accent(sym("⧗", "..."));
-			const parts = [
-				`  ${icon} ${dim("Queued".padEnd(10))}`,
-				"Processing in background",
-			];
-			console.log(parts.join("  "));
-			if (eventId) {
-				console.log(`  ${dim(`  event_id: ${eventId}`)}`);
-				console.log(
-					`  ${dim(`  → Check status: mem0 event status ${eventId}`)}`,
-				);
-			}
-			continue;
-		}
+  console.log();
+  for (const r of results) {
+    // Detect async PENDING response
+    if (r.status === "PENDING") {
+      const eventId = ((r.event_id as string) ?? "").slice(0, 8);
+      const icon = accent(sym("⧗", "..."));
+      const parts = [`  ${icon} ${dim("Queued".padEnd(10))}`, "Processing in background"];
+      if (eventId) parts.push(dim(`(event ${eventId})`));
+      console.log(parts.join("  "));
+      continue;
+    }

-		const event = (r.event ?? "ADD") as string;
-		const memory = (r.memory ?? r.text ?? r.content ?? r.data ?? "") as string;
-		const memId = ((r.id as string) ?? (r.memory_id as string) ?? "").slice(
-			0,
-			8,
-		);
+    const event = (r.event ?? "ADD") as string;
+    const memory = (r.memory ?? r.text ?? r.content ?? r.data ?? "") as string;
+    const memId = ((r.id as string) ?? (r.memory_id as string) ?? "").slice(0, 8);

-		let icon: string;
-		let label: string;
-		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("·");
-			label = "No change";
-		} else {
-			icon = dim("?");
-			label = event;
-		}
+    let icon: string;
+    let label: string;
+    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("·");
+      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();
+    const parts = [`  ${icon} ${dim(label.padEnd(10))}`];
+    if (memory) parts.push(memory);
+    if (memId) parts.push(dim(`(${memId})`));
+    console.log(parts.join("  "));
+  }
+  console.log();
 }

 export function formatJsonEnvelope(opts: {
-	command: string;
-	data: unknown;
-	durationMs?: number;
-	scope?: Record<string, string | undefined>;
-	count?: number;
-	status?: string;
-	error?: string;
+  command: string;
+  data: unknown;
+  durationMs?: number;
+  scope?: Record<string, string | undefined>;
+  count?: number;
+  status?: string;
+  error?: string;
 }): void {
-	const envelope: Record<string, unknown> = {
-		status: opts.status ?? "success",
-		command: opts.command,
-	};
-	if (opts.durationMs !== undefined) envelope.duration_ms = opts.durationMs;
-	if (opts.scope !== undefined) envelope.scope = opts.scope;
-	if (opts.count !== undefined) envelope.count = opts.count;
-	if (opts.error) envelope.error = opts.error;
-	envelope.data = opts.data;
-
-	// If the platform flagged this as an unclaimed Agent Mode account, surface
-	// the notice inside the JSON envelope so an agent consuming the output
-	// sees it without needing to inspect HTTP headers.
-	// eslint-disable-next-line @typescript-eslint/no-require-imports
-	const { takeNotice } = require("./state.js");
-	const notice = takeNotice();
-	if (notice) envelope.mem0_notice = notice;
-
-	console.log(JSON.stringify(envelope, null, 2));
-}
-
-function pick(
-	obj: Record<string, unknown>,
-	keys: string[],
-): Record<string, unknown> {
-	const result: Record<string, unknown> = {};
-	for (const key of keys) {
-		if (key in obj) result[key] = obj[key];
-	}
-	return result;
-}
-
-export function sanitizeAgentData(command: string, data: unknown): unknown {
-	if (data === null || data === undefined) return data;
-
-	switch (command) {
-		case "add": {
-			const items = Array.isArray(data) ? data : [data];
-			return items.map((item) => {
-				const r = item as Record<string, unknown>;
-				if (r.status === "PENDING") return pick(r, ["status", "event_id"]);
-				return pick(r, ["id", "memory", "event"]);
-			});
-		}
-		case "search":
-			return (data as Record<string, unknown>[]).map((r) =>
-				pick(r, [
-					"id",
-					"memory",
-					"score",
-					"created_at",
-					"categories",
-					"expiration_date",
-				]),
-			);
-		case "list":
-			return (data as Record<string, unknown>[]).map((r) =>
-				pick(r, [
-					"id",
-					"memory",
-					"created_at",
-					"categories",
-					"expiration_date",
-				]),
-			);
-		case "get": {
-			const r = data as Record<string, unknown>;
-			return pick(r, [
-				"id",
-				"memory",
-				"created_at",
-				"updated_at",
-				"categories",
-				"metadata",
-				"expiration_date",
-			]);
-		}
-		case "update": {
-			const r = data as Record<string, unknown>;
-			return pick(r, ["id", "memory", "expiration_date"]);
-		}
-		case "delete":
-		case "delete-all":
-		case "entity delete":
-			return data;
-		case "entity list":
-			return (data as Record<string, unknown>[]).map((r) => ({
-				name: (r.name ?? r.id) as string,
-				...pick(r, ["type", "count"]),
-			}));
-		case "event list":
-			return (data as Record<string, unknown>[]).map((r) =>
-				pick(r, ["id", "event_type", "status", "latency", "created_at"]),
-			);
-		case "event status": {
-			const ev = data as Record<string, unknown>;
-			const rawResults =
-				(ev.results as Record<string, unknown>[] | undefined) ?? [];
-			const sanitizedResults = rawResults.map((r) => {
-				const nested = r.data as Record<string, unknown> | undefined;
-				return {
-					id: r.id,
-					event: r.event,
-					user_id: r.user_id,
-					memory: nested?.memory ?? null,
-				};
-			});
-			return {
-				...pick(ev, [
-					"id",
-					"event_type",
-					"status",
-					"latency",
-					"created_at",
-					"updated_at",
-				]),
-				results: sanitizedResults,
-			};
-		}
-		default:
-			return data;
-	}
-}
-
-export function formatAgentEnvelope(opts: {
-	command: string;
-	data: unknown;
-	durationMs?: number;
-	scope?: Record<string, string | undefined>;
-	count?: number;
-}): void {
-	const envelope: Record<string, unknown> = {
-		status: "success",
-		command: opts.command,
-	};
-	if (opts.durationMs !== undefined) envelope.duration_ms = opts.durationMs;
-	if (opts.scope) {
-		const filtered = Object.fromEntries(
-			Object.entries(opts.scope).filter(([, v]) => v),
-		);
-		if (Object.keys(filtered).length > 0) envelope.scope = filtered;
-	}
-	if (opts.count !== undefined) envelope.count = opts.count;
-	envelope.data = sanitizeAgentData(opts.command, opts.data);
-
-	// Surface the unclaimed-Agent-Mode notice (if any) in the envelope so an
-	// agent reading the JSON output sees it without inspecting HTTP headers.
-	const notice = takeNotice();
-	if (notice) envelope.mem0_notice = notice;
-
-	console.log(JSON.stringify(envelope, null, 2));
+  const envelope: Record<string, unknown> = {
+    status: opts.status ?? "success",
+    command: opts.command,
+  };
+  if (opts.durationMs !== undefined) envelope.duration_ms = opts.durationMs;
+  if (opts.scope !== undefined) envelope.scope = opts.scope;
+  if (opts.count !== undefined) envelope.count = opts.count;
+  if (opts.error) envelope.error = opts.error;
+  envelope.data = opts.data;
+  console.log(JSON.stringify(envelope, null, 2));
 }

 export function printResultSummary(opts: {
-	count: number;
-	durationSecs?: number;
-	page?: number;
-	scopeIds?: Record<string, string | undefined>;
+  count: number;
+  durationSecs?: number;
+  page?: number;
+  scopeIds?: Record<string, string | undefined>;
 }): void {
-	const parts = [`${opts.count} result${opts.count !== 1 ? "s" : ""}`];
-	if (opts.page !== undefined) parts.push(`page ${opts.page}`);
-	if (opts.scopeIds) {
-		const scopeParts = Object.entries(opts.scopeIds)
-			.filter(([, v]) => v)
-			.map(([k, v]) => `${k}=${v}`);
-		if (scopeParts.length > 0) parts.push(scopeParts.join(", "));
-	}
-	if (opts.durationSecs !== undefined)
-		parts.push(`${opts.durationSecs.toFixed(2)}s`);
+  const parts = [`${opts.count} result${opts.count !== 1 ? "s" : ""}`];
+  if (opts.page !== undefined) 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 !== undefined) parts.push(`${opts.durationSecs.toFixed(2)}s`);

-	console.log(`  ${dim(parts.join(" · "))}`);
-	console.log();
+  console.log(`  ${dim(parts.join(" · "))}`);
+  console.log();
 }
@@ -1,120 +0,0 @@
-/**
- * Sync the active Mem0 API key into other ecosystem touchpoints.
- *
- * Why: the CLI canonical state is ~/.mem0/config.json. MCP servers
- * (Claude Code plugin, Codex plugin) read MEM0_API_KEY from env or
- * their own config files. Without a sync, agent-mode bootstrap mints a
- * new key into config.json but the plugin's MCP keeps using the old
- * key from env — silent surprise.
- *
- * Design:
- *  - Update ONLY entries that already exist; never create new ones
- *  - Preserve surrounding content, formatting, other keys
- *  - Atomic writes (tmp + rename) so a crash mid-write doesn't corrupt
- *  - Idempotent — re-running with the same key is a no-op
- *
- * Targets:
- *  - ~/.claude/settings.json::env::MEM0_API_KEY (Claude Code env injection)
- *  - ~/.zshrc / ~/.bashrc `export MEM0_API_KEY="..."` lines
- *
- * Out of scope: Codex / Cursor MCP configs and the plugin's own
- * <plugin-dir>/.api_key file (plugin-managed, different schema).
- */
-
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-
-const CLAUDE_SETTINGS = path.join(os.homedir(), ".claude", "settings.json");
-const SHELL_RCS = [
-	path.join(os.homedir(), ".zshrc"),
-	path.join(os.homedir(), ".bashrc"),
-	path.join(os.homedir(), ".bash_profile"),
-];
-
-// Use [ \t]* (not \s*) so a trailing newline at end-of-file is preserved
-// when the MEM0_API_KEY export is the last line of the rc file.
-const RC_LINE_RE =
-	/^([ \t]*export[ \t]+MEM0_API_KEY[ \t]*=[ \t]*)(["']?)([^"'\n]*)(["']?)[ \t]*$/m;
-
-export function syncApiKey(apiKey: string): string[] {
-	if (!apiKey) return [];
-	const updated: string[] = [];
-	if (updateClaudeSettings(CLAUDE_SETTINGS, apiKey)) {
-		updated.push(CLAUDE_SETTINGS);
-	}
-	for (const rc of SHELL_RCS) {
-		if (updateShellRc(rc, apiKey)) updated.push(rc);
-	}
-	return updated;
-}
-
-/** @internal — exported for unit tests; consumers should use {@link syncApiKey}. */
-export function updateClaudeSettings(
-	filePath: string,
-	apiKey: string,
-): boolean {
-	if (!fs.existsSync(filePath)) return false;
-	let raw: string;
-	let data: Record<string, unknown>;
-	try {
-		raw = fs.readFileSync(filePath, "utf-8");
-		data = JSON.parse(raw);
-	} catch {
-		return false;
-	}
-	const env = data.env;
-	if (!env || typeof env !== "object" || !("MEM0_API_KEY" in env)) {
-		return false; // no existing entry — don't create one
-	}
-	const envObj = env as Record<string, string>;
-	if (envObj.MEM0_API_KEY === apiKey) return false; // already in sync
-	envObj.MEM0_API_KEY = apiKey;
-	atomicWriteText(filePath, `${JSON.stringify(data, null, 2)}\n`);
-	return true;
-}
-
-/** @internal — exported for unit tests; consumers should use {@link syncApiKey}. */
-export function updateShellRc(filePath: string, apiKey: string): boolean {
-	if (!fs.existsSync(filePath)) return false;
-	let text: string;
-	try {
-		text = fs.readFileSync(filePath, "utf-8");
-	} catch {
-		return false;
-	}
-	const match = text.match(RC_LINE_RE);
-	if (!match) return false; // no existing line
-	if (match[3] === apiKey) return false;
-	const newText = text.replace(
-		RC_LINE_RE,
-		(_full, prefix) => `${prefix}"${apiKey}"`,
-	);
-	atomicWriteText(filePath, newText);
-	return true;
-}
-
-function atomicWriteText(filePath: string, content: string): void {
-	const dir = path.dirname(filePath);
-	const tmp = path.join(dir, `.${path.basename(filePath)}.${process.pid}.tmp`);
-	try {
-		fs.writeFileSync(tmp, content, "utf-8");
-		// Preserve permissions if original existed.
-		if (fs.existsSync(filePath)) {
-			try {
-				const mode = fs.statSync(filePath).mode & 0o777;
-				fs.chmodSync(tmp, mode);
-			} catch {
-				/* best-effort */
-			}
-		}
-		fs.renameSync(tmp, filePath);
-	} catch (err) {
-		try {
-			fs.unlinkSync(tmp);
-		} catch {
-			/* ignore */
-		}
-		throw err;
-	}
-}
@@ -1,53 +0,0 @@
-/**
- * Agent mode state — set by the root program option handler,
- * read by commands and branding functions.
- */
-
-import fs from "node:fs";
-
-let _agentMode = false;
-let _currentCommand = "";
-let _pendingNotice = "";
-
-export function isAgentMode(): boolean {
-	return _agentMode;
-}
-
-export function setAgentMode(val: boolean): void {
-	_agentMode = val;
-}
-
-export function getCurrentCommand(): string {
-	return _currentCommand;
-}
-
-export function setCurrentCommand(name: string): void {
-	_currentCommand = name;
-}
-
-/**
- * Stash a Mem0 backend notice (Agent Mode unclaimed reminder) for end-of-
- * command surfacing. Called from the platform backend after each response so
- * the notice prints once per command regardless of how many sub-requests
- * fired. Last-write-wins is fine — the message text is identical.
- */
-export function captureNotice(notice: string | null | undefined): void {
-	if (notice) _pendingNotice = notice;
-}
-
-export function takeNotice(): string {
-	const msg = _pendingNotice;
-	_pendingNotice = "";
-	return msg;
-}
-
-/** True only when stdin is an actual pipe or file redirect (never in agent mode). */
-export function stdinIsPiped(): boolean {
-	if (isAgentMode()) return false;
-	try {
-		const stat = fs.fstatSync(0);
-		return stat.isFIFO() || stat.isFile();
-	} catch {
-		return false;
-	}
-}
@@ -1,157 +0,0 @@
-/**
- * CLI telemetry — anonymous usage tracking via PostHog.
- *
- * Sends fire-and-forget events by spawning a detached child process
- * (telemetry-sender.cjs). The parent CLI process exits immediately;
- * the child handles email resolution, caching, and the HTTP POST.
- *
- * Disable with: MEM0_TELEMETRY=false
- */
-
-import { spawn } from "node:child_process";
-import { createHash, randomUUID } from "node:crypto";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { CONFIG_FILE, loadConfig, saveConfig } from "./config.js";
-import { CLI_VERSION } from "./version.js";
-
-const POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX";
-const POSTHOG_HOST = "https://us.i.posthog.com/i/v0/e/";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const SENDER_SCRIPT = path.join(__dirname, "..", "telemetry-sender.cjs");
-
-function isTelemetryEnabled(): boolean {
-	try {
-		return process.env.MEM0_TELEMETRY !== "false";
-	} catch {
-		return true;
-	}
-}
-
-/**
- * Return a persistent per-machine anonymous ID, generating one if needed.
- *
- * Stored in ~/.mem0/config.json under `telemetry.anonymous_id` so that
- * repeat runs on the same machine share one PostHog identity instead of
- * collapsing into a single shared fallback string.
- */
-function getOrCreateAnonymousId(): string {
-	const config = loadConfig();
-	if (config.telemetry.anonymousId) {
-		return config.telemetry.anonymousId;
-	}
-
-	const newId = `cli-anon-${randomUUID().replace(/-/g, "")}`;
-	config.telemetry.anonymousId = newId;
-	try {
-		saveConfig(config);
-	} catch {
-		/* ignore persistence failure — still return the generated ID */
-	}
-	return newId;
-}
-
-/**
- * Return a stable anonymous identifier for the current user.
- *
- * Priority: cached user_email (from /v1/ping/) > MD5(api_key) >
- * persistent per-machine anonymous ID.
- */
-function getDistinctId(): string {
-	try {
-		const config = loadConfig();
-		if (config.platform.userEmail) {
-			return config.platform.userEmail;
-		}
-		if (config.platform.apiKey) {
-			return createHash("md5").update(config.platform.apiKey).digest("hex");
-		}
-	} catch {
-		/* ignore */
-	}
-	try {
-		return getOrCreateAnonymousId();
-	} catch {
-		return `cli-anon-${randomUUID().replace(/-/g, "")}`;
-	}
-}
-
-/**
- * Fire a PostHog event (non-blocking, returns void, never throws).
- * Spawns telemetry-sender.cjs as a detached subprocess.
- *
- * When `preResolvedEmail` is provided (e.g. from an upfront ping
- * validation), it is used directly as the PostHog distinct ID and the
- * subprocess skips its own `/v1/ping/` call.
- */
-export function captureEvent(
-	eventName: string,
-	properties: Record<string, unknown> = {},
-	preResolvedEmail?: string,
-): void {
-	if (!isTelemetryEnabled()) return;
-
-	try {
-		const config = loadConfig();
-		const distinctId = preResolvedEmail || getDistinctId();
-
-		// Detect anonymous → identified transition. If a stored anonymous_id
-		// exists and we just resolved to a real identity, fire a one-shot
-		// $identify event so PostHog stitches the pre-signup history onto
-		// the authenticated profile. Clear the stored id so we don't re-alias.
-		let anonIdToAlias: string | null = null;
-		if (
-			distinctId &&
-			!distinctId.startsWith("cli-anon-") &&
-			config.telemetry.anonymousId
-		) {
-			anonIdToAlias = config.telemetry.anonymousId;
-			config.telemetry.anonymousId = "";
-			try {
-				saveConfig(config);
-			} catch {
-				/* ignore — alias may double-fire next run, harmless */
-			}
-		}
-
-		// M4: every cli.* event carries agent_mode based on the config flag
-		// (unclaimed Agent Mode key). This is the growth-doc property used to
-		// join init → add → search funnels in PostHog.
-		const payload = {
-			api_key: POSTHOG_API_KEY,
-			distinct_id: distinctId,
-			event: eventName,
-			properties: {
-				source: "CLI",
-				language: "node",
-				cli_version: CLI_VERSION,
-				agent_mode: Boolean(config.platform.agentMode),
-				node_version: process.version,
-				os: process.platform,
-				...properties,
-				$process_person_profile: false,
-				$lib: "posthog-node",
-			},
-		};
-
-		const context = {
-			payload,
-			posthogHost: POSTHOG_HOST,
-			needsEmail: !distinctId || !distinctId.includes("@"),
-			mem0ApiKey: config.platform.apiKey || "",
-			mem0BaseUrl: config.platform.baseUrl || "https://api.mem0.ai",
-			configPath: CONFIG_FILE,
-			anonDistinctIdToAlias: anonIdToAlias,
-		};
-
-		const child = spawn(process.execPath, [SENDER_SCRIPT], {
-			detached: true,
-			stdio: ["pipe", "ignore", "ignore"],
-		});
-		child.stdin?.end(JSON.stringify(context));
-		child.unref();
-	} catch {
-		/* silently swallow */
-	}
-}
@@ -1,10 +0,0 @@
-import { createRequire } from "node:module";
-
-// __CLI_VERSION__ is replaced at build time by tsup (see tsup.config.ts).
-// When running via tsx in dev/test mode, fall back to reading package.json.
-// typeof is safe to use on undeclared identifiers — it returns 'undefined' without throwing.
-export const CLI_VERSION: string =
-	typeof __CLI_VERSION__ !== "undefined"
-		? (__CLI_VERSION__ as string)
-		: (createRequire(import.meta.url)("../package.json") as { version: string })
-				.version;
@@ -1,155 +0,0 @@
-/**
- * Standalone telemetry sender — runs as a detached child process.
- *
- * Usage: node telemetry-sender.cjs   (JSON context is read from stdin; a single
- * argv argument is still accepted as a legacy fallback)
- *
- * This script is spawned by telemetry.captureEvent() and runs independently
- * of the parent CLI process. It:
- *
- * 1. Resolves the user's email via /v1/ping/ if not already cached
- * 2. Caches the email in ~/.mem0/config.json for future runs
- * 3. Sends the PostHog event
- *
- * All errors are silently swallowed — this process must never produce output
- * or affect the user experience.
- */
-
-"use strict";
-
-const https = require("https");
-const fs = require("fs");
-
-function loadContext() {
-	return new Promise((resolve, reject) => {
-		if (process.argv[2]) {
-			try {
-				resolve(JSON.parse(process.argv[2]));
-			} catch (err) {
-				reject(err);
-			}
-			return;
-		}
-
-		let data = "";
-		process.stdin.setEncoding("utf8");
-		process.stdin.on("data", (chunk) => (data += chunk));
-		process.stdin.on("end", () => {
-			try {
-				resolve(JSON.parse(data));
-			} catch (err) {
-				reject(err);
-			}
-		});
-		process.stdin.on("error", reject);
-	});
-}
-
-function httpsRequest(url, method, headers, body) {
-	return new Promise((resolve, reject) => {
-		const u = new URL(url);
-		const opts = {
-			hostname: u.hostname,
-			path: u.pathname + u.search,
-			method,
-			headers,
-			timeout: 10000,
-		};
-		const req = https.request(opts, (res) => {
-			let data = "";
-			res.on("data", (chunk) => (data += chunk));
-			res.on("end", () => {
-				try {
-					resolve(JSON.parse(data));
-				} catch {
-					resolve({});
-				}
-			});
-		});
-		req.on("error", reject);
-		req.on("timeout", () => {
-			req.destroy();
-			reject(new Error("timeout"));
-		});
-		if (body) {
-			req.end(body);
-		} else {
-			req.end();
-		}
-	});
-}
-
-async function resolveAndCacheEmail(ctx, payload) {
-	try {
-		const pingUrl = ctx.mem0BaseUrl.replace(/\/+$/, "") + "/v1/ping/";
-		const data = await httpsRequest(pingUrl, "GET", {
-			Authorization: "Token " + ctx.mem0ApiKey,
-			"Content-Type": "application/json",
-		});
-		if (data.user_email) {
-			payload.distinct_id = data.user_email;
-			cacheEmail(ctx.configPath, data.user_email);
-		}
-	} catch {
-		// silently swallow
-	}
-}
-
-function cacheEmail(configPath, email) {
-	if (!configPath) return;
-	try {
-		const raw = fs.readFileSync(configPath, "utf-8");
-		const cfg = JSON.parse(raw);
-		if (!cfg.platform) cfg.platform = {};
-		cfg.platform.user_email = email;
-		fs.writeFileSync(configPath, JSON.stringify(cfg, null, 2));
-	} catch {
-		// silently swallow
-	}
-}
-
-async function sendPosthogEvent(posthogHost, payload) {
-	try {
-		const body = JSON.stringify(payload);
-		await httpsRequest(posthogHost, "POST", {
-			"Content-Type": "application/json",
-			"Content-Length": Buffer.byteLength(body),
-		}, body);
-	} catch {
-		// silently swallow
-	}
-}
-
-async function sendIdentifyEvent(ctx, payload, anonId) {
-	const identifyPayload = {
-		api_key: payload.api_key,
-		event: "$identify",
-		distinct_id: payload.distinct_id,
-		properties: {
-			$anon_distinct_id: anonId,
-			$lib: (payload.properties && payload.properties.$lib) || "posthog-node",
-		},
-	};
-	await sendPosthogEvent(ctx.posthogHost, identifyPayload);
-}
-
-async function main() {
-	const ctx = await loadContext();
-	const payload = ctx.payload;
-
-	if (ctx.needsEmail && ctx.mem0ApiKey) {
-		await resolveAndCacheEmail(ctx, payload);
-	}
-
-	// Fire $identify *after* email resolution so PostHog links the stored
-	// anonymous id directly to the final identity (email, not the api-key
-	// hash). The regular event is sent next so it lands under the merged
-	// profile.
-	if (ctx.anonDistinctIdToAlias) {
-		await sendIdentifyEvent(ctx, payload, ctx.anonDistinctIdToAlias);
-	}
-
-	await sendPosthogEvent(ctx.posthogHost, payload);
-}
-
-main().catch(() => {});
@@ -1,141 +0,0 @@
-/**
- * Parity tests for `mem0 init --agent` (Agent Mode bootstrap).
- *
- * Mirror of `cli/python/tests/test_agent_mode.py` — both files MUST stay
- * in sync so that the Python and Node CLIs expose an identical surface
- * for the Agent Mode entrypoint. If you add a flag here, add the same
- * assertion on the Python side (and vice versa).
- *
- * Network-bound bootstrap is covered by the platform-side E2E suite
- * (`backend/tests/e2e/test_05_agent_mode.py`); these tests only verify
- * the CLI surface that ships in the binary.
- */
-
-import { describe, it, expect } from "vitest";
-import { execSync } from "node:child_process";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-
-function run(
-  args: string[],
-  opts: { home?: string; env?: Record<string, string> } = {},
-): { stdout: string; stderr: string; exitCode: number } {
-  const env = { ...process.env };
-  for (const key of Object.keys(env)) {
-    if (key.startsWith("MEM0_")) delete env[key];
-  }
-  if (opts.home) env.HOME = opts.home;
-  if (opts.env) Object.assign(env, opts.env);
-
-  try {
-    const stdout = execSync(`npx tsx src/index.ts ${args.join(" ")}`, {
-      cwd: path.join(__dirname, ".."),
-      env,
-      encoding: "utf-8",
-      timeout: 15000,
-    });
-    return { stdout, stderr: "", exitCode: 0 };
-  } catch (e: any) {
-    return {
-      stdout: e.stdout ?? "",
-      stderr: e.stderr ?? "",
-      exitCode: e.status ?? 1,
-    };
-  }
-}
-
-function cleanHome(): string {
-  return fs.mkdtempSync(path.join(os.tmpdir(), "mem0-test-"));
-}
-
-describe("init flag surface", () => {
-  it("init --help lists --agent", () => {
-    const result = run(["init", "--help"]);
-    expect(result.exitCode).toBe(0);
-    expect(result.stdout).toContain("--agent");
-  });
-
-  it("init --help describes Agent Mode", () => {
-    const result = run(["init", "--help"]);
-    expect(result.exitCode).toBe(0);
-    // Description must mention what --agent actually does so an agent
-    // reading the help can self-discover the bootstrap entrypoint.
-    expect(
-      result.stdout.includes("Agent Mode") ||
-        result.stdout.toLowerCase().includes("unattended"),
-    ).toBe(true);
-  });
-
-  it("init --help lists --source", () => {
-    const result = run(["init", "--help"]);
-    expect(result.exitCode).toBe(0);
-    expect(result.stdout).toContain("--source");
-  });
-
-  it("init --help lists --email and --code", () => {
-    const result = run(["init", "--help"]);
-    expect(result.exitCode).toBe(0);
-    expect(result.stdout).toContain("--email");
-    expect(result.stdout).toContain("--code");
-  });
-});
-
-describe("argv preprocessing — --agent reaches init subcommand", () => {
-  // Regression for the bug where the global --agent JSON-alias swallowed
-  // the init-level --agent flag, making `mem0 init --agent` behave like
-  // the plain interactive wizard.
-
-  it("init --agent triggers bootstrap branch (not the wizard)", () => {
-    const home = cleanHome();
-    const result = run(["init", "--agent"], {
-      home,
-      env: {
-        MEM0_BASE_URL: "http://127.0.0.1:1", // blackhole
-        FORCE_COLOR: "0",
-      },
-    });
-    const combined = (result.stdout + result.stderr).toLowerCase();
-    // Either bootstrap-attempt error, or a connection/network error —
-    // both prove the --agent path executed (the wizard would prompt for
-    // input and succeed/hang, not surface a network error).
-    expect(
-      combined.includes("agent") ||
-        combined.includes("connect") ||
-        combined.includes("network") ||
-        combined.includes("fetch") ||
-        combined.includes("bootstrap"),
-    ).toBe(true);
-    fs.rmSync(home, { recursive: true, force: true });
-  });
-});
-
-describe("JSON envelope on network failure", () => {
-  it("init --agent --json does not leak a stack trace when backend is unreachable", () => {
-    const home = cleanHome();
-    const result = run(["init", "--agent", "--json"], {
-      home,
-      env: {
-        MEM0_BASE_URL: "http://127.0.0.1:1",
-        FORCE_COLOR: "0",
-      },
-    });
-    const combined = result.stdout + result.stderr;
-    // No raw Node stack should escape the agent-mode handler.
-    expect(combined).not.toMatch(/at \w+\s*\(.+\.ts:\d+/);
-    expect(combined).not.toContain("UnhandledPromiseRejection");
-    expect(result.exitCode).not.toBe(0);
-    fs.rmSync(home, { recursive: true, force: true });
-  });
-});
-
-describe("top-level help lists init", () => {
-  // `mem0 --help` must list `init` so agents walking the top-level help
-  // can discover the Agent Mode entrypoint without prior knowledge.
-
-  it("--help lists init", () => {
-    const result = run(["--help"]);
-    expect(result.exitCode).toBe(0);
-    expect(result.stdout).toContain("init");
-  });
-});
@@ -80,19 +80,19 @@ describe("printWarning", () => {
 describe("printInfo", () => {
  it("prints info message", () => {
    printInfo("Important note");
-    expect(errOutput).toContain("Important note");
+    expect(output).toContain("Important note");
  });
 });

 describe("printScope", () => {
  it("prints scope when IDs present", () => {
    printScope({ user_id: "alice", agent_id: "bot" });
-    expect(errOutput).toContain("alice");
-    expect(errOutput).toContain("bot");
+    expect(output).toContain("alice");
+    expect(output).toContain("bot");
  });

  it("prints nothing when no IDs", () => {
    printScope({});
-    expect(errOutput).toBe("");
+    expect(output).toBe("");
  });
 });
@@ -44,24 +44,21 @@ describe("CLI Integration — help and version", () => {
    expect(result.stdout).toContain("search");
  });

-  it("prints the version with --version, and has no version subcommand", () => {
-    const flag = run(["--version"]);
-    expect(flag.exitCode).toBe(0);
-    expect(flag.stdout).toContain("Mem0");
-    expect(run(["version"]).exitCode).not.toBe(0);
+  it("shows version with --version", () => {
+    const result = run(["--version"]);
+    expect(result.exitCode).toBe(0);
+    expect(result.stdout).toContain("0.1.0");
  });

-  it.each([["help", "--json"], ["--json", "help"], ["--agent", "help"]])(
-    "%s %s produces valid JSON",
-    (...args) => {
-      const result = run(args);
-      expect(result.exitCode).toBe(0);
-      const parsed = JSON.parse(result.stdout);
-      // spec may have cli.name or top-level name
-      const name = parsed.name ?? parsed.cli?.name;
-      expect(name).toBe("mem0");
-    },
-  );
+
+  it("help --json produces valid JSON", () => {
+    const result = run(["help", "--json"]);
+    expect(result.exitCode).toBe(0);
+    const parsed = JSON.parse(result.stdout);
+    // spec may have cli.name or top-level name
+    const name = parsed.name ?? parsed.cli?.name;
+    expect(name).toBe("mem0");
+  });

  it("shows add help", () => {
    const result = run(["add", "--help"]);
@@ -117,22 +114,22 @@ describe("CLI Integration — help and version", () => {
    expect(result.exitCode).toBe(0);
  });

-  it("add help has --output flag", () => {
+  it("add help has --graph flag", () => {
    const result = run(["add", "--help"]);
    expect(result.exitCode).toBe(0);
-    expect(result.stdout).toContain("--output");
+    expect(result.stdout).toContain("--graph");
  });

-  it("search help has --rerank flag", () => {
+  it("search help has --graph flag", () => {
    const result = run(["search", "--help"]);
    expect(result.exitCode).toBe(0);
-    expect(result.stdout).toContain("--rerank");
+    expect(result.stdout).toContain("--graph");
  });

-  it("list help has --category flag", () => {
+  it("list help has --graph flag", () => {
    const result = run(["list", "--help"]);
    expect(result.exitCode).toBe(0);
-    expect(result.stdout).toContain("--category");
+    expect(result.stdout).toContain("--graph");
  });
 });

@@ -2,11 +2,9 @@
 * Tests for CLI commands using mock backend.
 */

-import { Command } from "commander";
-import { beforeEach, describe, expect, it, vi } from "vitest";
-import type { Backend } from "../src/backend/base.js";
-import { setAgentMode } from "../src/state.js";
+import { describe, it, expect, vi, beforeEach } from "vitest";
 import { createMockBackend } from "./setup.js";
+import type { Backend } from "../src/backend/base.js";

 let mockBackend: Backend;

@@ -17,657 +15,207 @@ const originalLog = console.log;
 const originalError = console.error;

 beforeEach(() => {
-	mockBackend = createMockBackend();
-	output = "";
-	errOutput = "";
-	console.log = (...args: unknown[]) => {
-		output += args.map(String).join(" ") + "\n";
-	};
-	console.error = (...args: unknown[]) => {
-		errOutput += args.map(String).join(" ") + "\n";
-	};
+  mockBackend = createMockBackend();
+  output = "";
+  errOutput = "";
+  console.log = (...args: unknown[]) => {
+    output += args.map(String).join(" ") + "\n";
+  };
+  console.error = (...args: unknown[]) => {
+    errOutput += args.map(String).join(" ") + "\n";
+  };
 });

 // Restore after each test
 import { afterEach } from "vitest";
 afterEach(() => {
-	console.log = originalLog;
-	console.error = originalError;
-	setAgentMode(false);
+  console.log = originalLog;
+  console.error = originalError;
 });

 describe("cmdAdd", () => {
-	it("adds text memory", async () => {
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		await cmdAdd(mockBackend, "I prefer dark mode", {
-			userId: "alice",
-			immutable: false,
-			output: "text",
-		});
-		expect(mockBackend.add).toHaveBeenCalledOnce();
-	});
+  it("adds text memory", async () => {
+    const { cmdAdd } = await import("../src/commands/memory.js");
+    await cmdAdd(mockBackend, "I prefer dark mode", {
+      userId: "alice",
+      immutable: false,
+      noInfer: false,
+      enableGraph: false,
+      output: "text",
+    });
+    expect(mockBackend.add).toHaveBeenCalledOnce();
+  });

-	it("adds from messages JSON", async () => {
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		await cmdAdd(mockBackend, undefined, {
-			userId: "alice",
-			messages: JSON.stringify([{ role: "user", content: "I love Python" }]),
-			immutable: false,
-			output: "text",
-		});
-		expect(mockBackend.add).toHaveBeenCalledOnce();
-	});
+  it("adds from messages JSON", async () => {
+    const { cmdAdd } = await import("../src/commands/memory.js");
+    await cmdAdd(mockBackend, undefined, {
+      userId: "alice",
+      messages: JSON.stringify([{ role: "user", content: "I love Python" }]),
+      immutable: false,
+      noInfer: false,
+      enableGraph: false,
+      output: "text",
+    });
+    expect(mockBackend.add).toHaveBeenCalledOnce();
+  });

-	it("outputs json format", async () => {
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		await cmdAdd(mockBackend, "test", {
-			userId: "alice",
-			immutable: false,
-			output: "json",
-		});
-		expect(output).toContain("results");
-	});
+  it("outputs json format", async () => {
+    const { cmdAdd } = await import("../src/commands/memory.js");
+    await cmdAdd(mockBackend, "test", {
+      userId: "alice",
+      immutable: false,
+      noInfer: false,
+      enableGraph: false,
+      output: "json",
+    });
+    expect(output).toContain("results");
+  });

-	it("quiet mode produces no memory content", async () => {
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		await cmdAdd(mockBackend, "test", {
-			userId: "alice",
-			immutable: false,
-			output: "quiet",
-		});
-		expect(output).not.toContain("dark mode");
-	});
-});
-
-describe("cmdAdd forwards --no-infer (regression for #5261)", () => {
-	it("forwards infer: false when --no-infer is set", async () => {
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		await cmdAdd(mockBackend, "store me verbatim", {
-			userId: "alice",
-			immutable: false,
-			infer: false,
-			output: "text",
-		});
-		expect(mockBackend.add).toHaveBeenCalledWith(
-			"store me verbatim",
-			undefined,
-			expect.objectContaining({ infer: false }),
-		);
-	});
-
-	it("forwards infer: true by default (flag absent)", async () => {
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		await cmdAdd(mockBackend, "infer me", {
-			userId: "alice",
-			immutable: false,
-			output: "text",
-		});
-		expect(mockBackend.add).toHaveBeenCalledWith(
-			"infer me",
-			undefined,
-			expect.objectContaining({ infer: true }),
-		);
-	});
-
-	it("Commander stores --no-infer as opts.infer, not opts.noInfer", () => {
-		const withFlag = new Command();
-		withFlag
-			.option("--no-infer", "Skip inference, store raw.")
-			.action(() => {});
-		withFlag.parse(["--no-infer"], { from: "user" });
-		expect(withFlag.opts().infer).toBe(false);
-		expect(withFlag.opts().noInfer).toBeUndefined();
-
-		const withoutFlag = new Command();
-		withoutFlag
-			.option("--no-infer", "Skip inference, store raw.")
-			.action(() => {});
-		withoutFlag.parse([], { from: "user" });
-		expect(withoutFlag.opts().infer).toBe(true);
-	});
-});
-
-describe("cmdAdd forwards MEM-5893 option-parity flags", () => {
-	it("forwards customInstructions, customCategories, structuredDataSchema, timestamp", async () => {
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		await cmdAdd(mockBackend, "test", {
-			userId: "alice",
-			immutable: false,
-			customInstructions: "Extract only preferences.",
-			customCategories: JSON.stringify([{ prefs: "user preferences" }]),
-			structuredDataSchema: JSON.stringify({ type: "object" }),
-			timestamp: 1700000000,
-			output: "text",
-		});
-		expect(mockBackend.add).toHaveBeenCalledWith(
-			"test",
-			undefined,
-			expect.objectContaining({
-				customInstructions: "Extract only preferences.",
-				customCategories: [{ prefs: "user preferences" }],
-				structuredDataSchema: { type: "object" },
-				timestamp: 1700000000,
-			}),
-		);
-	});
-
-	it("regression: metadata, expires, and customCategories reach the backend together", async () => {
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		await cmdAdd(mockBackend, "test", {
-			userId: "alice",
-			immutable: false,
-			metadata: JSON.stringify({ source: "test" }),
-			expires: "2099-01-01",
-			customCategories: JSON.stringify([{ prefs: "user preferences" }]),
-			output: "text",
-		});
-		expect(mockBackend.add).toHaveBeenCalledWith(
-			"test",
-			undefined,
-			expect.objectContaining({
-				metadata: { source: "test" },
-				expires: "2099-01-01",
-				customCategories: [{ prefs: "user preferences" }],
-			}),
-		);
-	});
-});
-
-describe("cmdAdd rejects invalid input before calling the backend (MEM-5893)", () => {
-	function mockProcessExit() {
-		return vi.spyOn(process, "exit").mockImplementation(((code?: number) => {
-			throw new Error(`process.exit:${code}`);
-		}) as never);
-	}
-
-	it("rejects --categories with a message pointing to --custom-categories", async () => {
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		const exitSpy = mockProcessExit();
-
-		await expect(
-			cmdAdd(mockBackend, "test", {
-				userId: "alice",
-				immutable: false,
-				categories: "prefs",
-				output: "text",
-			}),
-		).rejects.toThrow("process.exit:1");
-
-		expect(errOutput).toContain("--custom-categories");
-		expect(mockBackend.add).not.toHaveBeenCalled();
-		exitSpy.mockRestore();
-	});
-
-	it("rejects invalid JSON in --custom-categories", async () => {
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		const exitSpy = mockProcessExit();
-
-		await expect(
-			cmdAdd(mockBackend, "test", {
-				userId: "alice",
-				immutable: false,
-				customCategories: "not-json",
-				output: "text",
-			}),
-		).rejects.toThrow("process.exit:1");
-
-		expect(errOutput).toContain("--custom-categories");
-		expect(mockBackend.add).not.toHaveBeenCalled();
-		exitSpy.mockRestore();
-	});
-
-	it("rejects invalid JSON in --structured-data-schema", async () => {
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		const exitSpy = mockProcessExit();
-
-		await expect(
-			cmdAdd(mockBackend, "test", {
-				userId: "alice",
-				immutable: false,
-				structuredDataSchema: "not-json",
-				output: "text",
-			}),
-		).rejects.toThrow("process.exit:1");
-
-		expect(errOutput).toContain("--structured-data-schema");
-		expect(mockBackend.add).not.toHaveBeenCalled();
-		exitSpy.mockRestore();
-	});
-});
-
-describe("cmdAdd deduplicates PENDING", () => {
-	const DUPLICATE_PENDING = {
-		results: [
-			{ status: "PENDING", event_id: "evt-dup" },
-			{ status: "PENDING", event_id: "evt-dup" },
-		],
-	};
-
-	it("text shows one pending block", async () => {
-		(mockBackend.add as ReturnType<typeof vi.fn>).mockResolvedValue(
-			DUPLICATE_PENDING,
-		);
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		await cmdAdd(mockBackend, "test", {
-			userId: "alice",
-			immutable: false,
-			output: "text",
-		});
-		expect(output.match(/Queued/g)?.length).toBe(1);
-	});
-
-	it("json shows one pending entry", async () => {
-		(mockBackend.add as ReturnType<typeof vi.fn>).mockResolvedValue(
-			DUPLICATE_PENDING,
-		);
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		await cmdAdd(mockBackend, "test", {
-			userId: "alice",
-			immutable: false,
-			output: "json",
-		});
-		const data = JSON.parse(output);
-		const pending = data.results.filter(
-			(r: Record<string, unknown>) => r.status === "PENDING",
-		);
-		expect(pending).toHaveLength(1);
-	});
-
-	it("agent shows one pending entry", async () => {
-		(mockBackend.add as ReturnType<typeof vi.fn>).mockResolvedValue(
-			DUPLICATE_PENDING,
-		);
-		setAgentMode(true);
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		await cmdAdd(mockBackend, "test", {
-			userId: "alice",
-			immutable: false,
-			output: "agent",
-		});
-		const data = JSON.parse(output);
-		expect(data.count).toBe(1);
-		expect(data.data).toHaveLength(1);
-	});
+  it("quiet mode produces no memory content", async () => {
+    const { cmdAdd } = await import("../src/commands/memory.js");
+    await cmdAdd(mockBackend, "test", {
+      userId: "alice",
+      immutable: false,
+      noInfer: false,
+      enableGraph: false,
+      output: "quiet",
+    });
+    expect(output).not.toContain("dark mode");
+  });
 });

 describe("cmdSearch", () => {
-	it("searches and shows results in text mode", async () => {
-		const { cmdSearch } = await import("../src/commands/memory.js");
-		await cmdSearch(mockBackend, "preferences", {
-			userId: "alice",
-			topK: 10,
-			threshold: 0.3,
-			rerank: false,
-			keyword: false,
+  it("searches and shows results in text mode", async () => {
+    const { cmdSearch } = await import("../src/commands/memory.js");
+    await cmdSearch(mockBackend, "preferences", {
+      userId: "alice",
+      topK: 10,
+      threshold: 0.3,
+      rerank: false,
+      keyword: false,
+      enableGraph: false,
+      output: "text",
+    });
+    expect(output).toContain("Found 2");
+  });

-			output: "text",
-		});
-		expect(output).toContain("Found 2");
-	});
+  it("outputs json format", async () => {
+    const { cmdSearch } = await import("../src/commands/memory.js");
+    await cmdSearch(mockBackend, "preferences", {
+      userId: "alice",
+      topK: 10,
+      threshold: 0.3,
+      rerank: false,
+      keyword: false,
+      enableGraph: false,
+      output: "json",
+    });
+    expect(output).toContain("memory");
+  });

-	it("outputs json format", async () => {
-		const { cmdSearch } = await import("../src/commands/memory.js");
-		await cmdSearch(mockBackend, "preferences", {
-			userId: "alice",
-			topK: 10,
-			threshold: 0.3,
-			rerank: false,
-			keyword: false,
-
-			output: "json",
-		});
-		expect(output).toContain("memory");
-	});
-
-	it("shows no results message", async () => {
-		(mockBackend.search as ReturnType<typeof vi.fn>).mockResolvedValue([]);
-		const { cmdSearch } = await import("../src/commands/memory.js");
-		await cmdSearch(mockBackend, "nonexistent", {
-			userId: "alice",
-			topK: 10,
-			threshold: 0.3,
-			rerank: false,
-			keyword: false,
-
-			output: "text",
-		});
-		expect(errOutput).toContain("No memories found");
-	});
-
-	it("forwards showExpired, referenceDate, latestOnly (MEM-5893)", async () => {
-		const { cmdSearch } = await import("../src/commands/memory.js");
-		await cmdSearch(mockBackend, "preferences", {
-			userId: "alice",
-			topK: 10,
-			threshold: 0.3,
-			rerank: false,
-			keyword: false,
-			showExpired: true,
-			referenceDate: "2024-01-01",
-			latestOnly: true,
-			output: "text",
-		});
-		expect(mockBackend.search).toHaveBeenCalledWith(
-			"preferences",
-			expect.objectContaining({
-				showExpired: true,
-				referenceDate: "2024-01-01",
-				latestOnly: true,
-			}),
-		);
-	});
+  it("shows no results message", async () => {
+    (mockBackend.search as ReturnType<typeof vi.fn>).mockResolvedValue([]);
+    const { cmdSearch } = await import("../src/commands/memory.js");
+    await cmdSearch(mockBackend, "nonexistent", {
+      userId: "alice",
+      topK: 10,
+      threshold: 0.3,
+      rerank: false,
+      keyword: false,
+      enableGraph: false,
+      output: "text",
+    });
+    expect(output).toContain("No memories found");
+  });
 });

 describe("cmdGet", () => {
-	it("gets memory in text mode", async () => {
-		const { cmdGet } = await import("../src/commands/memory.js");
-		await cmdGet(mockBackend, "abc-123-def-456", { output: "text" });
-		expect(output).toContain("dark mode");
-	});
+  it("gets memory in text mode", async () => {
+    const { cmdGet } = await import("../src/commands/memory.js");
+    await cmdGet(mockBackend, "abc-123-def-456", { output: "text" });
+    expect(output).toContain("dark mode");
+  });

-	it("gets memory in json mode", async () => {
-		const { cmdGet } = await import("../src/commands/memory.js");
-		await cmdGet(mockBackend, "abc-123-def-456", { output: "json" });
-		expect(output).toContain("memory");
-	});
+  it("gets memory in json mode", async () => {
+    const { cmdGet } = await import("../src/commands/memory.js");
+    await cmdGet(mockBackend, "abc-123-def-456", { output: "json" });
+    expect(output).toContain("memory");
+  });
 });

 describe("cmdList", () => {
-	it("lists in table mode", async () => {
-		const { cmdList } = await import("../src/commands/memory.js");
-		await cmdList(mockBackend, {
-			userId: "alice",
-			page: 1,
-			pageSize: 100,
+  it("lists in table mode", async () => {
+    const { cmdList } = await import("../src/commands/memory.js");
+    await cmdList(mockBackend, {
+      userId: "alice",
+      page: 1,
+      pageSize: 100,
+      enableGraph: false,
+      output: "table",
+    });
+    expect(output).toContain("dark mode");
+  });

-			output: "table",
-		});
-		expect(output).toContain("dark mode");
-	});
-
-	it("shows empty message", async () => {
-		(mockBackend.listMemories as ReturnType<typeof vi.fn>).mockResolvedValue(
-			[],
-		);
-		const { cmdList } = await import("../src/commands/memory.js");
-		await cmdList(mockBackend, {
-			userId: "alice",
-			page: 1,
-			pageSize: 100,
-
-			output: "text",
-		});
-		expect(errOutput).toContain("No memories found");
-	});
-
-	it("forwards showExpired and latestOnly (MEM-5893)", async () => {
-		const { cmdList } = await import("../src/commands/memory.js");
-		await cmdList(mockBackend, {
-			userId: "alice",
-			page: 1,
-			pageSize: 100,
-			showExpired: true,
-			latestOnly: true,
-			output: "text",
-		});
-		expect(mockBackend.listMemories).toHaveBeenCalledWith(
-			expect.objectContaining({ showExpired: true, latestOnly: true }),
-		);
-	});
+  it("shows empty message", async () => {
+    (mockBackend.listMemories as ReturnType<typeof vi.fn>).mockResolvedValue([]);
+    const { cmdList } = await import("../src/commands/memory.js");
+    await cmdList(mockBackend, {
+      userId: "alice",
+      page: 1,
+      pageSize: 100,
+      enableGraph: false,
+      output: "text",
+    });
+    expect(output).toContain("No memories found");
+  });
 });

 describe("cmdUpdate", () => {
-	it("updates memory", async () => {
-		const { cmdUpdate } = await import("../src/commands/memory.js");
-		await cmdUpdate(mockBackend, "abc-123", "New text", { output: "text" });
-		expect(output.toLowerCase()).toContain("updated");
-	});
-
-	it("forwards expires and timestamp (MEM-5893)", async () => {
-		const { cmdUpdate } = await import("../src/commands/memory.js");
-		await cmdUpdate(mockBackend, "abc-123", "New text", {
-			expires: "2099-01-01",
-			timestamp: 1700000000,
-			output: "text",
-		});
-		expect(mockBackend.update).toHaveBeenCalledWith(
-			"abc-123",
-			"New text",
-			undefined,
-			expect.objectContaining({
-				expirationDate: "2099-01-01",
-				timestamp: 1700000000,
-			}),
-		);
-	});
+  it("updates memory", async () => {
+    const { cmdUpdate } = await import("../src/commands/memory.js");
+    await cmdUpdate(mockBackend, "abc-123", "New text", { output: "text" });
+    expect(output.toLowerCase()).toContain("updated");
+  });
 });

 describe("cmdDelete", () => {
-	it("deletes memory", async () => {
-		const { cmdDelete } = await import("../src/commands/memory.js");
-		await cmdDelete(mockBackend, "abc-123", { output: "text" });
-		expect(output.toLowerCase()).toContain("deleted");
-	});
-
-	it("forwards deleteLinked (MEM-5893)", async () => {
-		const { cmdDelete } = await import("../src/commands/memory.js");
-		await cmdDelete(mockBackend, "abc-123", {
-			deleteLinked: true,
-			output: "text",
-		});
-		expect(mockBackend.delete).toHaveBeenCalledWith(
-			"abc-123",
-			expect.objectContaining({ deleteLinked: true }),
-		);
-	});
+  it("deletes memory", async () => {
+    const { cmdDelete } = await import("../src/commands/memory.js");
+    await cmdDelete(mockBackend, "abc-123", { output: "text" });
+    expect(output.toLowerCase()).toContain("deleted");
+  });
 });

 describe("cmdDeleteAll", () => {
-	it("deletes all with force", async () => {
-		const { cmdDeleteAll } = await import("../src/commands/memory.js");
-		await cmdDeleteAll(mockBackend, {
-			force: true,
-			userId: "alice",
-			output: "text",
-		});
-		expect(output.toLowerCase()).toContain("deleted");
-	});
+  it("deletes all with force", async () => {
+    const { cmdDeleteAll } = await import("../src/commands/memory.js");
+    await cmdDeleteAll(mockBackend, {
+      force: true,
+      userId: "alice",
+      output: "text",
+    });
+    expect(output.toLowerCase()).toContain("deleted");
+  });
+});
+
+describe("cmdVersion", () => {
+  it("shows version", async () => {
+    const { cmdVersion } = await import("../src/commands/utils.js");
+    cmdVersion();
+    expect(output).toContain("0.1.0");
+  });
 });

 describe("cmdEntitiesList", () => {
-	it("lists users in table mode", async () => {
-		const { cmdEntitiesList } = await import("../src/commands/entities.js");
-		await cmdEntitiesList(mockBackend, "users", { output: "table" });
-		expect(output).toContain("alice");
-	});
+  it("lists users in table mode", async () => {
+    const { cmdEntitiesList } = await import("../src/commands/entities.js");
+    await cmdEntitiesList(mockBackend, "users", { output: "table" });
+    expect(output).toContain("alice");
+  });

-	it("lists in json mode", async () => {
-		const { cmdEntitiesList } = await import("../src/commands/entities.js");
-		await cmdEntitiesList(mockBackend, "users", { output: "json" });
-		expect(output).toContain("alice");
-	});
-});
-
-describe("cmdEventList", () => {
-	it("lists events in table mode", async () => {
-		const { cmdEventList } = await import("../src/commands/events.js");
-		await cmdEventList(mockBackend, { output: "table" });
-		expect(output).toContain("evt-abc-");
-		expect(output).toContain("ADD");
-		expect(output).toContain("SUCCEEDED");
-	});
-
-	it("lists events in json mode", async () => {
-		const { cmdEventList } = await import("../src/commands/events.js");
-		await cmdEventList(mockBackend, { output: "json" });
-		expect(output).toContain("evt-abc-123-def-456");
-		expect(output).toContain("evt-def-456-ghi-789");
-	});
-
-	it("shows empty message when no events", async () => {
-		(mockBackend.listEvents as ReturnType<typeof vi.fn>).mockResolvedValueOnce(
-			[],
-		);
-		const { cmdEventList } = await import("../src/commands/events.js");
-		await cmdEventList(mockBackend, { output: "table" });
-		expect((output + errOutput).toLowerCase()).toContain("no events");
-	});
-});
-
-describe("cmdEventStatus", () => {
-	it("shows event details in text mode", async () => {
-		const { cmdEventStatus } = await import("../src/commands/events.js");
-		await cmdEventStatus(mockBackend, "evt-abc-123-def-456", {
-			output: "text",
-		});
-		expect(output).toContain("evt-abc-123-def-456");
-		expect(output).toContain("SUCCEEDED");
-	});
-
-	it("shows event details in json mode", async () => {
-		const { cmdEventStatus } = await import("../src/commands/events.js");
-		await cmdEventStatus(mockBackend, "evt-abc-123-def-456", {
-			output: "json",
-		});
-		expect(output).toContain("evt-abc-123-def-456");
-		expect(output).toContain("ADD");
-	});
-});
-
-describe("agent mode", () => {
-	it("cmdAdd outputs JSON envelope", async () => {
-		setAgentMode(true);
-		const { cmdAdd } = await import("../src/commands/memory.js");
-		await cmdAdd(mockBackend, "test preference", {
-			userId: "alice",
-			immutable: false,
-			output: "agent",
-		});
-		const parsed = JSON.parse(output.trim());
-		expect(parsed.status).toBe("success");
-		expect(parsed.command).toBe("add");
-		expect(parsed.data).toBeDefined();
-		expect(parsed.scope).toMatchObject({ user_id: "alice" });
-		expect(Object.keys(parsed.data[0]).sort()).toEqual(
-			["event", "id", "memory"].sort(),
-		);
-	});
-
-	it("cmdSearch outputs JSON envelope", async () => {
-		setAgentMode(true);
-		const { cmdSearch } = await import("../src/commands/memory.js");
-		await cmdSearch(mockBackend, "preferences", {
-			userId: "alice",
-			topK: 10,
-			threshold: 0.3,
-			rerank: false,
-			keyword: false,
-
-			output: "agent",
-		});
-		const parsed = JSON.parse(output.trim());
-		expect(parsed.status).toBe("success");
-		expect(parsed.command).toBe("search");
-		expect(Array.isArray(parsed.data)).toBe(true);
-		expect(parsed.count).toBe(2);
-		const keys = Object.keys(parsed.data[0]);
-		expect(keys).toContain("id");
-		expect(keys).toContain("memory");
-		expect(keys).toContain("score");
-		expect(keys).toContain("created_at");
-		expect(keys).toContain("categories");
-		expect(keys).not.toContain("user_id");
-		expect(keys).not.toContain("agent_id");
-	});
-
-	it("cmdList outputs JSON envelope", async () => {
-		setAgentMode(true);
-		const { cmdList } = await import("../src/commands/memory.js");
-		await cmdList(mockBackend, {
-			userId: "alice",
-			page: 1,
-			pageSize: 100,
-
-			output: "agent",
-		});
-		const parsed = JSON.parse(output.trim());
-		expect(parsed.status).toBe("success");
-		expect(parsed.command).toBe("list");
-		expect(Array.isArray(parsed.data)).toBe(true);
-		expect(parsed.count).toBe(2);
-		expect(Object.keys(parsed.data[0]).sort()).toEqual([
-			"categories",
-			"created_at",
-			"id",
-			"memory",
-		]);
-	});
-
-	it("cmdGet outputs JSON envelope", async () => {
-		setAgentMode(true);
-		const { cmdGet } = await import("../src/commands/memory.js");
-		await cmdGet(mockBackend, "abc-123-def-456", { output: "agent" });
-		const parsed = JSON.parse(output.trim());
-		expect(parsed.status).toBe("success");
-		expect(parsed.command).toBe("get");
-		expect(parsed.data).toBeDefined();
-		expect(parsed.data).toMatchObject({ id: "abc-123-def-456" });
-		expect(Object.keys(parsed.data)).not.toContain("user_id");
-	});
-
-	it("cmdUpdate outputs JSON envelope", async () => {
-		setAgentMode(true);
-		const { cmdUpdate } = await import("../src/commands/memory.js");
-		await cmdUpdate(mockBackend, "abc-123", "Updated text", {
-			output: "agent",
-		});
-		const parsed = JSON.parse(output.trim());
-		expect(parsed.status).toBe("success");
-		expect(parsed.command).toBe("update");
-		expect(parsed.data).toBeDefined();
-	});
-
-	it("cmdDelete outputs JSON envelope", async () => {
-		setAgentMode(true);
-		const { cmdDelete } = await import("../src/commands/memory.js");
-		await cmdDelete(mockBackend, "abc-123", { output: "agent" });
-		const parsed = JSON.parse(output.trim());
-		expect(parsed.status).toBe("success");
-		expect(parsed.command).toBe("delete");
-		expect(parsed.data).toBeDefined();
-	});
-
-	it("cmdEventList outputs JSON envelope", async () => {
-		setAgentMode(true);
-		const { cmdEventList } = await import("../src/commands/events.js");
-		await cmdEventList(mockBackend, { output: "agent" });
-		const parsed = JSON.parse(output.trim());
-		expect(parsed.status).toBe("success");
-		expect(parsed.command).toBe("event list");
-		expect(Array.isArray(parsed.data)).toBe(true);
-		expect(parsed.count).toBe(2);
-		expect(Object.keys(parsed.data[0]).sort()).toEqual([
-			"created_at",
-			"event_type",
-			"id",
-			"latency",
-			"status",
-		]);
-		expect(Object.keys(parsed.data[0])).not.toContain("updated_at");
-	});
-
-	it("cmdEventStatus outputs JSON envelope", async () => {
-		setAgentMode(true);
-		const { cmdEventStatus } = await import("../src/commands/events.js");
-		await cmdEventStatus(mockBackend, "evt-abc-123-def-456", {
-			output: "agent",
-		});
-		const parsed = JSON.parse(output.trim());
-		expect(parsed.status).toBe("success");
-		expect(parsed.command).toBe("event status");
-		expect(parsed.data).toBeDefined();
-		expect(parsed.data).toMatchObject({ id: "evt-abc-123-def-456" });
-		expect(parsed.data.results[0]).toHaveProperty("memory");
-		expect(parsed.data.results[0]).not.toHaveProperty("data");
-	});
+  it("lists in json mode", async () => {
+    const { cmdEntitiesList } = await import("../src/commands/entities.js");
+    await cmdEntitiesList(mockBackend, "users", { output: "json" });
+    expect(output).toContain("alice");
+  });
 });
@@ -64,6 +64,7 @@ describe("createDefaultConfig", () => {
    expect(config.platform.baseUrl).toBe("https://api.mem0.ai");
    expect(config.platform.apiKey).toBe("");
    expect(config.defaults.userId).toBe("");
+    expect(config.defaults.enableGraph).toBe(false);
  });
 });

@@ -104,4 +105,9 @@ describe("setNestedValue", () => {
    expect(config.defaults.userId).toBe("bob");
  });

+  it("coerces boolean for enable_graph", () => {
+    const config = createDefaultConfig();
+    expect(setNestedValue(config, "defaults.enable_graph", "true")).toBe(true);
+    expect(config.defaults.enableGraph).toBe(true);
+  });
 });
@@ -1,168 +0,0 @@
-/**
- * Unit tests for init internals — decision tree primitives + plugin sync.
- *
- * Mirror of `cli/python/tests/test_init_internals.py`. Both files MUST stay
- * in sync — if you add a behavioral assertion here, mirror it on the Python
- * side and vice versa.
- *
- *  - `pingKey` must NOT treat network errors as "invalid key" (else a VPN
- *    flap silently mints a new shadow over a working key).
- *  - `plugin_sync` must only update entries that already exist, preserve
- *    trailing newlines, and never mangle other lines.
- */
-
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-import { pingKey } from "../src/commands/init.js";
-import { updateClaudeSettings, updateShellRc } from "../src/plugin-sync.js";
-
-// ── pingKey ──────────────────────────────────────────────────────────────
-
-describe("pingKey — network vs auth distinction", () => {
-	const origFetch = globalThis.fetch;
-	afterEach(() => {
-		globalThis.fetch = origFetch;
-		vi.restoreAllMocks();
-	});
-
-	it("returns true for 200", async () => {
-		globalThis.fetch = vi.fn().mockResolvedValue({ status: 200 } as Response);
-		await expect(pingKey("k", "http://x")).resolves.toBe(true);
-	});
-
-	it("returns false for 401 (definitively invalid)", async () => {
-		globalThis.fetch = vi.fn().mockResolvedValue({ status: 401 } as Response);
-		await expect(pingKey("k", "http://x")).resolves.toBe(false);
-	});
-
-	it("returns false for 403 (definitively invalid)", async () => {
-		globalThis.fetch = vi.fn().mockResolvedValue({ status: 403 } as Response);
-		await expect(pingKey("k", "http://x")).resolves.toBe(false);
-	});
-
-	it("returns true for 5xx (transient upstream — prefer reuse)", async () => {
-		globalThis.fetch = vi.fn().mockResolvedValue({ status: 503 } as Response);
-		await expect(pingKey("k", "http://x")).resolves.toBe(true);
-	});
-
-	it("returns true on network error (prefer reuse over re-mint)", async () => {
-		globalThis.fetch = vi.fn().mockRejectedValue(new Error("ECONNREFUSED"));
-		await expect(pingKey("k", "http://x")).resolves.toBe(true);
-	});
-
-	it("returns true on timeout (prefer reuse)", async () => {
-		globalThis.fetch = vi.fn().mockRejectedValue(new Error("aborted"));
-		await expect(pingKey("k", "http://x")).resolves.toBe(true);
-	});
-});
-
-// ── updateShellRc ────────────────────────────────────────────────────────
-
-describe("updateShellRc — exists-only contract", () => {
-	let tmpDir: string;
-
-	beforeEach(() => {
-		tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "mem0-test-"));
-	});
-	afterEach(() => {
-		fs.rmSync(tmpDir, { recursive: true, force: true });
-	});
-
-	it("updates existing export and preserves trailing newline", () => {
-		const rc = path.join(tmpDir, ".zshrc");
-		fs.writeFileSync(rc, 'export MEM0_API_KEY="old"\n');
-		expect(updateShellRc(rc, "newkey")).toBe(true);
-		expect(fs.readFileSync(rc, "utf-8")).toBe('export MEM0_API_KEY="newkey"\n');
-	});
-
-	it("does NOT create a new export when none exists", () => {
-		const rc = path.join(tmpDir, ".zshrc");
-		fs.writeFileSync(rc, "alias ll='ls -la'\n");
-		expect(updateShellRc(rc, "newkey")).toBe(false);
-		expect(fs.readFileSync(rc, "utf-8")).toBe("alias ll='ls -la'\n");
-	});
-
-	it("preserves surrounding content", () => {
-		const rc = path.join(tmpDir, ".zshrc");
-		const original =
-			"# my zshrc\n" +
-			"alias ll='ls -la'\n" +
-			"export MEM0_API_KEY='old'\n" +
-			"export OTHER=keepme\n";
-		fs.writeFileSync(rc, original);
-		updateShellRc(rc, "newkey");
-		const after = fs.readFileSync(rc, "utf-8");
-		expect(after).toContain("alias ll='ls -la'\n");
-		expect(after).toContain("export OTHER=keepme\n");
-		expect(after).toContain("# my zshrc\n");
-		expect(after).toContain('export MEM0_API_KEY="newkey"\n');
-	});
-
-	it("is idempotent when value already matches", () => {
-		const rc = path.join(tmpDir, ".zshrc");
-		fs.writeFileSync(rc, 'export MEM0_API_KEY="same"\n');
-		expect(updateShellRc(rc, "same")).toBe(false);
-	});
-
-	it("is a no-op for missing files", () => {
-		const rc = path.join(tmpDir, ".zshrc"); // does not exist
-		expect(updateShellRc(rc, "x")).toBe(false);
-	});
-});
-
-// ── updateClaudeSettings ─────────────────────────────────────────────────
-
-describe("updateClaudeSettings — never creates entries", () => {
-	let tmpDir: string;
-
-	beforeEach(() => {
-		tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "mem0-test-"));
-	});
-	afterEach(() => {
-		fs.rmSync(tmpDir, { recursive: true, force: true });
-	});
-
-	it("does not create env block when none exists", () => {
-		const settings = path.join(tmpDir, "settings.json");
-		fs.writeFileSync(settings, JSON.stringify({ otherKey: 1 }));
-		expect(updateClaudeSettings(settings, "newkey")).toBe(false);
-		expect(JSON.parse(fs.readFileSync(settings, "utf-8"))).toEqual({
-			otherKey: 1,
-		});
-	});
-
-	it("does not create MEM0_API_KEY entry in existing env block", () => {
-		const settings = path.join(tmpDir, "settings.json");
-		fs.writeFileSync(settings, JSON.stringify({ env: { OTHER_KEY: "x" } }));
-		expect(updateClaudeSettings(settings, "newkey")).toBe(false);
-	});
-
-	it("updates existing entry and preserves siblings", () => {
-		const settings = path.join(tmpDir, "settings.json");
-		fs.writeFileSync(
-			settings,
-			JSON.stringify({ env: { MEM0_API_KEY: "old", OTHER: "y" } }, null, 2),
-		);
-		expect(updateClaudeSettings(settings, "fresh")).toBe(true);
-		const data = JSON.parse(fs.readFileSync(settings, "utf-8"));
-		expect(data.env.MEM0_API_KEY).toBe("fresh");
-		expect(data.env.OTHER).toBe("y");
-	});
-
-	it("is idempotent when value already matches", () => {
-		const settings = path.join(tmpDir, "settings.json");
-		fs.writeFileSync(
-			settings,
-			JSON.stringify({ env: { MEM0_API_KEY: "same" } }),
-		);
-		expect(updateClaudeSettings(settings, "same")).toBe(false);
-	});
-
-	it("is a no-op for malformed JSON", () => {
-		const settings = path.join(tmpDir, "settings.json");
-		fs.writeFileSync(settings, "{ this is not json");
-		expect(updateClaudeSettings(settings, "x")).toBe(false);
-	});
-});
@@ -1,164 +0,0 @@
-/**
- * Drift test: every documented v3 add/search/list param must be reachable from the Node CLI.
- */
-
-import { execSync } from "node:child_process";
-import fs from "node:fs";
-import path from "node:path";
-import { describe, expect, it } from "vitest";
-
-const OPENAPI_PATH = path.join(
-	__dirname,
-	"..",
-	"..",
-	"..",
-	"docs",
-	"openapi.json",
-);
-
-const KNOWN_UNSURFACED: Record<string, Record<string, string>> = {
-	"/v3/memories/add/": {
-		includes: "extraction hint, no CLI flag yet",
-		excludes: "extraction hint, no CLI flag yet",
-		enable_graph: "graph memory toggle, no CLI flag yet",
-		output_format: "response envelope is pinned by the CLI",
-		prompt_profile_id: "no CLI flag yet",
-		temporal_reasoning: "no CLI flag yet",
-		timezone: "no CLI flag yet",
-		observation_datetime: "no CLI flag yet, --timestamp backdates instead",
-		observation_date: "no CLI flag yet, --timestamp backdates instead",
-	},
-	"/v3/memories/search/": {
-		categories: "expressible through --filter",
-		metadata: "expressible through --filter",
-	},
-	"/v3/memories/": {
-		start_date: "covered by --after via filters.created_at.gte",
-		end_date: "covered by --before via filters.created_at.lte",
-		categories: "covered by --category via filters.categories",
-		fields: "no CLI flag yet",
-		keywords: "no CLI flag yet",
-	},
-};
-
-const ADD_MAPPING: Record<string, string[]> = {
-	messages: ["--messages", "--file", "text"],
-	user_id: ["--user-id"],
-	agent_id: ["--agent-id"],
-	app_id: ["--app-id"],
-	run_id: ["--run-id"],
-	metadata: ["--metadata"],
-	expiration_date: ["--expires"],
-	custom_instructions: ["--custom-instructions"],
-	agent_custom_instructions: ["--agent-custom-instructions"],
-	custom_categories: ["--custom-categories"],
-	infer: ["--no-infer"],
-	immutable: ["--immutable"],
-	structured_data_schema: ["--structured-data-schema"],
-	timestamp: ["--timestamp"],
-};
-
-const SEARCH_MAPPING: Record<string, string[]> = {
-	query: ["query"],
-	filters: ["--filter", "--user-id", "--agent-id", "--run-id"],
-	show_expired: ["--show-expired"],
-	top_k: ["--top-k"],
-	threshold: ["--threshold"],
-	rerank: ["--rerank"],
-	reference_date: ["--reference-date"],
-	fields: ["--fields"],
-};
-
-const LIST_MAPPING: Record<string, string[]> = {
-	filters: [
-		"--user-id",
-		"--agent-id",
-		"--run-id",
-		"--category",
-		"--after",
-		"--before",
-	],
-	show_expired: ["--show-expired"],
-	page: ["--page"],
-	page_size: ["--page-size"],
-};
-
-function documentedFields(endpoint: string): string[] {
-	const spec = JSON.parse(fs.readFileSync(OPENAPI_PATH, "utf-8"));
-	const schema =
-		spec.paths[endpoint].post.requestBody.content["application/json"].schema;
-	return Object.keys(schema.properties);
-}
-
-function helpText(command: string): string {
-	return execSync(`npx tsx src/index.ts ${command} --help`, {
-		cwd: path.join(__dirname, ".."),
-		encoding: "utf-8",
-		timeout: 15000,
-	});
-}
-
-function assertAllReachable(
-	endpoint: string,
-	mapping: Record<string, string[]>,
-	command: string,
-) {
-	const documented = documentedFields(endpoint);
-	const help = helpText(command);
-	for (const field of documented) {
-		if (KNOWN_UNSURFACED[endpoint]?.[field]) continue;
-		const candidates = mapping[field];
-		expect(
-			candidates,
-			`${endpoint}: documented field "${field}" has no mapping entry for command "${command}"`,
-		).toBeDefined();
-		const reachable = candidates.some((flag) =>
-			flag.startsWith("--") ? help.includes(flag) : true,
-		);
-		expect(
-			reachable,
-			`${endpoint}: documented field "${field}" not reachable via any of ${JSON.stringify(candidates)} on command "${command}"`,
-		).toBe(true);
-	}
-}
-
-describe("Option parity: Node CLI reachability of documented v3 params", () => {
-	it("add covers documented fields", () => {
-		assertAllReachable("/v3/memories/add/", ADD_MAPPING, "add");
-	});
-
-	it("search covers documented fields", () => {
-		assertAllReachable("/v3/memories/search/", SEARCH_MAPPING, "search");
-	});
-
-	it("list covers documented fields", () => {
-		assertAllReachable("/v3/memories/", LIST_MAPPING, "list");
-	});
-});
-
-describe("stdin fallback uses the shared piped-stdin guard", () => {
-	const SOURCES = ["src/index.ts", "src/commands/memory.ts"];
-
-	for (const rel of SOURCES) {
-		it(`${rel} never checks process.stdin.isTTY directly`, () => {
-			const src = fs.readFileSync(path.join(__dirname, "..", rel), "utf-8");
-			expect(
-				src.includes("process.stdin.isTTY"),
-				`${rel}: use stdinIsPiped() from state.ts. A bare !isTTY check is also true for /dev/null and sockets, so readFileSync(0) crashes with EAGAIN in scripts, CI, and agent mode.`,
-			).toBe(false);
-		});
-
-		it(`${rel} guards every readFileSync(0) with stdinIsPiped()`, () => {
-			const src = fs.readFileSync(path.join(__dirname, "..", rel), "utf-8");
-			const lines = src.split("\n");
-			for (const [i, line] of lines.entries()) {
-				if (!line.includes("readFileSync(0")) continue;
-				const guard = lines.slice(Math.max(0, i - 3), i).join("\n");
-				expect(
-					guard.includes("stdinIsPiped()"),
-					`${rel}:${i + 1}: readFileSync(0) must be guarded by stdinIsPiped()`,
-				).toBe(true);
-			}
-		});
-	}
-});
@@ -10,7 +10,6 @@ import {
  formatSingleMemory,
  formatAddResult,
  printResultSummary,
-  sanitizeAgentData,
 } from "../src/output.js";

 let output: string;
@@ -99,18 +98,6 @@ describe("formatAddResult", () => {
    });
    expect(output).toContain("Queued");
  });
-
-  it("deduplicates PENDING entries with same event_id", () => {
-    formatAddResult({
-      results: [
-        { status: "PENDING", event_id: "evt-dup" },
-        { status: "PENDING", event_id: "evt-dup" },
-      ],
-    });
-    // Should show only one PENDING block despite two entries with same event_id
-    expect(output.match(/Queued/g)?.length).toBe(1);
-    expect(output.match(/evt-dup/g)?.length).toBe(2); // event_id line + status hint line
-  });
 });

 describe("printResultSummary", () => {
@@ -126,73 +113,3 @@ describe("printResultSummary", () => {
    expect(output).not.toContain("results");
  });
 });
-
-describe("sanitizeAgentData", () => {
-  it("projects add results", () => {
-    const raw = [{ id: "abc", memory: "test", event: "ADD", metadata: { x: 1 }, categories: ["a"] }];
-    const result = sanitizeAgentData("add", raw) as Record<string, unknown>[];
-    expect(result).toEqual([{ id: "abc", memory: "test", event: "ADD" }]);
-  });
-
-  it("passes through PENDING add items", () => {
-    const raw = [{ status: "PENDING", event_id: "evt-123", noise: "x" }];
-    const result = sanitizeAgentData("add", raw) as Record<string, unknown>[];
-    expect(result).toEqual([{ status: "PENDING", event_id: "evt-123" }]);
-  });
-
-  it("projects search results", () => {
-    const raw = [{ id: "abc", memory: "test", score: 0.9, created_at: "2026-01-01", categories: ["a"], user_id: "u1" }];
-    const result = sanitizeAgentData("search", raw) as Record<string, unknown>[];
-    expect(result[0]).not.toHaveProperty("user_id");
-    expect(result[0]).toHaveProperty("score");
-  });
-
-  it("projects list results", () => {
-    const raw = [{ id: "abc", memory: "test", created_at: "2026-01-01", categories: ["a"], user_id: "u1" }];
-    const result = sanitizeAgentData("list", raw) as Record<string, unknown>[];
-    expect(Object.keys(result[0]).sort()).toEqual(["categories", "created_at", "id", "memory"]);
-  });
-
-  it("projects get result", () => {
-    const raw = { id: "abc", memory: "test", created_at: "2026-01-01", updated_at: "2026-01-02", categories: ["a"], metadata: { k: "v" }, user_id: "u1" };
-    const result = sanitizeAgentData("get", raw) as Record<string, unknown>;
-    expect(result).not.toHaveProperty("user_id");
-    expect(result).toHaveProperty("metadata");
-  });
-
-  it("projects update result", () => {
-    const raw = { id: "abc", memory: "updated", extra: "noise" };
-    const result = sanitizeAgentData("update", raw);
-    expect(result).toEqual({ id: "abc", memory: "updated" });
-  });
-
-  it("projects event list results", () => {
-    const raw = [{ id: "evt-1", event_type: "ADD", status: "SUCCEEDED", graph_status: null, latency: 100, created_at: "2026-01-01", updated_at: "2026-01-02" }];
-    const result = sanitizeAgentData("event list", raw) as Record<string, unknown>[];
-    expect(result[0]).not.toHaveProperty("updated_at");
-    expect(result[0]).not.toHaveProperty("graph_status");
-  });
-
-  it("flattens event status results", () => {
-    const raw = {
-      id: "evt-1", event_type: "ADD", status: "SUCCEEDED",
-      latency: 100, created_at: "2026-01-01", updated_at: "2026-01-02",
-      results: [{ id: "mem-1", event: "ADD", user_id: "alice", data: { memory: "dark mode" } }],
-    };
-    const result = sanitizeAgentData("event status", raw) as Record<string, unknown>;
-    const firstResult = (result.results as Record<string, unknown>[])[0];
-    expect(firstResult).toHaveProperty("memory", "dark mode");
-    expect(firstResult).not.toHaveProperty("data");
-  });
-
-  it("passes through status/config/import commands unchanged", () => {
-    const data = { key: "value", other: "stuff" };
-    for (const cmd of ["status", "import", "config show", "config get", "config set"]) {
-      expect(sanitizeAgentData(cmd, data)).toEqual(data);
-    }
-  });
-
-  it("handles null data", () => {
-    expect(sanitizeAgentData("add", null)).toBeNull();
-  });
-});
@@ -1,242 +0,0 @@
-/**
- * Tests for the Platform backend (mem0 Platform API client).
- */
-
-import { beforeEach, describe, expect, it, vi } from "vitest";
-import { PlatformBackend } from "../src/backend/platform.js";
-import { createDefaultConfig } from "../src/config.js";
-
-function makeBackend(): PlatformBackend {
-	return new PlatformBackend(createDefaultConfig().platform);
-}
-
-function mockFetch() {
-	const fetchMock = vi.fn().mockResolvedValue({
-		ok: true,
-		status: 200,
-		headers: { get: vi.fn().mockReturnValue(null) },
-		json: vi.fn().mockResolvedValue({ message: "ok" }),
-	});
-	vi.stubGlobal("fetch", fetchMock);
-	return fetchMock;
-}
-
-beforeEach(() => {
-	vi.restoreAllMocks();
-	vi.unstubAllGlobals();
-});
-
-describe("deleteEntities", () => {
-	it("returns all results keyed by entity type for a multi-entity delete", async () => {
-		const backend = makeBackend();
-		const responses: Record<string, unknown> = {
-			"/v2/entities/user/alice/": { message: "user deleted" },
-			"/v2/entities/agent/bob/": { message: "agent deleted" },
-		};
-		const spy = vi
-			// biome-ignore lint/suspicious/noExplicitAny: spying on a private method
-			.spyOn(backend as any, "_request")
-			.mockImplementation(
-				async (_method: string, path: string) => responses[path],
-			);
-
-		const result = await backend.deleteEntities({
-			userId: "alice",
-			agentId: "bob",
-		});
-
-		expect(result).toEqual({
-			user: { message: "user deleted" },
-			agent: { message: "agent deleted" },
-		});
-		expect(spy).toHaveBeenCalledTimes(2);
-	});
-
-	it("keys a single-entity delete by its type", async () => {
-		const backend = makeBackend();
-		// biome-ignore lint/suspicious/noExplicitAny: spying on a private method
-		vi.spyOn(backend as any, "_request").mockResolvedValue({
-			message: "user deleted",
-		});
-
-		const result = await backend.deleteEntities({ userId: "alice" });
-		expect(result).toEqual({ user: { message: "user deleted" } });
-	});
-
-	it("throws when no entity id is provided", async () => {
-		const backend = makeBackend();
-		await expect(backend.deleteEntities({})).rejects.toThrow(
-			"At least one entity ID is required",
-		);
-	});
-});
-
-describe("PlatformBackend option-parity payloads (MEM-5893)", () => {
-	it("add: custom_instructions, custom_categories, structured_data_schema, timestamp reach the payload alongside existing fields", async () => {
-		const backend = makeBackend();
-		const spy = vi
-			// biome-ignore lint/suspicious/noExplicitAny: spying on a private method
-			.spyOn(backend as any, "_request")
-			.mockResolvedValue({ results: [] });
-
-		await backend.add("hello", undefined, {
-			userId: "alice",
-			metadata: { source: "test" },
-			expires: "2099-01-01",
-			customInstructions: "Extract only preferences.",
-			agentCustomInstructions: "Extract only tool outcomes.",
-			customCategories: [{ prefs: "user preferences" }],
-			structuredDataSchema: { type: "object" },
-			timestamp: 1700000000,
-		});
-
-		const payload = spy.mock.calls[0][2].json;
-		expect(payload.custom_instructions).toBe("Extract only preferences.");
-		expect(payload.agent_custom_instructions).toBe(
-			"Extract only tool outcomes.",
-		);
-		expect(payload.custom_categories).toEqual([{ prefs: "user preferences" }]);
-		expect(payload.structured_data_schema).toEqual({ type: "object" });
-		expect(payload.timestamp).toBe(1700000000);
-		expect(payload.metadata).toEqual({ source: "test" });
-		expect(payload.expiration_date).toBe("2099-01-01");
-	});
-
-	it("add: omitted optional fields are absent from the payload", async () => {
-		const backend = makeBackend();
-		const spy = vi
-			// biome-ignore lint/suspicious/noExplicitAny: spying on a private method
-			.spyOn(backend as any, "_request")
-			.mockResolvedValue({ results: [] });
-
-		await backend.add("hello", undefined, { userId: "alice" });
-
-		const payload = spy.mock.calls[0][2].json;
-		expect(payload).not.toHaveProperty("custom_instructions");
-		expect(payload).not.toHaveProperty("agent_custom_instructions");
-		expect(payload).not.toHaveProperty("custom_categories");
-		expect(payload).not.toHaveProperty("structured_data_schema");
-		expect(payload).not.toHaveProperty("timestamp");
-	});
-
-	it("search: show_expired, reference_date, latest_only reach the payload", async () => {
-		const backend = makeBackend();
-		// biome-ignore lint/suspicious/noExplicitAny: spying on a private method
-		const spy = vi.spyOn(backend as any, "_request").mockResolvedValue([]);
-
-		await backend.search("query", {
-			showExpired: true,
-			referenceDate: "2024-01-01",
-			latestOnly: true,
-		});
-
-		const payload = spy.mock.calls[0][2].json;
-		expect(payload.show_expired).toBe(true);
-		expect(payload.reference_date).toBe("2024-01-01");
-		expect(payload.latest_only).toBe(true);
-	});
-
-	it("search: keyword_search and fields reach the payload", async () => {
-		const backend = makeBackend();
-		// biome-ignore lint/suspicious/noExplicitAny: spying on a private method
-		const spy = vi.spyOn(backend as any, "_request").mockResolvedValue([]);
-
-		await backend.search("query", {
-			keyword: true,
-			fields: ["memory", "score"],
-		});
-
-		const payload = spy.mock.calls[0][2].json;
-		expect(payload.keyword_search).toBe(true);
-		expect(payload.fields).toEqual(["memory", "score"]);
-	});
-
-	it("search: omitted keyword and fields are absent from the payload", async () => {
-		const backend = makeBackend();
-		// biome-ignore lint/suspicious/noExplicitAny: spying on a private method
-		const spy = vi.spyOn(backend as any, "_request").mockResolvedValue([]);
-
-		await backend.search("query", {});
-
-		const payload = spy.mock.calls[0][2].json;
-		expect(payload).not.toHaveProperty("keyword_search");
-		expect(payload).not.toHaveProperty("fields");
-	});
-
-	it("listMemories: show_expired and latest_only are top-level, not nested inside filters", async () => {
-		const backend = makeBackend();
-		// biome-ignore lint/suspicious/noExplicitAny: spying on a private method
-		const spy = vi.spyOn(backend as any, "_request").mockResolvedValue([]);
-
-		await backend.listMemories({
-			userId: "alice",
-			showExpired: true,
-			latestOnly: true,
-		});
-
-		const payload = spy.mock.calls[0][2].json;
-		expect(payload.show_expired).toBe(true);
-		expect(payload.latest_only).toBe(true);
-		expect(payload.filters ?? {}).not.toHaveProperty("show_expired");
-		expect(payload.filters ?? {}).not.toHaveProperty("latest_only");
-	});
-
-	it("update: expiration_date and timestamp reach the payload", async () => {
-		const backend = makeBackend();
-		// biome-ignore lint/suspicious/noExplicitAny: spying on a private method
-		const spy = vi.spyOn(backend as any, "_request").mockResolvedValue({});
-
-		await backend.update("mem-123", undefined, undefined, {
-			expirationDate: "2099-01-01",
-			timestamp: 1700000000,
-		});
-
-		const payload = spy.mock.calls[0][2].json;
-		expect(payload.expiration_date).toBe("2099-01-01");
-		expect(payload.timestamp).toBe(1700000000);
-	});
-
-	it("delete: delete_linked is a query param, not part of the JSON body", async () => {
-		const backend = makeBackend();
-		// biome-ignore lint/suspicious/noExplicitAny: spying on a private method
-		const spy = vi.spyOn(backend as any, "_request").mockResolvedValue({});
-
-		await backend.delete("mem-123", { deleteLinked: true });
-
-		const opts = spy.mock.calls[0][2];
-		expect(opts.params.delete_linked).toBe("true");
-		expect(opts.json).toBeUndefined();
-	});
-});
-
-describe("PlatformBackend path encoding", () => {
-	it("encodes memory IDs before interpolating them into paths", async () => {
-		const fetchMock = mockFetch();
-		const backend = makeBackend();
-
-		await backend.get("mem/a?b#c");
-		await backend.update("mem/a?b#c", "updated");
-		await backend.delete("mem/a?b#c");
-
-		const urls = fetchMock.mock.calls.map((call) => call[0]);
-		expect(urls).toEqual([
-			"https://api.mem0.ai/v1/memories/mem%2Fa%3Fb%23c/?source=CLI",
-			"https://api.mem0.ai/v1/memories/mem%2Fa%3Fb%23c/",
-			"https://api.mem0.ai/v1/memories/mem%2Fa%3Fb%23c/?source=CLI",
-		]);
-	});
-
-	it("encodes entity and event IDs before interpolating them into paths", async () => {
-		const fetchMock = mockFetch();
-		const backend = makeBackend();
-
-		await backend.deleteEntities({ userId: "org/team?active#frag" });
-		await backend.getEvent("evt/a?b#c");
-
-		const urls = fetchMock.mock.calls.map((call) => call[0]);
-		expect(urls).toEqual([
-			"https://api.mem0.ai/v2/entities/user/org%2Fteam%3Factive%23frag/?source=CLI",
-			"https://api.mem0.ai/v1/event/evt%2Fa%3Fb%23c/",
-		]);
-	});
-});
@@ -71,42 +71,5 @@ export function createMockBackend(): Backend {
      { name: "alice", count: 5 },
      { name: "bob", count: 3 },
    ]),
-    listEvents: vi.fn().mockResolvedValue([
-      {
-        id: "evt-abc-123-def-456",
-        event_type: "ADD",
-        status: "SUCCEEDED",
-        graph_status: null,
-        latency: 1234.5,
-        created_at: "2026-04-01T10:00:00Z",
-        updated_at: "2026-04-01T10:00:01Z",
-      },
-      {
-        id: "evt-def-456-ghi-789",
-        event_type: "SEARCH",
-        status: "PENDING",
-        graph_status: null,
-        latency: null,
-        created_at: "2026-04-01T10:01:00Z",
-        updated_at: "2026-04-01T10:01:00Z",
-      },
-    ]),
-    getEvent: vi.fn().mockResolvedValue({
-      id: "evt-abc-123-def-456",
-      event_type: "ADD",
-      status: "SUCCEEDED",
-      graph_status: "SUCCEEDED",
-      latency: 1234.5,
-      created_at: "2026-04-01T10:00:00Z",
-      updated_at: "2026-04-01T10:00:01Z",
-      results: [
-        {
-          id: "mem-abc-123",
-          event: "ADD",
-          user_id: "alice",
-          data: { memory: "User prefers dark mode" },
-        },
-      ],
-    }),
  };
 }
@@ -1,59 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from "vitest";
-
-const mockLoadConfig = vi.fn();
-const mockSaveConfig = vi.fn();
-const mockSpawn = vi.fn();
-
-vi.mock("../src/config.js", () => ({
-  CONFIG_FILE: "/tmp/mem0-config.json",
-  loadConfig: mockLoadConfig,
-  saveConfig: mockSaveConfig,
-}));
-
-vi.mock("node:child_process", () => ({
-  spawn: mockSpawn,
-}));
-
-describe("captureEvent", () => {
-  beforeEach(() => {
-    vi.resetModules();
-    mockLoadConfig.mockReset();
-    mockSaveConfig.mockReset();
-    mockSpawn.mockReset();
-    delete process.env.MEM0_TELEMETRY;
-  });
-
-  it("pipes the telemetry context through stdin instead of argv", async () => {
-    mockLoadConfig.mockReturnValue({
-      platform: {
-        apiKey: "m0-node-secret",
-        baseUrl: "https://api.mem0.ai",
-        userEmail: "",
-      },
-      telemetry: {
-        anonymousId: "cli-anon-node",
-      },
-    });
-
-    const stdin = { end: vi.fn() };
-    const child = { stdin, unref: vi.fn() };
-    mockSpawn.mockReturnValue(child);
-
-    const { captureEvent } = await import("../src/telemetry.js");
-    captureEvent("node_test_event", { case: "stdin-secret" });
-
-    expect(mockSpawn).toHaveBeenCalledTimes(1);
-    const [execPath, args, options] = mockSpawn.mock.calls[0];
-    expect(execPath).toBe(process.execPath);
-    expect(args).toHaveLength(1);
-    expect(String(args[0])).toContain("telemetry-sender.cjs");
-    expect(JSON.stringify(args)).not.toContain("m0-node-secret");
-    expect(options).toMatchObject({ detached: true, stdio: ["pipe", "ignore", "ignore"] });
-
-    expect(stdin.end).toHaveBeenCalledTimes(1);
-    const payload = JSON.parse(stdin.end.mock.calls[0][0]);
-    expect(payload.mem0ApiKey).toBe("m0-node-secret");
-    expect(payload.payload.event).toBe("node_test_event");
-    expect(child.unref).toHaveBeenCalledTimes(1);
-  });
-});
@@ -1,15 +0,0 @@
-import { defineConfig } from 'tsup';
-import { createRequire } from 'node:module';
-
-const _require = createRequire(import.meta.url);
-const pkg = _require('./package.json');
-
-export default defineConfig({
-  entry: ['src/index.ts'],
-  format: ['esm'],
-  dts: true,
-  clean: true,
-  define: {
-    __CLI_VERSION__: JSON.stringify(pkg.version),
-  },
-});
@@ -1,17 +0,0 @@
-import { createRequire } from "node:module";
-import { defineConfig } from "vitest/config";
-
-const _require = createRequire(import.meta.url);
-const pkg = _require("./package.json") as { version: string };
-
-export default defineConfig({
-	define: {
-		__CLI_VERSION__: JSON.stringify(pkg.version),
-	},
-	test: {
-		// Integration tests spawn the CLI via `npx tsx` (15s subprocess
-		// timeout); the first spawn in a file pays a cold-start cost that can
-		// exceed vitest's 5s default on CI runners.
-		testTimeout: 30_000,
-	},
-});
@@ -1,47 +0,0 @@
-# Python CLI (`cli/python/`)
-
-The `mem0-cli` package on PyPI. Typer-based, entry point `mem0`.
-
-## Commands
-
-```bash
-pip install -e ".[dev]"   # dev install: ruff + pytest
-ruff check .              # lint
-ruff format .             # format
-pytest                    # test
-hatch build               # build
-```
-
-## Conventions
-
-> **Line length is 100 here, not 120.** The root Python SDK uses 120. Running the root
-> `make format` over this directory reformats every file and fails CI. Use the local
-> `ruff` invocations above.
-
- **Python 3.10+.** Not 3.9, unlike the root SDK.
- **Ruff** with an extended rule set: `E`, `F`, `I`, `W`, `UP`, `B`, `SIM`, `RUF`.
-  Ignores `E501` (formatter handles it), `B008` (required by Typer's argument defaults),
-  and `SIM108`.
- **Ruff format:** double quotes, space indent, `docstring-code-format = true`.
- **isort** first-party is `mem0_cli` only.
- **pytest** for tests.
- Target version pinned to `py310`.
-
-## Layout
-
-```
-cli/python/
-├── src/mem0_cli/     package source (src layout)
-└── tests/
-```
-
-Entry point: `mem0 = "mem0_cli.app:main"`.
-
-## Dependencies
-
-Typer + Rich + httpx. `mem0ai` is **optional**, exposed through the `[oss]` extra for OSS mode. Do not promote it to a required dependency.
-
-## CI and release
-
- CI: `cli-python-ci.yml`, ruff + pytest + `hatch build` on Python 3.10, 3.11, 3.12.
- Release: tag prefix `cli-v*` dispatches `cli-python-cd.yml`, publishing to PyPI over OIDC.
@@ -1 +0,0 @@
-AGENTS.md
@@ -1,12 +1,6 @@
-# mem0 CLI (Python)
+# mem0 CLI

-The official command-line interface for [mem0](https://mem0.ai) — the memory layer for AI agents. Python implementation.
-
-> **Built for AI agents.** Pass `--agent` (or `--json`) as a global flag on any command to get structured JSON output optimized for programmatic consumption — sanitized fields, no colors or spinners, and errors as JSON too.
-
-## Prerequisites
-
- Python **3.10+**
+The official command-line interface for [mem0](https://mem0.ai) — the memory layer for AI agents.

 ## Installation

@@ -24,320 +18,22 @@ pip install mem0-cli

 > **Note:** On macOS with Homebrew Python, `pip install` outside a virtual environment will fail with an `externally-managed-environment` error ([PEP 668](https://peps.python.org/pep-0668/)). Use `pipx` instead, or install inside a virtual environment.

-## Quick start
+## Quick Start

 ```bash
-# Interactive setup wizard
+# Set up your configuration
 mem0 init

-# Or login via email
-mem0 init --email alice@company.com
-
-# Or authenticate with an existing API key
-mem0 init --api-key m0-xxx
-
 # 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 for a user
+# List all memories
 mem0 list --user-id alice
-
-# Get a specific memory
-mem0 get <memory-id>
-
-# Update a memory
-mem0 update <memory-id> "I switched to light mode"
-
-# Delete a memory
-mem0 delete <memory-id>
 ```

-## Commands
-
-### `mem0 init`
-
-Interactive setup wizard. Prompts for your API key and default user ID.
-
-```bash
-mem0 init
-mem0 init --api-key m0-xxx --user-id alice
-mem0 init --email alice@company.com
-```
-
-If an existing configuration is detected, the CLI asks for confirmation before overwriting. Use `--force` to skip the prompt (useful in CI/CD).
-
-```bash
-mem0 init --api-key m0-xxx --user-id alice --force
-```
-
-| Flag | Description |
-|------|-------------|
-| `--api-key` | API key (skip prompt) |
-| `-u, --user-id` | Default user ID (skip prompt) |
-| `--email` | Login via email verification code |
-| `--code` | Verification code (use with `--email` for non-interactive login) |
-| `--force` | Overwrite existing config without confirmation |
-
-### `mem0 add`
-
-Add a memory from text, a JSON messages array, a file, or stdin.
-
-```bash
-mem0 add "I prefer dark mode" --user-id alice
-mem0 add --file conversation.json --user-id alice
-echo "Loves hiking on weekends" | mem0 add --user-id alice
-```
-
-| Flag | Description |
-|------|-------------|
-| `-u, --user-id` | Scope to a user |
-| `--agent-id` | Scope to an agent |
-| `--messages` | Conversation messages as JSON |
-| `-f, --file` | Read messages from a JSON file |
-| `-m, --metadata` | Custom metadata as JSON |
-| `--categories` | Categories (JSON array or comma-separated) |
-| `--graph / --no-graph` | Enable or disable graph memory extraction |
-| `-o, --output` | Output format: `text`, `json`, `quiet` |
-
-### `mem0 search`
-
-Search memories using natural language.
-
-```bash
-mem0 search "dietary restrictions" --user-id alice
-mem0 search "preferred tools" --user-id alice --output json --top-k 5
-```
-
-| Flag | Description |
-|------|-------------|
-| `-u, --user-id` | Filter by user |
-| `-k, --top-k` | Number of results (default: 10) |
-| `--threshold` | Minimum similarity score (default: 0.3) |
-| `--rerank` | Enable reranking |
-| `--keyword` | Use keyword search instead of semantic |
-| `--filter` | Advanced filter expression (JSON) |
-| `--graph / --no-graph` | Enable or disable graph in search |
-| `-o, --output` | Output format: `text`, `json`, `table` |
-
-### `mem0 list`
-
-List memories with optional filters and pagination.
-
-```bash
-mem0 list --user-id alice
-mem0 list --user-id alice --category preferences --output json
-mem0 list --user-id alice --after 2024-01-01 --page-size 50
-```
-
-| Flag | Description |
-|------|-------------|
-| `-u, --user-id` | Filter by user |
-| `--page` | Page number (default: 1) |
-| `--page-size` | Results per page (default: 100) |
-| `--category` | Filter by category |
-| `--after` | Created after date (YYYY-MM-DD) |
-| `--before` | Created before date (YYYY-MM-DD) |
-| `-o, --output` | Output format: `text`, `json`, `table` |
-
-### `mem0 get`
-
-Retrieve a specific memory by ID.
-
-```bash
-mem0 get 7b3c1a2e-4d5f-6789-abcd-ef0123456789
-mem0 get 7b3c1a2e-4d5f-6789-abcd-ef0123456789 --output json
-```
-
-### `mem0 update`
-
-Update the text or metadata of an existing memory.
-
-```bash
-mem0 update <memory-id> "Updated preference text"
-mem0 update <memory-id> --metadata '{"priority": "high"}'
-echo "new text" | mem0 update <memory-id>
-```
-
-### `mem0 delete`
-
-Delete a single memory, all memories for a scope, or an entire entity.
-
-```bash
-# Delete a single memory
-mem0 delete <memory-id>
-
-# Delete all memories for a user
-mem0 delete --all --user-id alice --force
-
-# Delete all memories project-wide
-mem0 delete --all --project --force
-
-# Preview what would be deleted
-mem0 delete --all --user-id alice --dry-run
-```
-
-| Flag | Description |
-|------|-------------|
-| `--all` | Delete all memories matching scope filters |
-| `--entity` | Delete the entity and all its memories |
-| `--project` | With `--all`: delete all memories project-wide |
-| `--dry-run` | Preview without deleting |
-| `--force` | Skip confirmation prompt |
-
-### `mem0 import`
-
-Bulk import memories from a JSON file.
-
-```bash
-mem0 import data.json --user-id alice
-```
-
-The file should be a JSON array where each item has a `memory` (or `text` or `content`) field and optional `user_id`, `agent_id`, and `metadata` fields.
-
-### `mem0 config`
-
-View or modify the local CLI configuration.
-
-```bash
-mem0 config show              # Display current config (secrets redacted)
-mem0 config get api_key       # Get a specific value
-mem0 config set user_id bob   # Set a value
-```
-
-### `mem0 entity`
-
-List or delete entities (users, agents, apps, runs).
-
-```bash
-mem0 entity list users
-mem0 entity list agents --output json
-mem0 entity delete --user-id alice --force
-```
-
-### `mem0 event`
-
-Inspect background processing events created by async operations (e.g. bulk deletes, large add jobs).
-
-```bash
-# List recent events
-mem0 event list
-
-# Check the status of a specific event
-mem0 event status <event-id>
-```
-
-| Flag | Description |
-|------|-------------|
-| `-o, --output` | Output format: `text`, `json` |
-
-### `mem0 status`
-
-Verify your API connection and display the current project.
-
-```bash
-mem0 status
-```
-
-## Agent mode
-
-Pass `--agent` (or its alias `--json`) as a **global flag** on any command to get output designed for AI agent tool loops:
-
-```bash
-mem0 --agent search "user preferences" --user-id alice
-mem0 --agent add "User prefers dark mode" --user-id alice
-mem0 --agent list --user-id alice
-mem0 --agent delete --all --user-id alice --force
-```
-
-Every command returns the same envelope shape:
-
-```json
-{
-  "status": "success",
-  "command": "search",
-  "duration_ms": 134,
-  "scope": { "user_id": "alice" },
-  "count": 2,
-  "data": [
-    { "id": "abc-123", "memory": "User prefers dark mode", "score": 0.97, "created_at": "2026-01-15", "categories": ["preferences"] }
-  ]
-}
-```
-
-What agent mode does differently from `--output json`:
-
- **Sanitized `data`**: only the fields an agent needs (id, memory, score, etc.) — no internal API noise
- **No human output**: spinners, colors, and banners are suppressed entirely
- **Errors as JSON**: errors go to stdout as `{"status": "error", "command": "...", "error": "..."}` with a non-zero exit code
-
-Use `mem0 help --json` to get the full command tree as JSON — useful for agents that need to self-discover available commands.
-
-## Output formats
-
-Control how results are displayed with `--output`:
-
-| Format | Description |
-|--------|-------------|
-| `text` | Human-readable with colors and formatting (default) |
-| `json` | Structured JSON for piping to `jq` (raw API response) |
-| `table` | Tabular format (default for `list`) |
-| `quiet` | Minimal — just IDs or status codes |
-| `agent` | Structured JSON envelope with sanitized fields (set by `--agent`/`--json`) |
-
-## Global flags
-
-These flags are available on all commands:
-
-| Flag | Description |
-|------|-------------|
-| `--json` | Enable agent mode: structured JSON envelope output, no colors or spinners |
-| `--agent` | Alias for `--json` |
-| `--api-key` | Override the configured API key for this request |
-| `--base-url` | Override the configured API base URL for this request |
-| `-o, --output` | Set the output format |
-
-`mem0 --version` prints the CLI version. It is only valid before a subcommand, not after one.
-
-## 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`) |
-
-Environment variables take precedence over values in the config file, which take precedence over defaults.
-
-## Development
-
-```bash
-cd cli/python
-python -m venv .venv && source .venv/bin/activate
-pip install -e ".[dev]"
-
-# Run during development
-python -m mem0_cli --help
-mem0 add "test memory" --user-id alice
-```
-
-## Releasing
-
-1. Update `version` in `pyproject.toml`
-2. Create a GitHub Release with tag `cli-v<version>` (e.g. `cli-v0.2.1`)
-
-For a pre-release, use a beta version like `0.2.1b1` and check the **pre-release** checkbox.
-
-## Documentation
-
-Full documentation is available at [docs.mem0.ai/platform/cli](https://docs.mem0.ai/platform/cli).
-
 ## License

 Apache-2.0
@@ -80,7 +80,7 @@ mem0 --help
 # Using Python directly (with venv activated)
 source .venv/bin/activate
 mem0 --help
-mem0 --version
+mem0 version

 # Or run without activating
 .venv/bin/mem0 --help
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"

 [project]
 name = "mem0-cli"
-version = "0.2.11"
+version = "0.1.0"
 description = "The official CLI for mem0 — the memory layer for AI agents"
 readme = "README.md"
 license = "Apache-2.0"
--- a/Show More
+++ b/Show More