Merge remote-tracking branch 'origin/main' into fix/codex-install-docs

# Conflicts: # mem0-plugin/README.md
docs(codex): lead sideload with CLI, flag auto-MCP, align server name
2026-04-27 11:04:22 -07:00 · 2026-04-24 16:53:30 -07:00 · 2026-04-24 15:35:01 -07:00 · 2026-04-24 15:34:47 -07:00 · 2026-04-23 15:04:35 -07:00
1872 changed files with 87121 additions and 123292 deletions
@@ -8,7 +8,7 @@
      "name": "mem0",
      "source": {
        "source": "local",
-        "path": "./integrations/mem0-plugin"
+        "path": "./mem0-plugin"
      },
      "policy": {
        "installation": "AVAILABLE",
@@ -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.1"
    }
  ]
 }
@@ -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.1"
    }
  ]
 }
@@ -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,18 @@
 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')
+    if: startsWith(github.event.release.tag_name, '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 +39,7 @@ jobs:
      #     packages_dir: dist/

      - name: Publish distribution 📦 to PyPI
+        if: startsWith(github.ref, 'refs/tags/v')
        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,11 +1,20 @@
 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/**'
+      - 'pyproject.toml'

 jobs:
  changelog_check:
@@ -51,8 +60,9 @@ jobs:
    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 +70,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 +96,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,25 +1,13 @@
 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
+  release:
+    types: [published]

 jobs:
  build-n-publish:
    name: Build and publish @mem0/cli 📦 to npm
-    if: startsWith(inputs.tag, 'cli-node-v')
+    if: startsWith(github.event.release.tag_name, 'cli-node-v')
    runs-on: ubuntu-latest
    permissions:
      id-token: write
@@ -28,8 +16,6 @@ jobs:
        working-directory: cli/node
    steps:
      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}

      - name: Install pnpm
        uses: pnpm/action-setup@v4
@@ -52,7 +38,7 @@ jobs:

      - name: Publish to npm
        run: |
-          if [ "${{ inputs.prerelease }}" = "true" ]; then
+          if [ "${{ github.event.release.prerelease }}" = "true" ]; then
            PREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")
            npx npm@latest publish --provenance --access public --tag "$PREID"
          else
@@ -1,7 +1,5 @@
 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:
@@ -9,7 +7,10 @@ on:
    paths:
      - 'cli/node/**'
      - '.github/workflows/cli-node-ci.yml'
-  workflow_call:
+  pull_request:
+    paths:
+      - 'cli/node/**'
+      - '.github/workflows/cli-node-ci.yml'

 jobs:
  lint:
@@ -1,24 +1,13 @@
 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
+  release:
+    types: [published]

 jobs:
  build-n-publish:
    name: Build and publish mem0-cli 📦 to PyPI
-    if: startsWith(inputs.tag, 'cli-v')
+    if: startsWith(github.event.release.tag_name, 'cli-v')
    runs-on: ubuntu-latest
    permissions:
      id-token: write
@@ -27,8 +16,6 @@ jobs:
        working-directory: cli/python
    steps:
      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}

      - name: Set up Python
        uses: actions/setup-python@v5
@@ -1,7 +1,5 @@
 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:
@@ -9,7 +7,10 @@ on:
    paths:
      - 'cli/python/**'
      - '.github/workflows/cli-python-ci.yml'
-  workflow_call:
+  pull_request:
+    paths:
+      - 'cli/python/**'
+      - '.github/workflows/cli-python-ci.yml'

 jobs:
  lint:
@@ -6,10 +6,13 @@ name: docs - llms.txt check
 #   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:
+  pull_request:
+    paths:
+      - 'docs/**/*.mdx'
+      - 'docs/llms.txt'
+      - 'scripts/check-llms-txt-coverage.py'
+      - 'scripts/llms-txt-ignore.txt'
  workflow_dispatch: {}

 permissions:
@@ -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,35 +1,21 @@
 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
+  release:
+    types: [published]

 jobs:
  build-n-publish:
    name: Build and publish @mem0/openclaw-mem0 📦 to npm
-    if: startsWith(inputs.tag, 'openclaw-v')
+    if: startsWith(github.event.release.tag_name, 'openclaw-v')
    runs-on: ubuntu-latest
    permissions:
      id-token: write
    defaults:
      run:
-        working-directory: integrations/openclaw
+        working-directory: openclaw
    steps:
      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}

      - name: Install pnpm
        uses: pnpm/action-setup@v4
@@ -42,7 +28,7 @@ jobs:
          node-version: '22'
          registry-url: 'https://registry.npmjs.org'
          cache: 'pnpm'
-          cache-dependency-path: integrations/openclaw/pnpm-lock.yaml
+          cache-dependency-path: openclaw/pnpm-lock.yaml

      - name: Install dependencies
        run: pnpm install --frozen-lockfile
@@ -52,7 +38,7 @@ jobs:

      - name: Publish to npm
        run: |
-          if [ "${{ inputs.prerelease }}" = "true" ]; then
+          if [ "${{ github.event.release.prerelease }}" = "true" ]; then
            PREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")
            npx npm@latest publish --provenance --access public --tag "$PREID"
          else
@@ -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,24 +1,13 @@
 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
+  release:
+    types: [published]

 jobs:
  build-n-publish:
    name: Build and publish mem0ai 📦 to npm
-    if: startsWith(inputs.tag, 'ts-v')
+    if: startsWith(github.event.release.tag_name, 'ts-v')
    runs-on: ubuntu-latest
    permissions:
      id-token: write
@@ -27,8 +16,6 @@ jobs:
        working-directory: mem0-ts
    steps:
      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}

      - name: Install pnpm
        uses: pnpm/action-setup@v4
@@ -51,7 +38,7 @@ jobs:

      - name: Publish to npm
        run: |
-          if [ "${{ inputs.prerelease }}" = "true" ]; then
+          if [ "${{ github.event.release.prerelease }}" = "true" ]; then
            PREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")
            npx npm@latest publish --provenance --access public --tag "$PREID"
          else
@@ -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:
@@ -1,35 +1,21 @@
 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
+  release:
+    types: [published]

 jobs:
  build-n-publish:
    name: Build and publish @mem0/vercel-ai-provider 📦 to npm
-    if: startsWith(inputs.tag, 'vercel-ai-v')
+    if: startsWith(github.event.release.tag_name, 'vercel-ai-v')
    runs-on: ubuntu-latest
    permissions:
      id-token: write
    defaults:
      run:
-        working-directory: integrations/vercel-ai-sdk
+        working-directory: vercel-ai-sdk
    steps:
      - uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}

      - name: Install pnpm
        uses: pnpm/action-setup@v4
@@ -42,7 +28,7 @@ jobs:
          node-version: '22'
          registry-url: 'https://registry.npmjs.org'
          cache: 'pnpm'
-          cache-dependency-path: integrations/vercel-ai-sdk/pnpm-lock.yaml
+          cache-dependency-path: vercel-ai-sdk/pnpm-lock.yaml

      - name: Install dependencies
        run: pnpm install --frozen-lockfile
@@ -52,7 +38,7 @@ jobs:

      - name: Publish to npm
        run: |
-          if [ "${{ inputs.prerelease }}" = "true" ]; then
+          if [ "${{ github.event.release.prerelease }}" = "true" ]; then
            PREID=$(node -p "require('./package.json').version.split('-')[1].split('.')[0]")
            npx npm@latest publish --provenance --access public --tag "$PREID"
          else
@@ -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
@@ -170,6 +170,7 @@ cython_debug/
 # Database
 db
 test-db
+!embedchain/embedchain/core/db/

 .vscode
 .idea/
@@ -189,5 +190,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
@@ -12,7 +12,7 @@ This file provides context for AI coding assistants (Claude Code, Cursor, GitHub

 ## Repository Structure

-This is a **polyglot monorepo** containing Python and TypeScript packages, CLIs, servers, plugins, and documentation.
+This is a **polyglot monorepo** containing Python and TypeScript packages, CLIs, servers, plugins, documentation, and evaluation tooling.

 ### Key Directories

@@ -22,19 +22,18 @@ This is a **polyglot monorepo** containing Python and TypeScript packages, CLIs,
 | `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 |
+| `vercel-ai-sdk/` | `@mem0/vercel-ai-provider` — Vercel AI SDK memory provider |
+| `openclaw/` | `@mem0/openclaw-mem0` — OpenClaw plugin for Claude Code / AI editors |
 | `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/` |
+| `openmemory/` | Self-hosted memory platform — `api/` (FastAPI + Alembic + MCP server) and `ui/` (Next.js 15 + React 19) |
+| `mem0-plugin/` | AI editor plugins (Claude Code, Cursor, Codex) — MCP server connection, lifecycle hooks, skills |
+| `skills/` | Claude Code skill definitions — `mem0/`, `mem0-cli/`, `mem0-vercel-ai-sdk/` |
 | `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/`) |
+| `evaluation/` | Benchmarking framework — LOCOMO evals, experiment runner, score generation |
+| `examples/` | Sample projects — demo apps, Chrome extension, multi-agent patterns |
+| `cookbooks/` | Jupyter notebooks — customer support chatbot, AutoGen integration |
+| `embedchain/` | Legacy Embedchain RAG framework (maintained separately, Poetry-based) |
 | `pr-reviews/` | Pull request review materials |
 | `scripts/` | Repo-wide utility scripts (e.g., `check-llms-txt-coverage.py` for docs/llms.txt sync) |

@@ -51,8 +50,8 @@ mem0 (Python SDK)          mem0-ts (TypeScript SDK)

 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)
+vercel-ai-sdk/ ──▶ ai, @ai-sdk/* providers
+openclaw/   ──▶ mem0ai (npm)
 ```

 ## Development Setup
@@ -63,7 +62,7 @@ integrations/openclaw/ ──▶ mem0ai (npm)
 - **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
+- **Docker**: Required for `server/` and `openmemory/` development

 ### Initial Setup

@@ -75,8 +74,8 @@ 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
+cd vercel-ai-sdk && pnpm install  # Vercel AI provider
+cd openclaw && pnpm install       # OpenClaw plugin
 ```

 ## Build, Lint, and Test Commands
@@ -164,10 +163,10 @@ pnpm run dev                       # tsx src/index.ts (development)
 - **Test:** vitest (not jest)
 - **Framework:** Commander + Chalk + ora + cli-table3

-### Vercel AI SDK Provider (`integrations/vercel-ai-sdk/`)
+### Vercel AI SDK Provider (`vercel-ai-sdk/`)

 ```bash
-cd integrations/vercel-ai-sdk
+cd vercel-ai-sdk
 pnpm install
 pnpm run build                     # tsup
 pnpm run lint                      # eslint
@@ -182,10 +181,10 @@ pnpm run test:node                 # vitest (node runtime)
 - **Lint:** ESLint + Prettier
 - **Test:** jest + vitest (edge/node configs)

-### OpenClaw Plugin (`integrations/openclaw/`)
+### OpenClaw Plugin (`openclaw/`)

 ```bash
-cd integrations/openclaw
+cd openclaw
 pnpm install
 pnpm run build                     # tsup
 pnpm run test                      # vitest run
@@ -215,6 +214,28 @@ docker-compose up                  # starts all 3 services
 - **Services:** PostgreSQL with pgvector, Neo4j 5.x with APOC plugin
 - **Hot reload:** Dev Dockerfile mounts `server/` and `mem0/` for live changes

+### OpenMemory (`openmemory/`)
+
+```bash
+# Full stack via Docker Compose
+cd openmemory
+docker-compose up
+# Qdrant: localhost:6333
+# API (MCP): localhost:8765
+# UI: localhost:3000
+
+# Individual development
+cd openmemory/api && uvicorn main:app --reload       # FastAPI backend
+cd openmemory/ui && npm run dev                       # Next.js frontend
+
+# Tests
+cd openmemory/api && pytest tests/                   # API tests (e.g., test_mcp_server.py)
+```
+
+- **API:** FastAPI + Alembic (DB migrations) + MCP server (Model Context Protocol)
+- **UI:** Next.js 15, React 19, Radix UI, Redux Toolkit, TailwindCSS, Recharts
+- **Vector store:** Qdrant
+
 ### Documentation (`docs/`)

 ```bash
@@ -225,19 +246,18 @@ make docs                          # or: cd docs && mintlify dev
 - **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:
+### Evaluation (`evaluation/`)

 ```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
+cd evaluation
+make run-mem0-add                  # Run mem0 add experiments
+make run-mem0-search               # Run mem0 search experiments
+make run-mem0-plus-add             # With graph memory
+make run-mem0-plus-search          # With graph memory
+make run-rag                       # RAG baseline
+make run-full-context              # Full context baseline
+make run-langmem                   # LangMem comparison
+make run-openai                    # OpenAI comparison
 ```

 ## Core APIs
@@ -310,6 +330,7 @@ python -m benchmarks.beam.run --project-name my-test --backend cloud --mem0-api-
  - 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.
+- Ruff excludes `embedchain/` and `openmemory/` from root config.

 ### TypeScript Conventions

@@ -322,8 +343,8 @@ python -m benchmarks.beam.run --project-name my-test --backend cloud --mem0-api-
 |---------|--------|-----------|---------------|
 | `mem0-ts/` | — | Prettier | jest |
 | `cli/node/` | Biome | Biome | vitest |
-| `integrations/vercel-ai-sdk/` | ESLint | Prettier | jest + vitest |
-| `integrations/openclaw/` | — | — | vitest |
+| `vercel-ai-sdk/` | ESLint | Prettier | jest + vitest |
+| `openclaw/` | — | — | vitest |

 ### Type Checking

@@ -360,14 +381,13 @@ Optional layer on top of vector memory for relationship-aware retrieval. Configu
 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`
+- **Local:** MCP server in `openmemory/api/` (FastAPI-based)
+- **Plugin:** MCP tools in `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).
+- `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, covering SDK usage, CLI workflows, and Vercel AI SDK patterns.

 ### Adding a New Provider

@@ -381,70 +401,38 @@ To add a new LLM, embedding, vector store, or reranker provider:
 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.
+| Workflow | File | Triggers | Tests |
+|----------|------|----------|-------|
+| Python SDK | `ci.yml` | Push to main, PRs on `mem0/`, `tests/`, `pyproject.toml` | Ruff lint + pytest on Python 3.10, 3.11, 3.12 |
+| TypeScript SDK | `ts-sdk-ci.yml` | Push to main, PRs on `mem0-ts/` | Prettier + build + jest on Node 20, 22 |
+| Python CLI | `cli-python-ci.yml` | Push to `cli/python/`, PRs, manual | Ruff lint + pytest + hatch build on Python 3.10, 3.11, 3.12 |
+| Node CLI | `cli-node-ci.yml` | Push to `cli/node/`, PRs, manual | Biome lint + tsc + vitest + tsup build on Node 20, 22 |
+| OpenClaw | `openclaw-checks.yml` | Push to `openclaw/`, PRs, manual | tsc + vitest (with Codecov) + tsup build on Node 20, 22 |
+| Embedchain | `ci.yml` (shared) | PRs on `embedchain/` | Ruff + pytest + coverage on Python 3.9–3.12 |

 ### 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`. |

@@ -567,7 +555,7 @@ N/A

 - 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.
+- For `server/` and `openmemory/` 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
@@ -586,8 +574,10 @@ N/A
 - 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.
+- Modify `embedchain/` unless specifically working on that package — it has its own build system (Poetry).
 - 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).
+- Modify `openmemory/` database migrations without understanding the Alembic migration chain.
 - Change public APIs without updating documentation in `docs/`.
@@ -1,157 +1,72 @@
-# 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
+Make sure that all tests pass across all supported Python versions before submitting a pull request.

-## Reporting Security Issues
+We look forward to your pull requests and can't wait to see your contributions!

-**Do not report security vulnerabilities through public issues or pull requests.**
-Please follow our [Security Policy](./SECURITY.md) to report them privately.
+### 🚀 Releasing

-## Releasing
+All packages are published automatically via GitHub Actions when a GitHub Release is created with the correct tag prefix.

-All packages are published automatically via GitHub Actions when a GitHub Release
-is created with the correct tag prefix.
-
-### Tag Prefixes
+#### Tag Prefixes

 | Package | Registry | Tag Prefix | Example |
 |---------|----------|------------|---------|
