docs(changelog): consolidate per-package changelogs into the SDK changelog page (#6007)

docs/changelog/highlights.mdx

@@ -4,7 +4,7 @@ description: "Major product launches, headline features, and milestones for Mem0
 mode: "wide"
 ---
 
-<Update label="2026-06-27" description="SDK memory expiration and TypeScript provider updates">
+<Update label="2026-06-27" description="SDK memory expiration">
 
 **SDK Memory Expiration: Expiring Memories Across Python and TypeScript**
 
@@ -19,6 +19,96 @@ See [SDK & Tools](/changelog/sdk) for version details and PR links.
 
 </Update>
 
+<Update label="2026-06-25" description="Mem0 Plugin v0.2.11">
+
+**Mem0 Plugin: Shared Memory for Claude Code, Cursor, Codex, and Antigravity**
+
+The shared Mem0 editor plugin is current through v0.2.11:
+
+- **Automatic context injection:** File reads, bash errors, session resume prompts, and startup timelines can retrieve relevant memories automatically.
+- **Project and global scopes:** Project-scoped memories remain the default, while `global_search` supports team-wide recall across users and app scopes.
+- **Coding categories:** A 17-category coding taxonomy installs in the background and is cached per Mem0 account.
+- **Reliable capture:** Auto-capture, compaction summaries, session summaries, and metadata defaults keep memories scoped and readable.
+- **Editor correctness:** Telemetry now reports Claude Code, Cursor, Codex, and Antigravity separately with each editor's real plugin version.
+
+</Update>
+
+<Update label="2026-06-25" description="Antigravity Plugin v0.1.3">
+
+**Antigravity Plugin: Mem0 for Google Antigravity**
+
+Antigravity support in the shared Mem0 editor plugin family is current through v0.1.3:
+
+- **Self-contained plugin:** Includes its own plugin manifest, MCP config, hooks, shared scripts, and skills.
+- **AGENTS.md convention:** Uses Antigravity's `contextFileName: "AGENTS.md"` convention.
+- **Lifecycle hooks:** Wires session start, prompt recall, file-read context, memory-tool metadata enforcement, bash-error lookup, post-tool tracking, and stop summaries.
+- **Shared memory layer:** Reuses the Mem0 Platform MCP tools and the shared 16-skill command bundle.
+- **Better automatic recall:** v0.1.3 adds reranked injected context and clean `files_touched` metadata in session summaries.
+- **Telemetry correctness:** v0.1.2 reports Antigravity as `antigravity` with the plugin's own version.
+
+</Update>
+
+<Update label="2026-06-22" description="OpenCode Plugin v0.2.0">
+
+**OpenCode Plugin: Native SDK Memory Tools for OpenCode**
+
+`@mem0/opencode-plugin` adds memory to OpenCode and is current through v0.2.0:
+
+- **Native SDK tools:** Memory tools register through `@opencode-ai/plugin` and call the `mem0ai` SDK directly, so the plugin no longer depends on `mcp.mem0.ai`.
+- **Memory scopes:** Operations support `project`, `session`, and `global` scope, with `/mem0-scope` to change the default.
+- **Automatic context:** File-context injection, structured compaction summaries, and a recent-activity timeline surface relevant memories without manual recall.
+- **Auto-dream consolidation:** Gated consolidation merges duplicates, drops stale or sensitive entries, and rewrites vague memories.
+- **Skills load in place:** The `config` hook adds bundled skills to `skills.paths` instead of copying them into user config directories.
+- **Safety controls:** Blocks `MEMORY.md` writes and redacts secrets before storing memories.
+
+</Update>
+
+<Update label="2026-06-12" description="Pi Agent Plugin v0.1.2">
+
+**Pi Agent Plugin: Persistent Memory for Pi Agent**
+
+`@mem0/pi-agent-plugin` adds semantic memory to Pi Agent and has been updated through v0.1.2:
+
+- **Agent memory tool:** Registers `mem0_memory` for scoped search, add, get, delete, and delete-all operations.
+- **Slash commands:** Adds `/mem0-remember`, `/mem0-search`, `/mem0-forget`, `/mem0-tour`, `/mem0-dream`, `/mem0-pin`, `/mem0-scope`, and `/mem0-status`.
+- **Auto-capture:** Stores user and assistant memories after agent turns.
+- **Dream consolidation:** Merges duplicates, resolves contradictions, and prunes stale memories behind session, time, and memory-count gates.
+- **Project scoping:** Uses git-root detection for stable `app_id` values across monorepos.
+- **Relevant command results:** v0.1.2 adds visible command feedback and thresholded, reranked search for search, forget, and pin commands.
+
+</Update>
+
+<Update label="2026-06-12" description="OpenClaw v1.0.13">
+
+**OpenClaw Plugin: Current Memory Backend for OpenClaw**
+
+`@mem0/openclaw-mem0` is current through v1.0.13, with the original production-ready memory backend plus newer setup, security, and runtime work:
+
+- **Skills-based memory architecture:** Triage, recall, and dream skills handle extraction, recall, consolidation, and tool guidance.
+- **Chat and CLI setup:** Supports chat-based platform setup, `openclaw mem0 init`, direct API keys, email OTP, autonomous agent setup, and OSS onboarding.
+- **Platform and OSS modes:** Works with Mem0 Platform or self-hosted OSS providers including OpenAI, Anthropic, Ollama, Qdrant, and PGVector.
+- **Agent-friendly CLI:** All 16 CLI commands support `--json` for machine-driven setup and diagnostics.
+- **Runtime integration:** Exposes OpenClaw memory capability APIs for search manager and backend config status.
+- **Security and compliance:** Added path containment checks, sensitive config metadata, dependency overrides, telemetry hashing, and metadata-only registration safety.
+
+</Update>
+
+<Update label="2026-06-10" description="Vercel AI SDK Provider v3.0.0">
+
+**Vercel AI SDK Provider: Memory-Augmented Generation for AI SDK v6**
+
+The Vercel AI SDK provider moved to the v6 provider contract and Mem0 v3 APIs:
+
+- **AI SDK v6 support:** Migrated to `LanguageModelV3` / `ProviderV3`, including v3 stream lifecycle events and content arrays.
+- **Mem0 v3 API support:** Memory writes and searches now use `/v3/memories/add/` and `/v3/memories/search/`.
+- **Mem0 sources in responses:** `generateText` and `streamText` responses include memories as sources with `providerMetadata.mem0.memories`.
+- **Safer prompt handling:** Prompts are cloned before memory injection, avoiding caller-side mutation.
+- **Async storage fix:** `addMemories` is awaited so generated memories are not silently dropped.
+- **Raw memory utilities:** Exports `searchMemories`, `retrieveMemories`, `getMemories`, and `addMemories` for apps that need direct memory control.
+- **Deployment controls:** Per-request `mem0ApiKey` and `host` support Mem0 Platform, custom API keys, and self-hosted API endpoints.
+
+</Update>
+
 <Update label="2026-05-13" description="Temporal Reasoning for Mem0 Platform v3">
 
 **Temporal Reasoning: Time-Aware Retrieval for Platform v3**
@@ -94,34 +184,6 @@ A full-featured command-line interface for Mem0, available in both Python and No
 
 </Update>
 
-<Update label="2026-04-06" description="OpenClaw v1.0.4">
-
-**OpenClaw Plugin: Production-Ready**
-
-The OpenClaw Mem0 plugin went from initial release to production-ready in one week (v1.0.0 → v1.0.4):
-
-- **Skills-based memory architecture:** New extraction pipeline with skill-loader, batched extraction, and domain-aware memory triage.
-- **Dream gate:** Automatic memory consolidation during idle periods for higher-quality long-term recall.
-- **Interactive CLI:** `openclaw mem0 init`, `status`, `config`, `import`, and `event` commands.
-- **Unified tool naming:** `memory_add` and `memory_delete` replace four legacy tools and match the platform API.
-- **Security hardened:** Path traversal protection, pinned dependencies, and 329 tests across 10 files.
-
-</Update>
-
-<Update label="2026-04-02" description="Mem0 Plugin for AI Editors">
-
-**Mem0 Plugin for Claude Code, Cursor, and Codex**
-
-Launched a unified Mem0 plugin across three major AI development environments: Claude Code and Cursor first (March 25), then Codex (April 2).
-
-- **9 MCP memory tools:** Add, search, get, update, delete, bulk delete, and entity management via `mcp.mem0.ai`.
-- **Lifecycle hooks:** Automatic memory capture at session start, context compaction, task completion, and session end.
-- **Cloud MCP server:** Managed endpoint replaces local MCP and Smithery setup.
-- **Streamable HTTP transport:** New MCP transport protocol for real-time streaming.
-- **Codex-specific skill:** Dedicated skill in `mem0-plugin/skills/mem0-codex` for Codex workflows.
-
-</Update>
-
 <Update label="2026-03-21" description="New Providers">
 
 **Apache AGE, Turbopuffer, MiniMax, and pgvector for Node.js**

docs/changelog/openclaw.mdx

@@ -1,336 +0,0 @@
----
-title: "OpenClaw"
-description: "Release notes for the OpenClaw plugin and agent harness."
-mode: "wide"
----
-
-<Update label="2026-06-12" description="v1.0.13">
-
-**Fixes:**
-- **Custom categories payload:** `customCategories` (a `Record<string, string>` map) is now converted via the new `customCategoryMapToList()` helper into the `Array<Record<string, string>>` shape the Mem0 SDK expects on `add` calls: previously the raw object was passed as `custom_categories` and silently ignored ([#5345](https://github.com/mem0ai/mem0/pull/5345))
-- **Skip runtime setup during metadata registration:** `register()` now detects `registrationMode === "cli-metadata"`, registers only the CLI commands, and returns early: avoiding backend initialization, service/tool registration, and hook installation during OpenClaw's metadata-only registration pass ([#5383](https://github.com/mem0ai/mem0/pull/5383))
-
-**Security:**
-- Bumped `mem0ai` from `3.0.3` to `3.0.7` (latest Node SDK): includes the transitive axios CVE remediation shipped in `3.0.6` ([#5460](https://github.com/mem0ai/mem0/pull/5460))
-- Added pnpm override `uuid@<11.1.1` → `>=11.1.1` to resolve an open MEDIUM Dependabot alert ([#5489](https://github.com/mem0ai/mem0/pull/5489))
-
-**Improvements:**
-- **Repo consolidation:** Plugin moved from repo-root `openclaw/` to `integrations/openclaw/`; `package.json` `repository.directory` updated to match so npm provenance links to the correct subdirectory ([#5491](https://github.com/mem0ai/mem0/pull/5491))
-
-**Tests:**
-- Added `customCategoryMapToList` unit tests and a `PlatformProvider` test asserting `custom_categories` is passed to the Mem0 SDK as a list ([#5345](https://github.com/mem0ai/mem0/pull/5345))
-- Added a regression test asserting `cli-metadata` registration registers only CLI commands and triggers no runtime side effects ([#5383](https://github.com/mem0ai/mem0/pull/5383))
-
-</Update>
-
-<Update label="2026-06-02" description="v1.0.12">
-
-**Docs:**
-- **Agent Mode onboarding:** README now documents an autonomous setup path for AI agents: `mem0 init --agent --json` mints an evaluation Mem0 API key with no email, OTP, or browser and exports it as `MEM0_API_KEY` for `openclaw mem0 init`; a human owner can later run `mem0 init --email <email>` to claim ownership without disrupting the agent ([#5123](https://github.com/mem0ai/mem0/pull/5123))
-
-**Security:**
-- Added pnpm overrides to remediate advisories in transitive dependencies: `langsmith@<0.6.0` → `^0.6.0`, `picomatch@<2.3.2` → `^2.3.2`, `vite` → `^8.0.5`, and `@qdrant/js-client-rest` → `^1.18.0` ([#5294](https://github.com/mem0ai/mem0/pull/5294))
-
-**Dependencies:**
-- Bumped `mem0ai` from `3.0.2` to `3.0.3` ([#5212](https://github.com/mem0ai/mem0/pull/5212))
-- Bumped dev dependencies `@vitest/coverage-v8` and `vitest` from `^4.0.18` to `^4.1.7`; added `vite@^8.0.5` and `@qdrant/js-client-rest@^1.18.0` ([#5294](https://github.com/mem0ai/mem0/pull/5294))
-
-</Update>
-
-<Update label="2026-04-29" description="v1.0.11">
-
-**New Features:**
-- **Skills-mode auto-setup:** `enableSkillsConfig()` now runs automatically after onboarding: enables triage, recall (with reranking + keyword search), and dream consolidation with `tools.profile = "full"` and disables the built-in session-memory hook to avoid conflicts
-- **Memory runtime capability:** Plugin now exposes `runtime.getMemorySearchManager()` and `resolveMemoryBackendConfig()` on the registered memory capability, enabling OpenClaw gateway to query memory status and backend config directly
-- **Dimension-aware collections:** OSS wizard detects embedder dimension changes and creates a new collection (`mem0_<dims>d`) automatically, with a warning about old memories being inaccessible under the new embedder
-- **Tool documentation in skills:** Both `memory-triage` and `memory-dream` SKILL.md files now include full tool reference sections listing all available tools with parameters
-
-**Improvements:**
-- **Auto-capture and auto-recall default to enabled:** `autoCapture` and `autoRecall` now default to `true` (was `false`). Manifest descriptions updated accordingly. Ignored in skills mode
-- **`memory_update` over delete+add:** Skills now prefer `memory_update` for in-place edits: atomic and preserves edit history. Consolidation pattern updated: update best memory, delete redundant ones
-- **Search threshold lowered:** Default `searchThreshold` reduced from `0.5` to `0.1` for broader recall. Removed hardcoded `0.6` recall-specific override: all searches now use the configured threshold
-- **Embedder dimension propagation:** Vector store config auto-resolves dimensions from embedder config when not explicitly set. Syncs `dimension` and `embeddingModelDims` fields for Qdrant/PGVector compatibility
-- **Config file write safety:** `writeFullConfig()` now re-reads and deep-merges the `plugins` section before writing, preserving `installs` and `slots` written by the OpenClaw gateway
-- **Additional embedder models:** Added `mxbai-embed-large` (1024), `all-minilm` (384), and `snowflake-arctic-embed` (1024) to known embedder dimensions
-
-**Security:**
-- Bumped `protobufjs` to `>=7.5.5` via pnpm overrides (GHSA-xq3m-2v4x-88gg) ([#5012](https://github.com/mem0ai/mem0/pull/5012))
-
-**Fixes:**
-- Moved `bootstrapTelemetryFlag()` and removed `ensureInstallRecord()` from module-level side effects: both now run inside `register()` to avoid crashes when loaded outside OpenClaw gateway
-- Fixed OSS history DB path resolution: absolute paths no longer passed through `resolvePath()`, preventing double-prefix bugs
-- Manifest `providerAuthEnvVars` replaced with spec-compliant `setup.providers` format using `id` + `envVars`
-
-**Dependencies:**
-- Bumped `mem0ai` from `3.0.1` to `3.0.2`
-- Bumped `pluginApi` and `minGatewayVersion` compat to `>=2026.4.24`
-
-</Update>
-
-<Update label="2026-04-23" description="v1.0.10">
-
-**Security:**
-- Telemetry `distinct_id` now uses SHA-256 instead of MD5: prevents rainbow-table reversal of API key hashes
-- User email is now SHA-256 hashed before sending as `distinct_id`: no PII in telemetry payloads
-- Declared PostHog telemetry endpoint (`us.i.posthog.com`) in `providerEndpoints`
-
-**Fixes:**
-- Fixed version-pinned install records preventing plugin updates. `ensureInstallRecord()` now detects semver-pinned specs (e.g. `@mem0/openclaw-mem0@1.0.7`) and rewrites them to `@latest` or `clawhub:` prefix so `openclaw plugins update` resolves to the newest release
-- Fixed `searchThreshold` default inconsistency: standardized to `0.3` across docs, README, and manifest
-- `PLUGIN_VERSION` now injected at build time via tsup `define` from `package.json`: no more hardcoded version strings
-
-**Manifest Compliance:**
-- Removed non-spec fields: `requiredEnvVars`, `dataLocations`, `privacy`, `setup` (with `externalEndpoints`, `providers`, `requiresRuntime`, `postInstallHint`)
-- Replaced `setup.externalEndpoints` with spec-compliant `providerEndpoints` using `endpointClass` + `hosts` format
-- Env var declarations now rely solely on `providerAuthEnvVars` (already spec-compliant)
-
-**Docs:**
-- Fixed `openclaw plugins update` command: uses plugin ID (`openclaw-mem0`), not npm package name (`@mem0/openclaw-mem0`)
-- Added update section to README
-- Removed redundant "Key Features" and "Conclusion" sections from integration docs
-
-</Update>
-
-<Update label="2026-04-22" description="v1.0.9">
-
-**Security & Compliance:**
-- Added top-level `requiredEnvVars` to plugin manifest, declaring env vars per mode (platform, OSS OpenAI, OSS Anthropic, OSS Ollama). Fixes ClaHub scanner "required env vars: none" mismatch
-- Added `sensitive: true` and descriptions to `apiKey` and `userEmail` in `configSchema`: previously only declared in `uiHints`
-- Added `default: false` with descriptions to `autoCapture` and `autoRecall` in `configSchema` so scanner can confirm opt-in defaults
-- Added `dataLocations` field to manifest declaring all persistence paths (config, vectorStore, historyDb, dreamState)
-- Added `privacy` field to manifest documenting data flow for platform vs open-source mode and credential storage guidance
-- Added `externalEndpoints` to `setup` section declaring api.mem0.ai and app.mem0.ai with purpose and requirement context
-
-**Tests:**
-- Replaced direct `process.env` access in `tests/cli-commands.test.ts` and `tests/fs-safe.test.ts` with `vi.stubEnv`/`vi.unstubAllEnvs`. Fixes ClaHub static analysis flag for "environment variable access combined with network send"
-- 421 tests across 15 test files
-
-</Update>
-
-<Update label="2026-04-21" description="v1.0.8">
-
-**New Features:**
-- **OSS Onboarding Wizard:** New guided 4-step interactive setup for open-source mode: walks through LLM provider, embedding provider, vector store, and user ID selection with prefilled defaults
-- **Agent-Friendly CLI:** Added `--json` flag to all 16 CLI commands for machine-readable output. Agents can call `openclaw mem0 help --json` to discover every command and flag
-- **Non-Interactive OSS Setup:** Added `--mode open-source` with `--oss-llm`, `--oss-embedder`, `--oss-vector` flags for fully automated OSS configuration without prompts
-- **JSON Helpers Module:** New `cli/json-helpers.ts` with `jsonOut`, `jsonErr`, and `redactSecrets` utilities for consistent structured output
-
-**Improvements:**
-- **Init Flow Redesigned:** Replaced 3-option flat menu with 2-level structure: Platform (email login or API key) and Open Source (guided wizard)
-- **Provider Selection:** LLM providers: OpenAI, Ollama, Anthropic. Embedding providers: OpenAI, Ollama. Vector stores: Qdrant, PGVector
-- **Input Prefill:** All prompts with defaults (base URL, user ID) now prefill the input field instead of showing defaults in brackets
-- **Smart Reuse:** When LLM and embedder use the same provider, API key and base URL are automatically reused from the LLM step
-- **Default Model:** Updated default LLM model to `gpt-5-mini`
-- **Manifest Compliance:** Removed undocumented fields, aligned env var declarations between SKILL.md and manifest, fixed `configSchema.required` for clean installs
-
-**Tests:**
-- 404 tests across 15 test files (+3 new: `json-helpers.test.ts`, `oss-wizard.test.ts`, `cli-commands.test.ts`)
-
-</Update>
-
-<Update label="2026-04-20" description="v1.0.7">
-
-**New Features:**
-- **Chat-Based Setup:** Added chat-based Platform setup flow: users can now configure the plugin conversationally instead of editing config files manually
-- **Installation Docs Rewrite:** Rewrote README and integration docs with chat-first setup, numbered manual steps.
-
-**Improvements:**
-- **SDK Upgrade:** Bumped `mem0ai` dependency to 3.0.1 for V3 API compatibility
-- **Config Cleanup:** Dropped deprecated `orgId`, `projectId`, `enableGraph` config options; updated CLI prompts ([#4734](https://github.com/mem0ai/mem0/pull/4734), [#4764](https://github.com/mem0ai/mem0/pull/4764))
-- **Noise Filtering:** Expanded noise patterns in memory add tool; handle leading text in JSON extraction
-
-</Update>
-
-<Update label="2026-04-11" description="v1.0.6">
-
-**Bug Fixes:**
-- **Telemetry:** Replaced shared `"anonymous-openclaw"` fallback with a persistent per-machine random hash (`openclaw-anon-<uuid>`), so anonymous plugin users are counted individually in PostHog ([#4790](https://github.com/mem0ai/mem0/pull/4790))
-- **Telemetry:** Added PostHog `$identify` event on first authenticated run to stitch anonymous history onto the authenticated profile ([#4790](https://github.com/mem0ai/mem0/pull/4790))
-- **Telemetry:** Fixed event loss on short-lived CLI invocations: added `beforeExit` handler to flush queued events before the process exits ([#4790](https://github.com/mem0ai/mem0/pull/4790))
-- **Telemetry:** Added lazy `/v1/ping/` email resolution so users who configure API key outside `mem0 init` show as their email in PostHog, not an md5 hash ([#4790](https://github.com/mem0ai/mem0/pull/4790))
-- **Telemetry:** Unified CLI event prefix from `openclaw.<cmd>` to `openclaw.cli.<cmd>` on the needsSetup branch to match the authenticated branch ([#4790](https://github.com/mem0ai/mem0/pull/4790))
-
-**Improvements:**
-- **API:** Added `source: "OPENCLAW"` to all provider calls (`add`, `search`, `getAll`) across tools, CLI commands, recall, and the OSS backend adapter ([#4790](https://github.com/mem0ai/mem0/pull/4790))
-
-</Update>
-
-<Update label="2026-04-07" description="v1.0.5">
-
-**Bug Fixes:**
-- **Init interactive choice bug**: Fixed number selection in `openclaw mem0 init`: entering 1/2/3 now correctly selects the corresponding option (was broken by readline prefill concatenating with user input)
-- **OSS pgvector crash** ([#4727](https://github.com/mem0ai/mem0/issues/4727)): Fixed "Client has already been connected" cascade when using pgvector in OSS mode. The warmup call swallowed errors leaving a half-initialized pg client; concurrent recall/capture then all hit `client.connect()` on the same client. Fix: let warmup errors propagate (so `initPromise` resets and retries with a fresh Memory + fresh pg client) and build fresh config objects per attempt instead of mutating shared state.
-
-**Removed:**
-- **`orgId` / `projectId` config parameters**: Removed from config schema, CLI (`config show/get/set`), init display, and providers. The API key is project-scoped, so separate org/project IDs are unnecessary and could cause access errors if mismatched.
-- **`enableGraph` config parameter**: Removed from all config surfaces, providers, backend, and tools. Graph memory is being deprecated: removing the flag avoids unnecessary exposure.
-
-</Update>
-
-<Update label="2026-04-04" description="v1.0.4">
-
-**New Features:**
-- **Interactive init flow**: `openclaw mem0 init` with interactive menu (email verification or direct API key). Non-interactive modes: `--api-key`, `--email`, `--email --code`
-- **`memory_add` tool**: Replaces `memory_store`: name now matches `mem0` CLI and platform API
-- **`memory_delete` tool**: Unified delete: single ID, search-then-delete, bulk, entity cascade. Replaces `memory_forget` and `memory_delete_all`
-- **CLI subcommands**: `openclaw mem0 init`, `openclaw mem0 status`, `openclaw mem0 config show`, `openclaw mem0 config set`
-- **`import` CLI command**: Bulk-import memories from a JSON file with `--user-id` and `--agent-id` overrides
-- **`event list` / `event status` CLI commands**: Monitor background processing events
-- **`fs-safe.ts` module**: Isolated filesystem wrappers in a separate entry point
-- **`backend/` module**: `PlatformBackend` with direct HTTP API access for CLI commands
-- **Plugin manifest**: Added `contracts.tools`, `configSchema`, and `uiHints` to `openclaw.plugin.json`
-- **Test suite**: 329 tests across 10 test files
-
-**Changes:**
-- **Modular architecture**: Extracted tools into `tools/` directory (6 files) and CLI into `cli/commands.ts`
-- **Code splitting**: tsup builds with `splitting: true` and two entry points
-- **Skills updated**: All SKILL.md files reference new tool names (`memory_add`, `memory_delete`)
-- **Auto-recall timeout**: Recall wrapped in 8-second `Promise.race`
-- **Auto-capture fire-and-forget**: `provider.add()` runs in background via `.then()/.catch()`
-- **Auto-capture minimum content gate**: Skips extraction when total user content is fewer than 50 chars
-
-**Removed:**
-- `memory_store` tool: replaced by `memory_add`
-- `memory_forget` tool: replaced by `memory_delete`
-- `memory_delete_all` tool: merged into `memory_delete`
-- `memory_history` tool and `history` CLI command: deprecated
-
-</Update>
-
-<Update label="2026-04-03" description="v1.0.3">
-
-**Bug Fixes:**
-- **Security**: Added `safePath()` containment helper to `readSkillFile` and `readDomainOverlay` in `skill-loader.ts`: prevents directory traversal
-- **Noise filter**: Reverted incorrect `After-Compaction` regex rename back to `Post-Compaction`
-
-**Changes:**
-- **Supply-chain hardening**: Pinned `mem0ai` dependency to exact `2.3.0` (was `^2.3.0`)
-
-**Tests:**
-- 12 new tests covering `safePath`, `readSkillFile`, `readDomainOverlay`, and `loadSkill` with traversal inputs
-
-</Update>
-
-<Update label="2026-04-02" description="v1.0.2">
-
-**Bug Fixes:**
-- **Security**: Removed `resolveEnvVars()` and `resolveEnvVarsDeep()` from `config.ts`: plugin-side env resolution was redundant and triggered static analysis warnings ([#4676](https://github.com/mem0ai/mem0/pull/4676))
-
-</Update>
-
-<Update label="2026-04-02" description="v1.0.1">
-
-**New Features:**
-- **CD workflow**: Added continuous deployment workflow with OIDC trusted publishing ([#4672](https://github.com/mem0ai/mem0/pull/4672))
-- **Plugin configuration manifest**: Added `compat` and `build` metadata to `package.json` ([#4667](https://github.com/mem0ai/mem0/pull/4667))
-- **LICENSE**: Added Apache-2.0 license file ([#4667](https://github.com/mem0ai/mem0/pull/4667))
-
-**Bug Fixes:**
-- **Dream gate**: Fixed cheap-first ordering, session isolation, and verified completion ([#4666](https://github.com/mem0ai/mem0/pull/4666))
-- **Graceful startup**: Plugin now starts gracefully when no API key is configured ([#4669](https://github.com/mem0ai/mem0/pull/4669))
-
-</Update>
-
-<Update label="2026-04-01" description="v1.0.0">
-
-**New Features:**
-- **Skills-based memory architecture**: New skill-loader and skill-based extraction pipeline with batched extraction ([#4624](https://github.com/mem0ai/mem0/pull/4624))
-- **Dream gate**: Memory consolidation and dream-cycle processing during idle periods
-- **Enhanced recall**: New `recall.ts` module with improved recall logic and skill-aware retrieval
-- **Memory triage skill**: Domain-aware memory triage with companion domain support and recall protocol
-- **Memory dream skill**: Skill for memory consolidation during idle periods
-- **Plugin configuration**: Added `openclaw.plugin.json` manifest and `scripts/configure.py` setup helper
-
-**Changes:**
-- Extraction pipeline refactored to use skills-based architecture for more contextual and higher quality memory capture
-
-</Update>
-
-<Update label="2026-03-26" description="v0.4.1">
-
-**New Features:**
-- **Improved extraction quality**: Enhanced noise filtering, deduplication, and better extraction instructions
-
-**Bug Fixes:**
-- **Credential detection**: Improved detection of credentials, API keys, and secrets in extraction instructions (#4552)
-- **Standalone timestamps**: Prevented extraction of standalone timestamps as memories (#4550)
-
-</Update>
-
-<Update label="2026-03-16" description="v0.4.0">
-
-**New Features:**
-- **Non-interactive trigger filtering**: Skips recall and capture for `cron`, `heartbeat`, `automation`, and `schedule` triggers
-- **Subagent hallucination prevention**: Detects ephemeral subagent sessions and routes recall to parent namespace
-- **Dynamic recall thresholding**: Memories scoring less than 50% of top result are dropped
-- **SQLite resilience**: Init error recovery with automatic retry for OSS mode
-- **`disableHistory` config option**: New `oss.disableHistory` flag
-- 78 unit tests covering filtering, isolation, trigger filtering, subagent detection, and SQLite resilience
-
-**Changes:**
-- Auto-recall threshold raised from 0.5 to 0.6 for stricter precision
-- Recall candidate pool increased to `topK * 2` for better filtering headroom
-- Relaxed extraction instructions: related facts kept together to preserve context
-
-**Bug Fixes:**
-- **Concurrent session race condition**: Lifecycle hooks now use `ctx.sessionKey` directly instead of a shared mutable variable
-
-</Update>
-
-<Update label="2026-03-12" description="v0.3.1">
-
-**New Features:**
-- **Message filtering pipeline**: Multi-stage noise removal before extraction
-- **Broad recall for new sessions**: Short or new-session prompts trigger secondary broad search
-- **Client-side threshold filtering**: Safety net that drops low-relevance results
-- **Temporal anchoring**: Extraction instructions now include current date
-- 55 unit tests covering filtering and isolation helpers
-
-**Changes:**
-- Extraction window expanded from last 10 to last 20 messages
-- Rewritten custom extraction instructions for conciseness and deduplication
-- Refactored monolithic `index.ts` (1772 lines) into 6 focused modules
-
-</Update>
-
-<Update label="2026-03-10" description="v0.3.0">
-
-**Bug Fixes:**
-- Updated `mem0ai` dependency with sqlite3 to better-sqlite3 migration (#4270)
-
-</Update>
-
-<Update label="2026-03-09" description="v0.2.0">
-
-**New Features:**
-- Per-agent memory isolation for multi-agent setups via `agentId`
-- "Understanding userId" section in docs
-
-**Changes:**
-- Updated config examples to use concrete `userId` values instead of placeholders
-
-**Bug Fixes:**
-- Migrated platform search to Mem0 v2 API
-
-</Update>
-
-<Update label="2026-02-19" description="v0.1.2">
-
-**New Features:**
-- Source field for openclaw memory entries
-
-**Bug Fixes:**
-- Auto-recall injection and auto-capture message drop
-
-</Update>
-
-<Update label="2026-02-02" description="v0.1.0">
-
-**New Features:**
-- Initial release of the OpenClaw Mem0 plugin
-- Platform mode (Mem0 Cloud) and open-source mode support
-- Auto-recall: inject relevant memories before each turn
-- Auto-capture: store facts after each turn
-- Configurable `topK`, `threshold`, and `apiVersion` options
-
-</Update>

docs/changelog/sdk.mdx

@@ -1583,6 +1583,16 @@ See the [TypeScript SDK migration guide](https://docs.mem0.ai/migration/ts-v2-to
 
 <Tab title="CLI">
 
+<Update label="2026-06-19" description="Python v0.2.8 / Node v0.2.9">
+
+**Security:**
+- **Telemetry key handling:** CLI telemetry no longer passes the Mem0 API key to a child process through command-line arguments. The context is sent over stdin, so the key is not visible in `ps`, `/proc/<pid>/cmdline`, or Activity Monitor. Fixes #4862.
+
+**Bug Fixes:**
+- **Python package version:** `__version__` now matches the packaged `mem0-cli` version.
+
+</Update>
+
 <Update label="2026-06-01" description="Node v0.2.8">
 
 **Security:**
@@ -1590,6 +1600,19 @@ See the [TypeScript SDK migration guide](https://docs.mem0.ai/migration/ts-v2-to
 
 </Update>
 
+<Update label="2026-05-20" description="Python v0.2.7 / Node v0.2.7">
+
+**New Features:**
+- **`mem0 whoami`:** Prints the active agent's `default_user_id` from local config without a network call.
+- **`mem0 agent-rush <add | search>`:** Wraps the `/v1/agent-rush/` platform endpoints for the AGENTRUSH game. Project routing is resolved server-side, and platform error codes are shown as actionable hints.
+- **PII safety prompt:** The first interactive `mem0 agent-rush add` asks users to acknowledge that AGENTRUSH memories are public. The acknowledgement is stored in `~/.mem0/config.json` under `agent_rush.acknowledged_at`.
+- **Config schema:** Added `agent_rush.acknowledged_at` for the local acknowledgement timestamp.
+
+**Changes:**
+- **Agent Rush telemetry:** Agent Rush commands send `X-Mem0-Mode: agent-rush` so platform telemetry can split game traffic from regular CLI usage.
+
+</Update>
+
 <Update label="2026-05-16" description="Python v0.2.6 / Node v0.2.6">
 
 **Bug Fixes:**
@@ -1706,13 +1729,639 @@ A full-featured command-line interface for Mem0, available in both Python and No
 
 <Tab title="Plugins">
 
-<Update label="2026-06-01" description="openclaw-mem0 v1.0.12">
+<Tabs>
+<Tab title="Mem0 Plugin">
 
-**Security:**
-- **Dependencies:** Pinned transitive dependencies via pnpm overrides to remediate high-severity CVEs: `protobufjs` → ^7.5.5, `vite` → ^8.0.5, `langsmith` → ^0.6.0 (CVE-2026-45134), `picomatch` → ^2.3.2 (CVE-2026-33671), `@qdrant/js-client-rest` → ^1.18.0
+<Update label="2026-06-25" description="mem0-plugin v0.2.11">
+
+**Fixes:**
+- **Session summary metadata:** `files_touched` now stores a real list instead of a double-encoded JSON string, so returned memories render readable file paths across Claude Code, Cursor, Codex, and Antigravity.
+
+**Improvements:**
+- **Reranked auto-injected context:** File-context, bash-error lookup, and session-resume prefetch now rerank by default. Disable with `MEM0_RERANK=0`, `false`, `no`, or `off`.
 
 </Update>
 
+<Update label="2026-06-25" description="mem0-plugin v0.2.10">
+
+**Fixes:**
+- **Editor telemetry attribution:** Antigravity is no longer counted as Claude Code, Codex no longer falls back to the generic `plugin` bucket, and Cursor wrappers now pin their platform before delegating to shared hook scripts.
+- **Per-editor plugin version:** Telemetry reads the manifest for the detected platform instead of always reading the Claude plugin manifest.
+
+**New Features:**
+- **`MEM0_PLATFORM` override:** Explicit platform markers now win over env-var auto-detection for reliable telemetry labels.
+
+</Update>
+
+<Update label="2026-06-25" description="mem0-plugin v0.2.9">
+
+**New Features:**
+- **File-context injection:** Before supported editors read a file, Mem0 searches for memories that reference that path and injects a compact prior-work timeline.
+- **Stop hook session summaries:** Session-end hooks store structured summaries with request, decisions, learnings, next steps, and files touched.
+- **SessionStart activity timeline:** Sessions with existing memories show recent decisions, bug fixes, and session summaries on startup.
+
+**Changes:**
+- Added shared `file_context.py`, `capture_session_summary.py`, and `session_timeline.py` helpers for the hook pipeline.
+
+</Update>
+
+<Update label="2026-06-25" description="mem0-plugin v0.2.8">
+
+**New Features:**
+- **Global search mode:** `global_search` lets reads search all users and projects in the platform project while writes stay scoped to the current `user_id` and `app_id`.
+- **Automatic coding categories:** The coding taxonomy is installed in the background on session start and gated by an API-key and taxonomy fingerprint.
+- **Global scope controls:** `/mem0:switch-project --global` and `/mem0:switch-project --no-global` persist global-search behavior in `~/.mem0/settings.json`.
+- **Scope-aware startup:** Session banners show `scope=global` when global search is active, and startup memory counts use the same global filter.
+- **Category setup state:** `~/.mem0/categories_setup.json` caches setup per Mem0 account and taxonomy fingerprint, so categories are applied once and re-applied only when the taxonomy changes.
+- **Tests:** Added coverage for category fingerprints, state-file gating, state save/load, and idempotent category application.
+
+**Changes:**
+- Session start spawns `auto_setup_categories.py` in the background alongside project-file auto-import.
+- Onboarding no longer asks users to install coding categories manually; it verifies status and applies categories only if the background run has not finished.
+- New-project startup copy now tells users that coding categories install automatically.
+
+</Update>
+
+<Update label="2026-06-25" description="mem0-plugin v0.2.7">
+
+**Fixes:**
+- **First-install auth:** Removed `authorizationUrl` from `.mcp.json` so Claude Code uses the `MEM0_API_KEY` header instead of falling into a broken OAuth reconnect flow.
+- **Onboarding auth copy:** `/mem0:onboard` no longer tells users to complete browser OAuth.
+- **Invalid configure command:** Removed `claude plugin configure mem0` references and clarified that Claude Code stores the plugin API key through the enable UI prompt.
+
+</Update>
+
+<Update label="2026-06-25" description="mem0-plugin v0.2.6">
+
+**Fixes:**
+- **Memory count and stats:** Removed the `run_id: "*"` filter from read paths so memories written without `run_id` are visible again.
+- **Write scoping:** `add_memory` moved session tracking from top-level `run_id` to `metadata.session_id`, keeping new memories in the default query partition.
+- **Session stats:** Memory add/search tracking moved into `enforce_metadata_defaults.sh`, because plugin MCP tools do not trigger PostToolUse hooks.
+- **Auto-capture reliability:** Added direct API auto-capture every third message plus a proportional prompt nudge when few memories have been stored.
+- **Desktop API keys:** `_identity.sh` and `_identity.py` can read `MEM0_API_KEY` from common shell profiles when Claude Code Desktop does not inherit shell env vars.
+- **Import cleanup:** Stale auto-import chunks now delete through the v1 delete endpoint, matching Mem0 v3 add behavior.
+
+**Removed:**
+- Removed Stop and SessionEnd hook capture paths, redundant post-commit/task/subagent scripts, dead settings, and the deleted file-read test.
+
+**Changes:**
+- Stats and tour now query with `user_id` + `app_id` filters only.
+- Session banners now tell agents to store learnings incrementally instead of waiting until session end.
+- Session-start resets per-user message counters so nudges begin cleanly.
+
+</Update>
+
+<Update label="2026-06-25" description="mem0-plugin v0.2.5">
+
+**Fixes:**
+- **Hook schema:** PostToolUse scripts now read `tool_response`, Stop hook output is schema-compliant, and SessionStart uses visible raw stdout.
+- **Tool coverage:** Memory write blocking includes `MultiEdit`, and metadata enforcement covers add, search, get, update, and delete-all variants.
+- **Identity injection:** `add_memory`, `search_memories`, `get_memories`, and `delete_all_memories` receive safe default `user_id` and `app_id` values when the agent omits them.
+- **Skill API calls:** Export, stats, pin, health, memory-reviewer, dream, tour, onboard, context-loader, and weekly stats examples now use the correct filter and `top_k` shapes.
+- **Compact summary capture:** `capture_compact_summary.py` is spawned correctly after compaction and guarded against unset identity variables.
+
+**New Features:**
+- **Stop hook analyzer:** Added `stop_hook_check.py` to detect meaningful work before prompting memory capture.
+- **Skill checklists:** Added progress checklists to `/mem0:dream` and `/mem0:onboard`.
+
+**Changes:**
+- `enforce_metadata_defaults.sh` was rewritten around handler-based dispatch and never overrides explicitly provided identity.
+
+</Update>
+
+<Update label="2026-06-25" description="mem0-plugin v0.2.4">
+
+**Fixes:**
+- **PostToolUse matcher:** Supports both `mcp__mem0__` and `mcp__plugin_mem0_mem0__` names so session stats record memory operations again.
+- **File-read noise:** File-read recall now prefers `metadata.files` plus score threshold before falling back to basename search.
+- **Pinning:** `/mem0:pin` no longer uses removed `immutable=True`; it relies on pinned metadata/text conventions.
+- **Project listing:** `/mem0:list-projects` merges null-scoped and app-scoped memories so legacy records are counted.
+- **ID lookup:** `/mem0:peek` routes memory-id references to `get_memory` instead of semantic search.
+
+**New Features:**
+- **Session ID capture:** SessionStart persists the Claude session ID for session-scoped memory operations.
+- **Search controls:** `_search.py` gained `min_score`, metadata filters, rerank, and threshold support.
+- **Reranked tour and peek:** `/mem0:tour` and `/mem0:peek` use reranking for better precision.
+
+**Removed:**
+- Removed the nonexistent `PostToolUseFailure` hook and the superseded `/mem0:protocol` skill.
+
+</Update>
+
+<Update label="2026-06-25" description="mem0-plugin v0.2.3">
+
+**New Features:**
+- **Read hook:** Added `PreToolUse(Read)` file recall with skip rules for non-code files, lockfiles, and `node_modules`.
+- **Shared search module:** Added `_search.py` for v3 search calls and consistent context formatting.
+- **Settings file:** Added `~/.mem0/settings.json` with search, retention, confidence, debug, and capture settings.
+- **Memory skills:** Added `/mem0:forget`, `/mem0:peek`, `/mem0:memory-reviewer`, and `/mem0:context-loader`.
+- **Compact output style:** Added compact `[type] content [mem0:id]` memory display.
+- **Claude userConfig:** Added sensitive `api_key` plugin config support.
+
+**Changes:**
+- Skills were renamed to shorter command names, bash-error hooks now run real searches, resume prompts prefetch context, and remember-intent phrases route to `/mem0:remember`.
+- API key resolution now checks `CLAUDE_PLUGIN_OPTION_API_KEY`, and hook timeouts increased for prompt and bash-output searches.
+
+**Removed:**
+- Removed `/mem0:dream --forget`, `/mem0:dream --schedule`, `/mem0:health --fix`, and CLI config fallback.
+
+</Update>
+
+<Update label="2026-06-25" description="mem0-plugin v0.2.2">
+
+**Fixes:**
+- **Compaction writes:** Prevented duplicate pre-compaction captures and shortened session-state content before letting Mem0 infer structured memories.
+- **Error detection:** Reduced false positives from routine test and linter output.
+- **Git commit noise:** Removed automatic background commit-context writes and gated post-commit prompts behind settings.
+- **Project identity:** Added git-remote hash fallback when folders are renamed.
+- **Dependency install race:** Added a lock and failure sentinel for `ensure_deps.sh`.
+- **Telemetry:** Switched `distinct_id` from MD5 to SHA-256, protected system props, and loaded plugin version from the manifest.
+
+**New Features:**
+- **Chunking and import:** Added shared chunking helpers and Markdown chunk imports.
+- **Metadata defaults:** Added `enforce_metadata_defaults.sh` for default confidence, source, and type on `add_memory`.
+- **Project utilities:** Added list-projects, all-project tour, weekly stats, dream forget mode, and competing-tools import.
+
+**Removed:**
+- Removed `on_pre_commit.py` and merged digest, forget, import-tools, and peek flows into existing skills.
+
+</Update>
+
+<Update label="2026-06-25" description="mem0-plugin v0.2.1">
+
+**New Features:**
+- **Skill suite:** Added 11 skills for dream, export, import, tool import, forget, health, peek, pin, remember, stats, and digest.
+- **Hook suite:** Added bash-error recall, git/commit context hooks, compaction recovery, session-end capture, subagent reminders, tool-failure recovery, and pre-commit capture.
+- **Telemetry:** Added sampled PostHog telemetry with no memory content or API keys and `MEM0_TELEMETRY=false` opt-out.
+- **Coding categories:** Added 10 more coding categories and dependency-managed SDK install through `ensure_deps.sh`.
+- **Project onboarding:** Added auto-onboarding, `mem0.md` config loading, inactive API-key banner, import/export parsers, and competing-tool import.
+
+**Changes:**
+- Memory scoping moved from `metadata.project_id` to top-level `app_id`, and write paths moved to `/v3/memories/add/`.
+- Session stats gained category counters and recent memory IDs.
+- Tour, onboard, prompt hooks, and MCP guidance were updated for project-aware workflows.
+
+**Fixes:**
+- Shared scripts now resolve plugin API-key env vars consistently and pass hook CWD into project/branch resolution.
+
+</Update>
+
+<Update label="2026-06-25" description="mem0-plugin v0.2.0">
+
+**New Features:**
+- **Project-scoped memories:** Deterministic project IDs from git remotes isolate memories per repo.
+- **Branch-aware tagging:** Session-state and compact-summary memories include branch metadata.
+- **Project file import:** SessionStart imports `CLAUDE.md`, `AGENTS.md`, `.cursorrules`, `.windsurfrules`, and `mem0.md` as project-profile memories.
+- **Active identity banner:** Startup shows user, project, branch, and memory count.
+- **Session report:** Stop hook reports memory writes, retrieves, and touched categories.
+- **Onboarding, tour, and switch-project skills:** Added first-run setup, proof-of-value browsing, and manual project override.
+- **Session stats tracker:** Added local add/search tracking for reports.
+
+</Update>
+
+<Update label="2026-04-02" description="mem0-plugin v0.1.3">
+
+**Fixes:**
+- **User ID regression:** `user_id` resolution no longer derives from `MEM0_API_KEY`, restoring `MEM0_USER_ID` to `$USER` to `default` order so older memories remain reachable.
+
+**Upgrade Notes:**
+- The `~/.mem0/identity.json` cache is no longer used.
+- Users who stored memories under the short-lived API-key hash can recover them by temporarily setting `MEM0_USER_ID` to the old hash.
+
+</Update>
+
+<Update label="2026-04-02" description="mem0-plugin v0.1.2">
+
+**New Features:**
+- **Identity resolver:** Added deterministic user-id resolver, later reverted in v0.1.3.
+- **Compact summaries:** Added SessionStart compact handler for `compact_summary` memories.
+- **Coding taxonomy setup:** Added one-shot coding category setup for architecture, anti-patterns, task learnings, tooling, bug fixes, conventions, and preferences.
+- **Debug logging:** Added opt-in hook logs with `MEM0_DEBUG=1`.
+- **Shared MCP skill:** Replaced the Claude-Code-specific Codex skill with `mem0-mcp`.
+
+**Fixes:**
+- Session IDs are stored in memory metadata, startup exits quietly without an API key, memory-write blocking avoids `docs/memory/*.md`, duplicate compact writes were removed, and hook captures now expire after 90 days.
+
+</Update>
+
+<Update label="2026-04-02" description="mem0-plugin v0.1.1">
+
+**Fixes:**
+- Cursor plugin became fully functional.
+- Codex plugin support and integration docs were added.
+- Codex lifecycle hooks became available through the opt-in installer.
+- Invalid Claude plugin config keys were removed.
+
+</Update>
+
+<Update label="2026-04-02" description="mem0-plugin v0.1.0">
+
+**Mem0 Plugin for Claude Code, Cursor, and Codex**
+
+Initial release of the Mem0 plugin for Claude Code and Cursor, followed by Codex support:
+
+- **9 MCP memory tools:** `add_memory`, `search_memories`, `get_memories`, `get_memory`, `update_memory`, `delete_memory`, `delete_all_memories`, `delete_entities`, `list_entities`: all via `mcp.mem0.ai`.
+- **Lifecycle hooks:** Automatic memory capture at session start, context compaction, task completion, and session end.
+- **Cloud MCP server:** Managed endpoint replaces local MCP and Smithery setup.
+- **Streamable HTTP transport:** New MCP transport protocol for real-time streaming.
+- **Codex-specific skill:** Dedicated skill in `mem0-plugin/skills/mem0-codex` for Codex workflows.
+
+</Update>
+
+</Tab>
+
+<Tab title="OpenCode">
+
+<Update label="2026-06-22" description="OpenCode plugin v0.2.0">
+
+**Breaking Changes:**
+- **Native SDK tools:** Memory tools are registered through `@opencode-ai/plugin` and backed by the `mem0ai` SDK directly. The plugin no longer registers or depends on `mcp.mem0.ai`.
+- **Skills load in place:** The `config` hook adds `opencode-skills/` to `skills.paths`; skills are no longer copied into user config directories.
+- **Focused skill set:** Trimmed to 9 skills: `context-loader`, `dream`, `forget`, `status`, `search`, `scope`, `pin`, `remember`, and `tour`.
+
+**New Features:**
+- **Memory scopes:** Memory operations support `project`, `session`, and `global` scope, with `/mem0-scope` for changing the default.
+- **Auto-dream:** Gated memory consolidation can merge duplicates, drop stale/sensitive entries, and rewrite vague memories.
+- **Expanded telemetry:** OpenCode emits the shared `plugin.*` schema, including prompt, bash-error, pre-compact, session-stop, dream-triggered, and dream-completed events.
+
+**Fixes:**
+- **Project ID detection:** Git remote parsing now handles HTTPS, SSH, and custom SSH host aliases before falling back to the repo root.
+- **Auto-dream visibility:** `/mem0-status` shows which dream gate is blocking consolidation.
+- **Delete-all safety:** User-wide deletes require explicit `scope="global"`, regardless of the default scope.
+
+</Update>
+
+<Update label="2026-06-22" description="OpenCode plugin v0.1.3">
+
+**New Features:**
+- **File-context injection:** Before a file read, the plugin searches for memories referencing that path and injects prior work as system context.
+- **Structured compaction summaries:** Session compaction stores `session_summary` memories with `infer=True`.
+- **Recent activity timeline:** Initial memory loading shows typed memories with age labels instead of bare text.
+- **PostHog telemetry:** Anonymous plugin telemetry uses the shared `plugin.*` schema and never sends memory content, prompts, or API keys.
+
+</Update>
+
+<Update label="2026-06-22" description="OpenCode plugin v0.1.2">
+
+**New Features:**
+- **Automatic coding categories:** Sets up 17 coding categories at startup, idempotently and in the background.
+- **Global search mode:** Adds `global_search` support across initial load, per-message recall, resume detection, error lookup, and compaction context.
+- **Global search env:** Exports `MEM0_GLOBAL_SEARCH` to child shells via the `shell.env` hook.
+
+**Changes:**
+- Search filters now follow the `global_search` setting instead of always using project-scoped filters.
+- Resume and error-pattern searches broadened by removing narrow metadata type filters.
+
+</Update>
+
+<Update label="2026-06-22" description="OpenCode plugin v0.1.1">
+
+**Changes:**
+- Renamed the package to `@mem0/opencode-plugin` ([#5272](https://github.com/mem0ai/mem0/pull/5272)).
+- Added the plugin array to the bundled `opencode.json` ([#5271](https://github.com/mem0ai/mem0/pull/5271)).
+- Fixed `tsconfig`, added `publishConfig` and the bun lockfile ([#5273](https://github.com/mem0ai/mem0/pull/5273)).
+- Validated the CI/CD publish flow ([#5288](https://github.com/mem0ai/mem0/pull/5288)).
+
+</Update>
+
+<Update label="2026-04-02" description="OpenCode plugin v0.1.0">
+
+**Initial Release:**
+- **Native OpenCode plugin:** Added `@mem0/opencode-plugin` with TypeScript hooks for chat messages, tool execution, system-message transforms, session compaction, and shell env injection.
+- **Memory tooling:** Added add, search, update, delete, delete-all, entity tools, session-start memory loading, per-prompt semantic search, error-pattern lookup, auto-capture, and compaction capture.
+- **Skills and commands:** Bundled 16 OpenCode-native Mem0 skills and slash commands.
+- **Safety:** Blocks `MEMORY.md` writes and redacts secrets before memory storage.
+
+</Update>
+
+</Tab>
+
+<Tab title="Antigravity">
+
+<Update label="2026-06-25" description="Antigravity plugin v0.1.3">
+
+**Fixes:**
+- **Readable session metadata:** Stop-hook session summaries now store `files_touched` as a real list instead of a double-encoded JSON string, so returned memories show clean file paths.
+
+**Improvements:**
+- **Reranked injected context:** File-context, bash-error lookup, and session-resume recall now rerank by default for higher-quality automatic context. Disable with `MEM0_RERANK=0`, `false`, `no`, or `off`.
+
+</Update>
+
+<Update label="2026-06-25" description="Antigravity plugin v0.1.2">
+
+**Fixes:**
+- **Telemetry attribution:** Antigravity is now reported as `antigravity` instead of being counted as Claude Code.
+- **Per-editor version reporting:** Telemetry reads Antigravity's own `plugin.json`, so events report the Antigravity plugin version instead of the Claude plugin version.
+
+**New Features:**
+- **Platform override support:** Shared scripts honor `MEM0_PLATFORM` when an editor needs to pin its telemetry platform explicitly.
+
+</Update>
+
+<Update label="2026-04-02" description="Antigravity plugin v0.1.0">
+
+**Initial Release:**
+- **Self-contained plugin:** Added Antigravity plugin packaging with `plugin.json`, `mcp_config.json`, `hooks.json`, lifecycle hooks, shared scripts, and shared Mem0 skills.
+- **AGENTS.md support:** Uses Antigravity's `contextFileName: "AGENTS.md"` convention.
+- **Shared memory layer:** Reuses the Mem0 Platform MCP server, shared hook scripts, and 16 slash-command skills.
+- **Lifecycle hooks:** Wires session start, user prompt, file read, memory-tool metadata enforcement, bash output, post-tool tracking, and stop summaries.
+- **Install options:** Supports `degit` installs into `~/.gemini/config/plugins/mem0` and local Antigravity plugin installs.
+- **Codex parity:** Added missing Codex Write/Edit/MultiEdit blocking and pre-compaction hooks during the shared-plugin restructure.
+
+</Update>
+
+</Tab>
+
+<Tab title="OpenClaw">
+
+<Update label="2026-06-12" description="openclaw-mem0 v1.0.13">
+
+**Fixes:**
+- **Custom categories payload:** `customCategories` is converted into the list shape expected by the Mem0 SDK before add calls ([#5345](https://github.com/mem0ai/mem0/pull/5345)).
+- **Metadata registration:** `register()` exits early in `cli-metadata` mode, avoiding backend initialization and hook installation during OpenClaw metadata scans ([#5383](https://github.com/mem0ai/mem0/pull/5383)).
+
+**Security:**
+- Bumped `mem0ai` to `3.0.7` and added a `uuid` override to resolve known dependency advisories ([#5460](https://github.com/mem0ai/mem0/pull/5460), [#5489](https://github.com/mem0ai/mem0/pull/5489)).
+
+**Improvements:**
+- **Repo consolidation:** OpenClaw moved to `integrations/openclaw/`; npm provenance now points to the correct subdirectory ([#5491](https://github.com/mem0ai/mem0/pull/5491)).
+
+</Update>
+
+<Update label="2026-06-02" description="openclaw-mem0 v1.0.12">
+
+**Docs:**
+- **Agent Mode onboarding:** README documents `mem0 init --agent --json` for autonomous setup without email, OTP, or browser.
+
+**Security:**
+- Added overrides for `langsmith`, `picomatch`, `vite`, and `@qdrant/js-client-rest`.
+
+**Dependencies:**
+- Bumped `mem0ai` to `3.0.3` and refreshed Vitest coverage tooling.
+
+</Update>
+
+<Update label="2026-04-29" description="openclaw-mem0 v1.0.11">
+
+**New Features:**
+- **Skills-mode auto-setup:** Onboarding enables triage, recall, dream consolidation, and full tool profile automatically.
+- **Memory runtime capability:** Exposes `runtime.getMemorySearchManager()` and `resolveMemoryBackendConfig()`.
+- **Dimension-aware collections:** OSS wizard creates a new collection when embedder dimensions change.
+- **Tool docs in skills:** Memory triage and dream skills now include full tool reference sections.
+
+**Improvements:**
+- Auto-capture and auto-recall default to enabled.
+- Skills prefer `memory_update` over delete+add for atomic edits.
+- Default search threshold lowered to `0.1` for broader recall.
+- Config writes preserve OpenClaw gateway `plugins` state.
+
+</Update>
+
+<Update label="2026-04-23" description="openclaw-mem0 v1.0.10">
+
+**Security:**
+- Telemetry identity now uses SHA-256 hashes instead of MD5, and user email is hashed before telemetry submission.
+
+**Fixes:**
+- Version-pinned installs are rewritten to updatable specs.
+- `searchThreshold` is standardized across docs, README, and manifest.
+- `PLUGIN_VERSION` is injected at build time from `package.json`.
+
+**Manifest Compliance:**
+- Removed non-spec manifest fields and moved endpoint declarations to spec-compliant `providerEndpoints`.
+
+</Update>
+
+<Update label="2026-04-22" description="openclaw-mem0 v1.0.9">
+
+**Security & Compliance:**
+- **Manifest security metadata:** Added required env var declarations, sensitive config schema fields, data locations, privacy notes, and external endpoint declarations for platform and OSS modes.
+- **Static-analysis cleanup:** Tests now use `vi.stubEnv` / `vi.unstubAllEnvs` instead of direct environment access in places flagged by plugin scanning.
+
+**Tests:**
+- Expanded coverage to 421 tests across 15 files.
+
+</Update>
+
+<Update label="2026-04-21" description="openclaw-mem0 v1.0.8">
+
+**New Features:**
+- **OSS onboarding wizard:** Guided setup for LLM provider, embedding provider, vector store, and user ID.
+- **Agent-friendly CLI:** `--json` added to all 16 CLI commands.
+- **Non-interactive OSS setup:** Added `--mode open-source` with `--oss-llm`, `--oss-embedder`, and `--oss-vector`.
+- **JSON helpers:** Added structured `jsonOut`, `jsonErr`, and `redactSecrets` helpers.
+
+</Update>
+
+<Update label="2026-04-20" description="openclaw-mem0 v1.0.7">
+
+**New Features:**
+- **Chat-based setup:** Users can configure the Mem0 platform connection inside OpenClaw chat instead of editing config files manually.
+
+**Improvements:**
+- **V3 SDK compatibility:** Bumped the `mem0ai` dependency to `3.0.1` for Mem0 v3 API support.
+- **Config cleanup:** Removed deprecated `orgId`, `projectId`, and `enableGraph` setup paths from docs and CLI prompts.
+- **Noise filtering:** Expanded memory-add filtering and improved JSON extraction when model output includes leading text.
+
+</Update>
+
+<Update label="2026-04-11" description="openclaw-mem0 v1.0.6">
+
+**Fixes:**
+- **Telemetry identity:** Anonymous users now get a persistent per-machine hash instead of the shared `anonymous-openclaw` fallback.
+- **Telemetry stitching:** First authenticated runs emit `$identify` so anonymous history can attach to the authenticated profile.
+- **CLI event flushing:** Short-lived CLI invocations flush queued telemetry before exit.
+- **Email resolution:** API-key-only users resolve email lazily through `/v1/ping/`.
+
+**Improvements:**
+- **OpenClaw source tag:** Provider calls now send `source: "OPENCLAW"` across add, search, list, recall, CLI, and OSS backend paths.
+
+</Update>
+
+<Update label="2026-04-07" description="openclaw-mem0 v1.0.5">
+
+**Fixes:**
+- **Init menu selection:** `openclaw mem0 init` number choices now select the intended option.
+- **OSS pgvector recovery:** Warmup errors now reset initialization so failed pgvector clients do not cascade into repeated `client.connect()` failures.
+
+**Removed:**
+- Removed `orgId`, `projectId`, and `enableGraph` from config, CLI, providers, backend, and tools because API keys are project-scoped and graph memory moved to platform-level configuration.
+
+</Update>
+
+<Update label="2026-04-04" description="openclaw-mem0 v1.0.4">
+
+**OpenClaw Plugin: Production-Ready**
+
+- **Interactive init flow:** `openclaw mem0 init` supports email verification and direct API key setup.
+- **Unified tools:** `memory_add` and `memory_delete` replace legacy memory tools and match Mem0 naming.
+- **CLI commands:** Added `init`, `status`, `config`, `import`, `event list`, and `event status`.
+- **Modular architecture:** Extracted tools, CLI, filesystem safety, and backend modules.
+- **Security and tests:** Added path traversal protection, pinned dependencies, and 329 tests across 10 files.
+
+</Update>
+
+<Update label="2026-04-03" description="openclaw-mem0 v1.0.3">
+
+**Fixes:**
+- **Path traversal protection:** Added `safePath()` containment checks for skill and domain-overlay reads.
+- **Noise filter correction:** Restored the `Post-Compaction` pattern after an incorrect rename.
+
+**Security:**
+- Pinned `mem0ai` to exact `2.3.0`.
+
+</Update>
+
+<Update label="2026-04-02" description="openclaw-mem0 v1.0.2">
+
+**Fixes:**
+- **Env resolution:** Removed plugin-side env-var expansion from config because OpenClaw already resolves env references before plugin registration.
+
+</Update>
+
+<Update label="2026-04-02" description="openclaw-mem0 v1.0.1">
+
+**New Features:**
+- **CD workflow:** Added trusted-publishing release workflow.
+- **Plugin metadata:** Added compatibility and build metadata to `package.json`.
+- **License:** Added Apache-2.0 license file.
+
+**Fixes:**
+- **Dream gate:** Fixed cheap-first ordering, session isolation, and completion verification.
+- **Graceful startup:** Plugin starts cleanly when no API key is configured.
+
+</Update>
+
+<Update label="2026-04-01" description="openclaw-mem0 v1.0.0">
+
+**New Features:**
+- **Skills-based memory architecture:** Added the skill loader, memory triage skill, memory dream skill, batched extraction, and skill-aware recall.
+- **Dream gate:** Added idle-period memory consolidation.
+- **Enhanced recall:** Added `recall.ts` with improved retrieval and injection logic.
+- **Plugin manifest:** Added `openclaw.plugin.json` and setup helper scripts.
+
+</Update>
+
+<Update label="2026-03-26" description="openclaw-mem0 v0.4.1">
+
+**New Features:**
+- **Extraction quality:** Improved noise filtering, deduplication, and extraction instructions.
+
+**Fixes:**
+- Improved credential, API key, and secret detection during extraction.
+- Prevented standalone timestamps from being stored as memories.
+
+</Update>
+
+<Update label="2026-03-16" description="openclaw-mem0 v0.4.0">
+
+**New Features:**
+- **Trigger filtering:** Skips recall and capture for cron, heartbeat, automation, and schedule triggers.
+- **Subagent isolation:** Routes ephemeral subagent sessions back to the parent namespace.
+- **Dynamic recall thresholding:** Drops candidates below 50% of the top score.
+- **OSS resilience:** Adds SQLite init retry and `oss.disableHistory`.
+
+**Fixes:**
+- Lifecycle hooks now use `ctx.sessionKey` directly, removing a concurrent-session race.
+
+</Update>
+
+<Update label="2026-03-12" description="openclaw-mem0 v0.3.1">
+
+**New Features:**
+- **Message filtering pipeline:** Multi-stage noise removal before extraction.
+- **Broad recall:** Short or new-session prompts trigger secondary broad search.
+- **Temporal anchoring:** Extraction instructions include the current date.
+
+**Changes:**
+- Extraction now reads the last 20 messages and the monolithic plugin file was split into focused modules.
+
+</Update>
+
+<Update label="2026-03-10" description="openclaw-mem0 v0.3.0">
+
+**Fixes:**
+- Updated `mem0ai` for the SQLite to `better-sqlite3` migration.
+
+</Update>
+
+<Update label="2026-03-09" description="openclaw-mem0 v0.2.0">
+
+**New Features:**
+- **Multi-agent isolation:** Added per-agent memory isolation via `agentId`.
+- **Docs:** Added guidance for understanding `userId`.
+
+**Fixes:**
+- Migrated platform search to the Mem0 v2 API.
+
+</Update>
+
+<Update label="2026-02-19" description="openclaw-mem0 v0.1.2">
+
+**New Features:**
+- Added a source field for OpenClaw memory entries.
+
+**Fixes:**
+- Fixed auto-recall injection and auto-capture message drops.
+
+</Update>
+
+<Update label="2026-02-02" description="openclaw-mem0 v0.1.0">
+
+**Initial Release:**
+- **Memory backend:** Added Mem0 Cloud and self-hosted OSS modes for OpenClaw.
+- **Auto-recall:** Injects relevant memories before each turn.
+- **Auto-capture:** Stores facts after each turn.
+- **Config:** Added `topK`, `threshold`, and `apiVersion` options.
+
+</Update>
+
+</Tab>
+
+<Tab title="Pi Agent">
+
+<Update label="2026-06-12" description="Pi Agent plugin v0.1.2">
+
+**Fixes:**
+- **Visible command feedback:** `/mem0-remember`, `/mem0-forget`, `/mem0-pin`, and `/mem0-scope` now render persistent message blocks instead of easy-to-miss status notifications.
+- **Relevance-filtered search:** Search, forget, and pin commands now pass `threshold`, `top_k`, and `rerank` to avoid weak unrelated matches.
+
+**Improvements:**
+- **Richer command output:** Commands show scope, query, match counts, and affected memories.
+- **Cleaner dream flow:** `/mem0-dream` keeps the consolidation protocol hidden behind a concise status line.
+- **Configurable relevance floor:** `searchThreshold` defaults to `0.3` in `mem0-config.json` and is shown in `/mem0-status`.
+
+</Update>
+
+<Update label="2026-06-10" description="Pi Agent plugin v0.1.1">
+
+**Chores:**
+- Version bump to validate the new `pi-agent-plugin-checks.yml` and `pi-agent-plugin-cd.yml` release pipeline.
+
+</Update>
+
+<Update label="2026-06-09" description="Pi Agent plugin v0.1.0">
+
+**Initial Release:**
+- **Extension entry point:** Registers the `mem0_memory` tool, 8 slash commands, and auto-capture hooks.
+- **Agent tool:** Supports search, add, get-all, delete, and delete-all with scoped filters.
+- **Slash commands:** Adds `/mem0-remember`, `/mem0-forget`, `/mem0-search`, `/mem0-tour`, `/mem0-dream`, `/mem0-pin`, `/mem0-scope`, and `/mem0-status`.
+- **Auto-capture:** Extracts and stores memories from user and assistant messages on `agent_end`.
+- **Dream consolidation:** Merges duplicates, resolves contradictions, and prunes stale entries behind session, time, and memory-count gates.
+- **System prompt injection:** Appends `MEMORY_POLICY` before every agent turn.
+- **Project scoping:** Uses `git rev-parse --show-toplevel` for stable `app_id` values across monorepos.
+- **Scopes and categories:** Supports project, session, and global scopes plus 10 default memory categories.
+- **Agent skills:** Bundles `context-loader`, `remember`, `search`, `forget`, `dream`, `tour`, `pin`, and `status` skills.
+- **Safety:** Confirmation dialogs protect destructive commands, pins preserve memory IDs, full memory UUIDs stay visible, outputs are truncated, all tool actions respect `AbortSignal`, and shutdown releases dream locks.
+- **Telemetry:** Batched PostHog telemetry uses PII-safe error payloads.
+
+</Update>
+
+</Tab>
+
+<Tab title="Vercel AI SDK">
+
 <Update label="2026-06-10" description="Vercel AI SDK v3.0.0">
 
 **Major Release**: Migrated to Vercel AI SDK v6 (`LanguageModelV3` / `ProviderV3`) and Mem0 v3 API.
@@ -1726,6 +2375,10 @@ A full-featured command-line interface for Mem0, available in both Python and No
 **New Features:**
 - **V3 provider contract:** `specificationVersion: 'v3'`, `supportedUrls` property, V3 content array in `doGenerate`, V3 stream lifecycle events in `doStream` ([#4741](https://github.com/mem0ai/mem0/pull/4741))
 - **Mem0 source in responses:** Memories are attached as a `source` in `generateText`/`streamText` responses with `providerMetadata.mem0.memories` for programmatic access ([#4741](https://github.com/mem0ai/mem0/pull/4741))
+- **Raw search helper:** `searchMemories()` is exported alongside `addMemories()`, `retrieveMemories()`, and `getMemories()` for callers that need raw semantic search results.
+- **Self-hosted API support:** `mem0ApiKey` and `host` can be passed per request, letting apps override the environment API key and point at a custom Mem0 API base URL.
+- **Provider coverage:** Built-in provider selection covers OpenAI, Anthropic, Google/Gemini, Groq, and Cohere through the AI SDK provider packages.
+- **Multimodal memory input:** File, image, Markdown, and PDF prompt parts are converted into the Mem0-compatible message shape when adding or searching memories.
 
 **Bug Fixes:**
 - **Async memory storage:** `addMemories` is now properly `await`ed: memories no longer silently fail to store ([#4741](https://github.com/mem0ai/mem0/pull/4741))
@@ -1743,21 +2396,6 @@ A full-featured command-line interface for Mem0, available in both Python and No
 
 </Update>
 
-<Update label="2026-04-02" description="mem0-plugin v1.0.0">
-
-**Mem0 Plugin for Claude Code, Cursor, and Codex**
-
-The unified Mem0 plugin for AI development environments:
-
-- **9 MCP memory tools:** `add_memory`, `search_memories`, `get_memories`, `get_memory`, `update_memory`, `delete_memory`, `delete_all_memories`, `delete_entities`, `list_entities`: all via `mcp.mem0.ai`
-- **Lifecycle hooks:** Automatic memory capture at session start, context compaction, task completion, and session end
-- **Cloud MCP server:** Managed endpoint replaces local MCP and Smithery setup
-- **Streamable HTTP transport:** New MCP transport protocol for real-time streaming
-- **Codex-specific skill:** Dedicated skill in `mem0-plugin/skills/mem0-codex` for Codex workflows
-- **Supported editors:** Claude Code, Claude Cowork, Cursor, Codex
-
-</Update>
-
 <Update label="2025-12-26" description="Vercel AI SDK v2.0.5">
 **Bug Fix:**
 - Removed unnecessary dependencies to make the package lighter.
@@ -1805,6 +2443,9 @@ The unified Mem0 plugin for AI development environments:
 - Added support for graph memories.
 </Update>
 
+</Tab>
+</Tabs>
+
 </Tab>
 
 </Tabs>

docs/docs.json

@@ -135,20 +135,6 @@
                   }
                 ]
               },
-              {
-                "tab": "OpenClaw",
-                "groups": [
-                  {
-                    "group": "Agent Harness",
-                    "icon": "robot",
-                    "pages": [
-                      "integrations/openclaw",
-                      "integrations/hermes",
-                      "integrations/pi-agent"
-                    ]
-                  }
-                ]
-              },
               {
                 "tab": "Open Source",
                 "groups": [
@@ -574,8 +560,7 @@
                     "pages": [
                       "changelog/highlights",
                       "changelog/sdk",
-                      "changelog/platform",
-                      "changelog/openclaw"
+                      "changelog/platform"
                     ]
                   }
                 ]
@@ -629,6 +614,10 @@
     ]
   },
   "redirects": [
+    {
+      "source": "/changelog/openclaw",
+      "destination": "/changelog/sdk"
+    },
     {
       "source": "/components/rerankers/models/llm",
       "destination": "/components/rerankers/models/llm_reranker"