opencode-session-recall 0.5.0 → 0.6.0

package/README.md

@@ -24,13 +24,19 @@ No embeddings. No vector store. No data duplication. No setup. Just install the
 
 ## Install
 
+```bash
+opencode plugin opencode-session-recall
+```
+
+Or add it to your `opencode.json` manually:
+
 ```jsonc
 {
   "plugin": [
     "opencode-session-recall",
 
-    // Enable cross-project search
-    ["opencode-session-recall", { "global": true }],
+    // Disable cross-project search if needed
+    ["opencode-session-recall", { "global": false }],
   ],
 }
 ```
@@ -129,7 +135,7 @@ Five tool calls, complete narrative reconstructed across projects.
 | Option    | Type      | Default | Description                                         |
 | --------- | --------- | ------- | --------------------------------------------------- |
 | `primary` | `boolean` | `true`  | Register tools as primary (available to all agents) |
-| `global`  | `boolean` | `false` | Enable cross-project search via `scope: "global"`   |
+| `global`  | `boolean` | `true`  | Allow cross-project search via `scope: "global"`    |
 
 ## How it works
 
@@ -141,7 +147,7 @@ When opencode compacts a session, it doesn't delete anything. Tool outputs get a
 - Zero setup — no embeddings to generate, no indexes to build, no data to sync
 - Sessions are scanned newest-first with bounded concurrency
 - Respects abort signals for long-running searches
-- Global scope is disabled by default
+- Cross-project search enabled by default (disable with `global: false`)
 
 ## License
 

package/dist/opencode-session-recall.js

@@ -40,7 +40,7 @@ function errmsg(e) {
 // src/sessions.ts
 function sessions(client, unscoped, global, limits) {
   return tool({
-    description: `List sessions from the opencode database. Use this FIRST to discover which sessions exist, then search their content with recall. Returns session titles, directories, and timestamps. For cross-project discovery, use scope "global" (requires plugin option global: true).
+    description: `List sessions from the opencode database. Use this FIRST to discover which sessions exist, then search their content with recall. Also use at session start to check if related work exists in other sessions or projects.
 
 Search filters by session title only (case-insensitive substring match \u2014 use recall for content search). Sessions are returned newest-updated first. This is a cheap metadata-only call.
 
@@ -57,7 +57,7 @@ Returns { ok, sessions: [{ id, title, directory, time, archived }], returned, sc
       if (args.scope === "global" && !global) {
         const err = {
           ok: false,
-          error: "Global scope disabled. Enable via plugin option: global: true"
+          error: "Global scope disabled via plugin option: global: false"
         };
         return JSON.stringify(err);
       }
@@ -312,7 +312,7 @@ function scan(messages2, session, query, type, role, limit, before, after, width
 }
 function search(client, unscoped, global, limits) {
   return tool2({
-    description: `Search your conversation history in the opencode database. Use this to recover context lost to compaction \u2014 original tool outputs, earlier messages, reasoning, and user instructions that were pruned from your context window.
+    description: `Search your conversation history in the opencode database. Use this to recover context lost to compaction \u2014 original tool outputs, earlier messages, reasoning, and user instructions that were pruned from your context window. Before debugging an issue or implementing a feature, check whether prior sessions already tackled it \u2014 the history shows whether an approach succeeded or was abandoned.
 
 Searches text content, tool inputs/outputs, and reasoning via case-insensitive substring matching. Returns matching snippets with session/message IDs you can pass to recall_get for full content, or recall_context if you need surrounding messages.
 
@@ -322,7 +322,7 @@ Scope costs: "session" scans 1 session. "project" scans up to \`sessions\` sessi
 
 Returns { ok, results: [{ sessionID, messageID, role, time, partID, partType, pruned, snippet, toolName? }], scanned, total, truncated }. Each result includes a pruned flag \u2014 if true, the content was compacted from your context window and recall_get will return the original full output. Check truncated to know if more matches exist beyond your results limit.
 
-This tool's own outputs are excluded from search results to prevent recursive noise, but remain visible via recall_get, recall_context, and recall_messages.`,
+This tool's own outputs are excluded from search results to prevent recursive noise; use recall_get or recall_context to retrieve any message directly.`,
     args: {
       query: tool2.schema.string().min(1).describe("Text to search for (case-insensitive substring match)"),
       scope: tool2.schema.enum(["session", "project", "global"]).default("session").describe(
@@ -351,7 +351,7 @@ This tool's own outputs are excluded from search results to prevent recursive no
       if (args.scope === "global" && !args.sessionID && !global) {
         const err = {
           ok: false,
-          error: "Global scope disabled. Enable via plugin option: global: true"
+          error: "Global scope disabled via plugin option: global: false"
         };
         return JSON.stringify(err);
       }
@@ -721,7 +721,7 @@ Returns { messages: [{ message: { id, role, time }, parts: [...] }], pagination:
 var server = async (ctx, options) => {
   const opts = options ?? {};
   const primary = opts.primary !== false;
-  const global = opts.global === true;
+  const global = opts.global !== false;
   const clamp = (val, fallback, min = 1) => Math.max(min, Math.floor(val ?? fallback));
   const limits = {
     concurrency: clamp(opts.concurrency, DEFAULTS.concurrency),

package/dist/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,YAAY,CAAC;AAqEpB,wBAAgB,MAAM,CACpB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GACb,cAAc,CAyNhB"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,YAAY,CAAC;AAqEpB,wBAAgB,MAAM,CACpB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GACb,cAAc,CAwNhB"}

package/dist/sessions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,YAAY,CAAC;AAEpB,wBAAgB,QAAQ,CACtB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GACb,cAAc,CA8GhB"}
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAKL,KAAK,MAAM,EACZ,MAAM,YAAY,CAAC;AAEpB,wBAAgB,QAAQ,CACtB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,MAAM,GACb,cAAc,CA6GhB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "opencode-session-recall",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "description": "Agent memory without a memory system — search and retrieve opencode conversation history that was lost to compaction, across sessions and projects",
   "main": "./dist/opencode-session-recall.js",