code-session-memory 0.3.0

package/dist/src/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * A single chunk of content ready to be embedded and stored.
+ */
+export interface DocumentChunk {
+    content: string;
+    metadata: {
+        session_id: string;
+        session_title: string;
+        project: string;
+        heading_hierarchy: string[];
+        section: string;
+        chunk_id: string;
+        url: string;
+        hash: string;
+        chunk_index: number;
+        total_chunks: number;
+    };
+}
+/**
+ * Which tool produced a session.
+ */
+export type SessionSource = "opencode" | "claude-code";
+/**
+ * A row in the sessions_meta table — tracks per-session indexing progress.
+ */
+export interface SessionMeta {
+    session_id: string;
+    session_title: string;
+    project: string;
+    source: SessionSource;
+    last_indexed_message_id: string | null;
+    updated_at: number;
+}
+/**
+ * Minimal session info shape (subset of OpenCode SDK Session type).
+ */
+export interface SessionInfo {
+    id: string;
+    title?: string;
+    directory?: string;
+}
+/**
+ * Minimal message shape used by the indexer (subset of OpenCode SDK types).
+ */
+export interface MessageInfo {
+    id: string;
+    role: "user" | "assistant";
+    time?: {
+        created?: number;
+        completed?: number;
+    };
+    agent?: string;
+    modelID?: string;
+}
+export interface MessagePart {
+    type: string;
+    text?: string;
+    toolName?: string;
+    toolCallId?: string;
+    state?: string;
+    args?: unknown;
+    result?: unknown;
+    filename?: string;
+    mediaType?: string;
+}
+export interface FullMessage {
+    info: MessageInfo;
+    parts: MessagePart[];
+}
+/**
+ * Result row returned by the MCP server query tools.
+ */
+export interface QueryResult {
+    chunk_id: string;
+    distance?: number;
+    content: string;
+    url?: string;
+    section?: string;
+    heading_hierarchy?: string;
+    chunk_index?: number;
+    total_chunks?: number;
+    source?: SessionSource;
+}
+/**
+ * Config for the database layer.
+ */
+export interface DatabaseConfig {
+    dbPath: string;
+    embeddingDimension?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,aAAa,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/src/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "code-session-memory",
+  "version": "0.3.0",
+  "description": "Automatically index OpenCode and Claude Code sessions into a shared sqlite-vec vector database for semantic search across your AI coding history",
+  "type": "commonjs",
+  "main": "dist/src/indexer.js",
+  "types": "dist/src/indexer.d.ts",
+  "bin": {
+    "code-session-memory": "dist/src/cli.js"
+  },
+  "files": [
+    "dist/",
+    "plugin/",
+    "skill/"
+  ],
+  "scripts": {
+    "build": "tsc && chmod 755 dist/src/cli.js dist/mcp/index.js",
+    "build:watch": "tsc --watch",
+    "start:mcp": "node dist/mcp/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "opencode",
+    "claude-code",
+    "mcp",
+    "sqlite-vec",
+    "vector",
+    "memory",
+    "ai",
+    "sessions"
+  ],
+  "author": "Denis Jannot <djannot@gmail.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@opencode-ai/plugin": "^1.2.8",
+    "@opencode-ai/sdk": "^1.2.8",
+    "better-sqlite3": "^11.9.1",
+    "openai": "^4.20.1",
+    "sqlite-vec": "0.1.7-alpha.2",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^20.10.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "typescript": "^5.3.2",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/plugin/memory.ts

@@ -0,0 +1,42 @@
+/**
+ * opencode-memory plugin
+ *
+ * Listens for session.idle events and incrementally indexes new messages
+ * into the sqlite-vec database by spawning a Node.js subprocess (so that
+ * native modules like better-sqlite3 / sqlite-vec load correctly).
+ *
+ * Install this file at:
+ *   ~/.config/opencode/plugins/opencode-memory.ts
+ *
+ * Or run:
+ *   npx opencode-memory install
+ *
+ * Required environment variable:
+ *   OPENAI_API_KEY  — used for generating embeddings
+ */
+
+import type { Plugin } from "@opencode-ai/plugin";
+
+// The path below is replaced with an absolute path at install time.
+const INDEXER_CLI = "OPENCODE_MEMORY_INDEXER_PATH";
+
+const MemoryPlugin: Plugin = async ({ $, serverUrl }) => {
+  return {
+    event: async ({ event }) => {
+      if (event.type !== "session.idle") return;
+
+      const sessionId = event.properties.sessionID;
+      if (!sessionId) return;
+
+      try {
+        await $`node ${INDEXER_CLI} ${sessionId} ${serverUrl.toString()}`.quiet();
+      } catch (err: unknown) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`[opencode-memory] Failed to index session ${sessionId}: ${msg}`);
+      }
+    },
+  };
+};
+
+export default MemoryPlugin;
+export { MemoryPlugin };

package/skill/memory.md

@@ -0,0 +1,61 @@
+---
+description: Search past OpenCode and Claude Code sessions stored in the shared vector memory database
+---
+
+# code-session-memory
+
+You have access to an MCP server called `code-session-memory` that automatically indexes all your past coding sessions — from both **OpenCode** and **Claude Code** — into a single shared local vector database. Every time a session completes a turn, the new messages are embedded and stored, giving you a searchable memory of your entire AI coding history across both tools.
+
+## Available tools
+
+### `query_sessions`
+
+Semantically search across all indexed sessions to find past conversations, decisions, code snippets, or context.
+
+**Parameters:**
+- `queryText` *(required)*: A natural language description of what you are looking for.
+- `project` *(optional)*: Filter results to a specific project directory path (e.g. `"/Users/me/myproject"`).
+- `source` *(optional)*: Filter by tool — `"opencode"` or `"claude-code"`. Omit to search across both.
+- `limit` *(optional, default 5)*: Number of results to return (1–20).
+
+### `get_session_chunks`
+
+Retrieve the full ordered content of a specific session message by URL.
+
+**Parameters:**
+- `sessionUrl` *(required)*: The `session://ses_xxx#msg_yyy` URL from a `query_sessions` result.
+- `startIndex` *(optional)*: First chunk index to retrieve (0-based).
+- `endIndex` *(optional)*: Last chunk index to retrieve (0-based, inclusive).
+
+## When to use these tools
+
+Use `query_sessions` proactively when:
+- The user asks about past work: *"How did we implement the auth flow last week?"*
+- You need context about a recurring problem: *"Have we seen this error before?"*
+- The user references a previous decision: *"What did we decide about the database schema?"*
+- You want to avoid repeating past mistakes or reinventing solutions
+
+Use `get_session_chunks` to read the full context around a match from `query_sessions`.
+
+## Example usage
+
+```
+# Find past work on a topic across all tools
+query_sessions("authentication middleware implementation")
+
+# Search only OpenCode sessions for a specific project
+query_sessions("dark mode toggle", project="/Users/me/myapp", source="opencode")
+
+# Search only Claude Code sessions
+query_sessions("sqlite migration", source="claude-code")
+
+# Get more context from a specific result
+get_session_chunks("session://ses_abc123#msg_def456")
+```
+
+## Notes
+
+- Sessions from both OpenCode and Claude Code are indexed into the **same** database.
+- Indexing is automatic — no manual action needed.
+- The database lives at `~/.local/share/code-session-memory/sessions.db`.
+- Embeddings use OpenAI `text-embedding-3-large` (3072 dimensions).