opencode-claude-memory 1.7.0 → 1.7.2

package/README.md

@@ -2,7 +2,9 @@
 
 # 🧠 Claude Code-compatible memory for OpenCode
 
-**Make OpenCode and Claude Code share the same memory — zero config, local-first, and no migration required.**
+**Persistent, local-first shared memory for OpenCode and Claude Code — zero config and no migration required.**
+
+This OpenCode memory plugin lets OpenCode read and write Claude Code-compatible Markdown memory files, so both CLIs share the same project context.
 
 Claude Code writes memory → OpenCode reads it. OpenCode writes memory → Claude Code reads it.
 
@@ -18,6 +20,8 @@ Claude Code writes memory → OpenCode reads it. OpenCode writes memory → Clau
 
 ## ✨ At a glance
 
+- **OpenCode plugin for Claude Code memory**
+  Adds persistent memory tools, system prompt injection, and post-session extraction to OpenCode.
 - **Claude Code-compatible memory**
   Uses Claude Code’s existing memory paths, file format, and taxonomy.
 - **Zero config**

package/dist/index.js

@@ -1,7 +1,8 @@
 import { tool } from "@opencode-ai/plugin";
+import { parse, resolve } from "path";
 import { buildMemorySystemPrompt } from "./prompt.js";
 import { formatRecalledMemories, recallSelectedMemories } from "./recall.js";
-import { assertSupportedRecallSelectorClient, selectRelevantMemoryFilenames } from "./recallSelector.js";
+import { isSupportedRecallSelectorClient, selectRelevantMemoryFilenames } from "./recallSelector.js";
 import { scanMemoryFiles } from "./memoryScan.js";
 import { saveMemory, deleteMemory, listMemories, searchMemories, readMemory, MEMORY_TYPES, } from "./memory.js";
 import { getMemoryDir } from "./paths.js";
@@ -117,6 +118,15 @@ function getRecallModel() {
         modelID: raw.slice(slashIdx + 1),
     };
 }