@@ -162,17 +77,15 @@ is created with the correct tag prefix.
 | `@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
+#### 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
+#### 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
-
-We look forward to your pull requests and can't wait to see your contributions!
@@ -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
@@ -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

@@ -46,25 +46,24 @@

 | Benchmark | Old | New  | Tokens  | Latency p50  |
 | --- | --- | --- | --- | --- |
-| **LoCoMo** | 71.4 | **92.5** | 7.0K  | 0.88s  |
-| **LongMemEval** | 67.8 | **94.4** | 6.8K  | 1.09s  |
+| **LoCoMo** | 71.4 | **91.6** | 7.0K  | 0.88s  |
+| **LongMemEval** | 67.8 | **93.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.
+All benchmarks run on the same production-representative model stack. Single-pass retrieval (one call, no agentic loops).

 **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
+- **91.6 on LoCoMo** -- +20 points over the previous algorithm
+- **93.4 on LongMemEval** -- +26 points, with +53.6 on assistant memory recall
 - **64.1 on BEAM (1M)** -- production-scale memory evaluation at 1M tokens
 - [Read the full paper](https://mem0.ai/research)

@@ -86,26 +85,6 @@ 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
-
-AI agents can mint a working Mem0 API key in under five seconds — no email, no dashboard, no OTP. Four commands end-to-end:
-
-```bash
-# 1. Install
-npm install -g @mem0/cli      # or: pip install mem0-cli
-
-# 2. Sign up as an agent (replace `claude-code` with your name)
-mem0 init --agent --agent-caller claude-code
-
-# 3. Add a memory
-mem0 add "I am using mem0"
-
-# 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 |
@@ -153,7 +132,6 @@ See the [self-hosted docs](https://docs.mem0.ai/open-source/overview) for config

 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

@@ -169,28 +147,6 @@ 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).
@@ -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.
@@ -60,8 +60,9 @@ mem0 delete <memory-id>
 | `mem0 entity` | List or delete entities (users, agents, apps, runs) |
 | `mem0 event` | Inspect background processing events (bulk deletes, large add jobs) |
 | `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.
+Run `mem0 <command> --help` for detailed usage on any command.

 ## Agent mode

@@ -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,7 +503,7 @@
    },
    {
      "name": "init",
-      "description": "Setup wizard for mem0 CLI. Supports Agent Mode bootstrap (--agent), email login (--email), or manual API key (--api-key).",
+      "description": "Setup wizard for mem0 CLI. Supports email login (--email) or manual API key (--api-key).",
      "usage": "mem0 init [OPTIONS]",
      "needsBackend": false,
      "needsConfig": false,
@@ -528,9 +516,7 @@
        { "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)." }
+        { "name": "force", "flags": ["--force"], "type": "boolean", "default": false, "help": "Overwrite existing config without confirmation." }
      ]
    },
    {
@@ -232,6 +232,14 @@ Verify your API connection and display the current project.
 mem0 status
 ```

+### `mem0 version`
+
+Print the CLI version.
+
+```bash
+mem0 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:
@@ -290,8 +298,6 @@ These flags are available on all commands:
 | `--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 |
