#1 Persistent memory for AI coding agents based on real-world benchmarks
TypeScript agentmemoryagentsaiclaudeclaudecodecodexcopilotcursorgenaiharnesshermesmemoryompopenclawopencodepi
chore: prepare 0.9.31 (#1612)
Rohit Ghumarebb8f0508cdc0
diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.jsonindex f1c6698c..4cabbe10 100644--- a/.cursor-plugin/plugin.json+++ b/.cursor-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "agentmemory",- "version": "0.9.30",+ "version": "0.9.31","description": "Persistent memory for Cursor: auto-captures sessions, prompts, and tool use via hooks, recalls with hybrid BM25 + vector + graph search, and exposes 54 memory tools over MCP. Keyless by default, runs entirely on your machine.","author": {"name": "Rohit Ghumare",diff --git a/.env.example b/.env.exampleindex 4699a9b9..e325877f 100644--- a/.env.example+++ b/.env.example@@ -133,11 +133,11 @@# -----------------------------------------------------------------------------# AGENTMEMORY_AUTO_COMPRESS=true # Run LLM-written compression on every observation batch. Requires BOTH this flag and a configured provider; a provider alone leaves synthetic compression active.-# AGENTMEMORY_INJECT_CONTEXT=true # Inject recalled memories back into agent prompts. Default off — hooks capture observations but do not modify conversation.-# CONSOLIDATION_ENABLED=true # Run the 4-tier consolidation pipeline (memories → semantic → procedural). Default off — opt in once you've measured the LLM cost.+# AGENTMEMORY_INJECT_CONTEXT=true # Opt in to Claude-style hook context injection. Pi/OMP use 1 in their launch environment for file enrichment; native prompt recall is independent.+# CONSOLIDATION_ENABLED=false # Disable the consolidation pipeline. Otherwise enabled when an LLM provider is configured, unless AGENTMEMORY_PROVIDER=noop.# CONSOLIDATION_DECAY_DAYS=30 # Age (days) after which non-reinforced memories decay during consolidation# GRAPH_EXTRACTION_ENABLED=true # Extract concept-graph edges on remember; powers the graph-traversal recall path-# GRAPH_EXTRACTION_BATCH_SIZE=8 # Memories per graph-extraction batch+# GRAPH_EXTRACTION_BATCH_SIZE=10 # Memories per graph-extraction batch# Local reasoning models only: set to 1 to ask the model to skip its# hidden thinking pass during graph extraction. Extraction runs several@@ -145,7 +145,7 @@# the model think (default).# AGENTMEMORY_LLM_NOTHINK=1-# AGENTMEMORY_REFLECT=true # Periodically auto-synthesize lessons from memories+# AGENTMEMORY_REFLECT=true # Enable slot reflection; requires AGENTMEMORY_SLOTS=true# AGENTMEMORY_DROP_STALE_INDEX=true # Drop on-disk BM25 / vector index on startup if dim guard fires. Recovery toggle for stuck-state debugging.# AGENTMEMORY_IMAGE_EMBEDDINGS=true # Enable image embeddings when an image provider is present (experimental).# AGENTMEMORY_AUDIT_RETENTION_MONTHS=6 # Drop whole audit-log month scopes older than N months on a daily sweep. Default 0 = keep audit history forever.@@ -161,7 +161,7 @@# -----------------------------------------------------------------------------# AGENTMEMORY_TOOLS=core # all (54 tools, default) | core (8 tools): surface exposed to MCP clients-# AGENTMEMORY_SLOTS=memory # Comma-separated plugin slot names the CLI should claim+# AGENTMEMORY_SLOTS=true # Enable structured memory slots (default off)# AGENTMEMORY_DEBUG=1 # Trace MCP shim probe + standalone fallback decisions to stderr# AGENTMEMORY_FORCE_PROXY=1 # Skip the MCP shim livez probe and trust AGENTMEMORY_URL (for sandboxed MCP clients that can't reach localhost)# AGENTMEMORY_PROBE_TIMEOUT_MS=2000 # MCP shim livez probe timeout@@ -181,7 +181,7 @@# AGENTMEMORY_ENV_FILE=/absolute/path/to/.env # Config file override (default ~/.agentmemory/.env)# AGENTMEMORY_EXPORT_ROOT=~/agentmemory-backup # Root directory for Obsidian vault exports-# AGENTMEMORY_STATE_BACKEND=redis # file (default) | redis — backend used by the state worker, see README "Storage backend"+# AGENTMEMORY_STATE_BACKEND=redis # file (default) | redis — see docs/reliability/state-storage.md# AGENTMEMORY_REDIS_URL=redis://localhost:6379 # Required when AGENTMEMORY_STATE_BACKEND=redis# STANDALONE_MCP=1 # MCP shim only — bypass the worker and run @agentmemory/mcp in-processdiff --git a/AGENTS.md b/AGENTS.mdindex 21b81dec..6c88f558 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -107,7 +107,7 @@ Hook scripts in `src/hooks/` are standalone Node.js scripts (no iii-sdk import).- Test files go in `test/` with `.test.ts` extension- Follow existing patterns in `test/crystallize.test.ts` for function tests-## Current Stats (v0.9.30)+## Current Stats (v0.9.31)- 54 MCP tools visible by default; `AGENTMEMORY_TOOLS=core` selects 8 essentials- 146 REST endpointsdiff --git a/CHANGELOG.md b/CHANGELOG.mdindex d7045cec..abac402c 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -6,8 +6,30 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),## [Unreleased]+## [0.9.31] — 2026-10-25+### Upgrade notes++- **The runtime moves to iii 0.25.0 and Worker Compose.** Stop the existing instance with its old CLI before upgrading, then restart with the same instance, port and data directory. File state, the daemon secret and Docker data volumes are preserved. The CLI no longer uses `AGENTMEMORY_USE_DOCKER`, `AGENTMEMORY_III_CONFIG` or custom `iii-config.yaml` files; Docker deployments use the shared deployment image. Follow the [upgrade guide](docs/upgrades/iii-0.25.md) for these installation changes.+- **Viewer updates use authenticated SSE** on the REST port at `/agentmemory/viewer/events`; port 3112 is unused. `agentmemory console` now prints migration guidance and the viewer URL. The viewer remains on port 3113 by default. Status reports the configured engine pin as `service.enginePinnedVersion` instead of `engineVersion`.+- **Narrative recall now returns structured JSON through MCP.** Read the `text` field for the narrative and the accompanying budget metadata for omitted or shortened results. See [recall guidance](docs/recall.md).+- Full historical vector recovery requires `AGENTMEMORY_VECTOR_BACKFILL=all` on each start and processes at most `AGENTMEMORY_VECTOR_BACKFILL_MAX` missing records per start. Keyword search remains available while recovery is paused. See [vector recovery](docs/reliability/source-and-vector-recovery.md) before rebuilding an old index.+- Re-run `agentmemory connect pi --with-mcp` or `agentmemory connect omp --with-mcp` after upgrading to refresh their bundled paths and skills. Existing DSH hook-bridge installations migrate with `agentmemory connect dsh --with-hooks --force`; the connector backs up configuration and preserves unrelated entries.++### Added++- **Installable Pi package and native OMP integration.** Pi's `@agentmemory/pi` package contains the compiled extension and shared skills. Both connectors install project recall, capture, native memory tools and optional MCP, with bounded offline capture queues. The connector works before the separate Pi package's first npm publication.+- **Native DSH capture** ships inside AgentMemory, with prompt, tool and assistant-reply capture, privacy filtering and offline recovery. No separate capture package is needed (#1609, including instruction-file setup by hejiawow).+- **Cursor workspace resolution** maps lifecycle hooks to the correct project using validated paths and local session metadata, with detached stop/session-end delivery (#1112).+- **Paged exports** support `collectionLimit`, `collectionOffset` and `collections` through REST and MCP. Partial exports cannot be imported with `strategy: "replace"`.+- **Compression recovery** preserves searchable captures after optional model compression fails. `agentmemory compression` inspects failures and supports scoped retries; summary repair resumes after late capture and restart.+### Fixed+- Saved-memory recall preserves project and agent scope, supports memory-only retrieval and retains recovery references when a token budget omits content. Graph retrieval uses bounded shared reads and keeps each observation's best score; optional reranking uses the model's actual paired-query scores.+- Vector recovery retains unfinished work across checkpoints, provider failures and restarts. Redis state mutations serialize per key within a worker, and deletion keeps graph and facet indexes consistent.+- Imports validate collection shapes and row keys before a replace operation deletes stored data. The import observation ceiling no longer changes with the ordinary capture limit.+- Hooks capture final assistant replies and distinguish separate subagent, task and notification events. Structured redaction preserves identifiers and retained custom-event content remains searchable.+- MCP keeps routine logs off stdout and reports when a write only reached its local fallback store. The viewer loads actions beyond the first page.- **JSONL import keeps real session times and no longer duplicates on re-import.** `parseJsonlText` took `startedAt`/`endedAt` from the first and last line even when it was a timestampless metadata entry (`last-prompt`, `cost-state`), so the session got the import time. It now uses only entries that carry a timestamp. Observation ids are derived from the entry `uuid` (or session id and line position when absent) instead of a random id, so importing the same transcript again overwrites the same rows, and `observationCount` counts only rows that were new. Rows imported by earlier versions keep their random ids, so the first re-import after upgrading adds one last copy.- **Session summaries cover the whole session again** (#745). 0.9.30 completed a session on the first per-turn Stop and ignored every later end, so summaries and graph extraction stopped at turn 1. `mem::observe` now reopens a completed session when new observations arrive, the Stop hook sends `final: false` so the session stays open, and an idle finalizer completes it once nothing has happened for `AGENTMEMORY_FINALIZE_IDLE_MS` (default 2 minutes). SessionEnd, the CLI and the OpenCode plugin send `final: true` and complete at once; a request without the flag behaves as before. The sweep summarizes a session before marking it abandoned (#737).- **The Devin plugin captures sessions.** A plugin install loaded `hooks/hooks.json`, whose capitalized Claude Code matchers never match Devin's tool names and whose extra events Devin rejects, so capture never fired. `plugin/hooks.json` now carries the six Devin hooks with lowercase matchers, and Devin loads it first. Verified on Devin CLI 3000.11.3: one session recorded session start, prompt, tool use and session end.@@ -15,6 +37,8 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),### Changed+- **Publishing verifies the exact gated tarballs.** The workflow checks SHA512 integrity and signed provenance against the source repository, workflow, ref and commit before accepting an existing version or completing publication. Conflicting artifacts fail instead of being skipped.+- Shared agent skills now describe the current runtime, credential discovery, native integrations and capture limits. The README and translations link to current setup, storage and upgrade guidance.- The Devin plugin manifest adds a display name and logo, says it is for Devin CLI and Devin Desktop only, and runs `@agentmemory/mcp` at the release version instead of the latest one. `npm run docs:sync` moves that pin on each version bump.- `@agentmemory/mcp` pins the exact matching `@agentmemory/agentmemory` release instead of a `~` range, so an installed shim never resolves a newer runtime than the one it was published with.@@ -273,6 +297,7 @@ Wave release closing several breaking regressions reported against v0.9.26, plus- `/agentmemory:forget` skill still calls `memory_governance_delete` which only touches `KV.memories` and never observations ([#833](https://github.com/rohitg00/agentmemory/issues/833)). Skill rewrite + new `memory_forget` MCP tool tracked separately.- `crypto.randomUUID()` global-only on Node <19 ([#715](https://github.com/rohitg00/agentmemory/issues/715)). Drop-in import fix tracked.+[0.9.31]: https://github.com/rohitg00/agentmemory/compare/v0.9.30...v0.9.31[0.9.30]: https://github.com/rohitg00/agentmemory/compare/v0.9.29...v0.9.30[0.9.29]: https://github.com/rohitg00/agentmemory/compare/v0.9.28...v0.9.29[0.9.28]: https://github.com/rohitg00/agentmemory/compare/v0.9.27...v0.9.28diff --git a/deploy/README.md b/deploy/README.mdindex 1c1e4ee5..6cb8a73e 100644--- a/deploy/README.md+++ b/deploy/README.md@@ -1,6 +1,6 @@# Docker deployments-agentmemory 0.9.30 runs on iii 0.25.0 with the `state` 0.22.20 and `http` 0.22.7 registry workers. All image builds use one [`Dockerfile`](Dockerfile), with engine and registry worker pins declared once. Update those build arguments together when promoting a release. Workers are fetched from the iii registry at startup; the `worker-compose.yaml` uses the same Worker Compose format as the CLI.+agentmemory runs on iii 0.25.0 with the `state` 0.22.20 and `http` 0.22.7 registry workers. All image builds use one [`Dockerfile`](Dockerfile), with engine and registry worker pins declared once. Update those build arguments together when promoting a release. Workers are fetched from the iii registry at startup; the `worker-compose.yaml` uses the same Worker Compose format as the CLI.The container runs `iii compose --up`: Compose owns the engine and supervises `state`, `http`, and the local `agentmemory` worker. There is no legacy embedded engine config, standalone stream, pubsub, or queue worker. The registry worker artifacts are pinned in the compose manifest. Engine and worker state, agentmemory state, generated secret, Compose cache, and logs live on the persistent `/data` volume. For Docker Compose, the volume key is `iii-data`, normally stored as `<compose-project>_iii-data`; set `AGENTMEMORY_DATA_DIR` to a host path to use a bind mount instead. The state worker continues to use `/data/state_store.db`, so the existing 0.22.1 file-based store is read in place without conversion or deletion.diff --git a/integrations/hermes/plugin.yaml b/integrations/hermes/plugin.yamlindex ed484d35..95eca81e 100644--- a/integrations/hermes/plugin.yaml+++ b/integrations/hermes/plugin.yaml@@ -1,5 +1,5 @@name: agentmemory-version: 0.9.30+version: 0.9.31description: "Persistent memory for Hermes Agent with profile-scoped capture, recall, and native memory tools."author: "Rohit Ghumare"homepage: "https://github.com/rohitg00/agentmemory"diff --git a/integrations/omp/package.json b/integrations/omp/package.jsonindex 8e2369a6..47419e64 100644--- a/integrations/omp/package.json+++ b/integrations/omp/package.json@@ -2,7 +2,7 @@"name": "agentmemory-omp-extension","private": true,"type": "module",- "version": "0.9.30",+ "version": "0.9.31","omp": {"name": "agentmemory","description": "Persistent cross-session memory for omp \u2014 captures sessions, tools, approvals, and compaction; injects smart-search recall.",diff --git a/integrations/openclaw/openclaw.plugin.json b/integrations/openclaw/openclaw.plugin.jsonindex dd90fb9c..eae33a5c 100644--- a/integrations/openclaw/openclaw.plugin.json+++ b/integrations/openclaw/openclaw.plugin.json@@ -3,7 +3,7 @@"kind": "memory","name": "agentmemory","description": "Persistent cross-session memory for OpenClaw via agentmemory.",- "version": "0.9.30",+ "version": "0.9.31","configSchema": {"type": "object","additionalProperties": false,diff --git a/integrations/openclaw/package.json b/integrations/openclaw/package.jsonindex 39d57c49..b5829608 100644--- a/integrations/openclaw/package.json+++ b/integrations/openclaw/package.json@@ -1,6 +1,6 @@{"name": "agentmemory",- "version": "0.9.30",+ "version": "0.9.31","type": "module","openclaw": {"extensions": [diff --git a/integrations/openclaw/plugin.yaml b/integrations/openclaw/plugin.yamlindex 09a12036..e7b0bdeb 100644--- a/integrations/openclaw/plugin.yaml+++ b/integrations/openclaw/plugin.yaml@@ -1,5 +1,5 @@name: agentmemory-version: 0.9.30+version: 0.9.31description: "Persistent cross-session memory for OpenClaw via agentmemory."author: "Rohit Ghumare"homepage: "https://github.com/rohitg00/agentmemory"diff --git a/package.json b/package.jsonindex a63663d3..3df4c8cc 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "@agentmemory/agentmemory",- "version": "0.9.30",+ "version": "0.9.31","description": "Persistent memory for AI coding agents, powered by iii-engine's three primitives","type": "module","main": "dist/index.mjs",diff --git a/packages/mcp/package.json b/packages/mcp/package.jsonindex b2301cc4..4b7c132e 100644--- a/packages/mcp/package.json+++ b/packages/mcp/package.json@@ -1,6 +1,6 @@{"name": "@agentmemory/mcp",- "version": "0.9.30",+ "version": "0.9.31","description": "Standalone MCP server for agentmemory — thin shim that re-exposes @agentmemory/agentmemory's MCP entrypoint","type": "module","bin": {@@ -28,7 +28,7 @@"homepage": "https://github.com/rohitg00/agentmemory#readme","bugs": "https://github.com/rohitg00/agentmemory/issues","dependencies": {- "@agentmemory/agentmemory": "0.9.30"+ "@agentmemory/agentmemory": "0.9.31"},"publishConfig": {"access": "public",diff --git a/plugin/.claude-plugin/plugin.json b/plugin/.claude-plugin/plugin.jsonindex 44e0dac5..826990cc 100644--- a/plugin/.claude-plugin/plugin.json+++ b/plugin/.claude-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "agentmemory",- "version": "0.9.30",+ "version": "0.9.31","description": "Persistent memory for AI coding agents -- captures tool usage, compresses via LLM, injects context into future sessions. 12 hooks, 54 MCP tools, 17 skills, real-time viewer.","author": {"name": "Rohit Ghumare",diff --git a/plugin/.codex-plugin/plugin.json b/plugin/.codex-plugin/plugin.jsonindex f06523f6..f4ccc88a 100644--- a/plugin/.codex-plugin/plugin.json+++ b/plugin/.codex-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "agentmemory",- "version": "0.9.30",+ "version": "0.9.31","description": "Local persistent memory for coding agents. Recall decisions, resume sessions, learn from corrections, and manage memory through 54 MCP tools and 17 skills. Optional capture through 6 Codex hooks.","author": {"name": "Rohit Ghumare",diff --git a/plugin/.devin-plugin/plugin.json b/plugin/.devin-plugin/plugin.jsonindex 4a73bda1..8caf4fc6 100644--- a/plugin/.devin-plugin/plugin.json+++ b/plugin/.devin-plugin/plugin.json@@ -1,7 +1,7 @@{"name": "agentmemory","displayName": "agentmemory",- "version": "0.9.30",+ "version": "0.9.31","description": "Persistent memory for Devin CLI and Devin Desktop. Captures every session automatically, recalls with hybrid BM25 + vector + graph search, and exposes 54 memory tools over MCP. Keyless by default, runs on your machine. Not supported in cloud sessions.","logo": "assets/icon.svg","author": {@@ -23,7 +23,7 @@"command": "npx","args": ["-y",- "@agentmemory/[email protected]"+ "@agentmemory/[email protected]"],"env": {"AGENTMEMORY_URL": "${AGENTMEMORY_URL:-http://localhost:3111}",diff --git a/plugin/opencode/plugin.json b/plugin/opencode/plugin.jsonindex 02a334f7..a53650ac 100644--- a/plugin/opencode/plugin.json+++ b/plugin/opencode/plugin.json@@ -1,6 +1,6 @@{"name": "agentmemory-capture",- "version": "0.9.30",+ "version": "0.9.31","description": "OpenCode plugin for agentmemory — full Claude Code hook parity: session lifecycle (create/idle/status/compacted/update/diff/delete/error), messages & prompts (chat.message, message.updated user+assistant, message.removed), tool lifecycle (ToolPart states with timing), part tracking (subtask, step-finish, reasoning, file, patch, compaction, agent, retry), file enrichment pipeline, permissions, task tracking (w/ priority), commands, config & model tracking. 22 hooks, 2 slash commands.","author": {"name": "Rohit Ghumare",diff --git a/plugin/plugin.json b/plugin/plugin.jsonindex 2577bd9e..f78c5ad8 100644--- a/plugin/plugin.json+++ b/plugin/plugin.json@@ -1,6 +1,6 @@{"name": "agentmemory",- "version": "0.9.30",+ "version": "0.9.31","description": "Persistent memory for AI coding agents -- captures tool usage, compresses via LLM, injects context into future sessions. 12 hooks, 54 MCP tools, 17 skills, real-time viewer.","author": {"name": "Rohit Ghumare",diff --git a/plugin/scripts/plugin-bridge.mjs b/plugin/scripts/plugin-bridge.mjsindex 75203ef5..5b490165 100644--- a/plugin/scripts/plugin-bridge.mjs+++ b/plugin/scripts/plugin-bridge.mjs@@ -3,7 +3,7 @@ import { readFileSync, realpathSync } from "node:fs";import { homedir } from "node:os";import { join } from "node:path";//#region src/version.ts-const VERSION = "0.9.30";+const VERSION = "0.9.31";//#endregion//#region src/secret-store.tsconst SECRET_KEY = "AGENTMEMORY_SECRET";diff --git a/plugin/skills/_shared/TROUBLESHOOTING.md b/plugin/skills/_shared/TROUBLESHOOTING.mdindex 7578c143..96707419 100644--- a/plugin/skills/_shared/TROUBLESHOOTING.md+++ b/plugin/skills/_shared/TROUBLESHOOTING.md@@ -11,7 +11,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -23,10 +25,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -41,9 +44,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/agentmemory-agents/SKILL.md b/plugin/skills/agentmemory-agents/SKILL.mdindex 3eb20e98..ced3c2ef 100644--- a/plugin/skills/agentmemory-agents/SKILL.md+++ b/plugin/skills/agentmemory-agents/SKILL.md@@ -16,6 +16,18 @@ After wiring, restart the host or run its MCP reload (for example `/mcp` in ClauDevin CLI and Devin Desktop can also install the whole plugin with `devin plugins install rohitg00/agentmemory#plugin`, which adds the skills, the MCP server, and the capture hooks in one step. Cloud Devin sessions cannot reach a local agentmemory server, so the plugin is for local sessions only.+For Pi, Oh My Pi, or DeepSeek Harness, start the daemon and choose the matching command:++```bash+agentmemory connect pi --with-mcp+agentmemory connect omp --with-mcp+agentmemory connect dsh --with-hooks+```++Pi and OMP install native recall, capture and bundled skills; `--with-mcp` adds the tools needed by the broader workflows. Reload Pi with `/reload`, or restart OMP, then run `/agentmemory-status`. Restart DSH after enabling its bundled capture plugin. Re-run the matching connector after upgrading or moving AgentMemory so installed runtime paths stay current.++Cursor's connector configures MCP. Install and enable the Cursor plugin through Settings → Plugins → Add marketplace → this repository for lifecycle capture; do not add a second global hook copy.+## Workflow1. Detect the calling agent. If unknown, ask which host to configure before changing files.@@ -24,8 +36,8 @@ Devin CLI and Devin Desktop can also install the whole plugin with `devin plugin## Notes-- Skills install separately: `npx [email protected] add rohitg00/agentmemory --agent hermes-agent --skill '*'` or use `--agent openclaw`. Choose the intended host; add `--global` only for a user-wide installation. Verify skill discovery and read a skill's local support file in that host.-- Windows: use WSL2. Native Windows runs the server but `connect` is not supported there.+- Hermes, OpenClaw, Pi and OMP connectors bundle skills. For a separate skills installation, use `npx [email protected] add rohitg00/agentmemory --agent hermes-agent --skill '*'` or `--agent openclaw`. Choose the intended host; add `--global` only for a user-wide installation. Avoid duplicate skill installations when a native package already bundles them. Verify skill discovery and read a skill's local support file in that host.+- Native Windows supports `agentmemory connect copilot-cli`. Other automated connectors require macOS, Linux or a host running in the same WSL2 environment; use the host's manual setup instructions otherwise.## See alsodiff --git a/plugin/skills/agentmemory-agents/TROUBLESHOOTING.md b/plugin/skills/agentmemory-agents/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/agentmemory-agents/TROUBLESHOOTING.md+++ b/plugin/skills/agentmemory-agents/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/agentmemory-architecture/TROUBLESHOOTING.md b/plugin/skills/agentmemory-architecture/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/agentmemory-architecture/TROUBLESHOOTING.md+++ b/plugin/skills/agentmemory-architecture/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/agentmemory-config/REFERENCE.md b/plugin/skills/agentmemory-config/REFERENCE.mdindex 281f7c87..7d58384e 100644--- a/plugin/skills/agentmemory-config/REFERENCE.md+++ b/plugin/skills/agentmemory-config/REFERENCE.md@@ -87,4 +87,4 @@ Configuration is read from the environment and from `~/.agentmemory/.env` (no `e- `AGENTMEMORY_STATE_BACKEND`: `file` (default) or `redis`. Anything else stops startup with an error.- `AGENTMEMORY_REDIS_URL`: required with `redis`, plain `redis://` only (the pinned state worker has no Redis TLS). The URL never appears in `/agentmemory/status` or the viewer.-Switching backends starts from an empty store; move data with `/agentmemory/export` and `/agentmemory/import`. Give each concurrent instance its own Redis database or server so their state cannot mix. Viewer events are broadcast by the running agentmemory process; they do not rely on Redis pub/sub. See the README section "Storage backend: file (default) vs redis".+Changing backends selects the target backend's existing data; a new target starts empty. It does not move or delete the old data. Pause writes and back up the original store before moving supported collections with `/agentmemory/export` and `/agentmemory/import`. Give each concurrent instance its own Redis database or server so their state cannot mix. Viewer events are broadcast by the running agentmemory process; they do not rely on Redis pub/sub. See the [state storage guide](https://github.com/rohitg00/agentmemory/blob/main/docs/reliability/state-storage.md) for persistence, isolation and migration details.diff --git a/plugin/skills/agentmemory-config/SKILL.md b/plugin/skills/agentmemory-config/SKILL.mdindex 1784a3fb..9dd46a31 100644--- a/plugin/skills/agentmemory-config/SKILL.md+++ b/plugin/skills/agentmemory-config/SKILL.md@@ -26,6 +26,7 @@ agentmemory reads configuration from the environment and from `~/.agentmemory/.eallowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).Only the local secret is read from the daemon's `.env`; other settings are notautomatically inherited by the MCP host.+ `AGENTMEMORY_CREDENTIAL_MODE=explicit` disables local credential discovery.5. Describe the observed mode. Codex's bundled bridge requires the daemon andnever silently saves into a fallback store. Other hosts using the standaloneshim may expose only seven basic tools when the daemon is unavailable.@@ -52,7 +53,8 @@ AGENTMEMORY_INJECT_CONTEXT=true- Basic keyword recall requires no API key. Local embeddings are optional andneed explicit configuration and model downloads; do not promise vector searchuntil it is enabled.-- Token-spending features ship OFF on purpose: `AGENTMEMORY_AUTO_COMPRESS` (LLM summaries) and `AGENTMEMORY_INJECT_CONTEXT` (auto context injection) both cost tokens proportional to tool-use frequency.+- Per-observation LLM compression (`AGENTMEMORY_AUTO_COMPRESS=true`) and Claude-style hook injection (`AGENTMEMORY_INJECT_CONTEXT=true`) are opt-in. Session summaries can use a configured LLM provider even when automatic observation compression is off. Native integrations have independent recall settings: Pi and OMP recall before prompts by default, and use `AGENTMEMORY_INJECT_CONTEXT=1` in the host launch environment for optional file enrichment. Do not apply daemon `.env` settings to every host implicitly.+- Consolidation is enabled when an LLM provider is configured unless explicitly disabled or `AGENTMEMORY_PROVIDER=noop`. Set `CONSOLIDATION_ENABLED=false` to disable it. Structured slots require `AGENTMEMORY_SLOTS=true`; slot reflection also requires `AGENTMEMORY_REFLECT=true`.- Tool visibility: set `AGENTMEMORY_TOOLS=all` (default) or `core` on the daemon,then restart it and reconnect MCP so the host refreshes its tool list.- Data stays in the configured local daemon store. Enabled external model@@ -64,6 +66,8 @@ AGENTMEMORY_INJECT_CONTEXT=trueREST defaults to port `3111`, the viewer to `3113`, and the internal engine WebSocket to `49134`. Set `--port <N>` or `--instance <N>` to select another local runtime.+Normal CLI startup manages the engine and its workers through Worker Compose. Use `agentmemory status` for runtime health and the active viewer URL. `agentmemory console` only prints migration guidance; it no longer starts a bundled engine console.+## See also- agentmemory-rest-api for how the secret is used.diff --git a/plugin/skills/agentmemory-config/TROUBLESHOOTING.md b/plugin/skills/agentmemory-config/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/agentmemory-config/TROUBLESHOOTING.md+++ b/plugin/skills/agentmemory-config/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/agentmemory-hooks/SKILL.md b/plugin/skills/agentmemory-hooks/SKILL.mdindex 3147d628..80b30127 100644--- a/plugin/skills/agentmemory-hooks/SKILL.md+++ b/plugin/skills/agentmemory-hooks/SKILL.md@@ -23,7 +23,9 @@ devin plugins install rohitg00/agentmemory#pluginRun `/hooks` inside Devin to confirm the agentmemory hooks are loaded. Plugin hooks run only in local Devin sessions, not in cloud sessions.-Hermes and OpenClaw use their native integrations and lifecycle contracts. Follow the matching integration setup instructions and verify a real turn creates an observation. Installing shared skills or connecting MCP alone does not enable automatic capture. Watch recorded observations in the viewer at `http://localhost:3113` when using the default port.+Pi and OMP install native recall and capture with `agentmemory connect pi --with-mcp` or `agentmemory connect omp --with-mcp`. Reload Pi or restart OMP, then inspect `/agentmemory-status`. DSH requires `agentmemory connect dsh --with-hooks` and a restart. Cursor lifecycle hooks come from its enabled plugin, separately from `connect cursor`'s MCP setup.++Hermes and OpenClaw use their native integrations and lifecycle contracts. Follow the matching integration setup instructions and verify a real turn creates an observation. Installing shared skills or connecting MCP alone does not enable automatic capture. Watch recorded observations in the viewer at `http://localhost:3113` when using the default port. A pending capture queue is not proof that the daemon stored the event.## What the hooks do@@ -34,7 +36,7 @@ Hermes and OpenClaw use their native integrations and lifecycle contracts. Follo## Important-- The plugin hooks capture by default without an LLM. Summary generation (`AGENTMEMORY_AUTO_COMPRESS`) and hook context injection (`AGENTMEMORY_INJECT_CONTEXT`) are separate options. Native integrations have their own recall/capture settings; inspect the host configuration instead of assuming these flags control every plugin.+- The plugin hooks capture by default without an LLM. Per-observation LLM compression (`AGENTMEMORY_AUTO_COMPRESS`) and hook context injection (`AGENTMEMORY_INJECT_CONTEXT`) are separate options. Session summaries can use a configured LLM provider independently of automatic observation compression. Native integrations have their own recall/capture settings; inspect the host configuration instead of assuming these flags control every plugin.- If observations are missing, confirm the plugin is enabled and the server is running. See [TROUBLESHOOTING.md](TROUBLESHOOTING.md).## See alsodiff --git a/plugin/skills/agentmemory-hooks/TROUBLESHOOTING.md b/plugin/skills/agentmemory-hooks/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/agentmemory-hooks/TROUBLESHOOTING.md+++ b/plugin/skills/agentmemory-hooks/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/agentmemory-mcp-tools/SKILL.md b/plugin/skills/agentmemory-mcp-tools/SKILL.mdindex 4da2b2ce..59f6e15f 100644--- a/plugin/skills/agentmemory-mcp-tools/SKILL.md+++ b/plugin/skills/agentmemory-mcp-tools/SKILL.md@@ -4,7 +4,7 @@ description: Map of every agentmemory MCP tool, what each does, and its parameteuser-invocable: false----This skill indexes agentmemory's MCP tools. Use the connected server's tool inventory and schemas; a native memory provider may expose a smaller set under different names. Hermes and OpenClaw skills that need the full surface require a separate MCP connection to the running daemon.+This skill indexes agentmemory's MCP tools. Use the connected server's tool inventory and schemas; a native memory provider may expose a smaller set under different names. Hermes and OpenClaw skills that need the full surface require a separate MCP connection to the running daemon. For Pi and OMP, connect with `--with-mcp` to enable the broader workflows. Pi exposes MCP names with an `mcp__agentmemory__` prefix; OMP exposes MCP operations as `xd://mcp__agentmemory_<tool>` devices through its `write` tool.## Quick startdiff --git a/plugin/skills/agentmemory-mcp-tools/TROUBLESHOOTING.md b/plugin/skills/agentmemory-mcp-tools/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/agentmemory-mcp-tools/TROUBLESHOOTING.md+++ b/plugin/skills/agentmemory-mcp-tools/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/agentmemory-rest-api/TROUBLESHOOTING.md b/plugin/skills/agentmemory-rest-api/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/agentmemory-rest-api/TROUBLESHOOTING.md+++ b/plugin/skills/agentmemory-rest-api/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/commit-context/TROUBLESHOOTING.md b/plugin/skills/commit-context/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/commit-context/TROUBLESHOOTING.md+++ b/plugin/skills/commit-context/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/commit-history/TROUBLESHOOTING.md b/plugin/skills/commit-history/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/commit-history/TROUBLESHOOTING.md+++ b/plugin/skills/commit-history/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/forget/TROUBLESHOOTING.md b/plugin/skills/forget/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/forget/TROUBLESHOOTING.md+++ b/plugin/skills/forget/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/handoff/TROUBLESHOOTING.md b/plugin/skills/handoff/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/handoff/TROUBLESHOOTING.md+++ b/plugin/skills/handoff/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/lesson/TROUBLESHOOTING.md b/plugin/skills/lesson/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/lesson/TROUBLESHOOTING.md+++ b/plugin/skills/lesson/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/memory-discipline/TROUBLESHOOTING.md b/plugin/skills/memory-discipline/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/memory-discipline/TROUBLESHOOTING.md+++ b/plugin/skills/memory-discipline/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/recall/TROUBLESHOOTING.md b/plugin/skills/recall/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/recall/TROUBLESHOOTING.md+++ b/plugin/skills/recall/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/recap/TROUBLESHOOTING.md b/plugin/skills/recap/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/recap/TROUBLESHOOTING.md+++ b/plugin/skills/recap/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/remember/TROUBLESHOOTING.md b/plugin/skills/remember/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/remember/TROUBLESHOOTING.md+++ b/plugin/skills/remember/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/session-history/TROUBLESHOOTING.md b/plugin/skills/session-history/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/session-history/TROUBLESHOOTING.md+++ b/plugin/skills/session-history/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/plugin/skills/write-agentmemory-skill/TROUBLESHOOTING.md b/plugin/skills/write-agentmemory-skill/TROUBLESHOOTING.mdindex d1e52724..deab28e3 100644--- a/plugin/skills/write-agentmemory-skill/TROUBLESHOOTING.md+++ b/plugin/skills/write-agentmemory-skill/TROUBLESHOOTING.md@@ -12,7 +12,9 @@ explicitly reduced tool surface. Walk these in order:1. Identify the host. In Claude Code, inspect `/plugin list` and `/mcp`.In Hermes, inspect the configured memory provider and `mcp_servers` separately.In OpenClaw, validate the host configuration and inspect its MCP servers and- native plugins separately. Do not run another host's setup commands.+ native plugins separately. In Pi or OMP, inspect `/agentmemory-status` and the+ MCP inventory separately; native save/search does not prove the broader tools+ are connected. Do not run another host's setup commands.2. Restart or reload the affected host connection after configuration changes.3. Inspect the connected tool inventory. Hermes may namespace MCP tools; invokethe actual advertised names and schemas. A native memory provider is not@@ -24,10 +26,11 @@ explicitly reduced tool surface. Walk these in order:5. If `agentmemory connect codex` and the Codex plugin are both enabled, chooseone MCP connection. Check `/hooks` before adding global hook fallbacks.-Skills are installed separately from the native provider. Check the host's skill-inventory and open this file from the installed skill directory. Test automatic-capture with a real turn and a recorded observation; tool connectivity alone-does not establish lifecycle capture.+Hermes, OpenClaw, Pi and OMP connector installations bundle skills; other hosts+may install them separately. Check the host's skill inventory and open this file+from the installed skill directory. Test automatic capture with a real turn and+a recorded observation; tool connectivity alone does not establish lifecycle+capture.An outage or timeout is not an empty search result. Report the failure. A writemay have committed before the response was lost; inspect state before retrying.@@ -42,9 +45,11 @@ API directly:`AGENTMEMORY_SECRET`; for loopback URLs only, fall back to the secret in`~/.agentmemory/.env` and then `~/.agentmemory/secret`. Load the value locallywithout displaying it. Never send a local-file secret to a remote URL.+ If `AGENTMEMORY_CREDENTIAL_MODE=explicit`, require the explicit host credential+ and do not read local credential files.Authenticated REST fallback requests require HTTPS for non-loopbackURLs; HTTP is allowed for loopback URLs (`localhost`, `127.0.0.0/8`, or `[::1]`).- Do not print or save the secret.+ Reject redirects on authenticated requests. Do not print or save the secret.Endpoint map by skill:diff --git a/scripts/docs-sync.state.json b/scripts/docs-sync.state.jsonindex 95a2662a..2693ada3 100644--- a/scripts/docs-sync.state.json+++ b/scripts/docs-sync.state.json@@ -1,5 +1,5 @@{- "version": "0.9.30",+ "version": "0.9.31","facts": {"mcpTools": ["54"diff --git a/scripts/docs-sync.ts b/scripts/docs-sync.tsindex b5257b53..7c38f119 100644--- a/scripts/docs-sync.ts+++ b/scripts/docs-sync.ts@@ -254,7 +254,6 @@ function replaceFact(text: string, fact: Fact, olds: string[], next: string): stconst VERSION_FILES: Array<{ file: RegExp; pattern: (v: string) => RegExp; replace: (v: string) => string }> = [{ file: /(^|\/)(package|plugin|openclaw\.plugin)\.json$/, pattern: (v) => new RegExp(`("version":\\s*")${escapeRegex(v)}(")`), replace: (v) => `$1${v}$2` },- { file: /^integrations\/hermes\/plugin\.yaml$/, pattern: (v) => new RegExp(`^(version:\\s*)${escapeRegex(v)}$`, "m"), replace: (v) => `$1${v}` },{ file: /^deploy\/.*(Dockerfile|\.ya?ml)$/, pattern: (v) => new RegExp(`(AGENTMEMORY_VERSION[=:]\\s*"?|value:\\s*")${escapeRegex(v)}\\b`, "g"), replace: (v) => `$1${v}` },{ file: /^src\/version\.ts$/, pattern: (v) => new RegExp(`(VERSION = ")${escapeRegex(v)}(")`), replace: (v) => `$1${v}$2` },{ file: /^AGENTS\.md$/, pattern: (v) => new RegExp(`(## Current Stats \\(v)${escapeRegex(v)}(\\))`), replace: (v) => `$1${v}$2` },@@ -322,6 +321,10 @@ function main(): void {if (ompManifest) {files.set(ompPath, ompManifest.replace(/("version":\s*")[^"]+(")/, `$1${version}$2`));}+ for (const path of ["integrations/hermes/plugin.yaml", "integrations/openclaw/plugin.yaml"]) {+ const pluginManifest = files.get(path);+ if (pluginManifest) files.set(path, pluginManifest.replace(/^(version:\s*)[^\r\n]+$/m, `$1${version}`));+ }if (version !== state.version) {for (const extra of ["src/types.ts", "src/functions/export-import.ts", "CHANGELOG.md"]) {if (!files.has(extra)) files.set(extra, read(extra));diff --git a/scripts/release-gate/openclaw.mjs b/scripts/release-gate/openclaw.mjsindex 3df513ff..6e02c8e0 100644--- a/scripts/release-gate/openclaw.mjs+++ b/scripts/release-gate/openclaw.mjs@@ -34,7 +34,7 @@ const backendHome = join(root, "backend-home");const secret = randomBytes(24).toString("hex");const hash = (path) => createHash("sha256").update(readFileSync(path)).digest("hex");const hashes = Object.fromEntries([cli, join(pkg, "dist/standalone.mjs"), join(plugin, "plugin.mjs"), join(plugin, "openclaw.plugin.json")].map((path) => [path, hash(path)]));-const baseEnv = (home) => ({ HOME: home, USERPROFILE: home, PATH: `${dirname(options.node)}:/usr/bin:/bin:/opt/homebrew/bin`, TMPDIR: join(root, "tmp"), NO_COLOR: "1", CI: "1" });+const baseEnv = (home) => ({ HOME: home, USERPROFILE: home, PATH: `${dirname(options.node)}:/usr/bin:/bin:/usr/sbin:/sbin:/opt/homebrew/bin`, TMPDIR: join(root, "tmp"), NO_COLOR: "1", CI: "1" });mkdirSync(join(root, "tmp"), { recursive: true });async function run(args, env, cwd, name, timeoutMs = 90_000) {const result = await runCommand(options.node, args, { env, cwd, children, timeoutMs });diff --git a/scripts/release-gate/skills.mjs b/scripts/release-gate/skills.mjsindex c6c20a28..122790a1 100644--- a/scripts/release-gate/skills.mjs+++ b/scripts/release-gate/skills.mjs@@ -24,7 +24,7 @@ const cwd = join(root, "project");for (const dir of [home, cwd, join(home, ".agentmemory/bin"), join(root, "tmp")]) mkdirSync(dir, { recursive: true });copyFileSync(options.engine, join(home, ".agentmemory/bin/iii"));chmodSync(join(home, ".agentmemory/bin/iii"), 0o755);-const baseEnv = (userHome) => ({ HOME: userHome, USERPROFILE: userHome, PATH: `${dirname(options.node)}:/usr/bin:/bin:/opt/homebrew/bin`, XDG_CONFIG_HOME: join(userHome, ".config"), XDG_CACHE_HOME: join(userHome, ".cache"), TMPDIR: join(root, "tmp"), CI: "1", NO_COLOR: "1", DO_NOT_TRACK: "1", III_TELEMETRY_ENABLED: "false" });+const baseEnv = (userHome) => ({ HOME: userHome, USERPROFILE: userHome, PATH: `${dirname(options.node)}:/usr/bin:/bin:/usr/sbin:/sbin:/opt/homebrew/bin`, XDG_CONFIG_HOME: join(userHome, ".config"), XDG_CACHE_HOME: join(userHome, ".cache"), TMPDIR: join(root, "tmp"), CI: "1", NO_COLOR: "1", DO_NOT_TRACK: "1", III_TELEMETRY_ENABLED: "false" });const env = { ...baseEnv(home), AGENTMEMORY_TOOLS: "all", AGENTMEMORY_AUTO_COMPRESS: "false", AGENTMEMORY_INJECT_CONTEXT: "false", AGENTMEMORY_READY_TIMEOUT_MS: "60000", AGENTMEMORY_ENGINE_READY_TIMEOUT_MS: "60000" };const receipts = [];const children = new Set();@@ -105,7 +105,7 @@ try {daemon = spawn(options.node, [cli, "--port", String(port), "--data-dir", join(root, "state")], { cwd, env, detached: true, stdio: ["ignore", fd, fd] });closeSync(fd); children.add(daemon.pid);await waitFor(async () => {- assert(daemon.exitCode === null, `Daemon exited ${daemon.exitCode}`);+ assert(daemon.signalCode === null && (daemon.exitCode === null || daemon.exitCode === 0), `Daemon launcher exited ${daemon.signalCode ?? daemon.exitCode}`);try {secret = readFileSync(join(home, ".agentmemory/secret"), "utf8").trim();return secret.length > 0 && (await rest("/health")).status === 200;diff --git a/src/functions/export-import.ts b/src/functions/export-import.tsindex 80cef8f2..05d7ff78 100644--- a/src/functions/export-import.ts+++ b/src/functions/export-import.ts@@ -310,7 +310,7 @@ export function registerExportImportFunction(sdk: IIIClient, state: StateKV): voconst strategy = data.strategy || "merge";const importData = data.exportData;- const supportedVersions = new Set(["0.3.0", "0.4.0", "0.5.0", "0.6.0", "0.6.1", "0.7.0", "0.7.2", "0.7.3", "0.7.4", "0.7.5", "0.7.6", "0.7.7", "0.7.9", "0.8.0", "0.8.1", "0.8.2", "0.8.3", "0.8.4", "0.8.5", "0.8.6", "0.8.7", "0.8.8", "0.8.9", "0.8.10", "0.8.11", "0.8.12", "0.8.13", "0.9.0", "0.9.1", "0.9.2", "0.9.3", "0.9.4", "0.9.5", "0.9.6", "0.9.7", "0.9.8", "0.9.9", "0.9.10", "0.9.11", "0.9.12", "0.9.13", "0.9.14", "0.9.15", "0.9.16", "0.9.17", "0.9.18", "0.9.19", "0.9.20", "0.9.21", "0.9.22", "0.9.23", "0.9.24", "0.9.25", "0.9.26", "0.9.27", "0.9.28", "0.9.29", "0.9.30"]);+ const supportedVersions = new Set(["0.3.0", "0.4.0", "0.5.0", "0.6.0", "0.6.1", "0.7.0", "0.7.2", "0.7.3", "0.7.4", "0.7.5", "0.7.6", "0.7.7", "0.7.9", "0.8.0", "0.8.1", "0.8.2", "0.8.3", "0.8.4", "0.8.5", "0.8.6", "0.8.7", "0.8.8", "0.8.9", "0.8.10", "0.8.11", "0.8.12", "0.8.13", "0.9.0", "0.9.1", "0.9.2", "0.9.3", "0.9.4", "0.9.5", "0.9.6", "0.9.7", "0.9.8", "0.9.9", "0.9.10", "0.9.11", "0.9.12", "0.9.13", "0.9.14", "0.9.15", "0.9.16", "0.9.17", "0.9.18", "0.9.19", "0.9.20", "0.9.21", "0.9.22", "0.9.23", "0.9.24", "0.9.25", "0.9.26", "0.9.27", "0.9.28", "0.9.29", "0.9.30", "0.9.31"]);if (!supportedVersions.has(importData.version)) {return {success: false,diff --git a/src/types.ts b/src/types.tsindex e2871326..27eda567 100644--- a/src/types.ts+++ b/src/types.ts@@ -390,7 +390,7 @@ export interface ExportCollectionPagination {}export interface ExportData {- version: "0.3.0" | "0.4.0" | "0.5.0" | "0.6.0" | "0.6.1" | "0.7.0" | "0.7.2" | "0.7.3" | "0.7.4" | "0.7.5" | "0.7.6" | "0.7.7" | "0.7.9" | "0.8.0" | "0.8.1" | "0.8.2" | "0.8.3" | "0.8.4" | "0.8.5" | "0.8.6" | "0.8.7" | "0.8.8" | "0.8.9" | "0.8.10" | "0.8.11" | "0.8.12" | "0.8.13" | "0.9.0" | "0.9.1" | "0.9.2" | "0.9.3" | "0.9.4" | "0.9.5" | "0.9.6" | "0.9.7" | "0.9.8" | "0.9.9" | "0.9.10" | "0.9.11" | "0.9.12" | "0.9.13" | "0.9.14" | "0.9.15" | "0.9.16" | "0.9.17" | "0.9.18" | "0.9.19" | "0.9.20" | "0.9.21" | "0.9.22" | "0.9.23" | "0.9.24" | "0.9.25" | "0.9.26" | "0.9.27" | "0.9.28" | "0.9.29" | "0.9.30";+ version: "0.3.0" | "0.4.0" | "0.5.0" | "0.6.0" | "0.6.1" | "0.7.0" | "0.7.2" | "0.7.3" | "0.7.4" | "0.7.5" | "0.7.6" | "0.7.7" | "0.7.9" | "0.8.0" | "0.8.1" | "0.8.2" | "0.8.3" | "0.8.4" | "0.8.5" | "0.8.6" | "0.8.7" | "0.8.8" | "0.8.9" | "0.8.10" | "0.8.11" | "0.8.12" | "0.8.13" | "0.9.0" | "0.9.1" | "0.9.2" | "0.9.3" | "0.9.4" | "0.9.5" | "0.9.6" | "0.9.7" | "0.9.8" | "0.9.9" | "0.9.10" | "0.9.11" | "0.9.12" | "0.9.13" | "0.9.14" | "0.9.15" | "0.9.16" | "0.9.17" | "0.9.18" | "0.9.19" | "0.9.20" | "0.9.21" | "0.9.22" | "0.9.23" | "0.9.24" | "0.9.25" | "0.9.26" | "0.9.27" | "0.9.28" | "0.9.29" | "0.9.30" | "0.9.31";exportedAt: string;sessions: Session[];observations: Record<string, CompressedObservation[]>;diff --git a/src/version.ts b/src/version.tsindex d717a01f..4a86705d 100644--- a/src/version.ts+++ b/src/version.ts@@ -1,2 +1,2 @@-export const VERSION = "0.9.30";+export const VERSION = "0.9.31";export const III_PINNED_VERSION = "0.25.0";diff --git a/test/consistency.test.ts b/test/consistency.test.tsindex 77802ea1..8d198db1 100644--- a/test/consistency.test.ts+++ b/test/consistency.test.ts@@ -1,6 +1,7 @@import { describe, it, expect, vi } from "vitest";import { readFileSync } from "node:fs";import { join } from "node:path";+import { parse } from "yaml";vi.mock("../src/logger.js", () => ({logger: { info: vi.fn(), warn: vi.fn(), error: vi.fn() },@@ -44,6 +45,11 @@ describe("Consistency checks", () => {expect(mcp.version).toBe(pkg.version);});+ it.each(["hermes", "openclaw"])("%s YAML plugin version matches the release", (integration) => {+ const plugin = parse(readText(`integrations/${integration}/plugin.yaml`));+ expect(plugin.version).toBe(VERSION);+ });+it("export-import.ts supports current version", () => {const src = readText("src/functions/export-import.ts");expect(src).toContain(`"${VERSION}"`);diff --git a/test/hermes-native-e2e.py b/test/hermes-native-e2e.pyindex 36f67166..29dff921 100755--- a/test/hermes-native-e2e.py+++ b/test/hermes-native-e2e.py@@ -272,8 +272,9 @@ display:nonlocal backendbackend = subprocess.Popen([args.node, str(cli), '--port', str(port), '--data-dir', str(out / 'state')], cwd=out, env=env, stdout=log, stderr=subprocess.STDOUT, start_new_session=True)for _ in range(180):- if backend.poll() is not None:- raise RuntimeError('Backend exited; inspect backend.log.')+ exit_code = backend.poll()+ if exit_code not in (None, 0):+ raise RuntimeError(f'Backend exited with code {exit_code}; inspect backend.log.')try:with urllib.request.urlopen(base + '/agentmemory/livez', timeout=1) as response:if isinstance(json.load(response).get('viewerPort'), int):