opencode-mem 2.3.4 → 2.3.5

package/README.md

@@ -8,202 +8,110 @@
 
 A persistent memory system for AI coding agents that enables long-term context retention across sessions using local vector database technology.
 
-## Overview
+## Visual Overview
 
-OpenCode Memory provides AI coding agents with the ability to remember and recall information across conversations. It uses vector embeddings and SQLite for efficient storage and retrieval of contextual information.
-
-## Key Features
-
-- **Local Vector Database**: SQLite-based storage with sqlite-vec extension
-- **Project Memory System**: Persistent storage for project-specific knowledge
-- **User Profile System**: Automatic learning of preferences, patterns, and workflows
-- **Unified Timeline**: Browse memories and prompts together with linking support
-- **Web Interface**: Full-featured UI for memory management and search
-- **Auto-Capture System**: Intelligent prompt-based memory extraction
-- **Multi-Provider AI**: Support for OpenAI, Anthropic, and OpenAI-compatible APIs
-- **Flexible Embedding Models**: 12+ local models or OpenAI-compatible APIs
-- **Smart Deduplication**: Prevents redundant memories using similarity detection
-- **Privacy Protection**: Built-in content filtering for sensitive information
-
-## Installation
-
-Add the plugin to your OpenCode configuration:
-
-**Location**: `~/.config/opencode/opencode.json` or `opencode.jsonc`
-
-```jsonc
-{
-  "plugins": [
-    "opencode-mem"
-  ]
-}
-```
+**Project Memory Timeline:**
 
-OpenCode will automatically download and install the plugin on next startup.
+![Project Memory Timeline](.github/screenshot-project-memory.png)
 
-### macOS Users - IMPORTANT
+**User Profile Viewer:**
 
-macOS ships with Apple's SQLite which **disables extension loading** for security reasons. You must install and configure Homebrew SQLite:
+![User Profile Viewer](.github/screenshot-user-profile.png)
 
-**Step 1: Install Homebrew SQLite**
-```bash
-brew install sqlite
-```
+## Core Features
 
-**Step 2: Find the library path**
-```bash
-brew --prefix sqlite
-```
+Local vector database with SQLite, persistent project memories, automatic user profile learning, unified memory-prompt timeline, full-featured web UI, intelligent prompt-based memory extraction, multi-provider AI support (OpenAI, Anthropic), 12+ local embedding models, smart deduplication, and built-in privacy protection.
 
-**Step 3: Configure the path**
+## Getting Started
 
-Edit `~/.config/opencode/opencode-mem.jsonc` and add:
+Add to your OpenCode configuration at `~/.config/opencode/opencode.json`:
 
 ```jsonc
 {
-  "customSqlitePath": "/opt/homebrew/opt/sqlite/lib/libsqlite3.dylib"
+  "plugins": ["opencode-mem"]
 }
 ```
 
-**Common paths:**
-- **Apple Silicon (M1/M2/M3)**: `/opt/homebrew/opt/sqlite/lib/libsqlite3.dylib`
-- **Intel Mac**: `/usr/local/opt/sqlite/lib/libsqlite3.dylib`
-
-The plugin will auto-detect these paths if not configured, but manual configuration is recommended for reliability.
-
-### Install from Source
-
-```bash
-git clone https://github.com/tickernelz/opencode-mem.git
-cd opencode-mem
-bun install
-bun run build
-```
-
-## Quick Start
+The plugin downloads automatically on next startup. macOS users with Apple Silicon must install Homebrew SQLite and configure the custom path - see our Wiki for details.
 
-### Basic Usage
+## Usage Examples
 
 ```typescript
-// Add project memory
 memory({ mode: "add", content: "Project uses microservices architecture" })
-
-// Search memories
 memory({ mode: "search", query: "architecture decisions" })
-
-// View user profile
 memory({ mode: "profile" })
-
-// List recent memories
 memory({ mode: "list", limit: 10 })
 ```
 
-### Web Interface
+Access the web interface at `http://127.0.0.1:4747` for visual memory browsing and management.
 
-Access at `http://127.0.0.1:4747` to browse memories, view prompt-memory links, and manage your memory database.
+## Configuration Essentials
 
-**Project Memory Timeline:**
-
-![Project Memory Timeline](.github/screenshot-project-memory.png)
-
-**User Profile Viewer:**
-
-![User Profile Viewer](.github/screenshot-user-profile.png)
-
-## Configuration
-
-Configuration file: `~/.config/opencode/opencode-mem.jsonc`
+Configure at `~/.config/opencode/opencode-mem.jsonc`:
 
 ```jsonc
 {
   "storagePath": "~/.opencode-mem/data",
-  "customSqlitePath": "/opt/homebrew/opt/sqlite/lib/libsqlite3.dylib",
   "embeddingModel": "Xenova/nomic-embed-text-v1",
   "webServerEnabled": true,
   "webServerPort": 4747,
   "autoCaptureEnabled": true,
   "memoryProvider": "openai-chat",
   "memoryModel": "gpt-4",
-  "memoryApiUrl": "https://api.openai.com/v1",
-  "memoryApiKey": "sk-...",
   "userProfileAnalysisInterval": 10,
   "maxMemories": 10
 }
 ```
 