+function isRootPath(path) {
+    const resolved = resolve(path);
+    return resolved === parse(resolved).root;
+}
+function resolveMemoryRoot(worktree, directory) {
+    if (isRootPath(worktree) && !isRootPath(directory))
+        return directory;
+    return worktree;
+}
 function isUsefulRecallQuery(query) {
     const trimmed = query?.trim();
     if (!trimmed)
@@ -134,7 +144,8 @@ function alreadySurfacedKey(header) {
 function startRecallPrefetch(input) {
     if (!input.client || !isUsefulRecallQuery(input.query))
         return undefined;
-    assertSupportedRecallSelectorClient(input.client);
+    if (!isSupportedRecallSelectorClient(input.client))
+        return undefined;
     const memoryDir = getMemoryDir(input.worktree);
     const headers = scanMemoryFiles(memoryDir).filter((header) => !input.alreadySurfaced.has(alreadySurfacedKey(header)));
     if (headers.length === 0)
@@ -225,7 +236,8 @@ function getCallID(ctx) {
 }
 export const MemoryPlugin = async ({ worktree, directory, client }) => {
     directory ??= worktree;
-    getMemoryDir(worktree);
+    const memoryRoot = resolveMemoryRoot(worktree, directory);
+    getMemoryDir(memoryRoot);
     return {
         config: async (config) => {
             const agentName = getRecallAgent();
@@ -285,7 +297,7 @@ export const MemoryPlugin = async ({ worktree, directory, client }) => {
                         : startRecallPrefetch({
                             client: client,
                             directory,
-                            worktree,
+                            worktree: memoryRoot,
                             parentSessionID: sessionID,
                             turnID,
                             query,
@@ -321,7 +333,7 @@ export const MemoryPlugin = async ({ worktree, directory, client }) => {
             const ignoreMemoryContext = process.env.OPENCODE_MEMORY_IGNORE === "1" || shouldIgnoreMemoryContext(query);
             const recalled = ignoreMemoryContext ? [] : consumeRecallPrefetch(ctx);
             const recalledSection = formatRecalledMemories(recalled);
-            const memoryPrompt = buildMemorySystemPrompt(worktree, recalledSection, {
+            const memoryPrompt = buildMemorySystemPrompt(memoryRoot, recalledSection, {
                 includeIndex: !ignoreMemoryContext,
             });
             output.system.push(memoryPrompt);
@@ -350,7 +362,7 @@ export const MemoryPlugin = async ({ worktree, directory, client }) => {
                         .describe("Memory content. For feedback/project types, structure as: rule/fact, then **Why:** and **How to apply:** lines"),
                 },
                 async execute(args, _ctx) {
-                    const filePath = saveMemory(worktree, args.file_name, args.name, args.description, args.type, args.content);
+                    const filePath = saveMemory(memoryRoot, args.file_name, args.name, args.description, args.type, args.content);
                     return `Memory saved to ${filePath}`;
                 },
             }),
@@ -360,7 +372,7 @@ export const MemoryPlugin = async ({ worktree, directory, client }) => {
                     file_name: tool.schema.string().describe("File name of the memory to delete (with or without .md extension)"),
                 },
                 async execute(args, _ctx) {
-                    const deleted = deleteMemory(worktree, args.file_name);
+                    const deleted = deleteMemory(memoryRoot, args.file_name);
                     return deleted ? `Memory "${args.file_name}" deleted.` : `Memory "${args.file_name}" not found.`;
                 },
             }),
@@ -370,7 +382,7 @@ export const MemoryPlugin = async ({ worktree, directory, client }) => {
                     "or when you need to recall what's been stored.",
                 args: {},
                 async execute(_args, ctx) {
-                    const entries = listMemories(worktree);
+                    const entries = listMemories(memoryRoot);
                     const callID = getCallID(ctx);
                     if (callID)
                         memoryListCountByCallID.set(callID, entries.length);
@@ -388,7 +400,7 @@ export const MemoryPlugin = async ({ worktree, directory, client }) => {
                     query: tool.schema.string().describe("Search query — searches across name, description, and content"),
                 },
                 async execute(args, ctx) {
-                    const results = searchMemories(worktree, args.query);
+                    const results = searchMemories(memoryRoot, args.query);
                     const callID = getCallID(ctx);
                     if (callID)
                         memorySearchCountByCallID.set(callID, results.length);
@@ -405,7 +417,7 @@ export const MemoryPlugin = async ({ worktree, directory, client }) => {
                     file_name: tool.schema.string().describe("File name of the memory to read (with or without .md extension)"),
                 },
                 async execute(args, _ctx) {
-                    const entry = readMemory(worktree, args.file_name);
+                    const entry = readMemory(memoryRoot, args.file_name);
                     if (!entry) {
                         return `Memory "${args.file_name}" not found.`;
                     }

package/dist/recallSelector.d.ts

@@ -1,6 +1,6 @@
 import { type MemoryHeader } from "./memoryScan.js";
 export declare const SELECT_MEMORIES_SYSTEM_PROMPT = "You are selecting memories that will be useful to OpenCode as it processes a user's query. You will be given the user's query and a list of available memory files with their filenames and descriptions.\n\nReturn a list of filenames for the memories that will clearly be useful to OpenCode as it processes the user's query (up to 5). Only include memories that you are certain will be helpful based on their name and description.\n- If you are unsure if a memory will be useful in processing the user's query, then do not include it in your list. Be selective and discerning.\n- If there are no memories in the list that would clearly be useful, feel free to return an empty list.\n- If a list of recently-used tools is provided, do not select memories that are usage reference or API documentation for those tools (OpenCode is already exercising them). DO still select memories containing warnings, gotchas, or known issues about those tools \u2014 active use is exactly when those matter.\n";
-export declare const UNSUPPORTED_RECALL_SELECTOR_CLIENT_MESSAGE = "opencode-claude-memory LLM recall requires an OpenCode SDK with structured output session.prompt support. Please upgrade OpenCode/@opencode-ai/plugin.";
+export declare const UNSUPPORTED_RECALL_SELECTOR_CLIENT_MESSAGE = "opencode-claude-memory LLM recall requires an OpenCode SDK session client with create/prompt/delete support.";
 export type SessionClient = {
     session?: {
         create?: (...args: unknown[]) => Promise<unknown>;

package/dist/recallSelector.js

@@ -17,7 +17,7 @@ const SELECT_MEMORIES_FORMAT = {
         additionalProperties: false,
     },
 };
-export const UNSUPPORTED_RECALL_SELECTOR_CLIENT_MESSAGE = "opencode-claude-memory LLM recall requires an OpenCode SDK with structured output session.prompt support. Please upgrade OpenCode/@opencode-ai/plugin.";
+export const UNSUPPORTED_RECALL_SELECTOR_CLIENT_MESSAGE = "opencode-claude-memory LLM recall requires an OpenCode SDK session client with create/prompt/delete support.";
 function unwrapData(response) {
     if (!response || typeof response !== "object")
         return response;
@@ -71,12 +71,9 @@ function extractSelectedMemories(response) {
 }
 export function isSupportedRecallSelectorClient(client) {
     const session = client?.session;
-    return Boolean(session?.create &&
-        session?.prompt &&
-        session?.delete &&
-        session.create.length >= 2 &&
-        session.prompt.length >= 2 &&
-        session.delete.length >= 2);
+    return Boolean(typeof session?.create === "function" &&
+        typeof session.prompt === "function" &&
+        typeof session.delete === "function");
 }
 export function assertSupportedRecallSelectorClient(client) {
     if (!isSupportedRecallSelectorClient(client)) {
@@ -87,9 +84,11 @@ async function createSelectorSession(client, directory, parentSessionID) {
     if (!client.session?.create)
         return undefined;
     const response = await client.session.create({
-        directory,
-        parentID: parentSessionID,
-        title: "opencode-memory recall selector",
+        body: {
+            parentID: parentSessionID,
+            title: "opencode-memory recall selector",
+        },
+        query: { directory },
     });
     return extractSessionID(response);
 }
@@ -104,13 +103,20 @@ async function promptSelectorSession(client, sessionID, directory, agent, model,
         format: SELECT_MEMORIES_FORMAT,
         parts: [{ type: "text", text: content }],
     };
-    return client.session.prompt({ sessionID, directory, ...body });
+    return client.session.prompt({
+        path: { id: sessionID },
+        query: { directory },
+        body,
+    });
 }
 async function deleteSelectorSession(client, sessionID, directory) {
     if (!client.session?.delete)
         return;
     try {
-        await client.session.delete({ sessionID, directory });
+        await client.session.delete({
+            path: { id: sessionID },
+            query: { directory },
+        });
     }
     catch {
         // Best-effort cleanup. A failed selector deletion should not affect recall.

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "opencode-claude-memory",
-  "version": "1.7.0",
+  "version": "1.7.2",
   "type": "module",
-  "description": "Claude Code-compatible memory compatibility layer for OpenCode — zero config, local-first, no migration",
+  "description": "OpenCode plugin for Claude Code memory: persistent, local-first shared memory with Claude Code-compatible Markdown files, auto extraction, and auto-dream",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
@@ -26,13 +26,29 @@
     "type": "git",
     "url": "git+https://github.com/kuitos/opencode-claude-memory.git"
   },
+  "bugs": {
+    "url": "https://github.com/kuitos/opencode-claude-memory/issues"
+  },
   "homepage": "https://github.com/kuitos/opencode-claude-memory#readme",
   "keywords": [
     "opencode",
+    "opencode-plugin",
+    "opencode-ai",
+    "claude",
+    "claude-code",
+    "claude-code-memory",
+    "claude-memory",
     "plugin",
     "memory",
-    "persistent",
-    "cross-session",
+    "persistent-memory",
+    "agent-memory",
+    "ai-memory",
+    "cross-session-memory",
+    "shared-memory",
+    "local-first",
+    "markdown-memory",
+    "coding-agent",
+    "developer-tools",
     "claude-code-compatible"
   ],
   "license": "MIT",