@zilliz/memsearch-opencode 0.1.1 → 0.2.0

package/README.md

@@ -30,6 +30,8 @@ uv tool install 'memsearch[onnx]'
 }
 ```
 
+> Windows note: the current plugin shells out to `bash` and `python3` helper scripts. Plain Windows installs are not supported yet; use WSL2 (recommended) or a POSIX-compatible shell such as Git Bash. See issue #387.
+
 ### Install from Source (development)
 
 ```bash
@@ -73,6 +75,17 @@ OpenCode Session
         └── memory_transcript ──→ parse-transcript.py (SQLite reader)
 ```
 
+## Verify It Works
+
+After restarting OpenCode, chat for a few turns in a project and confirm memory capture is happening:
+
+```bash
+ls .memsearch/memory/
+cat .memsearch/memory/$(date +%Y-%m-%d).md
+```
+
+If the plugin is active, daily markdown files should appear and grow as conversations finish.
+
 ## Recall Memories
 
 **Manual invocation** — explicitly invoke the skill with a query:

package/index.ts

@@ -68,12 +68,15 @@ function deriveCollectionName(projectDir: string): string {
 }
 
 /**
- * Read the tail of the N most recent daily .md files for cold-start context.
+ * Summarize the N most recent daily .md files for cold-start context.
+ * Extracts headings (## Session, ### turns) and bullet content from each
+ * file so the agent sees the structure of past days (what sessions existed,
+ * what topics came up), not just the tail of whichever file is newest.
  */
 function getRecentMemories(
   memDir: string,
   count = 2,
-  tailLines = 15
+  maxLinesPerFile = 30
 ): string {
   if (!existsSync(memDir)) return "";
 
@@ -84,23 +87,24 @@ function getRecentMemories(
 
   if (files.length === 0) return "";
 
-  const bullets: string[] = [];
+  const summary: string[] = [];
   for (const file of files) {
     try {
       const content = readFileSync(join(memDir, file), "utf-8");
-      const lines = content.split("\n").slice(-tailLines);
-      const fileBullets = lines.filter((l) => l.startsWith("- ") || l.startsWith("[Human]") || l.startsWith("[Assistant]"));
-      if (fileBullets.length > 0) {
-        bullets.push(`[${file}]`, ...fileBullets);
+      const lines = content.split("\n")
+        .filter((l) => /^#{2,4}\s/.test(l) || l.startsWith("- ") || l.startsWith("[Human]") || l.startsWith("[Assistant]"))
+        .slice(0, maxLinesPerFile);
+      if (lines.length > 0) {
+        summary.push(`[${file}]`, ...lines);
       }
     } catch { /* skip */ }
   }
 
-  if (bullets.length === 0) {
+  if (summary.length === 0) {
     return `You have ${files.length} past memory file(s). Use the memory_search tool when the user's question could benefit from historical context.`;
   }
 