-See [Configuration Guide](https://github.com/tickernelz/opencode-mem/wiki/Configuration-Guide) for all options.
-
-## Breaking Changes (v2.3)
+Full documentation available in our [Configuration Guide](https://github.com/tickernelz/opencode-mem/wiki/Configuration-Guide).
 
-**User-scoped memories completely removed:**
+## Important: v2.3 Breaking Changes
 
-- **Removed**: `scope` parameter from all memory operations
-- **Removed**: `maxProjectMemories` config (use `maxMemories` instead)
-- **Renamed**: `userMemoryAnalysisInterval` → `userProfileAnalysisInterval`
-- **Renamed**: `performUserMemoryLearning()` → `performUserProfileLearning()`
-- **Changed**: All memories are now project-scoped by default
-- **Changed**: User preferences managed exclusively through automatic profile system
+User-scoped memories removed. All memories now project-scoped. Update configuration:
 
-**Migration required:**
 ```jsonc
-// OLD
+// OLD: Remove these
 {
   "userMemoryAnalysisInterval": 10,
-  "maxMemories": 5,
   "maxProjectMemories": 10
 }
 
-// NEW
+// NEW: Use only
 {
   "userProfileAnalysisInterval": 10,
   "maxMemories": 10
 }
 ```
 
-Remove `scope` parameter from all `memory()` calls:
-```typescript
-// OLD
-memory({ mode: "add", content: "...", scope: "project" })
-
-// NEW
-memory({ mode: "add", content: "..." })
-```
+Remove `scope` parameter from all `memory()` calls. See [Migration Guide](https://github.com/tickernelz/opencode-mem/wiki/Migration-v2-3) for details.
 
 ## Documentation
 
-For detailed documentation, see the [Wiki](https://github.com/tickernelz/opencode-mem/wiki):
-
 - [Installation Guide](https://github.com/tickernelz/opencode-mem/wiki/Installation-Guide)
-- [Quick Start](https://github.com/tickernelz/opencode-mem/wiki/Quick-Start)
-- [Configuration Guide](https://github.com/tickernelz/opencode-mem/wiki/Configuration-Guide)
-- [User Profile System](https://github.com/tickernelz/opencode-mem/wiki/User-Profile-System)
-- [Memory Operations](https://github.com/tickernelz/opencode-mem/wiki/Memory-Operations)
-- [Auto-Capture System](https://github.com/tickernelz/opencode-mem/wiki/Auto-Capture-System)
-- [Web Interface](https://github.com/tickernelz/opencode-mem/wiki/Web-Interface)
 - [API Reference](https://github.com/tickernelz/opencode-mem/wiki/API-Reference)
 - [Troubleshooting](https://github.com/tickernelz/opencode-mem/wiki/Troubleshooting)
+- [Complete Wiki](https://github.com/tickernelz/opencode-mem/wiki)
+
+## Development & Contribution
 
-## Development
+Build and test locally:
 
 ```bash
 bun install
-bun run dev
 bun run build
-bun run format
 bun run typecheck
+bun run format
 ```
 
-## License
-
-MIT License - see LICENSE file for details
-
-## Acknowledgments
+This project is actively seeking contributions to become the definitive memory plugin for AI coding agents. Whether you are fixing bugs, adding features, improving documentation, or expanding embedding model support, your contributions are critical. The codebase is well-structured and ready for enhancement. If you hit a blocker or have improvement ideas, submit a pull request - we review and merge contributions quickly.
 
-Inspired by [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory)
+## License & Links
 
-## Links
+MIT License - see LICENSE file
 
 - **Repository**: https://github.com/tickernelz/opencode-mem
 - **Wiki**: https://github.com/tickernelz/opencode-mem/wiki
 - **Issues**: https://github.com/tickernelz/opencode-mem/issues
 - **OpenCode Platform**: https://opencode.ai
+
+Inspired by [opencode-supermemory](https://github.com/supermemoryai/opencode-supermemory)

package/dist/services/embedding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/services/embedding.ts"],"names":[],"mappings":"AAkBA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,WAAW,CAA8B;IAC1C,UAAU,EAAE,OAAO,CAAS;IAEnC,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOhC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YAQzD,eAAe;IAuBvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAkC1C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAG5D;AAED,eAAO,MAAM,gBAAgB,kBAAiC,CAAC"}
+{"version":3,"file":"embedding.d.ts","sourceRoot":"","sources":["../../src/services/embedding.ts"],"names":[],"mappings":"AAmBA,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,WAAW,CAA8B;IAC1C,UAAU,EAAE,OAAO,CAAS;IAEnC,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOhC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YAQzD,eAAe;IAuBvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAkC1C,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAG5D;AAED,eAAO,MAAM,gBAAgB,kBAAiC,CAAC"}

package/dist/services/embedding.js

@@ -1,9 +1,10 @@
 import { pipeline, env } from "@xenova/transformers";
 import { CONFIG } from "../config.js";
 import { log } from "./logger.js";
+import { join } from "node:path";
 env.allowLocalModels = true;
 env.allowRemoteModels = true;
-env.cacheDir = CONFIG.storagePath + "/.cache";
+env.cacheDir = join(CONFIG.storagePath, ".cache");
 const TIMEOUT_MS = 30000;
 const GLOBAL_EMBEDDING_KEY = Symbol.for("opencode-mem.embedding.instance");
 function withTimeout(promise, ms) {

package/dist/services/sqlite/connection-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-manager.d.ts","sourceRoot":"","sources":["../../../src/services/sqlite/connection-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMtC,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO,CAAC,eAAe;IAqEvB,OAAO,CAAC,YAAY;IAqBpB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAmBvC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASrC,QAAQ,IAAI,IAAI;CAWjB;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}
+{"version":3,"file":"connection-manager.d.ts","sourceRoot":"","sources":["../../../src/services/sqlite/connection-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAOtC,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,WAAW,CAAoC;IACvD,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO,CAAC,eAAe;IAqEzB,OAAO,CAAC,YAAY;IAqBlB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ;IAmBvC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASrC,QAAQ,IAAI,IAAI;CAWjB;AAED,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/services/sqlite/connection-manager.js

@@ -1,6 +1,7 @@
 import { Database } from "bun:sqlite";
 import * as sqliteVec from "sqlite-vec";
 import { existsSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
 import { log } from "../logger.js";
 import { CONFIG } from "../../config.js";
 export class ConnectionManager {
@@ -90,7 +91,7 @@ export class ConnectionManager {
             return this.connections.get(dbPath);
         }
         this.configureSqlite();
-        const dir = dbPath.substring(0, dbPath.lastIndexOf("/"));
+        const dir = dirname(dbPath);
         if (!existsSync(dir)) {
             mkdirSync(dir, { recursive: true });
         }

package/dist/services/tags.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/services/tags.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAO3C;AAED,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAO1C;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU9D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,wBAAgB,cAAc,IAAI,OAAO,CAoBxC;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAW5D;AAED,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG;IAC1C,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB,CAKA"}
+{"version":3,"file":"tags.d.ts","sourceRoot":"","sources":["../../src/services/tags.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAO3C;AAED,wBAAgB,UAAU,IAAI,MAAM,GAAG,IAAI,CAO1C;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU9D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,wBAAgB,cAAc,IAAI,OAAO,CAoBxC;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAW5D;AAED,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG;IAC1C,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB,CAKA"}

package/dist/services/tags.js

@@ -1,6 +1,7 @@
 import { createHash } from "node:crypto";
 import { execSync } from "node:child_process";
 import { CONFIG } from "../config.js";
+import { sep, normalize } from "node:path";
 function sha256(input) {
     return createHash("sha256").update(input).digest("hex").slice(0, 16);
 }
@@ -35,7 +36,9 @@ export function getGitRepoUrl(directory) {
     }
 }
 export function getProjectName(directory) {
-    const parts = directory.split("/").filter((p) => p);
+    // Normalize path to handle both Unix and Windows separators
+    const normalized = normalize(directory);
+    const parts = normalized.split(sep).filter((p) => p);
     return parts[parts.length - 1] || directory;
 }
 export function getUserTagInfo() {

package/dist/web/app.js

@@ -166,14 +166,14 @@ function renderMemoryCard(memory) {
   const isSelected = state.selectedMemories.has(memory.id);
   const isPinned = memory.isPinned || false;
   const isLinked = !!memory.linkedPromptId;
-  const similarityHtml =
+const similarityHtml =
     memory.similarity !== undefined
       ? `<span class="similarity-score">${memory.similarity}%</span>`
       : "";
 
   let displayInfo = memory.displayName || memory.id;
   if (memory.projectPath) {
-    const pathParts = memory.projectPath.split("/");
+    const pathParts = memory.projectPath.replace(/\\/g, "/").split("/").filter((p) => p);
     displayInfo = pathParts[pathParts.length - 1] || memory.projectPath;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-mem",
-  "version": "2.3.4",
+  "version": "2.3.5",
   "description": "OpenCode plugin that gives coding agents persistent memory using local vector database",
   "type": "module",
   "main": "dist/plugin.js",