@s_s/mnemo 1.0.0

package/README.md

@@ -0,0 +1,193 @@
+# Mnemo
+
+[中文文档](./docs/README.zh-CN.md)
+
+Persistent memory management for AI coding assistants via [MCP](https://modelcontextprotocol.io/).
+
+Mnemo solves the problem of context window overflow — important decisions, user preferences, and project knowledge get lost when conversations reset. Mnemo distills key information into persistent memory notes that can be recalled across sessions using semantic search.
+
+## Features
+
+- **Semantic search** — find memories by meaning, not just keywords (powered by local embeddings)
+- **Multi-agent support** — works with OpenCode, Claude Code, Openclaw, and Codex
+- **Fully local** — no API calls, no cloud storage; all data stays on your machine
+- **Auto-prompted** — injects instructions into your agent's config so it knows when to save and recall memories
+- **Compression workflow** — atomic distillation of old notes into fewer, concise ones
+
+## Quick Start
+
+### Install
+
+```bash
+npm install -g mnemo
+```
+
+### Configure your MCP client
+
+Add Mnemo to your MCP client configuration. For example, in OpenCode (`opencode.json`):
+
+```json
+{
+  "mcp": {
+    "mnemo": {
+      "command": "mnemo"
+    }
+  }
+}
+```
+
+For Claude Code (`.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "mnemo": {
+      "command": "mnemo"
+    }
+  }
+}
+```
+
+### Initialize
+
+Once connected, call the `memory_setup` tool to inject memory management instructions into your agent's config file:
+
+```
+> Use the memory_setup tool to initialize Mnemo
+```
+
+This writes a prompt block into your agent's config (e.g., `AGENTS.md` for OpenCode, `CLAUDE.md` for Claude Code) that teaches the agent when and how to use Mnemo's tools.
+
+## Usage Examples
+
+> **Important:** You don't call Mnemo tools directly. You chat with your AI agent in natural language, and the agent decides when to call Mnemo tools behind the scenes. After running `memory_setup`, the agent already knows when and how to use them.
+
+### First-time setup
+
+```
+You:   Help me set up Mnemo for memory management
+Agent: I'll initialize Mnemo for you.
+       → [calls memory_setup tool]
+       Mnemo has been initialized. I've added memory management
+       instructions to your AGENTS.md file.
+```
+
+### Saving memories (automatic)
+
+The agent saves memories on its own when it recognizes important information:
+
+```
+You:   Let's use 4-space indentation and single quotes for this project.
+Agent: Got it. I'll follow that style.
+       → [calls memory_save: "Project code style: 4-space indentation,
+          single quotes", tags: ["preference", "code-style"]]
+       I've saved this as a memory so I'll remember it next time.
+```
+
+### Recalling context (automatic)
+
+When you start a new conversation, the agent searches for relevant memories:
+
+```
+You:   Let's continue working on the auth module.
+Agent: → [calls memory_search: "auth module"]
+       Based on my memories, last time we decided to use JWT with
+       refresh tokens and store them in httpOnly cookies. Let me
+       pick up from there.
+```
+
+### Searching memories (on request)
+
+```
+You:   Do you remember what database we chose?
+Agent: → [calls memory_search: "database choice"]
+       Yes — we decided on PostgreSQL with Prisma ORM, mainly for
+       its type safety and migration tooling.
+```
+
+### Compressing memories
+
+When memories accumulate, you can ask the agent to clean up:
+
+```
+You:   We have a lot of memories now. Can you clean them up?
+Agent: → [calls memory_compress]
+       I found 23 memories. Let me distill them into fewer notes...
+       → [calls memory_compress_apply: saves 8 distilled notes,
+          deletes 23 originals]
+       Done. Compressed 23 memories into 8 concise notes.
+```
+
+## Tools
+
+Mnemo provides 6 MCP tools:
+
+| Tool                    | Description                                                                 |
+| ----------------------- | --------------------------------------------------------------------------- |
+| `memory_setup`          | Initialize Mnemo — inject usage instructions into agent config              |
+| `memory_save`           | Save a memory note with optional tags and source                            |
+| `memory_search`         | Semantic search across memories (supports `source_filter` and `tag_filter`) |
+| `memory_compress`       | List all notes for review/distillation                                      |
+| `memory_compress_apply` | Atomically save distilled notes and delete originals                        |
+| `memory_delete`         | Delete notes by ID                                                          |
+
+## How It Works
+
+### Storage
+
+Memory notes are stored as Markdown files with YAML frontmatter:
+
+```
+~/Library/Application Support/mnemo/    # macOS
+~/.local/share/mnemo/                   # Linux
+%APPDATA%/mnemo/                        # Windows
+├── notes/                              # Markdown files
+│   ├── 20260305-172200-a3f1.md
+│   └── 20260305-183015-b7c2.md
+└── index/                              # Vector index (vectra)
+```
+
+Override the data directory with `MNEMO_DATA_DIR` environment variable.
+
+### Semantic Search
+
+Mnemo uses [all-MiniLM-L6-v2](https://huggingface.co/Xenova/all-MiniLM-L6-v2) (33MB, 384 dimensions) for local embeddings via `@huggingface/transformers`. The model is preloaded at server startup so it's ready before the first search.
+
+### Memory Lifecycle
+
+1. **Save** — Agent saves key info during conversations (decisions, preferences, architecture choices, or when context is running low)
+2. **Search** — Agent retrieves relevant context at the start of new conversations or when needed
+3. **Compress** — When notes accumulate, the agent distills them into fewer, concise notes via `memory_compress` → review → `memory_compress_apply`
+
+## Development
+
+```bash
+git clone git@github.com:See-Cat/mnemo.git
+cd mnemo
+npm install
+npm run build
+npm test
+```
+
+### Scripts
+
+| Command                | Description                  |
+| ---------------------- | ---------------------------- |
+| `npm run build`        | Compile TypeScript           |
+| `npm run dev`          | Watch mode compilation       |
+| `npm test`             | Run tests (Vitest)           |
+| `npm run test:watch`   | Watch mode tests             |
+| `npm run prettier:fix` | Format all files             |
+| `npm run release`      | Interactive release workflow |
+
+### Release
+
+```bash
+npm run release
+```
+
+Interactive script that walks through: git check → branch check → version selection → format → test → build → publish → push.
+
+## License
+
+MIT

package/build/core/config.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Supported agent tool types
+ */
+export declare const AGENT_TYPES: readonly ["opencode", "claude-code", "openclaw", "codex"];
+export type AgentType = (typeof AGENT_TYPES)[number];
+/**
+ * Get platform-appropriate data directory for Mnemo.
+ *
+ * Follows platform conventions:
+ * - macOS:   ~/Library/Application Support/mnemo
+ * - Linux:   $XDG_DATA_HOME/mnemo  (defaults to ~/.local/share/mnemo)
+ * - Windows: %APPDATA%/mnemo
+ *
+ * Can be overridden via MNEMO_DATA_DIR env var.
+ */
+export declare function getDataDir(): string;
+/**
+ * Get the notes directory
+ */
+export declare function getNotesDir(): string;
+/**
+ * Get the vector index directory
+ */
+export declare function getIndexDir(): string;
+/**
+ * Ensure a directory exists
+ */
+export declare function ensureDir(dir: string): Promise<void>;
+/**
+ * Memory note metadata
+ */
+export interface NoteMeta {
+    id: string;
+    created: string;
+    updated: string;
+    tags: string[];
+    source: string;
+}
+/**
+ * Memory note (metadata + content)
+ */
+export interface Note {
+    meta: NoteMeta;
+    content: string;
+}
+/**
+ * Compress trigger thresholds
+ */
+export declare const COMPRESS_THRESHOLDS: {
+    /** Max number of notes before auto-compress suggestion */
+    readonly maxNotes: 50;
+    /** Max total content size (chars) before auto-compress suggestion */
+    readonly maxTotalSize: 100000;
+};

package/build/core/config.js

@@ -0,0 +1,61 @@
+import path from 'node:path';
+import os from 'node:os';
+import fs from 'node:fs/promises';
+/**
+ * Supported agent tool types
+ */
+export const AGENT_TYPES = ['opencode', 'claude-code', 'openclaw', 'codex'];
+/**
+ * Get platform-appropriate data directory for Mnemo.
+ *
+ * Follows platform conventions:
+ * - macOS:   ~/Library/Application Support/mnemo
+ * - Linux:   $XDG_DATA_HOME/mnemo  (defaults to ~/.local/share/mnemo)
+ * - Windows: %APPDATA%/mnemo
+ *
+ * Can be overridden via MNEMO_DATA_DIR env var.
+ */
+export function getDataDir() {
+    const envDir = process.env.MNEMO_DATA_DIR;
+    if (envDir)
+        return envDir;
+    const platform = process.platform;
+    const home = os.homedir();
+    switch (platform) {
+        case 'darwin':
+            return path.join(home, 'Library', 'Application Support', 'mnemo');
+        case 'win32':
+            return path.join(process.env.APPDATA || path.join(home, 'AppData', 'Roaming'), 'mnemo');
+        default:
+            // Linux and others: follow XDG Base Directory spec
+            return path.join(process.env.XDG_DATA_HOME || path.join(home, '.local', 'share'), 'mnemo');
+    }
+}
+/**
+ * Get the notes directory
+ */
+export function getNotesDir() {
+    return path.join(getDataDir(), 'notes');
+}
+/**
+ * Get the vector index directory
+ */
+export function getIndexDir() {
+    return path.join(getDataDir(), 'index');
+}
+/**
+ * Ensure a directory exists
+ */
+export async function ensureDir(dir) {
+    await fs.mkdir(dir, { recursive: true });
+}
+/**
+ * Compress trigger thresholds
+ */
+export const COMPRESS_THRESHOLDS = {
+    /** Max number of notes before auto-compress suggestion */
+    maxNotes: 50,
+    /** Max total content size (chars) before auto-compress suggestion */
+    maxTotalSize: 100_000,
+};
+//# sourceMappingURL=config.js.map

package/build/core/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAIrF;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU;IACtB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC1C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAE1B,QAAQ,QAAQ,EAAE,CAAC;QACf,KAAK,QAAQ;YACT,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,OAAO,CAAC,CAAC;QACtE,KAAK,OAAO;YACR,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;QAC5F;YACI,mDAAmD;YACnD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACnG,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACvB,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACvB,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACvC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAqBD;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAC/B,0DAA0D;IAC1D,QAAQ,EAAE,EAAE;IACZ,qEAAqE;IACrE,YAAY,EAAE,OAAO;CACf,CAAC"}

package/build/core/embedding.d.ts

@@ -0,0 +1,37 @@
+import { type Note } from './config.js';
+/**
+ * Pre-warm the embedding model in the background.
+ * Call this at server startup so the model is ready before the first tool call.
+ */
+export declare function preloadEmbedding(): void;
+/**
+ * Check if the embedding model is ready
+ */
+export declare function isEmbeddingReady(): boolean;
+/**
+ * Generate embedding vector for text
+ */
+export declare function embed(text: string): Promise<number[]>;
+/**
+ * Index a note (generate embedding and store in vector index)
+ */
+export declare function indexNote(note: Note): Promise<void>;
+/**
+ * Remove a note from the vector index
+ */
+export declare function removeFromIndex(noteId: string): Promise<void>;
+/**
+ * Remove multiple notes from the vector index
+ */
+export declare function removeMultipleFromIndex(noteIds: string[]): Promise<void>;
+/**
+ * Search for similar notes by query text
+ */
+export declare function searchNotes(query: string, topK?: number, sourceFilter?: string): Promise<Array<{
+    id: string;
+    score: number;
+    text: string;
+    tags: string;
+    source: string;
+    created: string;
+}>>;

package/build/core/embedding.js

@@ -0,0 +1,119 @@
+import { LocalIndex } from 'vectra';
+import { getIndexDir, ensureDir } from './config.js';
+let embedder = null;
+let embedderLoading = null;
+let indexInstance = null;
+/**
+ * Load the embedding model.
+ * Uses all-MiniLM-L6-v2 (384 dims, ~33MB, good quality/speed tradeoff).
+ * Deduplicates concurrent calls so the model is only loaded once.
+ */
+async function getEmbedder() {
+    if (embedder)
+        return embedder;
+    if (!embedderLoading) {
+        embedderLoading = (async () => {
+            console.error('Mnemo: loading embedding model...');
+            const { pipeline } = await import('@huggingface/transformers');
+            embedder = await pipeline('feature-extraction', 'Xenova/all-MiniLM-L6-v2');
+            console.error('Mnemo: embedding model loaded');
+            return embedder;
+        })();
+    }
+    return embedderLoading;
+}
+/**
+ * Pre-warm the embedding model in the background.
+ * Call this at server startup so the model is ready before the first tool call.
+ */
+export function preloadEmbedding() {
+    getEmbedder().catch((err) => {
+        console.error('Mnemo: failed to preload embedding model:', err);
+    });
+}
+/**
+ * Check if the embedding model is ready
+ */
+export function isEmbeddingReady() {
+    return embedder !== null;
+}
+/**
+ * Generate embedding vector for text
+ */
+export async function embed(text) {
+    const model = await getEmbedder();
+    const output = await model(text, { pooling: 'mean', normalize: true });
+    return Array.from(output.data);
+}
+/**
+ * Get or create the vector index
+ */
+async function getIndex() {
+    if (!indexInstance) {
+        const indexDir = getIndexDir();
+        await ensureDir(indexDir);
+        indexInstance = new LocalIndex(indexDir);
+        if (!(await indexInstance.isIndexCreated())) {
+            await indexInstance.createIndex({
+                version: 1,
+                metadata_config: { indexed: ['source'] },
+            });
+            console.error('Mnemo: vector index created');
+        }
+    }
+    return indexInstance;
+}
+/**
+ * Index a note (generate embedding and store in vector index)
+ */
+export async function indexNote(note) {
+    const index = await getIndex();
+    const vector = await embed(note.content);
+    await index.insertItem({
+        id: note.meta.id,
+        vector,
+        metadata: {
+            id: note.meta.id,
+            text: note.content.slice(0, 500), // store truncated text for quick access
+            tags: note.meta.tags.join(','),
+            source: note.meta.source,
+            created: note.meta.created,
+        },
+    });
+}
+/**
+ * Remove a note from the vector index
+ */
+export async function removeFromIndex(noteId) {
+    const index = await getIndex();
+    const item = await index.getItem(noteId);
+    if (item) {
+        await index.deleteItem(noteId);
+    }
+}
+/**
+ * Remove multiple notes from the vector index
+ */
+export async function removeMultipleFromIndex(noteIds) {
+    for (const id of noteIds) {
+        await removeFromIndex(id);
+    }
+}
+/**
+ * Search for similar notes by query text
+ */
+export async function searchNotes(query, topK = 5, sourceFilter) {
+    const index = await getIndex();
+    const vector = await embed(query);
+    const filter = sourceFilter ? { source: { $eq: sourceFilter } } : undefined;
+    const results = await index.queryItems(vector, '', topK, filter);
+    return results.map((r) => ({
+        id: r.item.metadata.id,
+        score: r.score,
+        text: r.item.metadata.text,
+        tags: r.item.metadata.tags,
+        source: r.item.metadata.source,
+        created: r.item.metadata.created,
+    }));
+}
+//# sourceMappingURL=embedding.js.map

package/build/core/embedding.js.map

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

package/build/core/notes.d.ts

@@ -0,0 +1,36 @@
+import { type Note } from './config.js';
+/**
+ * Parse a note markdown file into Note object
+ */
+export declare function parseNote(raw: string): Note | null;
+/**
+ * Serialize a Note to markdown string
+ */
+export declare function serializeNote(note: Note): string;
+/**
+ * Save a new note to disk and return it
+ */
+export declare function saveNote(content: string, tags?: string[], source?: string): Promise<Note>;
+/**
+ * Read a single note by ID
+ */
+export declare function readNote(id: string): Promise<Note | null>;
+/**
+ * Read all notes from disk
+ */
+export declare function readAllNotes(): Promise<Note[]>;
+/**
+ * Delete a note by ID
+ */
+export declare function deleteNote(id: string): Promise<boolean>;
+/**
+ * Delete multiple notes by ID
+ */
+export declare function deleteNotes(ids: string[]): Promise<number>;
+/**
+ * Get note stats (count and total size)
+ */
+export declare function getNoteStats(): Promise<{
+    count: number;
+    totalSize: number;
+}>;