@ephemushroom/opencode-claude-mem 0.2.1 → 0.2.3

package/README.md

@@ -11,7 +11,7 @@ This plugin communicates with the Claude-Mem worker service (HTTP API on port 37
 - **Inject memory context** — previous session context is injected into the system prompt on every LLM call
 - **Capture tool observations** — every tool execution is recorded as a structured observation
 - **Summarize sessions** — when a session goes idle, the last user/assistant messages are sent for summarization
-- **Search memory** — `mem-search` tool lets the LLM query project history
+- **Search memory** — memory search is available via claude-mem's MCP server
 - **View context on demand** — `/memory` command displays the current memory context in the chat flow
 
 ## Differences from Claude Code Version
@@ -23,14 +23,15 @@ This OpenCode version works differently:
 | | Claude Code | OpenCode (this plugin) |
 |---|---|---|
 | **Architecture** | Shell commands (`node script.js`) | JavaScript plugin API |
-| **Context injection** | `SessionStart` hook stdout → system prompt (once) | `experimental.chat.system.transform` → system prompt (every LLM call) |
-| **Context freshness** | Snapshot at session start | Refreshed every 60s — new observations during the conversation are picked up |
+| **Context injection** | `SessionStart` hook stdout → system prompt (once) | `experimental.chat.system.transform` → system prompt (every LLM call, session-level cache) |
+| **Context freshness** | Snapshot at session start | Cached once per session (same as Claude Code) |
 | **User-visible context** | Displayed in TUI automatically | `/memory` command to view on demand |
 | **Session init** | `UserPromptSubmit` hook | `chat.message` hook with real user prompt |
-| **Observations** | `PostToolUse` hook | `tool.execute.after` hook |
+| **Observations** | `PostToolUse` hook | `tool.execute.after` hook (with circular memory protection) |
 | **Summarization** | `Stop` hook | `session.idle` event |
+| **Memory search** | MCP server | MCP server (same — no custom tool needed) |
 
-The key advantage of this plugin is **live context refresh** — in long conversations, the LLM always sees the latest observations, not a stale snapshot from session start.
+Both versions behave the same way: context is fetched once per session and cached. The OpenCode plugin uses `experimental.chat.system.transform` which fires on every LLM call, but the context is session-level cached so the worker is only called once.
 
 ## Prerequisites
 
@@ -77,8 +78,8 @@ curl -s http://127.0.0.1:37777/api/health
 
 Once installed, the plugin works automatically:
 
-- **System prompt injection** — memory context is injected into every LLM call via `experimental.chat.system.transform`. The LLM sees your project's observation history, past decisions, and session summaries. Context is cached for 60s to avoid redundant worker calls.
-- **Tool observation capture** — every tool execution (file reads, edits, searches, etc.) is recorded as an observation in the memory database.
+- **System prompt injection** — memory context is injected into every LLM call via `experimental.chat.system.transform`. The LLM sees your project's observation history, past decisions, and session summaries. Context is cached once per session to avoid redundant worker calls.
+- **Tool observation capture** — every tool execution (file reads, edits, searches, etc.) is recorded as an observation in the memory database. Claude-mem's own MCP tools are automatically filtered to prevent circular memory.
 - **Session summarization** — when a session goes idle, the last user/assistant exchange is summarized and stored.
 - **Toast notification** — on session start, a "Memory active · {project}" toast confirms the plugin is connected to the worker.
 
@@ -86,9 +87,9 @@ Once installed, the plugin works automatically:
 
 Type `/memory` in the chat to display the current memory context inline. This shows you exactly what the LLM sees in its system prompt — the observation index, token economics, and session history.
 
-### `mem-search` Tool
+### Memory Search
 
-The LLM can use the `mem-search` tool to search project history and memory. This is available automatically — no action needed.
+Memory search is provided by claude-mem's MCP server. If you have the claude-mem MCP configured in OpenCode, the LLM can search project history directly via MCP tools — no plugin-level tool needed.
 
 ### Alternative: Manual Installation (from source)
 
@@ -255,7 +256,7 @@ The plugin is a thin HTTP client. All heavy lifting (LLM processing, storage, se
 
 | Claude Code Hook | OpenCode Hook | Purpose |
 |-----------------|---------------|---------|
-| `SessionStart` → context | `experimental.chat.system.transform` | Inject memory into system prompt (every LLM call, 60s cache) |
+| `SessionStart` → context | `experimental.chat.system.transform` | Inject memory into system prompt (every LLM call, session-level cache) |
 | `UserPromptSubmit` → session-init | `chat.message` | Init session with real user prompt |
 | `PostToolUse` → observation | `tool.execute.after` | Capture tool executions |
 | `Stop` → summarize | `event` (session.idle) | Summarize with real message content |
@@ -272,7 +273,6 @@ The plugin is a thin HTTP client. All heavy lifting (LLM processing, storage, se
 | `POST` | `/api/sessions/observations` | Send tool observation |
 | `POST` | `/api/sessions/summarize` | Trigger summarization |
 | `POST` | `/api/sessions/complete` | Complete session |
-| `GET` | `/api/search?q={query}&project={name}` | Search memory |
 
 ## Key Implementation Details
 
@@ -281,8 +281,10 @@ The plugin is a thin HTTP client. All heavy lifting (LLM processing, storage, se
 - **Deferred toast**: `client.tui.showToast()` is deferred to first hook invocation (TUI not ready during plugin init, calling it crashes OpenCode)
 - **Real prompt**: `chat.message` hook extracts actual user input instead of hardcoded "SESSION_START"
 - **Real summarize**: `session.idle` fetches last user/assistant messages via `client.session.messages()` for meaningful summaries
-- **Context caching**: `getCachedContext()` wraps `WorkerClient.getContext()` with a 60s TTL cache to avoid redundant worker calls
+- **Context caching**: `getCachedContext()` caches context once per session (invalidated on `session.created`) to avoid redundant worker calls
 - **Content-type handling**: Worker returns `text/plain` markdown — `getContext()` checks content-type and uses `response.text()` instead of `response.json()`
+- **Context tag wrapping**: Injected context is wrapped in `<claude-mem-context>` tags so the worker's tag-stripping logic can remove it from observations, preventing circular memory
+- **Circular memory protection**: `tool.execute.after` filters out claude-mem's own MCP tools (`claude-mem_mcp-search_*`) to prevent search results from being re-recorded as observations
 - **`/memory` command**: Registered via `config` hook, handled by `command.execute.before` — displays context as an `ignored: true` message (visible to user, not sent to LLM)
 
 ## Troubleshooting

package/dist/index.d.ts

@@ -13,3 +13,7 @@ import { type Plugin } from '@opencode-ai/plugin';
  * Uses TUI toast notifications for status feedback.
  */
 export declare const ClaudeMemPlugin: Plugin;
+declare const _default: {
+    server: Plugin;
+};
+export default _default;

package/dist/index.js

@@ -287,6 +287,8 @@ ${context}
     }
   };
 };
+var src_default = { server: ClaudeMemPlugin };
 export {
+  src_default as default,
   ClaudeMemPlugin
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ephemushroom/opencode-claude-mem",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "OpenCode plugin for Claude-Mem persistent memory system",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -12,6 +12,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
   "scripts": {
@@ -44,10 +48,8 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
-    "@opencode-ai/plugin": "latest"
-  },
   "devDependencies": {
+    "@opencode-ai/plugin": "^1.3.0",
     "@types/bun": "latest",
     "oxfmt": "^0.33.0",
     "oxlint": "^1.48.0",