@zilliz/memsearch-opencode 0.1.0 → 0.1.1

package/README.md

@@ -21,11 +21,20 @@ uv tool install 'memsearch[onnx]'
 # or: pip install 'memsearch[onnx]'
 ```
 
-### Install
+### Install from npm (recommended)
+
+```json
+// In ~/.config/opencode/opencode.json
+{
+  "plugin": ["@zilliz/memsearch-opencode"]
+}
+```
+
+### Install from Source (development)
 
 ```bash
-# Clone the repo (if you haven't already)
-git clone https://github.com/zc277584121/memsearch.git
+# Clone the repo
+git clone https://github.com/zilliztech/memsearch.git
 cd memsearch
 
 # Run the installer
@@ -44,15 +53,6 @@ mkdir -p ~/.agents/skills
 ln -sf /path/to/memsearch/plugins/opencode/skills/memory-recall ~/.agents/skills/memory-recall
 ```
 
-### npm Install (coming soon)
-
-```json
-// In ~/.config/opencode/opencode.json
-{
-  "plugin": ["memsearch-opencode"]
-}
-```
-
 ## Architecture
 
 ```
@@ -73,6 +73,20 @@ OpenCode Session
         └── memory_transcript ──→ parse-transcript.py (SQLite reader)
 ```
 
+## Recall Memories
+
+**Manual invocation** — explicitly invoke the skill with a query:
+
+```
+/memory-recall what was the auth approach we discussed?
+```
+
+**Auto invocation** — just ask naturally, the LLM auto-invokes memory tools when it senses the question needs history:
+
+```
+We discussed the authentication flow before, what was the approach?
+```
+
 ## Tools
 
 | Tool | Description |
@@ -100,7 +114,7 @@ Each file contains timestamped entries with bullet-point summaries:
 ## Session 14:30
 
 ### 14:30
-<!-- session:ses_abc123 source:opencode-sqlite -->
+<!-- session:ses_abc123 db:~/.local/share/opencode/opencode.db -->
 - User asked about the authentication flow.
 - Assistant explained the OAuth2 implementation in auth.ts.
 - Assistant modified the token refresh logic in refresh.ts.

package/index.ts

@@ -281,7 +281,7 @@ const MemsearchPlugin: Plugin = async ({ project, directory, worktree }) => {
         description:
           "Retrieve the original conversation from a past OpenCode session. " +
           "Use after memory_get when the expanded result contains a session anchor " +
-          "(<!-- session:ID source:opencode-sqlite -->). Returns the formatted " +
+          "(<!-- session:ID db:PATH -->). Returns the formatted " +
           "dialogue with [Human] and [Assistant] labels.",
         args: {
           session_id: tool.schema.string().describe("The session ID from the anchor comment"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zilliz/memsearch-opencode",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "memsearch plugin for OpenCode — semantic memory search across sessions",
   "type": "module",
   "main": "index.ts",

package/scripts/capture-daemon.py

@@ -208,7 +208,7 @@ def _extract_msg_text(conn, msg_id, msg_json):
     return "\n".join(text_parts)
 
 
-def write_capture(memory_dir, turn_text, session_id):
+def write_capture(memory_dir, turn_text, session_id, db_path=""):
     """Write a captured turn to the daily memory file."""
     os.makedirs(memory_dir, exist_ok=True)
 
@@ -220,7 +220,7 @@ def write_capture(memory_dir, turn_text, session_id):
         with open(memory_file, "w") as f:
             f.write(f"# {today}\n\n## Session {now}\n\n")
 
-    anchor = f"<!-- session:{session_id} source:opencode-sqlite -->\n" if session_id else ""
+    anchor = f"<!-- session:{session_id} db:{db_path} -->\n" if session_id else ""
     entry = f"### {now}\n{anchor}{turn_text}\n\n"
 
     with open(memory_file, "a") as f:
@@ -280,7 +280,7 @@ def main():
                 if turn_text and len(turn_text) > 10:
                     # Summarize with LLM, fallback to raw text
                     summary = summarize_with_llm(turn_text, small_model)
-                    write_capture(memory_dir, summary if summary else turn_text, session_id)
+                    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
                         try:

package/skills/memory-recall/SKILL.md

@@ -24,11 +24,9 @@ Search for memories relevant to: $ARGUMENTS
 
 3. **Expand**: For each relevant result, run `memsearch expand <chunk_hash> --collection <collection name above>` to get the full markdown section with surrounding context.
 
-4. **Deep drill (optional)**: If an expanded chunk contains a session anchor (`<!-- session:ID source:opencode-sqlite -->`), and the original conversation seems critical, run:
-   ```
-   python3 __INSTALL_DIR__/scripts/parse-transcript.py <session_id> --limit 10
-   ```
-   to retrieve the original conversation turns from the OpenCode SQLite database.
+4. **Deep drill (optional)**: If an expanded chunk contains transcript anchors (HTML comments with session info), and the original conversation seems critical:
+   - If the anchor contains `db:`, run `python3 __INSTALL_DIR__/scripts/parse-transcript.py <session_id> --limit 10` to retrieve the original conversation turns from the SQLite database.
+   - If the anchor format is unfamiliar (e.g. `transcript:`, `rollout:` instead of `db:`), try reading the referenced file directly to explore its structure and locate the relevant conversation by the session or turn identifiers in the anchor.
 
 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.