@@ -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,6 +1,6 @@
 {
  "name": "@mem0/cli",
-  "version": "0.2.12",
+  "version": "0.2.4",
  "description": "The official CLI for mem0 — the memory layer for AI agents",
  "type": "module",
  "bin": {
@@ -40,19 +40,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;
-}
@@ -14,10 +14,7 @@ export interface AddOptions {
 	immutable?: boolean;
 	infer?: boolean;
 	expires?: string;
-	customInstructions?: string;
-	customCategories?: Record<string, string>[];
-	structuredDataSchema?: Record<string, unknown>;
-	timestamp?: number;
+	categories?: string[];
 }

 export interface SearchOptions {
@@ -31,9 +28,6 @@ export interface SearchOptions {
 	keyword?: boolean;
 	filters?: Record<string, unknown>;
 	fields?: string[];
-	showExpired?: boolean;
-	referenceDate?: string | number;
-	latestOnly?: boolean;
 }

 export interface ListOptions {
@@ -46,8 +40,6 @@ export interface ListOptions {
 	category?: string;
 	after?: string;
 	before?: string;
-	showExpired?: boolean;
-	latestOnly?: boolean;
 }

 export interface DeleteOptions {
@@ -56,12 +48,6 @@ export interface DeleteOptions {
 	agentId?: string;
 	appId?: string;
 	runId?: string;
-	deleteLinked?: boolean;
-}
-
-export interface UpdateOptions {
-	expirationDate?: string;
-	timestamp?: number;
 }

 export interface EntityIds {
@@ -91,7 +77,6 @@ export interface Backend {
 		memoryId: string,
 		content?: string,
 		metadata?: Record<string, unknown>,
-		opts?: UpdateOptions,
 	): Promise<Record<string, unknown>>;

 	delete(
@@ -3,7 +3,7 @@
 */

 import type { PlatformConfig } from "../config.js";
-import { captureNotice, isAgentMode } from "../state.js";
+import { isAgentMode } from "../state.js";
 import { CLI_VERSION } from "../version.js";
 import {
 	APIError,
@@ -15,13 +15,8 @@ import {
 	type ListOptions,
 	NotFoundError,
 	type SearchOptions,
-	type UpdateOptions,
 } 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>;
@@ -95,39 +90,7 @@ export class PlatformBackend implements Backend {
 		if (resp.status === 204) {
 			return {};
 		}
-
-		const data = await resp.json();
-
-		// 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);
-
-		return data;
+		return resp.json();
 	}

 	async add(
@@ -151,13 +114,7 @@ export class PlatformBackend implements Backend {
 		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.customCategories)
-			payload.custom_categories = opts.customCategories;
-		if (opts.structuredDataSchema)
-			payload.structured_data_schema = opts.structuredDataSchema;
-		if (opts.timestamp !== undefined) payload.timestamp = opts.timestamp;
+		if (opts.categories) payload.categories = opts.categories;
 		payload.source = "CLI";

 		return (await this._request("POST", "/v3/memories/add/", {
@@ -218,10 +175,6 @@ export class PlatformBackend implements Backend {
 		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 result = (await this._request("POST", "/v3/memories/search/", {
@@ -233,13 +186,9 @@ export class PlatformBackend implements Backend {
 	}

 	async get(memoryId: string): Promise<Record<string, unknown>> {
-		return (await this._request(
-			"GET",
-			`/v1/memories/${encodePathSegment(memoryId)}/`,
-			{
-				params: { source: "CLI" },
-			},
-		)) as Record<string, unknown>;
+		return (await this._request("GET", `/v1/memories/${memoryId}/`, {
+			params: { source: "CLI" },
+		})) as Record<string, unknown>;
 	}

 	async listMemories(
@@ -276,8 +225,6 @@ export class PlatformBackend implements Backend {
 			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";

 		const result = (await this._request("POST", "/v3/memories/", {
@@ -293,21 +240,14 @@ export class PlatformBackend implements Backend {
 		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>;
+		return (await this._request("PUT", `/v1/memories/${memoryId}/`, {
+			json: payload,
+		})) as Record<string, unknown>;
 	}

 	async delete(
@@ -325,13 +265,9 @@ export class PlatformBackend implements Backend {
 			})) 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>;
+			return (await this._request("DELETE", `/v1/memories/${memoryId}/`, {
+				params: { source: "CLI" },
+			})) as Record<string, unknown>;
 		}
 		throw new Error("Either memoryId or --all is required");
 	}
@@ -348,18 +284,16 @@ export class PlatformBackend implements Backend {
 		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> = {};
+		// Delete each provided entity via the v2 path-based endpoint
+		let result: Record<string, unknown> = {};
 		for (const [entityType, entityId] of entities) {
-			results[entityType] = (await this._request(
+			result = (await this._request(
 				"DELETE",
-				`/v2/entities/${encodePathSegment(entityType)}/${encodePathSegment(entityId)}/`,
+				`/v2/entities/${entityType}/${entityId}/`,
 				{ params: { source: "CLI" } },
 			)) as Record<string, unknown>;
 		}
-		return results;
+		return result;
 	}

 	async ping(): Promise<Record<string, unknown>> {
@@ -418,9 +352,9 @@ export class PlatformBackend implements Backend {
 	}

 	async getEvent(eventId: string): Promise<Record<string, unknown>> {
-		return (await this._request(
-			"GET",
-			`/v1/event/${encodePathSegment(eventId)}/`,
-		)) as Record<string, unknown>;
+		return (await this._request("GET", `/v1/event/${eventId}/`)) as Record<
+			string,
+			unknown
+		>;
 	}
 }
@@ -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)}`);
-	});
-}
@@ -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}.`);
-}
@@ -21,8 +21,6 @@ import {
 	redactKey,
 	saveConfig,
 } from "../config.js";
-import { formatJsonEnvelope } from "../output.js";
-import { isAgentMode } from "../state.js";

 const { brand, dim } = colors;

@@ -35,65 +33,6 @@ function validateEmail(email: string): void {
 	}
 }

-/** @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,
@@ -257,7 +196,6 @@ async function setupPlatform(config: Mem0Config): Promise<void> {
 		process.exit(1);
 	}
 	config.platform.apiKey = apiKey;
-	config.platform.createdVia = "api_key";
 }

 async function setupDefaults(config: Mem0Config): Promise<void> {
@@ -311,35 +249,14 @@ export async function runInit(
 		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");
-
-	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);
-	};
-
 	const config = createDefaultConfig();
 	const savedConfig = loadConfig();
 	const baseUrl =
 		process.env.MEM0_BASE_URL ||
 		savedConfig.platform.baseUrl ||
 		DEFAULT_BASE_URL;
-	config.platform.baseUrl = baseUrl;

 	// Guards
 	if (opts.code && !opts.email) {
@@ -351,84 +268,6 @@ export async function runInit(
 		process.exit(1);
 	}

-	// ── 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;
-	}
-
-	// ── 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;
-	}
-
 	// Warn if an existing config with an API key would be overwritten
 	if (
 		!opts.force &&
@@ -485,7 +324,6 @@ export async function runInit(
 		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";

@@ -501,15 +339,13 @@ export async function runInit(
 	}

 	// ── 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.",
+				"Usage: mem0 init --api-key <key> [--user-id <id>]",
 			);
 			process.exit(1);
 		}
@@ -520,7 +356,6 @@ export async function runInit(
 	// 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);
@@ -568,7 +403,6 @@ export async function runInit(
 			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";

@@ -21,19 +21,16 @@ import {
 	formatSingleMemory,
 	printResultSummary,
 } from "../output.js";
-import { isAgentMode, setCurrentCommand, stdinIsPiped } from "../state.js";
+import { isAgentMode, setCurrentCommand } from "../state.js";

-/** Exit 1 if value is not a future YYYY-MM-DD date. */
-function _validateExpires(value: string): void {
-	if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) {
-		printError(
-			"Invalid date format for --expires. Use YYYY-MM-DD (e.g. 2025-12-31).",
-		);
-		process.exit(1);
-	}
-	if (new Date(value) <= new Date()) {
-		printError("--expires date must be in the future.");
-		process.exit(1);
+/** True only when stdin is an actual pipe or file redirect — never in agent mode. */
+function _stdinIsPiped(): boolean {
+	if (isAgentMode()) return false;
+	try {
+		const stat = fs.fstatSync(0);
+		return stat.isFIFO() || stat.isFile();
+	} catch {
+		return false;
 	}
 }

@@ -49,25 +46,13 @@ export async function cmdAdd(
 		file?: string;
 		metadata?: string;
 		immutable: boolean;
-		infer?: boolean;
+		noInfer: boolean;
 		expires?: string;
 		categories?: string;
-		customInstructions?: string;
-		customCategories?: string;
-		structuredDataSchema?: string;
-		timestamp?: number;
 		output: string;
 	},
 ): Promise<void> {
 	setCurrentCommand("add");
-
-	if (opts.categories) {
-		printError(
-			"--categories is not supported on add. Use --custom-categories instead.",
-		);
-		process.exit(1);
-	}
-
 	let msgs: Record<string, unknown>[] | undefined;
 	let content = text;

@@ -93,7 +78,7 @@ export async function cmdAdd(
 		}
 	}
 	// Read from stdin only if stdin is an actual pipe or file redirect
-	else if (!content && stdinIsPiped()) {
+	else if (!content && _stdinIsPiped()) {
 		content = fs.readFileSync(0, "utf-8").trim();
 	}

@@ -108,6 +93,20 @@ export async function cmdAdd(
 		process.exit(1);
 	}

+	// Validate --expires
+	if (opts.expires) {
+		if (!/^\d{4}-\d{2}-\d{2}$/.test(opts.expires)) {
+			printError(
+				"Invalid date format for --expires. Use YYYY-MM-DD (e.g. 2025-12-31).",
+			);
+			process.exit(1);
+		}
+		if (new Date(opts.expires) <= new Date()) {
+			printError("--expires date must be in the future.");
+			process.exit(1);
+		}
+	}
+
 	let meta: Record<string, unknown> | undefined;
 	if (opts.metadata) {
 		try {
@@ -118,28 +117,15 @@ export async function cmdAdd(
 		}
 	}

-	let customCats: Record<string, string>[] | undefined;
-	if (opts.customCategories) {
+	let cats: string[] | undefined;
+	if (opts.categories) {
 		try {
-			customCats = JSON.parse(opts.customCategories);
+			cats = JSON.parse(opts.categories);
 		} catch {
-			printError("Invalid JSON in --custom-categories.");
-			process.exit(1);
+			cats = opts.categories.split(",").map((c) => c.trim());
 		}
 	}

-	let schema: Record<string, unknown> | undefined;
-	if (opts.structuredDataSchema) {
-		try {
-			schema = JSON.parse(opts.structuredDataSchema);
-		} catch {
-			printError("Invalid JSON in --structured-data-schema.");
-			process.exit(1);
-		}
-	}
-
-	if (opts.expires) _validateExpires(opts.expires);
-
 	let result: Record<string, unknown>;
 	try {
 		result = await timedStatus("Adding memory...", async () => {
@@ -150,12 +136,9 @@ export async function cmdAdd(
 				runId: opts.runId,
 				metadata: meta,
 				immutable: opts.immutable,
-				infer: opts.infer !== false,
+				infer: !opts.noInfer,
 				expires: opts.expires,
-				customInstructions: opts.customInstructions,
-				customCategories: customCats,
-				structuredDataSchema: schema,
-				timestamp: opts.timestamp,
+				categories: cats,
 			});
 		});
 	} catch (e) {
@@ -240,9 +223,6 @@ export async function cmdSearch(
 		keyword: boolean;
 		filterJson?: string;
 		fields?: string;
-		showExpired?: boolean;
-		referenceDate?: string;
-		latestOnly?: boolean;
 		output: string;
 	},
 ): Promise<void> {
@@ -291,9 +271,6 @@ export async function cmdSearch(
 				keyword: opts.keyword,
 				filters,
 				fields: fieldList,
-				showExpired: opts.showExpired,
-				referenceDate: opts.referenceDate,
-				latestOnly: opts.latestOnly,
 			});
 		});
 	} catch (e) {
@@ -387,8 +364,6 @@ export async function cmdList(
 		category?: string;
 		after?: string;
 		before?: string;
-		showExpired?: boolean;
-		latestOnly?: boolean;
 		output: string;
 	},
 ): Promise<void> {
@@ -416,8 +391,6 @@ export async function cmdList(
 				category: opts.category,
 				after: opts.after,
 				before: opts.before,
-				showExpired: opts.showExpired,
-				latestOnly: opts.latestOnly,
 			});
 		});
 	} catch (e) {
@@ -477,12 +450,7 @@ export async function cmdUpdate(
 	backend: Backend,
 	memoryId: string,
 	text: string | undefined,
-	opts: {
-		metadata?: string;
-		expires?: string;
-		timestamp?: number;
-		output: string;
-	},
+	opts: { metadata?: string; output: string },
 ): Promise<void> {
 	setCurrentCommand("update");
 	let meta: Record<string, unknown> | undefined;
@@ -495,16 +463,11 @@ export async function cmdUpdate(
 		}
 	}

-	if (opts.expires) _validateExpires(opts.expires);
-
 	const start = performance.now();
 	let result: Record<string, unknown>;
 	try {
 		result = await timedStatus("Updating memory...", async () => {
-			return backend.update(memoryId, text, meta, {
-				expirationDate: opts.expires,
-				timestamp: opts.timestamp,
-			});
+			return backend.update(memoryId, text, meta);
 		});
 	} catch (e) {
 		printError(e instanceof Error ? e.message : String(e));
@@ -530,12 +493,7 @@ export async function cmdUpdate(
 export async function cmdDelete(
 	backend: Backend,
 	memoryId: string,
-	opts: {
-		output: string;
-		dryRun?: boolean;
-		force?: boolean;
-		deleteLinked?: boolean;
-	},
+	opts: { output: string; dryRun?: boolean; force?: boolean },
 ): Promise<void> {
 	setCurrentCommand("delete");
 	if (opts.dryRun) {
@@ -556,7 +514,7 @@ export async function cmdDelete(
 	let result: Record<string, unknown>;
 	try {
 		result = await timedStatus("Deleting...", async () => {
-			return backend.delete(memoryId, { deleteLinked: opts.deleteLinked });
+			return backend.delete(memoryId);
 		});
 	} catch (e) {
 		printError(e instanceof Error ? e.message : String(e));
@@ -1,5 +1,5 @@
 /**
- * Utility commands: status, import.
+ * Utility commands: status, version, import.
 */

 import fs from "node:fs";
@@ -8,6 +8,7 @@ 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 { CLI_VERSION } from "../version.js";

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

@@ -81,6 +82,10 @@ export async function cmdStatus(
 	console.log();
 }

+export function cmdVersion(): void {
+	console.log(`  ${brand("◆ Mem0")} CLI v${CLI_VERSION}`);
+}
+
 export async function cmdImport(
 	backend: Backend,
 	filePath: string,
@@ -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");
-}
@@ -21,12 +21,6 @@ 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
 }

 export interface DefaultsConfig {
@@ -40,18 +34,11 @@ 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;
-}
-
 export interface Mem0Config {
 	version: number;
 	defaults: DefaultsConfig;
 	platform: PlatformConfig;
 	telemetry: TelemetryConfig;
-	agentRush: AgentRushConfig;
 }

 export function createDefaultConfig(): Mem0Config {
@@ -67,18 +54,10 @@ export function createDefaultConfig(): Mem0Config {
 			apiKey: "",
 			baseUrl: DEFAULT_BASE_URL,
 			userEmail: "",
-			agentMode: false,
-			createdVia: "",
-			agentCaller: "",
-			claimedAt: "",
-			defaultUserId: "",
 		},
 		telemetry: {
 			anonymousId: "",
 		},
-		agentRush: {
-			acknowledgedAt: "",
-		},
 	};
 }

@@ -100,11 +79,6 @@ export function loadConfig(): Mem0Config {
 		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 defaults = data.defaults ?? {};
 		config.defaults.userId = defaults.user_id ?? "";
@@ -113,8 +87,6 @@ export function loadConfig(): Mem0Config {
 		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 ?? "";
 	}

 	// Environment variable overrides
@@ -146,36 +118,14 @@ export function saveConfig(config: Mem0Config): void {
 			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,
-		},
 	};

 	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 */
-		}
-	}
 }

 export function redactKey(key: string): string {
@@ -13,13 +13,7 @@ import { colors, printError, printWarning } from "./branding.js";
 import type { Mem0Config } from "./config.js";
 import { loadConfig, saveConfig } from "./config.js";
 import { richFormatHelp } from "./help.js";
-import {
-	isAgentMode,
-	setAgentMode,
-	setCurrentCommand,
-	stdinIsPiped,
-	takeNotice,
-} from "./state.js";
+import { setAgentMode } from "./state.js";
 import { captureEvent } from "./telemetry.js";
 import { CLI_VERSION } from "./version.js";

@@ -147,11 +141,6 @@ program
 	.description(
 		`◆ Mem0 CLI v${CLI_VERSION} · Node.js SDK\n\nThe Memory Layer for AI Agents`,
 	)
-	// Positional options: flags AFTER a subcommand name belong to that
-	// subcommand, not the global program. Without this, `mem0 init --agent`
-	// routes `--agent` to the program-level alias (for --json) and init's own
-	// `--agent` (Agent Mode bootstrap) silently never fires.
-	.enablePositionalOptions()
 	.option("--version", "Show version and exit.")
 	.on("option:version", () => {
 		console.log(`  ${colors.brand("◆ Mem0")} CLI v${CLI_VERSION}`);
@@ -160,7 +149,7 @@ program
 	.option("--json", "Output as JSON for agent/programmatic use.")
 	.option(
 		"--agent",
-		"Output as JSON for agent/programmatic use. (alias: --json) Place BEFORE the subcommand: `mem0 --agent <cmd>`. On `init`, `mem0 init --agent` is the Agent Mode bootstrap flag instead.",
+		"Output as JSON for agent/programmatic use. (alias: --json)",
 	)
 	.usage("<command> [options]")
 	.helpOption("--help", "Show this message and exit.")
@@ -177,14 +166,6 @@ program.hook("preAction", (_thisCommand, actionCommand) => {
 			parentName && parentName !== "mem0"
 				? `${parentName}.${commandName}`
 				: commandName;
-		// Stash the active command name in shared state so the JSON
-		// error envelope (printError) can report which command failed
-		// instead of an empty `"command": ""` field.
-		setCurrentCommand(fullCommand);
-		// init fires its own telemetry from runInit with full M1-M6 props
-		// (mode/agent_caller/signup_source/claimed_agent_mode); skip the
-		// auto-fire here so we don't double-count.
-		if (fullCommand === "init") return;
 		const isAgent = !!(program.opts().json || program.opts().agent);
 		captureEvent(
 			`cli.${fullCommand}`,
@@ -212,32 +193,11 @@ program
 		"Verification code (use with --email for non-interactive login).",
 	)
 	.option("--force", "Overwrite existing config without confirmation.", false)
-	.option(
-		"--agent",
-		"Bootstrap an unattended Agent Mode account (no email required).",
-		false,
-	)
-	.option(
-		"--source <channel>",
-		"Channel attribution for signup (e.g. github, hn, ph).",
-	)
-	.option(
-		"--agent-caller <name>",
-		"Self-declared agent identity (e.g. claude-code, cursor). Used with --agent to attribute Agent Mode signups.",
-	)
-	// Accept `--json` at the init level too so the PRD-documented form
-	// `mem0 init --agent --json` works without requiring users to move it
-	// before the subcommand. Effect is identical to the global `--json`:
-	// flip agent-mode output state.
-	.option("--json", "Output as JSON (alias for global `--json`).", false)
 	.addHelpText(
 		"after",
-		"\nExamples:\n  $ mem0 init\n  $ mem0 init --api-key m0-xxx --user-id alice\n  $ mem0 init --email you@example.com\n  $ mem0 init --email you@example.com --code 123456\n  $ mem0 init --agent             # Bootstrap an Agent Mode account (unattended)\n  $ mem0 init --email you@example.com  # Claims an existing Agent Mode key when one is present",
+		"\nExamples:\n  $ mem0 init\n  $ mem0 init --api-key m0-xxx --user-id alice\n  $ mem0 init --email you@example.com\n  $ mem0 init --email you@example.com --code 123456",
 	)
 	.action(async (opts) => {
-		// `--json` at init level mirrors the global flag — flip agent_mode
-		// state so downstream formatters use JSON envelopes.
-		if (opts.json) setAgentMode(true);
 		const { runInit } = await import("./commands/init.js");
 		await runInit({
 			apiKey: opts.apiKey,
@@ -245,66 +205,9 @@ program
 			email: opts.email,
 			code: opts.code,
 			force: opts.force,
-			agent: opts.agent,
-			source: opts.source,
-			agentCaller: opts.agentCaller,
 		});
 	});

-// ── Setup: identify (post-bootstrap agent self-tag) ──────────────────────
-
-program
-	.command("identify <name>")
-	.description(
-		"Tag your active Agent Mode key with the AI agent that's using it (e.g. claude-code, cursor).",
-	)
-	.action(async (name: string) => {
-		const { runIdentify } = await import("./commands/identify.js");
-		await runIdentify(name);
-	});
-
-// ── Setup: whoami (print active agent identifier) ────────────────────────
-
-program
-	.command("whoami")
-	.description("Print the active agent's AGENTRUSH identifier.")
-	.action(async () => {
-		const { cmdWhoami } = await import("./commands/whoami.js");
-		await cmdWhoami();
-	});
-
-// ── AGENTRUSH subcommand group ────────────────────────────────────────────
-
-const agentRush = program
-	.command("agent-rush")
-	.description("AGENTRUSH game commands.")
-	.addHelpCommand(false)
-	.configureHelp({ formatHelp: richFormatHelp });
-
-agentRush
-	.command("add <content...>")
-	.description("Submit a memory to AGENTRUSH.")
-	.addHelpText(
-		"after",
-		'\nExamples:\n  $ mem0 agent-rush add "I used mem0 to build a coding agent"\n  $ mem0 agent-rush add "Agents that remember are better agents"',
-	)
-	.action(async (parts: string[]) => {
-		const { cmdAgentRushAdd } = await import("./commands/agent-rush.js");
-		await cmdAgentRushAdd(parts.join(" "));
-	});
-
-agentRush
-	.command("search <query...>")
-	.description("Search AGENTRUSH memories.")
-	.addHelpText(
-		"after",
-		'\nExamples:\n  $ mem0 agent-rush search "agents and memory and tools"\n  $ mem0 agent-rush search "coding assistant"',
-	)
-	.action(async (parts: string[]) => {
-		const { cmdAgentRushSearch } = await import("./commands/agent-rush.js");
-		await cmdAgentRushSearch(parts.join(" "));
-	});
-
 // ── Memory: add ───────────────────────────────────────────────────────────

 program
@@ -320,25 +223,7 @@ program
 	.option("--immutable", "Prevent future updates.", false)
 	.option("--no-infer", "Skip inference, store raw.")
 	.option("--expires <date>", "Expiration date (YYYY-MM-DD).")
-	.option(
-		"--categories <value>",
-		"Not supported on add, use --custom-categories instead.",
-	)
-	.option(
-		"--custom-instructions <text>",
-		"Custom instructions for fact extraction.",
-	)
-	.option(
-		"--custom-categories <json>",
-		"Custom categories as a JSON array of {name: description} objects.",
-	)
-	.option(
-		"--structured-data-schema <json>",
-		"Schema for structured data extraction, as JSON.",
-	)
-	.option("--timestamp <unix>", "Unix timestamp for the memory.", (v) =>
-		Number.parseInt(v),
-	)
+	.option("--categories <value>", "Categories (JSON array or comma-separated).")
 	.option("-o, --output <format>", "Output format: text, json, quiet.", "text")
 	.option("--api-key <key>", "Override API key.")
 	.option("--base-url <url>", "Override API base URL.")
@@ -385,16 +270,6 @@ program
 	.option("--keyword", "Use keyword search.", false)
 	.option("--filter <json>", "Advanced filter expression (JSON).")
 	.option("--fields <list>", "Specific fields to return (comma-separated).")
-	.option("--show-expired", "Include expired memories.", false)
-	.option(
-		"--reference-date <date>",
-		"Reference date for relative queries (YYYY-MM-DD or unix timestamp).",
-	)
-	.option(
-		"--latest-only",
-		"Only return the latest version of each memory.",
-		false,
-	)
 	.option("-o, --output <format>", "Output: text, json, table.", "text")
 	.option("--api-key <key>", "Override API key.")
 	.option("--base-url <url>", "Override API base URL.")
@@ -404,7 +279,7 @@ program
 	)
 	.action(async (query, opts) => {
 		let resolvedQuery = query;
-		if (!resolvedQuery && stdinIsPiped()) {
+		if (!resolvedQuery && !process.stdin.isTTY) {
 			resolvedQuery = fs.readFileSync(0, "utf-8").trim();
 		}
 		if (!resolvedQuery) {
@@ -427,9 +302,6 @@ program
 			keyword: opts.keyword,
 			filterJson: opts.filter,
 			fields: opts.fields,
-			showExpired: opts.showExpired,
-			referenceDate: opts.referenceDate,
-			latestOnly: opts.latestOnly,
 			output,
 		});
 	});
@@ -473,12 +345,6 @@ program
 	.option("--category <name>", "Filter by category.")
 	.option("--after <date>", "Created after (YYYY-MM-DD).")
 	.option("--before <date>", "Created before (YYYY-MM-DD).")
-	.option("--show-expired", "Include expired memories.", false)
-	.option(
-		"--latest-only",
-		"Only return the latest version of each memory.",
-		false,
-	)
 	.option("-o, --output <format>", "Output: text, json, table.", "table")
 	.option("--api-key <key>", "Override API key.")
 	.option("--base-url <url>", "Override API base URL.")
@@ -502,8 +368,6 @@ program
 			category: opts.category,
 			after: opts.after,
 			before: opts.before,
-			showExpired: opts.showExpired,
-			latestOnly: opts.latestOnly,
 			output,
 		});
 	});
@@ -514,10 +378,6 @@ program
 	.command("update <memoryId> [text]")
 	.description("Update a memory's text or metadata.")
 	.option("-m, --metadata <json>", "Update metadata (JSON).")
-	.option("--expires <date>", "Expiration date (YYYY-MM-DD).")
-	.option("--timestamp <unix>", "Unix timestamp for the memory.", (v) =>
-		Number.parseInt(v),
-	)
 	.option("-o, --output <format>", "Output: text, json, quiet.", "text")
 	.option("--api-key <key>", "Override API key.")
 	.option("--base-url <url>", "Override API base URL.")
@@ -527,7 +387,7 @@ program
 	)
 	.action(async (memoryId, text, opts) => {
 		let resolvedText = text;
-		if (!resolvedText && stdinIsPiped()) {
+		if (!resolvedText && !opts.metadata && !process.stdin.isTTY) {
 			resolvedText = fs.readFileSync(0, "utf-8").trim();
 		}
 		const { cmdUpdate } = await import("./commands/memory.js");
@@ -536,8 +396,6 @@ program
 		const output = isAgent ? "agent" : opts.output;
 		await cmdUpdate(backend, memoryId, resolvedText, {
 			metadata: opts.metadata,
-			expires: opts.expires,
-			timestamp: opts.timestamp,
 			output,
 		});
 	});
@@ -556,11 +414,6 @@ program
 	.option("--project", "With --all: delete ALL memories project-wide.", false)
 	.option("--dry-run", "Show what would be deleted without deleting.", false)
 	.option("--force", "Skip confirmation.", false)
-	.option(
-		"--delete-linked",
-		"Also delete memories linked to this memory.",
-		false,
-	)
 	.option("-u, --user-id <id>", "Scope to user.")
 	.option("--agent-id <id>", "Scope to agent.")
 	.option("--app-id <id>", "Scope to app.")
@@ -614,7 +467,6 @@ program
 				output,
 				dryRun: opts.dryRun,
 				force: opts.force,
-				deleteLinked: opts.deleteLinked,
 			});
 			return;
 		}
@@ -858,8 +710,8 @@ program
 	.addHelpText("after", "\nExamples:\n  $ mem0 help\n  $ mem0 help --json")
 	.action((opts) => {
 		// opts.json is set when `mem0 help --json` is used (subcommand flag).
-		// program.opts().json/.agent is set when a root global flag was used first.
-		if (opts.json || program.opts().json || program.opts().agent) {
+		// program.opts().json is set when the root --json global flag was used first.
+		if (opts.json || program.opts().json) {
 			// Load spec from parent directory
 			const __dirname = path.dirname(fileURLToPath(import.meta.url));
 			const specPath = path.join(__dirname, "..", "..", "cli-spec.json");
@@ -917,16 +769,4 @@ program

 // ── Entrypoint ────────────────────────────────────────────────────────────

-// Surface any unclaimed Agent Mode notice once per command, after the primary
-// output. In JSON/agent mode the notice is folded into the envelope by
-// formatJsonEnvelope, so skip the stderr banner there to avoid duplication.
-function surfaceNotice(): void {
-	const notice = takeNotice();
-	if (notice && !isAgentMode()) {
-		process.stderr.write(`\n\x1b[33m🔔 ${notice}\x1b[0m\n\n`);
-	}
-}
-
-program.parseAsync().finally(() => {
-	surfaceNotice();
-});
+program.parse();
@@ -5,7 +5,6 @@
 import boxen from "boxen";
 import Table from "cli-table3";
 import { colors, sym } from "./branding.js";
-import { takeNotice } from "./state.js";

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

@@ -245,15 +244,6 @@ export function formatJsonEnvelope(opts: {
 	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));
 }

@@ -282,24 +272,11 @@ export function sanitizeAgentData(command: string, data: unknown): unknown {
 		}
 		case "search":
 			return (data as Record<string, unknown>[]).map((r) =>
-				pick(r, [
-					"id",
-					"memory",
-					"score",
-					"created_at",
-					"categories",
-					"expiration_date",
-				]),
+				pick(r, ["id", "memory", "score", "created_at", "categories"]),
 			);
 		case "list":
 			return (data as Record<string, unknown>[]).map((r) =>
-				pick(r, [
-					"id",
-					"memory",
-					"created_at",
-					"categories",
-					"expiration_date",
-				]),
+				pick(r, ["id", "memory", "created_at", "categories"]),
 			);
 		case "get": {
 			const r = data as Record<string, unknown>;
@@ -310,12 +287,11 @@ export function sanitizeAgentData(command: string, data: unknown): unknown {
 				"updated_at",
 				"categories",
 				"metadata",
-				"expiration_date",
 			]);
 		}
 		case "update": {
 			const r = data as Record<string, unknown>;
-			return pick(r, ["id", "memory", "expiration_date"]);
+			return pick(r, ["id", "memory"]);
 		}
 		case "delete":
 		case "delete-all":
@@ -380,12 +356,6 @@ export function formatAgentEnvelope(opts: {
 	}
 	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));
 }

@@ -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;
-	}
-}
@@ -3,11 +3,8 @@
 * read by commands and branding functions.
 */

-import fs from "node:fs";
-
 let _agentMode = false;
 let _currentCommand = "";
-let _pendingNotice = "";

 export function isAgentMode(): boolean {
 	return _agentMode;
@@ -24,30 +21,3 @@ export function getCurrentCommand(): string {
 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;
-	}
-}
@@ -115,9 +115,6 @@ export function captureEvent(
 			}
 		}

-		// 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,
@@ -126,7 +123,6 @@ export function captureEvent(
 				source: "CLI",
 				language: "node",
 				cli_version: CLI_VERSION,
-				agent_mode: Boolean(config.platform.agentMode),
 				node_version: process.version,
 				os: process.platform,
 				...properties,
@@ -145,11 +141,11 @@ export function captureEvent(
 			anonDistinctIdToAlias: anonIdToAlias,
 		};

-		const child = spawn(process.execPath, [SENDER_SCRIPT], {
-			detached: true,
-			stdio: ["pipe", "ignore", "ignore"],
-		});
-		child.stdin?.end(JSON.stringify(context));
+		const child = spawn(
+			process.execPath,
+			[SENDER_SCRIPT, JSON.stringify(context)],
+			{ detached: true, stdio: "ignore" },
+		);
 		child.unref();
 	} catch {
 		/* silently swallow */
@@ -1,8 +1,7 @@
 /**
 * 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)
+ * Usage: node telemetry-sender.cjs '<json context>'
 *
 * This script is spawned by telemetry.captureEvent() and runs independently
 * of the parent CLI process. It:
@@ -20,31 +19,6 @@
 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);
@@ -134,7 +108,7 @@ async function sendIdentifyEvent(ctx, payload, anonId) {
 }

 async function main() {
-	const ctx = await loadContext();
+	const ctx = JSON.parse(process.argv[2]);
 	const payload = ctx.payload;

 	if (ctx.needsEmail && ctx.mem0ApiKey) {
@@ -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");
-  });
-});
@@ -44,25 +44,15 @@ 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("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.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("shows add help", () => {
    const result = run(["add", "--help"]);
    expect(result.exitCode).toBe(0);
@@ -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,163 +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"],
-	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);
-			}
-		});
-	}
-});
@@ -1,237 +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.",
-			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.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("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/",
-		]);
-	});
-});
@@ -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);
-  });
-});
@@ -8,10 +8,4 @@ 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,
-	},
 });
@@ -241,6 +241,14 @@ Verify your API connection and display the current project.
 mem0 status
 ```

+### `mem0 version`
+
+Print the CLI version.
+
+```bash
+mem0 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:
@@ -299,8 +307,6 @@ These flags are available on all commands:
 | `--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 |
@@ -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.2.4"
 description = "The official CLI for mem0 — the memory layer for AI agents"
 readme = "README.md"
 license = "Apache-2.0"
@@ -1,3 +1,3 @@
 """mem0 CLI — the command-line interface for the mem0 memory layer."""

-__version__ = "0.2.11"
+__version__ = "0.2.4"
@@ -1,36 +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 None. The list is curated, not exhaustive — env
-vars we don't recognise fall through to None (caller treated as
-non-agent). Honest reporting depends on ``--agent-caller``; this list is
-just enough to enable the zero-friction auto-bootstrap UX.
-"""
-
-from __future__ import annotations
-
-import os
-
-_AGENT_CALLER_ENV: tuple[tuple[str, tuple[str, ...]], ...] = (
-    ("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",)),
-)
-
-
-def detect_agent_caller() -> str | None:
-    """Return a canonical agent name if any agent env var is set, else None."""
-    for name, env_vars in _AGENT_CALLER_ENV:
-        if any(os.environ.get(v) for v in env_vars):
-            return name
-    return None
@@ -237,14 +237,6 @@ def main_callback(
        cmd_version()
        raise typer.Exit()
    if ctx.invoked_subcommand:
-        # Stash the active subcommand name so the JSON error envelope
-        # (print_error in agent mode) can report which command failed
-        # instead of an empty `"command": ""` field.
-        from mem0_cli.state import set_current_command
-
-        set_current_command(ctx.invoked_subcommand)
-    if ctx.invoked_subcommand and ctx.invoked_subcommand != "init":
-        # init fires its own telemetry from init_cmd.run_init with full M1-M6 props.
        _fire_telemetry(ctx.invoked_subcommand)


@@ -273,21 +265,7 @@ def add(
    no_infer: bool = typer.Option(False, "--no-infer", help="Skip inference, store raw."),
    expires: str | None = typer.Option(None, "--expires", help="Expiration date (YYYY-MM-DD)."),
    categories: str | None = typer.Option(
-        None, "--categories", help="Not supported on add, use --custom-categories instead."
-    ),
-    custom_instructions: str | None = typer.Option(
-        None, "--custom-instructions", help="Custom instructions for fact extraction."
-    ),
-    custom_categories: str | None = typer.Option(
-        None,
-        "--custom-categories",
-        help="Custom categories as a JSON array of {name: description} objects.",
-    ),
-    structured_data_schema: str | None = typer.Option(
-        None, "--structured-data-schema", help="Schema for structured data extraction, as JSON."
-    ),
-    timestamp: int | None = typer.Option(
-        None, "--timestamp", help="Unix timestamp for the memory."
+        None, "--categories", help="Categories (JSON array or comma-separated)."
    ),
    output: str = typer.Option(
        "text", "--output", "-o", help="Output format: text, json, quiet.", rich_help_panel="Output"
@@ -326,10 +304,6 @@ def add(
        no_infer=no_infer,
        expires=expires,
        categories=categories,
-        custom_instructions=custom_instructions,
-        custom_categories=custom_categories,
-        structured_data_schema=structured_data_schema,
-        timestamp=timestamp,
        output=output,
    )

@@ -373,21 +347,6 @@ def search(
        help="Specific fields to return (comma-separated).",
        rich_help_panel="Search",
    ),
-    show_expired: bool = typer.Option(
-        False, "--show-expired", help="Include expired memories.", rich_help_panel="Search"
-    ),
-    reference_date: str | None = typer.Option(
-        None,
-        "--reference-date",
-        help="Reference date for relative queries (YYYY-MM-DD or unix timestamp).",
-        rich_help_panel="Search",
-    ),
-    latest_only: bool = typer.Option(
-        False,
-        "--latest-only",
-        help="Only return the latest version of each memory.",
-        rich_help_panel="Search",
-    ),
    output: str = typer.Option(
        "text", "--output", "-o", help="Output: text, json, table.", rich_help_panel="Output"
    ),
@@ -431,9 +390,6 @@ def search(
        keyword=keyword,
        filter_json=filter_json,
        fields=fields,
-        show_expired=show_expired,
-        reference_date=reference_date,
-        latest_only=latest_only,
        output=output,
    )

@@ -500,15 +456,6 @@ def list_cmd(
    before: str | None = typer.Option(
        None, "--before", help="Created before (YYYY-MM-DD).", rich_help_panel="Filters"
    ),
-    show_expired: bool = typer.Option(
-        False, "--show-expired", help="Include expired memories.", rich_help_panel="Filters"
-    ),
-    latest_only: bool = typer.Option(
-        False,
-        "--latest-only",
-        help="Only return the latest version of each memory.",
-        rich_help_panel="Filters",
-    ),
    output: str = typer.Option(
        "table", "--output", "-o", help="Output: text, json, table.", rich_help_panel="Output"
    ),
@@ -542,8 +489,6 @@ def list_cmd(
        category=category,
        after=after,
        before=before,
-        show_expired=show_expired,
-        latest_only=latest_only,
        output=output,
    )

@@ -556,10 +501,6 @@ def update(
    memory_id: str = typer.Argument(..., help="Memory ID to update."),
    text: str | None = typer.Argument(None, help="New memory text."),
    metadata: str | None = typer.Option(None, "--metadata", "-m", help="Update metadata (JSON)."),
-    expires: str | None = typer.Option(None, "--expires", help="Expiration date (YYYY-MM-DD)."),
-    timestamp: int | None = typer.Option(
-        None, "--timestamp", help="Unix timestamp for the memory."
-    ),
    output: str = typer.Option(
        "text", "--output", "-o", help="Output: text, json, quiet.", rich_help_panel="Output"
    ),
@@ -588,15 +529,7 @@ def update(
        text = _read_stdin()

    backend = _get_backend(api_key, base_url)
-    cmd_update(
-        backend,
-        memory_id,
-        text,
-        metadata=metadata,
-        expires=expires,
-        timestamp=timestamp,
-        output=output,
-    )
+    cmd_update(backend, memory_id, text, metadata=metadata, output=output)


 # ── Memory: delete ────────────────────────────────────────────────────────
@@ -618,9 +551,6 @@ def delete(
        False, "--dry-run", help="Show what would be deleted without deleting."
    ),
    force: bool = typer.Option(False, "--force", help="Skip confirmation."),
-    delete_linked: bool = typer.Option(
-        False, "--delete-linked", help="Also delete memories linked to this memory."
-    ),
    user_id: str | None = typer.Option(
        None, "--user-id", "-u", help="Scope to user.", rich_help_panel="Scope"
    ),
@@ -678,14 +608,7 @@ def delete(
        from mem0_cli.commands.memory import cmd_delete

        backend = _get_backend(api_key, base_url)
-        cmd_delete(
-            backend,
-            memory_id,
-            dry_run=dry_run,
-            force=force,
-            delete_linked=delete_linked,
-            output=output,
-        )
+        cmd_delete(backend, memory_id, dry_run=dry_run, force=force, output=output)

    elif all_:
        _fire_telemetry("delete", {"delete_mode": "all"})
@@ -928,19 +851,6 @@ def init(
    force: bool = typer.Option(
        False, "--force", help="Overwrite existing config without confirmation."
    ),
-    agent_signal: bool = typer.Option(
-        False, "--agent", help="Bootstrap an unattended Agent Mode account (no email required)."
-    ),
-    source: str | None = typer.Option(
-        None,
-        "--source",
-        help="Channel attribution for signup (e.g. github, hn, ph).",
-    ),
-    agent_caller: str | None = typer.Option(
-        None,
-        "--agent-caller",
-        help="Self-declared agent identity (e.g. claude-code, cursor). Used with --agent to attribute Agent Mode signups.",
-    ),
 ) -> None:
    """Interactive setup wizard for mem0 CLI.

@@ -949,97 +859,10 @@ def init(
      mem0 init --api-key m0-xxx --user-id alice
      mem0 init --email alice@company.com
      mem0 init --email alice@company.com --code 482901
-      mem0 init --agent --agent-caller claude-code   # AI agent self-identifies on Agent Mode bootstrap
-      mem0 init --email alice@company.com  # Claims an existing Agent Mode key when one is present
    """
    from mem0_cli.commands.init_cmd import run_init

-    run_init(
-        api_key=api_key,
-        user_id=user_id,
-        email=email,
-        code=code,
-        force=force,
-        source=source,
-        agent=agent_signal,
-        agent_caller=agent_caller,
-    )
-
-
-@app.command(rich_help_panel="Setup")
-def identify(
-    name: str = typer.Argument(..., help="Agent identity (e.g. claude-code, cursor, my-bot)."),
-) -> None:
-    """Tag your active Agent Mode key with the AI agent that's using it.
-
-    Run this once after `mem0 init --agent` if you didn't pass --agent-caller.
-    Idempotent — re-running just overwrites the value.
-
-    Example:
-      mem0 identify claude-code
-    """
-    from mem0_cli.commands.identify_cmd import run_identify
-
-    run_identify(name)
-
-
-@app.command(name="whoami", rich_help_panel="Setup")
-def whoami_cmd() -> None:
-    """Print your AGENTRUSH identifier (default_user_id).
-
-    Example:
-      mem0 whoami
-    """
-    from mem0_cli.commands.whoami_cmd import run_whoami
-
-    run_whoami()
-
-
-# ── AGENTRUSH sub-app ─────────────────────────────────────────────────────
-
-agent_rush_app = typer.Typer(
-    name="agent-rush",
-    help="AGENTRUSH game commands",
-    no_args_is_help=True,
-    rich_markup_mode="rich",
-)
-
-
-@agent_rush_app.callback(invoke_without_command=True)
-def _agent_rush_callback(ctx: typer.Context) -> None:
-    if ctx.invoked_subcommand:
-        _fire_telemetry(f"agent-rush.{ctx.invoked_subcommand}")
-
-
-@agent_rush_app.command(name="add")
-def agent_rush_add(
-    content: str = typer.Argument(..., help="Memory content (50-1000 characters, no URLs)."),
-) -> None:
-    """Submit a memory to AGENTRUSH.
-
-    Example:
-      mem0 agent-rush add "I enjoy solving constraint-satisfaction problems."
-    """
-    from mem0_cli.commands.agent_rush_cmd import run_agent_rush_add
-
-    run_agent_rush_add(content)
-
-
-@agent_rush_app.command(name="search")
-def agent_rush_search(
-    query: str = typer.Argument(..., help="Search query."),
-) -> None:
-    """Search AGENTRUSH memories.
-
-    Example:
-      mem0 agent-rush search "constraint satisfaction"
-    """
-    from mem0_cli.commands.agent_rush_cmd import run_agent_rush_search
-
-    run_agent_rush_search(query)
-
-
-app.add_typer(agent_rush_app, name="agent-rush", rich_help_panel="Setup")
+    run_init(api_key=api_key, user_id=user_id, email=email, code=code, force=force)


 # (entity_app registered at module level, below sub-group definitions)
@@ -1137,11 +960,7 @@ def _build_help_json() -> dict:
                "--immutable": "Prevent future updates.",
                "--no-infer": "Skip inference, store raw.",
                "--expires": "Expiration date (YYYY-MM-DD).",
-                "--categories": "Not supported on add, use --custom-categories instead.",
-                "--custom-instructions": "Custom instructions for fact extraction.",
-                "--custom-categories": "Custom categories as a JSON array of {name: description} objects.",
-                "--structured-data-schema": "Schema for structured data extraction, as JSON.",
-                "--timestamp": "Unix timestamp for the memory.",
+                "--categories": "Categories (JSON array or comma-separated).",
                "--graph": "Enable graph memory extraction.",
                "--no-graph": "Disable graph memory extraction.",
                "--output, -o": "Output format: text, json, quiet.",
@@ -1160,9 +979,6 @@ def _build_help_json() -> dict:
                "--keyword": "Use keyword search instead of semantic.",
                "--filter": "Advanced filter expression (JSON).",
                "--fields": "Specific fields to return (comma-separated).",
-                "--show-expired": "Include expired memories.",
-                "--reference-date": "Reference date for relative queries (YYYY-MM-DD or unix timestamp).",
-                "--latest-only": "Only return the latest version of each memory.",
                "--graph": "Enable graph in search.",
                "--no-graph": "Disable graph in search.",
                "--output, -o": "Output format: text, json, table.",
@@ -1186,8 +1002,6 @@ def _build_help_json() -> dict:
                "--category": "Filter by category.",
                "--after": "Created after (YYYY-MM-DD).",
                "--before": "Created before (YYYY-MM-DD).",
-                "--show-expired": "Include expired memories.",
-                "--latest-only": "Only return the latest version of each memory.",
                "--graph": "Enable graph in listing.",
                "--no-graph": "Disable graph in listing.",
                "--output, -o": "Output format: text, json, table.",
@@ -1202,8 +1016,6 @@ def _build_help_json() -> dict:
            },
            "options": {
                "--metadata, -m": "Update metadata (JSON).",
-                "--expires": "Expiration date (YYYY-MM-DD).",
-                "--timestamp": "Unix timestamp for the memory.",
                "--output, -o": "Output format: text, json, quiet.",
            },
        },
@@ -1220,7 +1032,6 @@ def _build_help_json() -> dict:
                "--all": "Delete all memories matching scope filters.",
                "--entity": "Delete the entity itself and all its memories (cascade).",
                "--project": "With --all: delete ALL memories project-wide.",
-                "--delete-linked": "Also delete memories linked to this memory.",
                "--dry-run": "Show what would be deleted without deleting.",
                "--force": "Skip confirmation.",
                "--user-id, -u": "Scope to user.",
@@ -1350,10 +1161,8 @@ def help(
      mem0 help
      mem0 help --json
    """
-    from mem0_cli.state import is_agent_mode
-
-    if json or is_agent_mode():
-        console.print_json(_json.dumps(_build_help_json()))
+    if json:
+        console.print(_json.dumps(_build_help_json(), indent=2))
    else:
        console.print(
            f"[{BRAND_COLOR}]◆ mem0 CLI[/] v{__version__} — The Memory Layer for AI Agents\n"
@@ -1389,28 +1198,11 @@ def main() -> None:
    import sys

    # Allow --json/--agent anywhere in the command line (not just before subcommand).
-    # Special case: `mem0 init --agent` is a subcommand flag (Agent Mode bootstrap)
-    # consumed by init_cmd, not a global JSON-output toggle — leave it in argv.
-    argv_rest = sys.argv[1:]
-    is_init = "init" in argv_rest
-    _global_flags = {"--json"} if is_init else {"--json", "--agent"}
-    if any(a in _global_flags for a in argv_rest):
+    _json_flags = {"--json", "--agent"}
+    if any(a in _json_flags for a in sys.argv[1:]):
        from mem0_cli.state import set_agent_mode

        set_agent_mode(True)
-        sys.argv = [sys.argv[0]] + [a for a in argv_rest if a not in _global_flags]
+        sys.argv = [sys.argv[0]] + [a for a in sys.argv[1:] if a not in _json_flags]

-    try:
-        app()
-    finally:
-        # Surface any unclaimed Agent Mode notice once per command, after the
-        # primary output. In JSON/agent mode the notice is folded into the
-        # envelope by format_json_envelope, so skip the stderr banner there
-        # to avoid duplicate output.
-        from mem0_cli.state import is_agent_mode, take_notice
-
-        notice = take_notice()
-        if notice and not is_agent_mode():
-            from rich.console import Console
-
-            Console(stderr=True).print(f"\n[yellow]🔔 {notice}[/yellow]\n")
+    app()
@@ -25,10 +25,7 @@ class Backend(ABC):
        immutable: bool = False,
        infer: bool = True,
        expires: str | None = None,
-        custom_instructions: str | None = None,
-        custom_categories: list[dict] | None = None,
-        structured_data_schema: dict | None = None,
-        timestamp: int | None = None,
+        categories: list[str] | None = None,
    ) -> dict: ...

    @abstractmethod
@@ -46,9 +43,6 @@ class Backend(ABC):
        keyword: bool = False,
        filters: dict | None = None,
        fields: list[str] | None = None,
-        show_expired: bool = False,
-        reference_date: str | None = None,
-        latest_only: bool = False,
    ) -> list[dict]: ...

    @abstractmethod
@@ -67,19 +61,11 @@ class Backend(ABC):
        category: str | None = None,
        after: str | None = None,
        before: str | None = None,
-        show_expired: bool = False,
-        latest_only: bool = False,
    ) -> list[dict]: ...

    @abstractmethod
    def update(
-        self,
-        memory_id: str,
-        content: str | None = None,
-        metadata: dict | None = None,
-        *,
-        expiration_date: str | None = None,
-        timestamp: int | None = None,
+        self, memory_id: str, content: str | None = None, metadata: dict | None = None
    ) -> dict: ...

    @abstractmethod
@@ -92,7 +78,6 @@ class Backend(ABC):
        agent_id: str | None = None,
        app_id: str | None = None,
        run_id: str | None = None,
-        delete_linked: bool = False,
    ) -> dict: ...

    @abstractmethod
@@ -3,7 +3,6 @@
 from __future__ import annotations

 from typing import Any
-from urllib.parse import quote

 import httpx

@@ -12,10 +11,6 @@ from mem0_cli.backend.base import Backend
 from mem0_cli.config import PlatformConfig


-def _encode_path_segment(value: Any) -> str:
-    return quote(str(value), safe="")
-
-
 class PlatformBackend(Backend):
    """Backend that talks to the mem0 Platform API."""

@@ -35,7 +30,7 @@ class PlatformBackend(Backend):
        )

    def _request(self, method: str, path: str, **kwargs: Any) -> Any:
-        from mem0_cli.state import capture_notice, is_agent_mode
+        from mem0_cli.state import is_agent_mode

        self._client.headers["X-Mem0-Caller-Type"] = "agent" if is_agent_mode() else "user"
        resp = self._client.request(method, path, **kwargs)
@@ -53,26 +48,7 @@ class PlatformBackend(Backend):
        resp.raise_for_status()
        if resp.status_code == 204:
            return {}
-        data = resp.json()
-
-        # Pull the unclaimed-Agent-Mode notice out of the body (or the header
-        # fallback for endpoints that return non-dict / non-dict-leading
-        # payloads) and stash it for end-of-command surfacing.
-        notice = None
-        if isinstance(data, dict) and "mem0_notice" in data:
-            notice = data.pop("mem0_notice")
-        elif (
-            isinstance(data, list)
-            and data
-            and isinstance(data[0], dict)
-            and "mem0_notice" in data[0]
-        ):
-            notice = data[0].pop("mem0_notice")
-        if notice is None:
-            notice = resp.headers.get("X-Mem0-Notice-Message") or None
-        capture_notice(notice)
-
-        return data
+        return resp.json()

    def add(
        self,
@@ -87,10 +63,7 @@ class PlatformBackend(Backend):
        immutable: bool = False,
        infer: bool = True,
        expires: str | None = None,
-        custom_instructions: str | None = None,
-        custom_categories: list[dict] | None = None,
-        structured_data_schema: dict | None = None,
-        timestamp: int | None = None,
+        categories: list[str] | None = None,
    ) -> dict:
        payload: dict[str, Any] = {}

@@ -115,14 +88,8 @@ class PlatformBackend(Backend):
            payload["infer"] = False
        if expires:
            payload["expiration_date"] = expires
-        if custom_instructions:
-            payload["custom_instructions"] = custom_instructions
-        if custom_categories:
-            payload["custom_categories"] = custom_categories
-        if structured_data_schema:
-            payload["structured_data_schema"] = structured_data_schema
-        if timestamp is not None:
-            payload["timestamp"] = timestamp
+        if categories:
+            payload["categories"] = categories
        payload["source"] = "CLI"

        return self._request("POST", "/v3/memories/add/", json=payload)
@@ -182,9 +149,6 @@ class PlatformBackend(Backend):
        keyword: bool = False,
        filters: dict | None = None,
        fields: list[str] | None = None,
-        show_expired: bool = False,
-        reference_date: str | None = None,
-        latest_only: bool = False,
    ) -> list[dict]:
        payload: dict[str, Any] = {"query": query, "top_k": top_k, "threshold": threshold}

@@ -203,12 +167,6 @@ class PlatformBackend(Backend):
            payload["keyword_search"] = True
        if fields:
            payload["fields"] = fields
-        if show_expired:
-            payload["show_expired"] = True
-        if reference_date is not None:
-            payload["reference_date"] = reference_date
-        if latest_only:
-            payload["latest_only"] = True
        payload["source"] = "CLI"

        result = self._request("POST", "/v3/memories/search/", json=payload)
@@ -219,11 +177,7 @@ class PlatformBackend(Backend):
        )

    def get(self, memory_id: str) -> dict:
-        return self._request(
-            "GET",
-            f"/v1/memories/{_encode_path_segment(memory_id)}/",
-            params={"source": "CLI"},
-        )
+        return self._request("GET", f"/v1/memories/{memory_id}/", params={"source": "CLI"})

    def list_memories(
        self,
@@ -237,8 +191,6 @@ class PlatformBackend(Backend):
        category: str | None = None,
        after: str | None = None,
        before: str | None = None,
-        show_expired: bool = False,
-        latest_only: bool = False,
    ) -> list[dict]:
        payload: dict[str, Any] = {}
        params = {"page": str(page), "page_size": str(page_size)}
@@ -261,10 +213,6 @@ class PlatformBackend(Backend):
        )
        if api_filters:
            payload["filters"] = api_filters
-        if show_expired:
-            payload["show_expired"] = True
-        if latest_only:
-            payload["latest_only"] = True
        payload["source"] = "CLI"

        result = self._request("POST", "/v3/memories/", json=payload, params=params)
@@ -275,29 +223,15 @@ class PlatformBackend(Backend):
        )

    def update(
-        self,
-        memory_id: str,
-        content: str | None = None,
-        metadata: dict | None = None,
-        *,
-        expiration_date: str | None = None,
-        timestamp: int | None = None,
+        self, memory_id: str, content: str | None = None, metadata: dict | None = None
    ) -> dict:
        payload: dict[str, Any] = {}
        if content:
            payload["text"] = content
        if metadata:
            payload["metadata"] = metadata
-        if expiration_date:
-            payload["expiration_date"] = expiration_date
-        if timestamp is not None:
-            payload["timestamp"] = timestamp
        payload["source"] = "CLI"
-        return self._request(
-            "PUT",
-            f"/v1/memories/{_encode_path_segment(memory_id)}/",
-            json=payload,
-        )
+        return self._request("PUT", f"/v1/memories/{memory_id}/", json=payload)

    def delete(
        self,
@@ -308,7 +242,6 @@ class PlatformBackend(Backend):
        agent_id: str | None = None,
        app_id: str | None = None,
        run_id: str | None = None,
-        delete_linked: bool = False,
    ) -> dict:
        if all:
            params: dict[str, str] = {"source": "CLI"}
@@ -322,14 +255,7 @@ class PlatformBackend(Backend):
                params["run_id"] = run_id
            return self._request("DELETE", "/v1/memories/", params=params)
        elif memory_id:
-            params = {"source": "CLI"}
-            if delete_linked:
-                params["delete_linked"] = "true"
-            return self._request(
-                "DELETE",
-                f"/v1/memories/{_encode_path_segment(memory_id)}/",
-                params=params,
-            )
+            return self._request("DELETE", f"/v1/memories/{memory_id}/", params={"source": "CLI"})
        else:
            raise ValueError("Either memory_id or --all is required")

@@ -351,17 +277,13 @@ class PlatformBackend(Backend):
        entities = {t: v for t, v in type_map.items() if v}
        if not entities:
            raise ValueError("At least one entity ID is required for delete_entities.")
-        # 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.
-        results: dict = {}
+        # Delete each provided entity via the v2 path-based endpoint
+        result: dict = {}
        for entity_type, entity_id in entities.items():
-            results[entity_type] = self._request(
-                "DELETE",
-                f"/v2/entities/{_encode_path_segment(entity_type)}/{_encode_path_segment(entity_id)}/",
-                params={"source": "CLI"},
+            result = self._request(
+                "DELETE", f"/v2/entities/{entity_type}/{entity_id}/", params={"source": "CLI"}
            )
-        return results
+        return result

    def ping(self, timeout: float | None = None) -> dict:
        """Call the ping endpoint and return the raw response.
@@ -405,7 +327,7 @@ class PlatformBackend(Backend):
        return result if isinstance(result, list) else result.get("results", [])

    def get_event(self, event_id: str) -> dict:
-        return self._request("GET", f"/v1/event/{_encode_path_segment(event_id)}/")
+        return self._request("GET", f"/v1/event/{event_id}/")


 class AuthError(Exception):
@@ -87,12 +87,10 @@ def print_error(console: Console, message: str, hint: str | None = None) -> None
        }
        print(_json.dumps(envelope))
        return
-    from rich.markup import escape
-
    sym = _sym("✗", "[error]")
-    console.print(f"[{ERROR_COLOR}]{sym} Error:[/] {escape(str(message))}")
+    console.print(f"[{ERROR_COLOR}]{sym} Error:[/] {message}")
    if hint:
-        console.print(f"  [{DIM_COLOR}]{escape(str(hint))}[/]")
+        console.print(f"  [{DIM_COLOR}]{hint}[/]")


 def print_warning(console: Console, message: str) -> None:
@@ -1,239 +0,0 @@
-"""Agent Mode commands — bootstrap (unattended signup) and claim (OTP-based human upgrade)."""
-
-from __future__ import annotations
-
-import json
-import sys
-from datetime import datetime, timezone
-from typing import Any
-
-import httpx
-import typer
-from rich.console import Console
-from rich.prompt import Prompt
-
-from mem0_cli.branding import (
-    BRAND_COLOR,
-    DIM_COLOR,
-    print_error,
-    print_success,
-)
-from mem0_cli.config import Mem0Config, save_config
-
-console = Console()
-err_console = Console(stderr=True)
-
-_SOURCE_HEADERS = {
-    "X-Mem0-Source": "cli",
-    "X-Mem0-Client-Language": "python",
-}
-
-
-def _validate_envelope(envelope: Any) -> None:
-    """Defend against partial/malformed backend responses.
-
-    A backend regression that returns ``{"api_key": null}`` would otherwise be
-    silently persisted, producing confusing downstream errors far from the
-    source. Fail fast with a clear message if the required fields are missing.
-    """
-    if not isinstance(envelope, dict):
-        print_error(err_console, "Bootstrap response was not a JSON object.")
-        raise typer.Exit(1)
-    for field in ("api_key", "default_user_id"):
-        value = envelope.get(field)
-        if not isinstance(value, str) or not value:
-            print_error(
-                err_console,
-                f"Bootstrap response missing required field {field!r} — please update the CLI.",
-            )
-            raise typer.Exit(1)
-
-
-def bootstrap_via_backend(
-    config: Mem0Config,
-    *,
-    source: str | None = None,
-    agent_caller: str | None = None,
-) -> None:
-    """POST /api/v1/auth/agent_mode/ and mutate config in place.
-
-    Args:
-        config: Mem0Config mutated in place with the new platform values.
-        source: ``--source`` flag passthrough (analytics tag, free-form).
-        agent_caller: Self-declared agent identity passed via ``--agent-caller``
-            (e.g. ``claude-code``, ``cursor``). May be None 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.agent_caller`` for local introspection.
-
-    Raises typer.Exit(1) on failure.
-    """
-    base_url = (config.platform.base_url or "https://api.mem0.ai").rstrip("/")
-    body: dict[str, Any] = {}
-    if source:
-        body["source"] = source
-    if agent_caller:
-        body["agent_caller"] = agent_caller
-
-    try:
-        with httpx.Client(timeout=30.0) as client:
-            resp = client.post(
-                f"{base_url}/api/v1/auth/agent_mode/",
-                headers={**_SOURCE_HEADERS, "Content-Type": "application/json"},
-                json=body,
-            )
-    except httpx.HTTPError as exc:
-        print_error(err_console, f"Network error contacting Mem0: {exc}")
-        raise typer.Exit(1) from exc
-
-    if resp.status_code == 429:
-        print_error(err_console, "Rate-limited. Try again in a few minutes.")
-        raise typer.Exit(1)
-    if resp.status_code == 503:
-        print_error(err_console, "Agent Mode is temporarily disabled. Try again later.")
-        raise typer.Exit(1)
-    if resp.status_code != 200:
-        detail = resp.text
-        try:
-            err_body = resp.json()
-            detail = err_body.get("error") or err_body.get("detail") or resp.text
-        except (json.JSONDecodeError, ValueError, AttributeError):
-            pass
-        # 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 as the rate-limit it actually is.
-        if resp.status_code == 403 and "permission" in str(detail).lower():
-            print_error(
-                err_console,
-                "Daily Agent Mode signup limit reached for this network (5/day). Try again from a different IP or after midnight UTC.",
-            )
-            raise typer.Exit(1)
-        print_error(err_console, f"Bootstrap failed: {detail}")
-        raise typer.Exit(1)
-
-    envelope = resp.json()
-    _validate_envelope(envelope)
-    config.platform.api_key = envelope["api_key"]
-    config.platform.base_url = base_url
-    config.platform.agent_mode = True
-    config.platform.created_via = "agent_mode"
-    config.platform.agent_caller = agent_caller or ""
-    config.platform.claimed_at = ""
-    config.platform.default_user_id = envelope["default_user_id"]
-    # Adopt the slug-derived user_id as the default scope for memory ops.
-    config.defaults.user_id = envelope["default_user_id"]
-    save_config(config)
-
-    print_success(console, f"Agent Mode active. Default user_id: {envelope['default_user_id']}")
-    notice = envelope.get("mem0_notice")
-    if notice:
-        console.print(f"\n[yellow]🔔 {notice}[/yellow]\n")
-    else:
-        # Fallback if the backend hasn't deployed the unified notice yet.
-        claim_cmd = envelope.get("claim_command", "mem0 init --email <your-email>")
-        console.print(f"  [{DIM_COLOR}]To claim this account later: {claim_cmd}[/]")
-
-    if not agent_caller:
-        console.print(
-            f"  [{DIM_COLOR}]If you are an AI agent, identify yourself: "
-            f"`mem0 identify <your-name>` (e.g. claude-code, cursor).[/]"
-        )
-
-
-def claim_via_otp(config: Mem0Config, *, email: str, code: str | None = None) -> None:
-    """Claim an existing Agent Mode account via OTP — no browser, no polling.
-
-    Reuses the standard email-code flow (`/api/v1/auth/email_code/` then
-    `/.../verify/`) and adds the local agent-mode API key in the verify body
-    as `agent_mode_api_key`. Backend's `verify_email_code` runs the
-    upgrade-in-place transaction inline and returns claim result.
-
-    On success: flips `platform.agent_mode=false`, sets `claimed_at`, stamps
-    `user_email`. The api_key value itself never changes.
-    """
-    base_url = (config.platform.base_url or "https://api.mem0.ai").rstrip("/")
-    if not config.platform.api_key or not config.platform.agent_mode:
-        print_error(
-            err_console,
-            "This command requires an active Agent Mode config. Run `mem0 init` first.",
-        )
-        raise typer.Exit(1)
-
-    raw_key = config.platform.api_key
-
-    with httpx.Client(timeout=30.0) as client:
-        # Step 1: request OTP (unless --code provided)
-        if not code:
-            send = client.post(
-                f"{base_url}/api/v1/auth/email_code/",
-                headers={**_SOURCE_HEADERS, "Content-Type": "application/json"},
-                json={"email": email},
-            )
-            if send.status_code == 429:
-                print_error(err_console, "Too many attempts. Try again in a few minutes.")
-                raise typer.Exit(1)
-            if send.status_code != 200:
-                try:
-                    detail = send.json().get("error", send.text)
-                except Exception:
-                    detail = send.text
-                print_error(err_console, f"Failed to send code: {detail}")
-                raise typer.Exit(1)
-
-            print_success(console, f"Verification code sent to {email}. Check your inbox.")
-
-            if not sys.stdin.isatty():
-                print_error(
-                    err_console,
-                    "No --code provided and terminal is non-interactive.",
-                    hint=f"Re-run: mem0 init --email {email} --code <code>",
-                )
-                raise typer.Exit(1)
-
-            console.print()
-            code = Prompt.ask(f"  [{BRAND_COLOR}]Verification Code[/]")
-            if not code:
-                print_error(err_console, "Code is required.")
-                raise typer.Exit(1)
-
-        # Step 2: verify + claim in one shot
-        verify = client.post(
-            f"{base_url}/api/v1/auth/email_code/verify/",
-            headers={**_SOURCE_HEADERS, "Content-Type": "application/json"},
-            json={
-                "email": email,
-                "code": code.strip(),
-                "agent_mode_api_key": raw_key,
-            },
-        )
-
-    if verify.status_code != 200:
-        try:
-            err_body = verify.json()
-            detail = err_body.get("error", verify.text)
-            code_str = err_body.get("code", "")
-        except (json.JSONDecodeError, ValueError, AttributeError):
-            detail = verify.text
-            code_str = ""
-        print_error(err_console, f"Claim failed: {detail}")
-        if code_str == "email_already_claimed":
-            console.print(
-                f"  [{DIM_COLOR}]Tip: this email already has a Mem0 account. Sign in at app.mem0.ai with your existing credentials.[/]"
-            )
-        raise typer.Exit(1)
-
-    claim_body = verify.json()
-    if not claim_body.get("claimed"):
-        print_error(err_console, f"Unexpected verify response: {claim_body}")
-        raise typer.Exit(1)
-
-    config.platform.agent_mode = False
-    config.platform.claimed_at = claim_body.get("claimed_at") or _utcnow_iso()
-    config.platform.user_email = email
-    config.platform.created_via = "email"
-    save_config(config)
-    print_success(console, f"Agent claimed to {email}. Your API key is unchanged.")
-
-
-def _utcnow_iso() -> str:
-    return datetime.now(timezone.utc).isoformat()
@@ -1,132 +0,0 @@
-"""mem0 agent-rush — AGENTRUSH game commands.
-
-Wraps the platform's /v1/agent-rush/{memories/, memories/search/} endpoints.
-Hardcoded routing; no flags needed.
-"""
-
-from __future__ import annotations
-
-import sys
-from datetime import datetime, timezone
-
-import httpx
-import typer
-from rich.console import Console
-
-from mem0_cli.branding import print_error, print_success
-from mem0_cli.config import load_config, save_config
-
-console = Console()
-err_console = Console(stderr=True)
-
-_PII_WARNING_LINES = (
-    "",
-    "[yellow]⚠️  AGENTRUSH memories are PUBLIC — visible to any other player.[/yellow]",
-    "[yellow]   Do not include real names, emails, secrets, work content, or PII.[/yellow]",
-    "",
-)
-
-_SOURCE_HEADERS = {
-    "X-Mem0-Source": "cli",
-    "X-Mem0-Client-Language": "python",
-    "X-Mem0-Mode": "agent-rush",
-}
-
-_ERROR_HINTS = {
-    "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.",
-}
-
-
-def _call(path: str, body: dict) -> dict:
-    config = load_config()
-    if not config.platform.api_key:
-        print_error(err_console, "Not initialized. Run `mem0 init --agent` first.")
-        raise typer.Exit(1)
-    base_url = (config.platform.base_url or "https://api.mem0.ai").rstrip("/")
-    try:
-        with httpx.Client(timeout=30.0) as client:
-            resp = client.post(
-                f"{base_url}{path}",
-                headers={
-                    **_SOURCE_HEADERS,
-                    "Authorization": f"Token {config.platform.api_key}",
-                    "Content-Type": "application/json",
-                },
-                json=body,
-            )
-    except httpx.HTTPError as exc:
-        print_error(err_console, f"Network error: {exc}")
-        raise typer.Exit(1) from exc
-    try:
-        data = resp.json()
-    except Exception:
-        data = {}
-    if resp.status_code >= 400:
-        code = (
-            (data.get("error") or {}).get("code", "unknown")
-            if isinstance(data, dict)
-            else "unknown"
-        )
-        print_error(err_console, f"AGENTRUSH error: {code}")
-        hint = _ERROR_HINTS.get(code)
-        if hint:
-            console.print(f"  [dim]{hint}[/dim]")
-        raise typer.Exit(1)
-    return data
-
-
-def _ensure_warning_acknowledged() -> None:
-    """Block the first interactive add on the PII warning; pass-through for agents.
-
-    Interactive (TTY): show prompt, require explicit 'y', persist
-    `agent_rush.acknowledged_at` so we never ask the same machine twice.
-
-    Non-interactive (no TTY — typical when an agent runs the CLI): surface
-    the warning to stderr for the human reading the agent transcript and
-    proceed without prompting (agents can't answer y/N).
-    """
-    config = load_config()
-    if config.agent_rush.acknowledged_at:
-        return
-
-    is_tty = sys.stdin.isatty() and sys.stdout.isatty()
-    if not is_tty:
-        for line in _PII_WARNING_LINES:
-            err_console.print(line)
-        return
-
-    for line in _PII_WARNING_LINES:
-        console.print(line)
-    answer = typer.prompt("   Continue? [y/N]", default="N", show_default=False).strip().lower()
-    if answer not in ("y", "yes"):
-        print_error(err_console, "Aborted.")
-        raise typer.Exit(1)
-
-    config.agent_rush.acknowledged_at = datetime.now(timezone.utc).isoformat()
-    save_config(config)
-
-
-def run_agent_rush_add(content: str) -> None:
-    _ensure_warning_acknowledged()
-    result = _call("/v1/agent-rush/memories/", {"content": content})
-    event_id = result.get("event_id", "?")
-    print_success(console, f"Memory submitted (event_id: {event_id})")
-
-
-def run_agent_rush_search(query: str) -> None:
-    result = _call("/v1/agent-rush/memories/search/", {"query": query})
-    memories = result.get("results") or result.get("memories") or []
-    if not memories:
-        console.print("[dim](no results)[/dim]")
-        return
-    for i, m in enumerate(memories[:5], start=1):
-        text = m.get("memory") if isinstance(m, dict) else str(m)
-        console.print(f"  {i}. {text}")
@@ -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 — running it again just
-overwrites.
-"""
-
-from __future__ import annotations
-
-import httpx
-import typer
-from rich.console import Console
-
-from mem0_cli.branding import print_error, print_success
-from mem0_cli.config import load_config, save_config
-
-console = Console()
-err_console = Console(stderr=True)
-
-_SOURCE_HEADERS = {
-    "X-Mem0-Source": "cli",
-    "X-Mem0-Client-Language": "python",
-}
-
-
-def run_identify(name: str) -> None:
-    """PATCH the active agent-mode key's agent_caller field."""
-    config = load_config()
-    if not config.platform.api_key:
-        print_error(
-            err_console,
-            "No API key configured. Run `mem0 init --agent` first.",
-        )
-        raise typer.Exit(1)
-    if not config.platform.agent_mode:
-        print_error(
-            err_console,
-            "This command only works on unclaimed agent-mode keys.",
-        )
-        raise typer.Exit(1)
-
-    name = (name or "").strip()
-    if not name:
-        print_error(err_console, "Agent name is required.")
-        raise typer.Exit(1)
-
-    base_url = (config.platform.base_url or "https://api.mem0.ai").rstrip("/")
-    try:
-        with httpx.Client(timeout=30.0) as client:
-            resp = client.patch(
-                f"{base_url}/api/v1/auth/agent_mode/caller/",
-                headers={
-                    **_SOURCE_HEADERS,
-                    "Authorization": f"Token {config.platform.api_key}",
-                    "Content-Type": "application/json",
-                },
-                json={"agent_caller": name},
-            )
-    except httpx.HTTPError as exc:
-        print_error(err_console, f"Network error: {exc}")
-        raise typer.Exit(1) from exc
-
-    if resp.status_code != 200:
-        try:
-            detail = resp.json().get("error", resp.text)
-        except Exception:
-            detail = resp.text
-        print_error(err_console, f"Identify failed: {detail}")
-        raise typer.Exit(1)
-
-    canonical = resp.json().get("agent_caller", name)
-    config.platform.agent_caller = canonical
-    save_config(config)
-    print_success(console, f"Identified as {canonical}.")
@@ -103,25 +103,6 @@ def _validate_email(email: str) -> None:
        raise typer.Exit(1)


-def _ping_key(api_key: str, base_url: str, timeout: float = 5.0) -> bool:
-    """Validate api_key against /v1/ping/.
-
-    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:
-        resp = httpx.get(
-            f"{base_url.rstrip('/')}/v1/ping/",
-            headers={"Authorization": f"Token {api_key}"},
-            timeout=timeout,
-        )
-    except httpx.HTTPError:
-        return True  # unknown — prefer reuse
-    return resp.status_code not in (401, 403)
-
-
 def _email_login(
    email: str,
    code: str | None,
@@ -201,143 +182,21 @@ def run_init(
    email: str | None = None,
    code: str | None = None,
    force: bool = False,
-    source: str | None = None,
-    agent: bool = False,
-    agent_caller: str | None = None,
 ) -> None:
    """Interactive setup wizard for mem0 CLI.

    When both *api_key* and *user_id* are supplied, all prompts are skipped
    (non-interactive mode).  When running in a non-TTY without the required
    flags, an error message is printed.
-
-    Agent Mode dispatch (no email/api-key flags):
-      - If existing config has an active API key → reuse (existing_key path).
-      - Else if any positive agent signal (--agent, --json global, agent env
-        var, or `agent` flag) → POST /api/v1/auth/agent_mode/ and write config.
-      - Else fall through to the interactive wizard.
-
-    Claim dispatch:
-      - If `--email` is set AND existing config has `agent_mode=true`, run the
-        claim device-flow against the existing key instead of minting a new
-        email-based key.
    """
-    from mem0_cli.agent_detect import detect_agent_caller
-    from mem0_cli.commands.agent_mode_cmd import bootstrap_via_backend, claim_via_otp
-    from mem0_cli.state import is_agent_mode as _global_agent_mode
-    from mem0_cli.telemetry import capture_event
-
-    def _fire_init(mode: str, *, claimed: bool = False) -> None:
-        """Fire cli.init telemetry with M1-M6 properties."""
-        props: dict = {"command": "init", "mode": mode}
-        if agent_caller:
-            # Self-declared via --agent-caller; not sniffed from env vars.
-            props["agent_caller"] = agent_caller
-        if source:
-            props["signup_source"] = source
-        if claimed:
-            props["claimed_agent_mode"] = True
-        capture_event("cli.init", props)
-
    config = Mem0Config()

    base_url = os.environ.get("MEM0_BASE_URL", config.platform.base_url or DEFAULT_BASE_URL)
-    config.platform.base_url = base_url

    if code and not email:
        print_error(err_console, "--code requires --email.")
        raise typer.Exit(1)

-    # ── Email + existing agent-mode config → claim flow ─────────────────
-    if email and CONFIG_FILE.exists():
-        existing = load_config()
-        if existing.platform.agent_mode and existing.platform.api_key:
-            email = email.strip().lower()
-            _validate_email(email)
-            print_info(console, f"Claiming Agent Mode account to {email}...")
-            claim_via_otp(existing, email=email, code=code)
-            _fire_init("email", claimed=True)
-            return
-
-    # ── Agent Mode path runs BEFORE the existing-config guard ──────────
-    # Rules 1/2 REUSE a valid existing key (not overwrite), so we must
-    # short-circuit before the guard prompts. Rule 3 mints only when there
-    # is no valid key to reuse — in that case overwriting is correct.
-    _agent_ctx = agent or _global_agent_mode() or (detect_agent_caller() is not None)
-    if not api_key and not email and _agent_ctx:
-        from mem0_cli.output import format_json_envelope
-        from mem0_cli.state import is_agent_mode as _is_json_mode
-
-        def _emit_reuse(source: str) -> None:
-            if _is_json_mode():
-                format_json_envelope(
-                    console,
-                    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:
-                msg = (
-                    "Existing MEM0_API_KEY is valid; reusing it. No new Agent Mode key was minted."
-                    if source == "env"
-                    else "Existing API key in config is valid; reusing it. No new Agent Mode key was minted."
-                )
-                print_success(console, msg)
-
-        def _maybe_identify(key: str) -> None:
-            """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 not agent_caller:
-                return
-            try:
-                resp = httpx.patch(
-                    f"{base_url.rstrip('/')}/api/v1/auth/agent_mode/caller/",
-                    headers={
-                        "Authorization": f"Token {key}",
-                        "Content-Type": "application/json",
-                    },
-                    json={"agent_caller": agent_caller},
-                    timeout=10.0,
-                )
-                # Also reflect in local config so introspection matches backend.
-                if resp.status_code == 200 and CONFIG_FILE.exists():
-                    try:
-                        cfg = load_config()
-                        cfg.platform.agent_caller = resp.json().get("agent_caller", agent_caller)
-                        save_config(cfg)
-                    except Exception:
-                        pass
-            except httpx.HTTPError:
-                pass
-
-        # Rule 1: env MEM0_API_KEY valid → reuse, no new key.
-        _env_key = (os.environ.get("MEM0_API_KEY") or "").strip()
-        if _env_key and _ping_key(_env_key, base_url):
-            _maybe_identify(_env_key)
-            _emit_reuse("env")
-            _fire_init("existing_key")
-            return
-        # Rule 2: existing config api_key valid → reuse.
-        if CONFIG_FILE.exists():
-            _existing = load_config()
-            if _existing.platform.api_key and _ping_key(_existing.platform.api_key, base_url):
-                _maybe_identify(_existing.platform.api_key)
-                _emit_reuse("config")
-                _fire_init("existing_key")
-                return
-        # Rule 3: mint a fresh shadow (no valid key to reuse).
-        # agent_caller is the agent's self-declared identity from --agent-caller
-        # (Proof Editor-style). Env-var auto-detect is still used above to
-        # decide we're in an agent context, but never to fill identity.
-        bootstrap_via_backend(config, source=source, agent_caller=agent_caller)
-        _fire_init("agent")
-        return
-
    # Warn if an existing config with an API key would be overwritten
    if not force and CONFIG_FILE.exists():
        existing = load_config()
@@ -383,7 +242,6 @@ def run_init(
        config.platform.api_key = api_key_val
        config.platform.base_url = base_url
        config.platform.user_email = email
-        config.platform.created_via = "email"
        config.defaults.user_id = (
            user_id or os.environ.get("USER") or os.environ.get("USERNAME") or "mem0-cli"
        )
@@ -400,8 +258,6 @@ def run_init(
        return

    # ── API key flow (existing) ───────────────────────────────────────
-    # (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 not sys.stdin.isatty():
@@ -409,7 +265,7 @@ def run_init(
            print_error(
                err_console,
                "Non-interactive terminal detected and --api-key is required.",
-                hint="Run: mem0 init --api-key <key>, --email <addr>, or --agent for unattended Agent Mode bootstrap.",
+                hint="Run: mem0 init --api-key <key> [--user-id <id>]",
            )
            raise typer.Exit(1)
        user_id = user_id or os.environ.get("USER") or os.environ.get("USERNAME") or "mem0-cli"
@@ -417,7 +273,6 @@ def run_init(
    # Fully non-interactive when both flags provided
    if api_key and user_id:
        config.platform.api_key = api_key
-        config.platform.created_via = "api_key"
        config.defaults.user_id = user_id
        _validate_platform(config)
        save_config(config)
@@ -458,7 +313,6 @@ def run_init(
            config.platform.api_key = api_key_val
            config.platform.base_url = base_url
            config.platform.user_email = email_addr
-            config.platform.created_via = "email"
            config.defaults.user_id = (
                user_id or os.environ.get("USER") or os.environ.get("USERNAME") or "mem0-cli"
            )
@@ -477,7 +331,6 @@ def run_init(
    # API key flow
    if api_key:
        config.platform.api_key = api_key
-        config.platform.created_via = "api_key"
    else:
        _setup_platform(config)

@@ -517,7 +370,6 @@ def _setup_platform(config: Mem0Config) -> None:
        raise typer.Exit(1)

    config.platform.api_key = api_key
-    config.platform.created_via = "api_key"


 def _setup_defaults(config: Mem0Config) -> None:
@@ -4,11 +4,9 @@ from __future__ import annotations

 import json
 import os
-import re
 import stat as _stat_mod
 import sys
 import time as _time
-from datetime import date
 from pathlib import Path

 import typer
@@ -49,18 +47,6 @@ def _stdin_is_piped() -> bool:
        return False


-def _validate_expires(value: str) -> None:
-    """Exit 1 if value is not a future YYYY-MM-DD date."""
-    if not re.match(r"^\d{4}-\d{2}-\d{2}$", value):
-        print_error(
-            err_console, "Invalid date format for --expires. Use YYYY-MM-DD (e.g. 2025-12-31)."
-        )
-        raise typer.Exit(1)
-    if date.fromisoformat(value) <= date.today():
-        print_error(err_console, "--expires date must be in the future.")
-        raise typer.Exit(1)
-
-
 def cmd_add(
    backend: Backend,
    text: str | None,
@@ -76,10 +62,6 @@ def cmd_add(
    no_infer: bool,
    expires: str | None,
    categories: str | None,
-    custom_instructions: str | None = None,
-    custom_categories: str | None = None,
-    structured_data_schema: str | None = None,
-    timestamp: int | None = None,
    output: str = "text",
 ) -> None:
    """Add a memory."""
@@ -88,13 +70,6 @@ def cmd_add(
    set_current_command("add")
    if is_agent_mode():
        output = "agent"
-
-    if categories:
-        print_error(
-            err_console, "--categories is not supported on add. Use --custom-categories instead."
-        )
-        raise typer.Exit(1)
-
    msgs = None
    content = text

@@ -133,24 +108,27 @@ def cmd_add(
            print_error(err_console, "Invalid JSON in --metadata.")
            raise typer.Exit(1) from None

-    custom_cats = None
-    if custom_categories:
+    cats = None
+    if categories:
        try:
-            custom_cats = json.loads(custom_categories)
+            cats = json.loads(categories)
        except json.JSONDecodeError:
-            print_error(err_console, "Invalid JSON in --custom-categories.")
-            raise typer.Exit(1) from None
-
-    schema = None
-    if structured_data_schema:
-        try:
-            schema = json.loads(structured_data_schema)
-        except json.JSONDecodeError:
-            print_error(err_console, "Invalid JSON in --structured-data-schema.")
-            raise typer.Exit(1) from None
+            cats = [c.strip() for c in categories.split(",")]

+    # Validate --expires
    if expires:
-        _validate_expires(expires)
+        import re
+
+        if not re.match(r"^\d{4}-\d{2}-\d{2}$", expires):
+            print_error(
+                err_console, "Invalid date format for --expires. Use YYYY-MM-DD (e.g. 2025-12-31)."
+            )
+            raise typer.Exit(1)
+        from datetime import date
+
+        if date.fromisoformat(expires) <= date.today():
+            print_error(err_console, "--expires date must be in the future.")
+            raise typer.Exit(1)

    with timed_status(err_console, "Adding memory...") as ts:
        try:
@@ -165,10 +143,7 @@ def cmd_add(
                immutable=immutable,
                infer=not no_infer,
                expires=expires,
-                custom_instructions=custom_instructions,
-                custom_categories=custom_cats,
-                structured_data_schema=schema,
-                timestamp=timestamp,
+                categories=cats,
            )
        except Exception as e:
            ts.error_msg = str(e)
@@ -249,9 +224,6 @@ def cmd_search(
    keyword: bool,
    filter_json: str | None,
    fields: str | None,
-    show_expired: bool = False,
-    reference_date: str | None = None,
-    latest_only: bool = False,
    output: str = "text",
 ) -> None:
    """Search memories."""
@@ -294,9 +266,6 @@ def cmd_search(
                keyword=keyword,
                filters=filters,
                fields=field_list,
-                show_expired=show_expired,
-                reference_date=reference_date,
-                latest_only=latest_only,
            )
        except Exception as e:
            print_error(err_console, str(e))
@@ -383,8 +352,6 @@ def cmd_list(
    category: str | None,
    after: str | None,
    before: str | None,
-    show_expired: bool = False,
-    latest_only: bool = False,
    output: str = "table",
 ) -> None:
    """List memories."""
@@ -413,8 +380,6 @@ def cmd_list(
                category=category,
                after=after,
                before=before,
-                show_expired=show_expired,
-                latest_only=latest_only,
            )
        except Exception as e:
            print_error(err_console, str(e))
@@ -481,8 +446,6 @@ def cmd_update(
    text: str | None,
    *,
    metadata: str | None,
-    expires: str | None = None,
-    timestamp: int | None = None,
    output: str,
 ) -> None:
    """Update a memory."""
@@ -499,19 +462,10 @@ def cmd_update(
            print_error(err_console, "Invalid JSON in --metadata.")
            raise typer.Exit(1) from None

-    if expires:
-        _validate_expires(expires)
-
    _start = _time.perf_counter()
    with timed_status(err_console, "Updating memory...") as _ts:
        try:
-            result = backend.update(
-                memory_id,
-                content=text,
-                metadata=meta,
-                expiration_date=expires,
-                timestamp=timestamp,
-            )
+            result = backend.update(memory_id, content=text, metadata=meta)
        except Exception as e:
            print_error(err_console, str(e))
            raise typer.Exit(1) from None
@@ -536,7 +490,6 @@ def cmd_delete(
    *,
    dry_run: bool = False,
    force: bool = False,
-    delete_linked: bool = False,
    output: str,
 ) -> None:
    """Delete a single memory by ID."""
@@ -559,7 +512,7 @@ def cmd_delete(
    _start = _time.perf_counter()
    with timed_status(err_console, "Deleting...") as _ts:
        try:
-            result = backend.delete(memory_id=memory_id, delete_linked=delete_linked)
+            result = backend.delete(memory_id=memory_id)
        except Exception as e:
            print_error(err_console, str(e))
            raise typer.Exit(1) from None
@@ -1,25 +0,0 @@
-"""mem0 whoami — print the active agent's default_user_id (AGENTRUSH identifier)."""
-
-from __future__ import annotations
-
-import typer
-from rich.console import Console
-
-from mem0_cli.branding import BRAND_COLOR, print_error, print_info
-from mem0_cli.config import load_config
-
-console = Console()
-err_console = Console(stderr=True)
-
-
-def run_whoami() -> None:
-    config = load_config()
-    session_id = config.platform.default_user_id if config.platform else None
-    if not session_id:
-        print_error(
-            err_console,
-            "No default_user_id found. Run `mem0 init --agent` first.",
-        )
-        raise typer.Exit(1)
-    console.print(f"Your AGENTRUSH identifier:  [{BRAND_COLOR}]{session_id}[/{BRAND_COLOR}]")
-    print_info(console, "Find your row at https://mem0.ai/agentrush")
@@ -28,14 +28,6 @@ class PlatformConfig:
    api_key: str = ""
    base_url: str = DEFAULT_BASE_URL
    user_email: str = ""
-    # Agent Mode (unclaimed-shadow signup)
-    agent_mode: bool = False  # True while the key is an unclaimed agent-mode key
-    created_via: str = ""  # "agent_mode" | "email" | "api_key" | "existing_key"
-    agent_caller: str = (
-        ""  # canonical agent name when created_via == "agent_mode" (e.g. "claude-code")
-    )
-    claimed_at: str = ""  # ISO timestamp once the agent has been claimed by a human
-    default_user_id: str = ""  # `user_<slug>` returned by bootstrap; used as auto-default


@dataclass
@@ -51,20 +43,12 @@ class TelemetryConfig:
    anonymous_id: str = ""


-@dataclass
-class AgentRushConfig:
-    # ISO timestamp the human acknowledged the "memories are public" warning.
-    # Empty until first interactive `mem0 agent-rush add`.
-    acknowledged_at: str = ""
-
-
@dataclass
 class Mem0Config:
    version: int = CONFIG_VERSION
    defaults: DefaultsConfig = field(default_factory=DefaultsConfig)
    platform: PlatformConfig = field(default_factory=PlatformConfig)
    telemetry: TelemetryConfig = field(default_factory=TelemetryConfig)
-    agent_rush: AgentRushConfig = field(default_factory=AgentRushConfig)


 SHORT_KEY_ALIASES: dict[str, str] = {
@@ -99,11 +83,6 @@ def load_config() -> Mem0Config:
        config.platform.api_key = plat.get("api_key", "")
        config.platform.base_url = plat.get("base_url", DEFAULT_BASE_URL)
        config.platform.user_email = plat.get("user_email", "")
-        config.platform.agent_mode = bool(plat.get("agent_mode", False))
-        config.platform.created_via = plat.get("created_via", "")
-        config.platform.agent_caller = plat.get("agent_caller", "")
-        config.platform.claimed_at = plat.get("claimed_at", "")
-        config.platform.default_user_id = plat.get("default_user_id", "")

        defaults = data.get("defaults", {})
        config.defaults.user_id = defaults.get("user_id", "")
@@ -113,9 +92,6 @@ def load_config() -> Mem0Config:
        telemetry = data.get("telemetry", {})
        config.telemetry.anonymous_id = telemetry.get("anonymous_id", "")

-        agent_rush = data.get("agent_rush", {})
-        config.agent_rush.acknowledged_at = agent_rush.get("acknowledged_at", "")
-
    # Environment variable overrides
    env_key = os.environ.get("MEM0_API_KEY")
    if env_key:
@@ -160,18 +136,10 @@ def save_config(config: Mem0Config) -> None:
            "api_key": config.platform.api_key,
            "base_url": config.platform.base_url,
            "user_email": config.platform.user_email,
-            "agent_mode": config.platform.agent_mode,
-            "created_via": config.platform.created_via,
-            "agent_caller": config.platform.agent_caller,
-            "claimed_at": config.platform.claimed_at,
-            "default_user_id": config.platform.default_user_id,
        },
        "telemetry": {
            "anonymous_id": config.telemetry.anonymous_id,
        },
-        "agent_rush": {
-            "acknowledged_at": config.agent_rush.acknowledged_at,
-        },
    }

    with open(CONFIG_FILE, "w") as f:
@@ -179,19 +147,6 @@ def save_config(config: Mem0Config) -> None:

    os.chmod(CONFIG_FILE, stat.S_IRUSR | stat.S_IWUSR)  # 0600

-    # Propagate the active api_key to ecosystem touchpoints (Claude Code
-    # plugin env injection, shell rc exports). Idempotent — only updates
-    # EXISTING entries; never creates new ones. Best-effort: any IOError
-    # in the sync is swallowed so config.json is always the authoritative
-    # write, never blocked by plugin-state issues.
-    if config.platform.api_key:
-        try:
-            from mem0_cli.plugin_sync import sync_api_key
-
-            sync_api_key(config.platform.api_key)
-        except Exception:
-            pass
-

 def redact_key(key: str) -> str:
    """Redact an API key for display: m0-xxx...xxx"""
@@ -235,10 +190,7 @@ def set_nested_value(config: Mem0Config, dotted_key: str, value: str) -> bool:
    if isinstance(current, bool):
        value = value.lower() in ("true", "1", "yes")  # type: ignore[assignment]
    elif isinstance(current, int):
-        try:
-            value = int(value)  # type: ignore[assignment]
-        except ValueError:
-            return False
+        value = int(value)  # type: ignore[assignment]

    setattr(obj, final_key, value)
    return True
@@ -20,8 +20,8 @@ def format_memories_text(console: Console, memories: list[dict], title: str = "m
    console.print(f"\n[{BRAND_COLOR}]Found {count} {title}:[/]\n")

    for i, mem in enumerate(memories, 1):
-        memory_text = mem.get("memory") or mem.get("text") or ""
-        mem_id = (mem.get("id") or "")[:8]
+        memory_text = mem.get("memory", mem.get("text", ""))
+        mem_id = mem.get("id", "")[:8]
        score = mem.get("score")
        created = _format_date(mem.get("created_at"))
        category = mem.get("categories", [None])
@@ -67,8 +67,8 @@ def format_memories_table(
    table.add_column("Created", max_width=12)

    for mem in memories:
-        mem_id = mem.get("id") or ""
-        memory_text = mem.get("memory") or mem.get("text") or ""
+        mem_id = mem.get("id", "")
+        memory_text = mem.get("memory", mem.get("text", ""))
        if len(memory_text) > 60:
            memory_text = memory_text[:57] + "..."
        categories = mem.get("categories", [])
@@ -104,8 +104,8 @@ def format_single_memory(console: Console, mem: dict, output: str = "text") -> N
        format_json(console, mem)
        return

-    memory_text = mem.get("memory") or mem.get("text") or ""
-    mem_id = mem.get("id") or ""
+    memory_text = mem.get("memory", mem.get("text", ""))
+    mem_id = mem.get("id", "")

    lines = []
    lines.append(f"  [white bold]{memory_text}[/]")
@@ -229,16 +229,6 @@ def format_json_envelope(
    if error:
        envelope["error"] = error
    envelope["data"] = 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.
-    from mem0_cli.state import take_notice
-
-    notice = take_notice()
-    if notice:
-        envelope["mem0_notice"] = notice
-
    console.print_json(json.dumps(envelope, default=str))


@@ -262,32 +252,16 @@ def sanitize_agent_data(command: str, data: Any) -> Any:
        return result

    if command == "search":
-        return [
-            pick(r, ["id", "memory", "score", "created_at", "categories", "expiration_date"])
-            for r in data
-        ]
+        return [pick(r, ["id", "memory", "score", "created_at", "categories"]) for r in data]

    if command == "list":
-        return [
-            pick(r, ["id", "memory", "created_at", "categories", "expiration_date"]) for r in data
-        ]
+        return [pick(r, ["id", "memory", "created_at", "categories"]) for r in data]

    if command == "get":
-        return pick(
-            data,
-            [
-                "id",
-                "memory",
-                "created_at",
-                "updated_at",
-                "categories",
-                "metadata",
-                "expiration_date",
-            ],
-        )
+        return pick(data, ["id", "memory", "created_at", "updated_at", "categories", "metadata"])

    if command == "update":
-        return pick(data, ["id", "memory", "expiration_date"])
+        return pick(data, ["id", "memory"])

    if command in ("delete", "delete-all", "entity delete"):
        return data
@@ -349,15 +323,6 @@ def format_agent_envelope(
    if count is not None:
        envelope["count"] = count
    envelope["data"] = sanitize_agent_data(command, 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.
-    from mem0_cli.state import take_notice
-
-    notice = take_notice()
-    if notice:
-        envelope["mem0_notice"] = notice
-
    console.print_json(json.dumps(envelope, default=str))


@@ -1,119 +0,0 @@
-"""Sync the active Mem0 API key into other ecosystem touchpoints.
-
-Why this exists:
-  The CLI canonical state lives in ``~/.mem0/config.json``. But MCP servers
-  (Claude Code plugin, Codex plugin, etc.) read ``MEM0_API_KEY`` from env
-  vars or their own config files. Without a sync, an 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 all surrounding content / formatting / other keys
-  - Atomic writes (tmpfile + rename) so a crash mid-write doesn't corrupt
-  - Idempotent — re-running with the same key is a no-op
-  - Skip on dry_run
-
-Targets currently handled:
-  - ``~/.claude/settings.json::env::MEM0_API_KEY`` (Claude Code env injection)
-  - ``~/.zshrc`` / ``~/.bashrc`` ``export MEM0_API_KEY="..."`` lines
-
-Out of scope (deliberately not touched):
-  - Codex / Cursor MCP configs — would require schema-aware edits and
-    those tools don't have mem0 entries by default
-  - Plugin's own ``<plugin-dir>/.api_key`` file — plugin-managed
-"""
-
-from __future__ import annotations
-
-import contextlib
-import json
-import os
-import re
-import tempfile
-from pathlib import Path
-
-# Files we know how to update safely.
-_CLAUDE_SETTINGS = Path.home() / ".claude" / "settings.json"
-_SHELL_RCS = [Path.home() / ".zshrc", Path.home() / ".bashrc", Path.home() / ".bash_profile"]
-
-
-def sync_api_key(api_key: str) -> list[str]:
-    """Propagate ``api_key`` into known ecosystem touchpoints.
-
-    Returns the list of paths actually updated. Empty list means nothing
-    needed updating (either targets didn't exist or already had this value).
-    """
-    if not api_key:
-        return []
-    updated: list[str] = []
-    if _update_claude_settings(_CLAUDE_SETTINGS, api_key):
-        updated.append(str(_CLAUDE_SETTINGS))
-    for rc in _SHELL_RCS:
-        if _update_shell_rc(rc, api_key):
-            updated.append(str(rc))
-    return updated
-
-
-def _update_claude_settings(path: Path, api_key: str) -> bool:
-    """Update ``env.MEM0_API_KEY`` in path. Returns True if file was changed."""
-    if not path.is_file():
-        return False
-    try:
-        with path.open("r", encoding="utf-8") as f:
-            data = json.load(f)
-    except (json.JSONDecodeError, OSError):
-        return False
-    env = data.get("env")
-    if not isinstance(env, dict) or "MEM0_API_KEY" not in env:
-        # No existing entry — don't create one.
-        return False
-    if env["MEM0_API_KEY"] == api_key:
-        return False  # already in sync
-    env["MEM0_API_KEY"] = api_key
-    _atomic_write_text(path, json.dumps(data, indent=2, ensure_ascii=False) + "\n")
-    return True
-
-
-# Match `export MEM0_API_KEY="..."` (or single quotes, or no quotes).
-# Use [ \t]* (not \s*) for trailing whitespace so a trailing newline at
-# end-of-file is preserved when MEM0_API_KEY is the last line.
-_RC_LINE = re.compile(
-    r'^([ \t]*export[ \t]+MEM0_API_KEY[ \t]*=[ \t]*)(["\']?)([^"\'\n]*)(["\']?)[ \t]*$',
-    re.MULTILINE,
-)
-
-
-def _update_shell_rc(path: Path, api_key: str) -> bool:
-    """Update an existing ``export MEM0_API_KEY=...`` line in path."""
-    if not path.is_file():
-        return False
-    try:
-        text = path.read_text(encoding="utf-8")
-    except OSError:
-        return False
-    match = _RC_LINE.search(text)
-    if not match:
-        return False  # no existing line
-    if match.group(3) == api_key:
-        return False
-    new_text = _RC_LINE.sub(lambda m: f'{m.group(1)}"{api_key}"', text, count=1)
-    _atomic_write_text(path, new_text)
-    return True
-
-
-def _atomic_write_text(path: Path, content: str) -> None:
-    """Write content to path atomically (temp + rename)."""
-    dirname = path.parent
-    fd, tmp_path = tempfile.mkstemp(prefix=f".{path.name}.", suffix=".tmp", dir=dirname)
-    try:
-        with os.fdopen(fd, "w", encoding="utf-8") as f:
-            f.write(content)
-        # Preserve mode if the original existed.
-        if path.exists():
-            os.chmod(tmp_path, path.stat().st_mode & 0o777)
-        os.replace(tmp_path, path)
-    except Exception:
-        with contextlib.suppress(OSError):
-            os.unlink(tmp_path)
-        raise
@@ -4,7 +4,6 @@ from __future__ import annotations

 _agent_mode: bool = False
 _current_command: str = ""
-_pending_notice: str = ""


 def is_agent_mode() -> bool:
@@ -23,23 +22,3 @@ def get_current_command() -> str:
 def set_current_command(name: str) -> None:
    global _current_command
    _current_command = name
-
-
-def capture_notice(notice: str | None) -> None:
-    """Stash a Mem0 backend notice for end-of-command surfacing.
-
-    Called from the platform backend after each response so the notice can
-    be printed once per command (regardless of how many sub-requests fired).
-    Last-write-wins is fine — the message text is identical across requests.
-    """
-    global _pending_notice
-    if notice:
-        _pending_notice = notice
-
-
-def take_notice() -> str:
-    """Return and clear the pending notice."""
-    global _pending_notice
-    msg = _pending_notice
-    _pending_notice = ""
-    return msg
@@ -87,6 +87,7 @@ def capture_event(
    try:
        from mem0_cli import __version__
        from mem0_cli.config import CONFIG_FILE, load_config, save_config
+        from mem0_cli.state import is_agent_mode

        config = load_config()
        distinct_id = pre_resolved_email or _get_distinct_id()
@@ -106,9 +107,6 @@ def capture_event(
            with contextlib.suppress(Exception):
                save_config(config)

-        # 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.
        payload = {
            "api_key": POSTHOG_API_KEY,
            "distinct_id": distinct_id,
@@ -117,7 +115,7 @@ def capture_event(
                "source": "CLI",
                "language": "python",
                "cli_version": __version__,
-                "agent_mode": bool(config.platform.agent_mode),
+                "agent_mode": is_agent_mode(),
                "python_version": sys.version,
                "os": sys.platform,
                "os_version": platform.version(),
@@ -137,19 +135,12 @@ def capture_event(
            "anon_distinct_id_to_alias": anon_id_to_alias,
        }

-        child = subprocess.Popen(
-            [sys.executable, "-m", "mem0_cli.telemetry_sender"],
-            stdin=subprocess.PIPE,
+        subprocess.Popen(
+            [sys.executable, "-m", "mem0_cli.telemetry_sender", json.dumps(context)],
            stdout=subprocess.DEVNULL,
            stderr=subprocess.DEVNULL,
            start_new_session=True,
            close_fds=True,
-            text=True,
        )
-        if child.stdin:
-            with contextlib.suppress(Exception):
-                child.stdin.write(json.dumps(context))
-            with contextlib.suppress(Exception):
-                child.stdin.close()
    except Exception:
        pass
@@ -1,7 +1,6 @@
 """Standalone telemetry sender — runs as a detached subprocess.

-Usage: python -m mem0_cli.telemetry_sender   (JSON context is read from stdin;
-a single argv argument is still accepted as a legacy fallback)
+Usage: python -m mem0_cli.telemetry_sender '<json context>'

 This module is spawned by telemetry.capture_event() and runs independently
 of the parent CLI process. It:
@@ -21,18 +20,8 @@ import sys
 import urllib.request


-def _load_context() -> dict:
-    """Load telemetry context from stdin, falling back to argv for compatibility."""
-    raw = ""
-    if not sys.stdin.isatty():
-        raw = sys.stdin.read().strip()
-    if not raw and len(sys.argv) > 1:
-        raw = sys.argv[1]
-    return json.loads(raw)
-
-
 def main() -> None:
-    ctx = _load_context()
+    ctx = json.loads(sys.argv[1])
    payload = ctx["payload"]

    if ctx.get("needs_email") and ctx.get("mem0_api_key"):
@@ -1,160 +0,0 @@
-"""Parity tests for `mem0 init --agent` (Agent Mode bootstrap).
-
-Mirror of ``cli/node/tests/agent-mode.test.ts`` — 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 Node 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.
-"""
-
-from __future__ import annotations
-
-import os
-import re
-import subprocess
-import sys
-
-import pytest
-
-_ANSI_RE = re.compile(r"\x1b\[[0-9;]*[mKJHABCDfsu]")
-
-
-def _strip_ansi(text: str) -> str:
-    return _ANSI_RE.sub("", text)
-
-
-def _run(args: list[str], home_dir: str | None = None) -> subprocess.CompletedProcess:
-    env = os.environ.copy()
-    for key in list(env.keys()):
-        if key.startswith("MEM0_"):
-            del env[key]
-    env.pop("FORCE_COLOR", None)
-    env["PYTHONIOENCODING"] = "utf-8"
-    if home_dir:
-        env["HOME"] = home_dir
-    result = subprocess.run(
-        [sys.executable, "-m", "mem0_cli", *args],
-        capture_output=True,
-        encoding="utf-8",
-        env=env,
-        timeout=15,
-    )
-    return subprocess.CompletedProcess(
-        args=result.args,
-        returncode=result.returncode,
-        stdout=_strip_ansi(result.stdout),
-        stderr=_strip_ansi(result.stderr),
-    )
-
-
-@pytest.fixture
-def clean_home(tmp_path):
-    return str(tmp_path)
-
-
-class TestInitFlagSurface:
-    """`mem0 init --help` must expose the Agent Mode flags."""
-
-    def test_init_help_lists_agent_flag(self):
-        result = _run(["init", "--help"])
-        assert result.returncode == 0
-        assert "--agent" in result.stdout
-
-    def test_init_help_describes_agent_mode(self):
-        result = _run(["init", "--help"])
-        assert result.returncode == 0
-        # Description must mention what --agent actually does so an agent
-        # reading the help can self-discover the bootstrap entrypoint.
-        assert "Agent Mode" in result.stdout or "unattended" in result.stdout.lower()
-
-    def test_init_help_lists_source_flag(self):
-        result = _run(["init", "--help"])
-        assert result.returncode == 0
-        assert "--source" in result.stdout
-
-    def test_init_help_lists_email_and_code(self):
-        # Claim flow flags must remain present alongside Agent Mode flags.
-        result = _run(["init", "--help"])
-        assert result.returncode == 0
-        assert "--email" in result.stdout
-        assert "--code" in result.stdout
-
-
-class TestArgvPreprocessing:
-    """`--agent` on `init` must reach init_cmd, not be eaten by the global preprocessor.
-
-    Regression for the bug where the top-level `--agent` JSON-alias was
-    stripped from ``sys.argv`` before Typer could bind it to the init
-    subcommand, making ``mem0 init --agent`` indistinguishable from a
-    plain ``mem0 init`` (interactive wizard).
-    """
-
-    def test_init_with_agent_reaches_subcommand(self, clean_home):
-        # We can't hit a real backend in unit tests, so we point the CLI at
-        # a guaranteed-dead URL and assert the failure is the bootstrap
-        # request failing — proving the --agent flag was honored and the
-        # bootstrap branch ran, not the interactive wizard.
-        result = subprocess.run(
-            [sys.executable, "-m", "mem0_cli", "init", "--agent"],
-            capture_output=True,
-            encoding="utf-8",
-            env={
-                **{k: v for k, v in os.environ.items() if not k.startswith("MEM0_")},
-                "HOME": clean_home,
-                "MEM0_BASE_URL": "http://127.0.0.1:1",  # blackhole
-                "FORCE_COLOR": "0",
-                "PYTHONIOENCODING": "utf-8",
-            },
-            timeout=15,
-        )
-        combined = _strip_ansi(result.stdout + result.stderr).lower()
-        # Either we got a connection/network error from the bootstrap POST,
-        # or the CLI surfaced an Agent Mode-specific failure message.
-        assert (
-            "agent" in combined
-            or "connect" in combined
-            or "network" in combined
-            or "fetch" in combined
-            or "bootstrap" in combined
-        ), f"Expected bootstrap attempt, got: {combined!r}"
-
-
-class TestJsonEnvelopeParity:
-    """`mem0 init --agent --json` should produce a JSON envelope on success.
-
-    Without a live backend we can only assert the failure shape: when the
-    backend is unreachable, the CLI must still exit non-zero AND not crash
-    on a Python traceback (which would mean we leaked an exception past
-    the agent-mode handler).
-    """
-
-    def test_init_agent_json_no_traceback_on_network_failure(self, clean_home):
-        result = subprocess.run(
-            [sys.executable, "-m", "mem0_cli", "init", "--agent", "--json"],
-            capture_output=True,
-            encoding="utf-8",
-            env={
-                **{k: v for k, v in os.environ.items() if not k.startswith("MEM0_")},
-                "HOME": clean_home,
-                "MEM0_BASE_URL": "http://127.0.0.1:1",
-                "FORCE_COLOR": "0",
-                "PYTHONIOENCODING": "utf-8",
-            },
-            timeout=15,
-        )
-        combined = _strip_ansi(result.stdout + result.stderr)
-        assert "Traceback (most recent call last)" not in combined
-        assert result.returncode != 0
-
-
-class TestInitInCommandList:
-    """`mem0 --help` must list `init` so agents walking the top-level help
-    can discover the Agent Mode entrypoint without prior knowledge."""
-
-    def test_top_level_help_lists_init(self):
-        result = _run(["--help"])
-        assert result.returncode == 0
-        assert "init" in result.stdout
@@ -7,7 +7,6 @@ boundaries).

 from __future__ import annotations

-import json
 import os
 import re
 import subprocess
@@ -50,7 +49,6 @@ def _run(
        if key.startswith("MEM0_"):
            del env[key]
    env.pop("FORCE_COLOR", None)
-    env["PYTHONIOENCODING"] = "utf-8"
    if home_dir:
        env["HOME"] = home_dir
    if env_override:
@@ -58,7 +56,7 @@ def _run(
    result = subprocess.run(
        [sys.executable, "-m", "mem0_cli", *args],
        capture_output=True,
-        encoding="utf-8",
+        text=True,
        env=env,
    )
    return subprocess.CompletedProcess(
@@ -85,31 +83,6 @@ class TestCLIIntegration:
        assert "add" in result.stdout
        assert "search" in result.stdout

-    def test_version_flag_only(self):
-        from mem0_cli import __version__
-
-        flag = _run(["--version"])
-        assert flag.returncode == 0
-        assert __version__ in flag.stdout
-        assert _run(["version"]).returncode != 0
-
-    @pytest.mark.parametrize(
-        "args",
-        [["help", "--json"], ["--json", "help"], ["help", "--agent"], ["--agent", "help"]],
-    )
-    def test_help_json_produces_valid_json(self, args):
-        result = _run(args)
-        assert result.returncode == 0
-        spec = json.loads(result.stdout)
-        assert spec["name"] == "mem0"
-        assert "add" in spec["commands"]
-
-    def test_help_without_json_is_text(self):
-        result = _run(["help"])
-        assert result.returncode == 0
-        with pytest.raises(json.JSONDecodeError):
-            json.loads(result.stdout)
-
    def test_add_help(self):
        result = _run(["add", "--help"])
        assert result.returncode == 0
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
gabrielstein-mem0	50c1861a59	Merge remote-tracking branch 'origin/main' into fix/codex-install-docs # Conflicts: # mem0-plugin/README.md	2026-04-27 11:04:22 -07:00
gabrielstein-mem0	674bb92423	docs(codex): lead sideload with CLI, flag auto-MCP, align server name Rework the Codex install flow around `codex plugin marketplace add <clone>` so users can lean on the repo's bundled `.agents/plugins/marketplace.json` instead of hand-authoring one. This removes the "path must be under ~/" constraint that was tripping people up. Also: - Call out that sideloading auto-registers `mem0` via .codex-mcp.json, so Option A (Direct MCP) and Option B (sideload) must not be combined. - Rename the Direct MCP snippet on the platform page from `mem0-mcp` to `mem0` to match the bundled plugin — prevents silent duplicate servers for users who follow one path then try the other. - Drop the trailing slash in .codex-mcp.json's URL to match the rest of the docs. - Add `codex plugin marketplace upgrade` / `remove` and the plugin cache path (~/.codex/plugins/cache/...). - New troubleshooting entries for duplicate MCP registration and for hooks breaking after a clone is moved (the installer bakes absolute paths, so moving the clone requires re-running it).	2026-04-24 16:53:30 -07:00
gabrielstein-mem0	a723cb485a	docs(codex): use relative source.path inside marketplace root Re-checked the docs PR against developers.openai.com/codex/plugins/build, which states: "Keep source.path relative to the marketplace root, start it with ./, and keep it inside that root." The earlier sideload instructions used an absolute path (/Users/YOU/src/mem0/mem0-plugin) which violates that rule. Updated: - docs/integrations/codex.mdx Option B — clone under ~/codex-plugins/, use "./codex-plugins/mem0-source/mem0-plugin", restart Codex made an explicit step. - mem0-plugin/README.md Option B — same fix. - Updated the "plugin/read failed in TUI" troubleshooting entry to point at the relative-path requirement.	2026-04-24 15:35:01 -07:00
gabrielstein-mem0	21043bab1f	Merge remote-tracking branch 'origin/main' into fix/codex-install-docs	2026-04-24 15:34:47 -07:00
gabrielstein-mem0	43b222ca57	docs(codex): fix broken install instructions, lead with direct MCP The support ticket that surfaced this found three overlapping issues: 1. docs/integrations/codex.mdx shipped a marketplace.json snippet with path "./plugins/mem0" — a directory that does not exist, with no clone prerequisite documented, and using a folder name that does not match the actual mem0-plugin/ directory. Users copy-pasted it verbatim and hit "plugin/read failed in TUI". 2. The "Manual MCP Configuration" option used a JSON mcpServers block. Codex reads MCP servers as TOML in ~/.codex/config.toml, not JSON. Same bug in docs/platform/mem0-mcp.mdx (no Codex accordion at all on main) and mem0-plugin/README.md Option C. 3. The page claimed "Codex uses a skill-based approach instead of lifecycle hooks" — stale; hooks are now available via opt-in installer (mem0-plugin/scripts/install_codex_hooks.py). Lead with the working TOML MCP config (zero dependencies, works today), demote the marketplace.json to a "Sideload (Advanced)" section with the required git clone step and the correct mem0-plugin path, and point sideloaders at the hooks installer + codex_hooks feature flag. Added troubleshooting entries for the TUI read error and hooks-not-firing.	2026-04-23 15:04:35 -07:00