code-session-memory 0.3.0

package/README.md

@@ -0,0 +1,290 @@
+# code-session-memory
+
+Automatic vector memory for [OpenCode](https://opencode.ai) and [Claude Code](https://claude.ai/code) sessions — shared across both tools.
+
+Every time the AI agent finishes its turn, `code-session-memory` automatically indexes the new messages into a local [sqlite-vec](https://github.com/asg017/sqlite-vec) vector database. Past sessions become semantically searchable — both by the AI agent (via the MCP server) and by you. Sessions from both OpenCode and Claude Code are stored in the **same database**, so memory is shared across tools.
+
+## How it works
+
+```
+OpenCode (session.idle event)          Claude Code (Stop hook)
+        │                                       │
+        │  fetches messages via REST API        │  reads JSONL transcript
+        ▼                                       ▼
+session-to-md                        transcript-to-messages
+        │                                       │
+        └───────────────┬───────────────────────┘
+                        ▼
+             chunker  →  heading-aware chunks (≤1000 tokens, 10% overlap)
+                        │
+                        ▼
+             embedder  →  OpenAI text-embedding-3-large (3072 dims)
+                        │
+                        ▼
+             sqlite-vec DB  →  ~/.local/share/code-session-memory/sessions.db
+                        │
+                        ▼
+             MCP server  →  query_sessions / get_session_chunks tools
+```
+
+Only **new messages** are indexed on each turn — previously indexed messages are skipped (tracked via `sessions_meta` table). This makes each indexing pass fast, even in long sessions.
+
+## Installation
+
+### Prerequisites
+
+- Node.js ≥ 18
+- An OpenAI API key (for `text-embedding-3-large`)
+- OpenCode and/or Claude Code installed
+
+### Install
+
+```bash
+npx code-session-memory install
+```
+
+The `install` command sets up everything for both tools in one shot:
+
+**OpenCode:**
+1. Copies the plugin to `~/.config/opencode/plugins/code-session-memory.ts`
+2. Copies the skill to `~/.config/opencode/skills/code-session-memory.md`
+3. Writes the MCP server entry into `~/.config/opencode/opencode.json`
+
+**Claude Code:**
+1. Writes a `Stop` hook to `~/.claude/settings.json` (fires after each agent turn)
+2. Injects the skill into `~/.claude/CLAUDE.md` (with idempotent markers)
+3. Registers the MCP server via `claude mcp add`
+
+**Both tools share:**
+- The same database at `~/.local/share/code-session-memory/sessions.db`
+- The same MCP server for querying past sessions
+
+Then **restart OpenCode / Claude Code** to activate.
+
+### Set your API key
+
+```bash
+export OPENAI_API_KEY=sk-...
+```
+
+Add this to your shell profile (`.bashrc`, `.zshrc`, etc.) so it's always available.
+
+## Usage
+
+Once installed, memory indexing is **fully automatic**. No further action needed — sessions are indexed as you use OpenCode or Claude Code.
+
+### Verify installation
+
+```bash
+npx code-session-memory status
+```
+
+Output:
+```
+code-session-memory status
+
+  Database       ~/.local/share/code-session-memory/sessions.db  ✓
+  Indexed chunks:   1842
+  Sessions tracked: 47
+
+  OpenCode
+    Plugin         ~/.config/opencode/plugins/code-session-memory.ts  ✓
+    Skill          ~/.config/opencode/skills/code-session-memory.md    ✓
+    MCP server     /path/to/dist/mcp/index.js                          ✓
+    MCP config     ~/.config/opencode/opencode.json                    ✓
+
+  Claude Code
+    Stop hook      ~/.claude/settings.json                             ✓
+    Skill          ~/.claude/CLAUDE.md                                 ✓
+    MCP server     /path/to/dist/mcp/index.js                          ✓
+```
+
+### MCP tools
+
+The agent can use two MCP tools (and will automatically via the installed skill):
+
+#### `query_sessions`
+
+Semantic search across all indexed sessions.
+
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `queryText` | string | yes | Natural language query |
+| `project` | string | no | Filter by project directory path |
+| `source` | string | no | Filter by tool: `"opencode"` or `"claude-code"` |
+| `limit` | number | no | Max results (default: 5) |
+
+Example result:
+```
+Result 1:
+  Content: [Session: Add dark mode toggle > User]
+
+  How can I implement a dark mode toggle using CSS variables?
+  Distance: 0.1823
+  URL: session://ses_abc123#msg_def456
+  Section: User
+  Chunk: 1 of 1
+---
+```
+
+#### `get_session_chunks`
+
+Retrieve the full ordered content of a specific session message. Use the `session://ses_xxx#msg_yyy` URL from `query_sessions` results.
+
+| Parameter | Type | Required | Description |
+|---|---|---|---|
+| `sessionUrl` | string | yes | URL from `query_sessions` result |
+| `startIndex` | number | no | First chunk index (0-based) |
+| `endIndex` | number | no | Last chunk index (0-based, inclusive) |
+
+### Asking the agent about past sessions
+
+The installed skill teaches the agent when and how to use these tools. Example prompts:
+
+```
+How did we implement the authentication middleware last week?
+Have we discussed this error before?
+What was our decision about the database schema?
+Show me how we solved the TypeScript config issue.
+```
+
+## Configuration
+
+### Environment variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `OPENAI_API_KEY` | — | **Required.** Used for embedding generation. |
+| `OPENCODE_MEMORY_DB_PATH` | `~/.local/share/code-session-memory/sessions.db` | Override the database path. |
+| `OPENCODE_CONFIG_DIR` | `~/.config/opencode` | Override the OpenCode config directory. |
+| `OPENAI_MODEL` | `text-embedding-3-large` | Override the embedding model. |
+
+### Database path
+
+The default database path works on both **macOS** and **Linux**. On macOS, `~/.local/share` is used for cross-platform consistency (rather than `~/Library/Application Support`).
+
+To change it:
+```bash
+export OPENCODE_MEMORY_DB_PATH=/custom/path/sessions.db
+npx code-session-memory install
+```
+
+## Project structure
+
+```
+code-session-memory/
+├── src/
+│   ├── types.ts                  # Shared TypeScript types
+│   ├── database.ts               # SQLite-vec: init, insert, query
+│   ├── chunker.ts                # Heading-aware markdown chunker
+│   ├── embedder.ts               # OpenAI embeddings (batched)
+│   ├── session-to-md.ts          # OpenCode SDK messages → markdown
+│   ├── transcript-to-messages.ts # Claude Code JSONL transcript parser
+│   ├── indexer.ts                # Orchestrator: incremental indexing
+│   ├── indexer-cli.ts            # Node.js subprocess (called by OpenCode plugin)
+│   ├── indexer-cli-claude.ts     # Node.js subprocess (called by Claude Code hook)
+│   └── cli.ts                    # install / status / uninstall commands
+├── mcp/
+│   ├── server.ts                 # MCP query handlers (testable, injected deps)
+│   └── index.ts                  # MCP stdio server entry point
+├── plugin/
+│   └── memory.ts                 # OpenCode plugin (session.idle hook)
+├── skill/
+│   └── memory.md                 # Skill instructions (injected into both tools)
+└── tests/
+    ├── chunker.test.ts
+    ├── database.test.ts
+    ├── embedder.test.ts
+    ├── indexer.test.ts
+    ├── mcp-server.test.ts
+    └── session-to-md.test.ts
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Watch mode
+npm run test:watch
+
+# Coverage report
+npm run test:coverage
+```
+
+### Running tests
+
+Tests use [Vitest](https://vitest.dev) and run without any external dependencies:
+- No real OpenAI API calls — the embedder is mocked
+- No real DB files — SQLite uses in-memory databases (`:memory:`) for unit tests
+- Indexer tests use a temp directory on disk
+
+```
+ ✓ tests/chunker.test.ts       (15 tests)
+ ✓ tests/mcp-server.test.ts    (13 tests)
+ ✓ tests/session-to-md.test.ts (18 tests)
+ ✓ tests/embedder.test.ts       (9 tests)
+ ✓ tests/database.test.ts      (25 tests)
+ ✓ tests/indexer.test.ts        (8 tests)
+   Tests  88 passed
+```
+
+## Uninstall
+
+```bash
+npx code-session-memory uninstall
+```
+
+This removes the plugin, hooks, and skill files for both tools. The database is **not** removed automatically.
+
+To also remove the database:
+```bash
+rm ~/.local/share/code-session-memory/sessions.db
+```
+
+## Architecture notes
+
+### Incremental indexing
+
+The plugin/hook fires on every agent turn. To avoid re-processing the entire session history each time, the indexer:
+
+1. Reads `last_indexed_message_id` from the `sessions_meta` table
+2. Skips all messages up to and including that ID
+3. Processes only the new messages
+4. Updates `last_indexed_message_id` after success
+
+This makes each indexing pass O(new messages) rather than O(all messages).
+
+### Why a Node.js subprocess?
+
+OpenCode plugins run inside **Bun**, but `better-sqlite3` and `sqlite-vec` are native Node.js addons that don't load under Bun. The plugin therefore spawns a Node.js subprocess (`indexer-cli.js`) to handle all database operations. The Claude Code hook calls a similar subprocess (`indexer-cli-claude.js`) which reads the transcript JSONL from disk.
+
+### Claude Code transcript parsing
+
+Claude Code writes a JSONL transcript after each session turn. The parser (`transcript-to-messages.ts`) handles:
+- Deduplicating streaming `assistant` chunks (keeps the last entry per `message.id`)
+- Skipping internal `thinking` blocks, metadata entries, and error messages
+- Converting `tool_use` / `tool_result` entries to readable markdown
+
+### Chunking strategy
+
+- Heading-aware splitting — headings define semantic boundaries
+- Max 1000 whitespace-tokenized words per chunk
+- Sections below 150 words are merged with adjacent sections
+- Sections above 1000 words are split with 10% overlap
+- Each chunk gets a `[Session: Title > Section]` breadcrumb prefix injected before embedding, improving retrieval precision
+
+### MCP server
+
+The MCP server uses **stdio transport** — the simplest and most reliable transport for local use. It opens and closes the SQLite connection on each query (no persistent connection), making it safe to run alongside the indexer. The `query_sessions` tool accepts an optional `source` parameter to filter results to a specific tool.
+
+## License
+
+MIT

package/dist/mcp/index.d.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/**
+ * code-session-memory MCP server (stdio transport).
+ *
+ * Exposes two tools:
+ *   - query_sessions     — semantic search across indexed sessions (OpenCode + Claude Code)
+ *   - get_session_chunks — retrieve ordered chunks for a specific session URL
+ *
+ * Environment variables:
+ *   OPENAI_API_KEY           — required for embedding generation
+ *   OPENAI_MODEL             — embedding model (default: text-embedding-3-large)
+ *   OPENCODE_MEMORY_DB_PATH  — path to the sqlite-vec DB
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../mcp/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}

package/dist/mcp/index.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * code-session-memory MCP server (stdio transport).
+ *
+ * Exposes two tools:
+ *   - query_sessions     — semantic search across indexed sessions (OpenCode + Claude Code)
+ *   - get_session_chunks — retrieve ordered chunks for a specific session URL
+ *
+ * Environment variables:
+ *   OPENAI_API_KEY           — required for embedding generation
+ *   OPENAI_MODEL             — embedding model (default: text-embedding-3-large)
+ *   OPENCODE_MEMORY_DB_PATH  — path to the sqlite-vec DB
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const openai_1 = require("openai");
+const sqliteVec = __importStar(require("sqlite-vec"));
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const fs_1 = __importDefault(require("fs"));
+const database_1 = require("../src/database");
+const server_1 = require("./server");
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+const dbPath = (0, database_1.resolveDbPath)();
+const openAiApiKey = process.env.OPENAI_API_KEY;
+const openAiModel = process.env.OPENAI_MODEL ?? "text-embedding-3-large";
+if (!openAiApiKey) {
+    console.error("Error: OPENAI_API_KEY environment variable is required.");
+    process.exit(1);
+}
+if (!fs_1.default.existsSync(dbPath)) {
+    console.error(`Error: Database not found at ${dbPath}.\nRun "npx code-session-memory install" first.`);
+    process.exit(1);
+}
+// ---------------------------------------------------------------------------
+// Embedding function
+// ---------------------------------------------------------------------------
+const openai = new openai_1.OpenAI({ apiKey: openAiApiKey });
+async function createEmbedding(text) {
+    const MAX_CHARS = 8191 * 4;
+    const input = text.length > MAX_CHARS ? text.slice(0, MAX_CHARS) : text;
+    const response = await openai.embeddings.create({ model: openAiModel, input });
+    const embedding = response.data?.[0]?.embedding;
+    if (!embedding)
+        throw new Error("No embedding returned from OpenAI API");
+    return embedding;
+}
+// ---------------------------------------------------------------------------
+// SQLite provider + tool handlers
+// ---------------------------------------------------------------------------
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const provider = (0, server_1.createSqliteProvider)({
+    dbPath,
+    sqliteVec: sqliteVec,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    Database: better_sqlite3_1.default,
+    fs: fs_1.default,
+});
+const { querySessionsHandler, getSessionChunksHandler } = (0, server_1.createToolHandlers)({
+    createEmbedding,
+    querySessions: provider.querySessions,
+    getSessionChunks: provider.getSessionChunks,
+});
+// ---------------------------------------------------------------------------
+// MCP server
+// ---------------------------------------------------------------------------
+const server = new mcp_js_1.McpServer({
+    name: "code-session-memory",
+    version: "0.3.0",
+});
+// Zod schemas defined separately to avoid type instantiation depth issues
+const querySessionsSchema = {
+    queryText: zod_1.z.string().min(1).describe("Natural language description of what you are looking for."),
+    project: zod_1.z.string().optional().describe("Filter results to a specific project directory path (e.g. '/Users/me/myproject'). Optional."),
+    source: zod_1.z.enum(["opencode", "claude-code"]).optional().describe("Filter results by tool source: 'opencode' or 'claude-code'. Optional — omit to search across both."),
+    limit: zod_1.z.number().int().min(1).optional().describe("Maximum number of results to return. Defaults to 5."),
+};
+const getSessionChunksSchema = {
+    sessionUrl: zod_1.z.string().min(1).describe("The session message URL from a query_sessions result (e.g. 'session://ses_xxx#msg_yyy')."),
+    startIndex: zod_1.z.number().int().min(0).optional().describe("First chunk index to retrieve (0-based, inclusive). Optional."),
+    endIndex: zod_1.z.number().int().min(0).optional().describe("Last chunk index to retrieve (0-based, inclusive). Optional."),
+};
+// Cast server to any to avoid deep MCP SDK Zod type instantiation (TS2589)
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const serverAny = server;
+serverAny.tool("query_sessions", "Semantically search across all indexed sessions stored in the vector database. Returns the most relevant chunks from past sessions. Sessions from both OpenCode and Claude Code are indexed into the same shared database.", querySessionsSchema, async (args) => querySessionsHandler({ ...args, limit: args.limit ?? 5 }));
+serverAny.tool("get_session_chunks", "Retrieve the ordered content chunks for a specific session message. Use the URL from query_sessions results (e.g. 'session://ses_xxx#msg_yyy') to get the full context around a match.", getSessionChunksSchema, async (args) => getSessionChunksHandler(args));
+// ---------------------------------------------------------------------------
+// Start
+// ---------------------------------------------------------------------------
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error(`code-session-memory MCP server running (DB: ${dbPath})`);
+}
+main().catch((err) => {
+    console.error("Failed to start MCP server:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../mcp/index.ts"],"names":[],"mappings":"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"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,60 @@
+/**
+ * MCP query handlers for opencode-memory.
+ *
+ * Adapted from doc2vec/mcp/src/server.ts — simplified to:
+ *   - SQLite-vec only (no Qdrant)
+ *   - Fixed single DB path (no multi-DB resolution)
+ *   - Two tools: query_sessions + get_session_chunks
+ */
+import type { QueryResult } from "../src/types";
+export type { QueryResult };
+type SqliteVecModule = {
+    load: (db: SqliteDatabase) => void;
+};
+type SqliteDatabase = {
+    prepare: (sql: string) => SqliteStatement;
+    close: () => void;
+};
+type SqliteStatement = {
+    all: (...params: unknown[]) => unknown[];
+};
+type FsModule = {
+    existsSync: (p: string) => boolean;
+};
+export declare function createSqliteProvider(deps: {
+    dbPath: string;
+    sqliteVec: SqliteVecModule;
+    Database: new (path: string) => SqliteDatabase;
+    fs: FsModule;
+}): {
+    querySessions: (queryEmbedding: number[], topK?: number, projectFilter?: string, sourceFilter?: string) => Promise<QueryResult[]>;
+    getSessionChunks: (url: string, startIndex?: number, endIndex?: number) => Promise<QueryResult[]>;
+};
+export declare function createToolHandlers(deps: {
+    createEmbedding: (text: string) => Promise<number[]>;
+    querySessions: (embedding: number[], topK: number, project?: string, source?: string) => Promise<QueryResult[]>;
+    getSessionChunks: (url: string, startIndex?: number, endIndex?: number) => Promise<QueryResult[]>;
+}): {
+    querySessionsHandler: (args: {
+        queryText: string;
+        project?: string;
+        source?: string;
+        limit?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+    getSessionChunksHandler: (args: {
+        sessionUrl: string;
+        startIndex?: number;
+        endIndex?: number;
+    }) => Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,YAAY,EAAE,WAAW,EAAE,CAAC;AAM5B,KAAK,eAAe,GAAG;IAAE,IAAI,EAAE,CAAC,EAAE,EAAE,cAAc,KAAK,IAAI,CAAA;CAAE,CAAC;AAC9D,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,eAAe,CAAC;IAC1C,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AACF,KAAK,eAAe,GAAG;IACrB,GAAG,EAAE,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,OAAO,EAAE,CAAC;CAC1C,CAAC;AACF,KAAK,QAAQ,GAAG;IAAE,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;CAAE,CAAC;AAMvD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,EAAE,KAAK,IAAI,EAAE,MAAM,KAAK,cAAc,CAAC;IAC/C,EAAE,EAAE,QAAQ,CAAC;CACd;oCAsBmB,MAAM,EAAE,iCAER,MAAM,iBACP,MAAM,KACpB,OAAO,CAAC,WAAW,EAAE,CAAC;4BA0ClB,MAAM,eACE,MAAM,aACR,MAAM,KAChB,OAAO,CAAC,WAAW,EAAE,CAAC;EAwB1B;AAMD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,aAAa,EAAE,CACb,SAAS,EAAE,MAAM,EAAE,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,KACZ,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5B,gBAAgB,EAAE,CAChB,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,KACd,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC7B;iCAK2C;QACxC,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB;;;;;;oCAuD4C;QAC3C,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;;;;;;EAwDF"}