opencode-memsearch 0.3.0 → 0.4.0

package/README.md

@@ -97,21 +97,27 @@ your-project/
 
 You should add `.memsearch/` to your `.gitignore`.
 
-## Seed script
+## CLI
 
-The package includes a seed script that can backfill memory from existing OpenCode sessions. This is useful when first installing the plugin on a project you've already been working on.
+The package includes a CLI for utility tasks. It requires [Bun](https://bun.sh/) to run.
 
-The seed script requires [Bun](https://bun.sh/) to run.
+```bash
+bunx opencode-memsearch --help
+```
+
+### Seed
+
+Backfill memory from existing OpenCode sessions. This is useful when first installing the plugin on a project you've already been working on.
 
 ```bash
 # Seed from the last 14 days of sessions (default)
-npx opencode-memsearch-seed
+bunx opencode-memsearch seed
 
 # Seed from the last 30 days
-npx opencode-memsearch-seed --days 30
+bunx opencode-memsearch seed --days 30
 ```
 
-Run the script from your project directory. It reads directly from the OpenCode SQLite database, summarizes each conversation turn, and writes the results to `.memsearch/memory/`. The seed script respects the same [configuration](#configuration) as the plugin (config file and environment variables).
+The command reads directly from the OpenCode SQLite database, processes all sessions across all projects, summarizes each conversation turn, and writes the results to each project's `.memsearch/memory/` directory. It can be run from anywhere. The seed command respects the same [configuration](#configuration) as the plugin (config file and environment variables).
 
 ## Configuration
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-memsearch",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Persistent cross-session memory for OpenCode, powered by memsearch",
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
     }
   },
   "bin": {
-    "opencode-memsearch-seed": "scripts/seed-memories.ts"
+    "opencode-memsearch": "scripts/cli.ts"
   },
   "files": [
     "dist",

package/scripts/cli.ts

@@ -0,0 +1,84 @@
+#!/usr/bin/env bun
+/**
+ * opencode-memsearch CLI — utilities for the opencode-memsearch plugin.
+ *
+ * Usage:
+ *   bunx opencode-memsearch <command> [options]
+ *
+ * Requires Bun (https://bun.sh/) to run.
+ */
+
+import { seed } from "./seed-memories"
+
+const HELP = `opencode-memsearch — CLI utilities for the opencode-memsearch plugin
+
+Usage:
+  opencode-memsearch <command> [options]
+
+Commands:
+  seed    Backfill memory from existing OpenCode sessions
+
+Options:
+  --help, -h    Show this help message
+
+Run 'opencode-memsearch <command> --help' for command-specific help.`
+
+const SEED_HELP = `Seed memsearch memory files from recent OpenCode sessions.
+
+Reads all sessions from the OpenCode SQLite database, summarizes each
+conversation turn via an LLM, and writes the results to each project's
+.memsearch/memory/ directory. Processes all projects; can be run from anywhere.
+
+Usage:
+  opencode-memsearch seed [--days <n>]
+
+Options:
+  --days <n>    Number of days of history to process (default: 14)
+  --help, -h    Show this help message`
+
+function parseSeedArgs(args: string[]): { days: number } {
+  let days = 14
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--days" && args[i + 1]) {
+      days = parseInt(args[i + 1], 10)
+      if (isNaN(days) || days < 1) {
+        console.error("Invalid --days value, using default 14")
+        days = 14
+      }
+    }
+  }
+  return { days }
+}
+
+async function main() {
+  const args = process.argv.slice(2)
+  const command = args[0]
+
+  if (!command || command === "--help" || command === "-h") {
+    console.log(HELP)
+    process.exit(0)
+  }
+
+  switch (command) {
+    case "seed": {
+      const subArgs = args.slice(1)
+      if (subArgs.includes("--help") || subArgs.includes("-h")) {
+        console.log(SEED_HELP)
+        process.exit(0)
+      }
+      const { days } = parseSeedArgs(subArgs)
+      await seed({ days })
+      break
+    }
+    default:
+      console.error(`Unknown command: ${command}`)
+      console.error()
+      console.log(HELP)
+      process.exit(1)
+  }
+}
+
+main().catch((err) => {
+  console.error("Fatal error:", err)
+  process.exit(1)
+})

package/scripts/seed-memories.ts

@@ -1,13 +1,9 @@
-#!/usr/bin/env bun
 /**
  * seed-memories.ts — Seed memsearch memory files from recent OpenCode sessions.
  *
- * Usage:
- *   npx opencode-memsearch-seed [--days 14]
+ * This module exports a `seed` function used by the CLI (cli.ts).
  *
- * Requires Bun (https://bun.sh/) to run.
- *
- * This script:
+ * What it does:
  * 1. Reads session + message data directly from the OpenCode SQLite database
  * 2. For each session, formats each conversation turn as a transcript
  * 3. Summarizes each turn via `opencode run` (model is configurable, see README)
@@ -107,21 +103,6 @@ function formatTime(epochMs: number): string {
   return `${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}`
 }
 
-function parseArgs(): { days: number } {
-  const args = process.argv.slice(2)
-  let days = 14
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === "--days" && args[i + 1]) {
-      days = parseInt(args[i + 1], 10)
-      if (isNaN(days) || days < 1) {
-        console.error("Invalid --days value, using default 14")
-        days = 14
-      }
-    }
-  }
-  return { days }
-}
-
 // --- Database types ---
 
 interface DbSession {
@@ -354,8 +335,8 @@ async function summarizeWithOpencode(transcript: string, tempFile: string, model
 
 // --- Main ---
 
-async function main() {
-  const { days } = parseArgs()
+export async function seed(opts: { days: number }) {
+  const { days } = opts
   const cutoff = Date.now() - days * 24 * 60 * 60 * 1000
 
   console.log(`Seeding memories from the last ${days} days...`)
@@ -514,7 +495,4 @@ async function main() {
   }
 }
 
-main().catch((err) => {
-  console.error("Fatal error:", err)
-  process.exit(1)
-})
+