-  return `Recent memories (use memory_search for full search):\n${bullets.join("\n")}`;
+  return `Recent memories (use memory_search for full search):\n${summary.join("\n")}`;
 }
 
 /** Shell-escape a string for safe use inside single quotes. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zilliz/memsearch-opencode",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "memsearch plugin for OpenCode — semantic memory search across sessions",
   "type": "module",
   "main": "index.ts",
@@ -11,6 +11,7 @@
     "index.ts",
     "scripts/",
     "skills/",
+    "prompts/",
     "README.md"
   ],
   "keywords": [

package/prompts/summarize.txt

@@ -0,0 +1,14 @@
+You are a third-person note-taker. You will receive a transcript of ONE conversation turn between a human and {{AGENT_NAME}}.
+
+Your job is to record what happened as factual third-person notes. You are an EXTERNAL OBSERVER — you are NOT {{AGENT_NAME}}, NOT an assistant. Do NOT answer the human's question, do NOT give suggestions, do NOT offer help. ONLY record what occurred.
+
+Output 2-6 bullet points, each starting with '- '. NOTHING else.
+
+Rules:
+- Write in third person: 'User asked...', '{{AGENT_NAME}} read file X', '{{AGENT_NAME}} ran command Y'
+- First bullet: what the user asked or wanted (one sentence)
+- Remaining bullets: what was done — tools called, files read/edited, commands run, key findings
+- Be specific: mention file names, function names, tool names, and concrete outcomes
+- Do NOT answer the human's question yourself — just note what was discussed
+- Do NOT add any text before or after the bullet points
+- Write in the same language as the human's message in the transcript

package/scripts/capture-daemon.py

@@ -53,20 +53,41 @@ def ensure_isolated_config():
     return os.path.dirname(isolated)  # /tmp/opencode-memsearch-summarize
 
 
-def summarize_with_llm(turn_text, small_model):
+def _load_summarize_prompt(agent_name, memsearch_cmd=None):
+    """Load summarization prompt: user custom > plugin built-in > inline fallback."""
+    # Try user-custom prompt via config
+    if memsearch_cmd:
+        try:
+            result = subprocess.run(
+                memsearch_cmd.split() + ["config", "get", "prompts.summarize"],
+                capture_output=True, text=True, timeout=5,
+            )
+            custom_path = result.stdout.strip()
+            if custom_path and os.path.isfile(custom_path):
+                template = Path(custom_path).read_text(encoding="utf-8")
+                return template.replace("{{AGENT_NAME}}", agent_name)
+        except Exception:
+            pass
+
+    # Plugin built-in template
+    builtin = Path(__file__).resolve().parent.parent / "prompts" / "summarize.txt"
+    if builtin.is_file():
+        template = builtin.read_text(encoding="utf-8")
+        return template.replace("{{AGENT_NAME}}", agent_name)
+
+    # Inline fallback
+    return (
+        "You are a third-person note-taker. Summarize the transcript as "
+        "2-6 bullet points. Write in third person. Output ONLY bullet points."
+    )
+
+
+def summarize_with_llm(turn_text, small_model, memsearch_cmd=None):
     """Summarize using opencode run in isolated env (no plugins -> no recursion)."""
-    # Keep the instruction short and put it AFTER the transcript to avoid
-    # the LLM treating the instruction itself as the conversation content.
-    # Clear delimiters (===) separate the transcript from the task.
+    system_prompt = _load_summarize_prompt("OpenCode", memsearch_cmd)
     full_prompt = (
-        f"===TRANSCRIPT START===\n"
-        f"{turn_text}\n"
-        f"===TRANSCRIPT END===\n\n"
-        f"Summarize the transcript above as 2-6 third-person bullet points (each starting with '- '). "
-        f"Write 'User asked/did...' and 'OpenCode replied/did...'. "
-        f"Be specific (file names, tools, outcomes). "
-        f"Same language as the human. "
-        f"Output ONLY bullet points, nothing else."
+        f"{system_prompt}\n\n"
+        f"Transcript:\n{turn_text}"
     )
     isolated_dir = ensure_isolated_config()
 
@@ -279,7 +300,7 @@ def main():
             for session_id, turn_text, msg_time in new_turns:
                 if turn_text and len(turn_text) > 10:
                     # Summarize with LLM, fallback to raw text
-                    summary = summarize_with_llm(turn_text, small_model)
+                    summary = summarize_with_llm(turn_text, small_model, args.memsearch_cmd)
                     write_capture(memory_dir, summary if summary else turn_text, session_id, db_path)
                     if msg_time > last_msg_time:
                         last_msg_time = msg_time

package/skills/memory-recall/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: memory-recall
-description: "Search and recall relevant memories from past sessions. Use when the user's question could benefit from historical context, past decisions, debugging notes, previous conversations, or project knowledge."
+description: "Search and recall relevant memories from past sessions via memsearch. Use when the user's question could benefit from historical context, past decisions, debugging notes, previous conversations, or project knowledge -- especially questions like 'what did I decide about X', 'why did we do Y', or 'have I seen this before'. Also use when you see `[memsearch] Memory available` hints injected via SessionStart or UserPromptSubmit. Typical flow: search for 3-5 chunks, expand the most relevant, optionally deep-drill into original transcripts via the anchor format. Skip when the question is purely about current code state (use Read/Grep), ephemeral (today's task only), or the user has explicitly asked to ignore memory."
 allowed-tools: Bash
 ---
 
@@ -8,7 +8,7 @@ You are a memory retrieval agent for memsearch. Your job is to search past memor
 
 ## Project Collection
 
-Collection: !`bash __INSTALL_DIR__/scripts/derive-collection.sh`
+Collection: !`bash -c 'root=$(git rev-parse --show-toplevel 2>/dev/null || true); if [ -n "$root" ]; then bash __INSTALL_DIR__/scripts/derive-collection.sh "$root"; else bash __INSTALL_DIR__/scripts/derive-collection.sh; fi'`
 
 ## Your Task
 
@@ -30,6 +30,16 @@ Search for memories relevant to: $ARGUMENTS
 
 5. **Return results**: Output a curated summary of the most relevant memories. Be concise — only include information that is genuinely useful for the user's current question.
 
+## When unsure what to search
+
+If the user's question is vague or you can't form a concrete search query, explore the raw markdown first — it is the source of truth for memory:
+
+- `ls -t .memsearch/memory/ | head -10` — recent daily logs
+- `grep -h "^## " .memsearch/memory/*.md | sort -u | tail -40` — session headings across all days
+- `cat .memsearch/memory/<YYYY-MM-DD>.md` — read a specific day
+
+Once a concrete topic jumps out, go back to `memsearch search` with a specific query.
+
 ## Output Format
 
 Organize by relevance. For each memory include: