@mnemo-mcp/cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Omer Maksuti
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,123 @@
+# Mnemo
+
+> Persistent memory for Claude Code. Your AI never starts from scratch again.
+
+[![CI](https://github.com/omermaksutii/mnemo/actions/workflows/ci.yml/badge.svg)](https://github.com/omermaksutii/mnemo/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Mnemo gives Claude Code a brain that survives across sessions. It captures decisions, conventions, and preferences — and recalls them by meaning, on demand, with sub-100ms semantic search.
+
+---
+
+## Install
+
+```bash
+# install the CLI
+npm install -g @mnemo-mcp/cli
+
+# install Mnemo into Claude Code (skill + MCP server)
+mnemo init
+
+# (optional) also wire auto-capture hooks
+mnemo init --with-hooks
+
+# verify
+mnemo doctor
+```
+
+After `mnemo init`, restart Claude Code. The `/mnemo` skill and the `mnemo_*` MCP tools are now available — Claude will use them automatically when relevant.
+
+## Use it from the terminal too
+
+```bash
+mnemo remember "our API auth uses OAuth2 with refresh tokens every 30min"
+mnemo remember --global "I prefer pnpm over npm"
+mnemo recall "what's our auth pattern?"
+mnemo list
+mnemo stats
+mnemo forget <id>
+mnemo export --out memories.json
+mnemo import memories.json
+```
+
+## What Mnemo solves
+
+Claude Code forgets everything when the session ends. `CLAUDE.md` partially helps — it's a static blob loaded on every turn — but it grows unwieldy fast and can't answer "do we have a precedent for X?"
+
+Mnemo gives you semantic, on-demand memory:
+
+| | `CLAUDE.md` | Mnemo |
+|---|---|---|
+| Capacity | A handful of paragraphs before token cost hurts | Tens of thousands of memories |
+| Retrieval | Always loaded, every turn | On demand, by meaning |
+| Updates | You edit a file by hand | Captured automatically or via `/teach` |
+| Cross-project | Per-project only | Project + global tiers |
+| Forgetting | Manually delete lines | `mnemo forget <id>` or `/forget` |
+
+## How it works
+
+```
+Claude Code session
+  ├── /mnemo skill              ← teaches Claude when to call the tools
+  ├── @mnemo-mcp/server server          ← exposes recall/remember/forget/list/stats
+  └── @mnemo-mcp/cli hooks           ← session-start, pre-task, post-edit auto-wiring
+              │
+              ▼
+       @mnemo-mcp/core
+       ├── ONNX all-MiniLM-L6-v2  (384-dim embeddings, ~25MB, lazy)
+       ├── HNSW vector index      (sub-100ms recall at 50k memories)
+       └── sql.js (WASM SQLite)   (~/.mnemo/memory.db)
+```
+
+Everything is local-first. No daemon. No cloud account. No telemetry.
+
+## Auto-capture rules
+
+By default the post-edit hook captures any change to:
+
+- `CLAUDE.md`, `AGENTS.md`, `GEMINI.md`
+- `*.adr.md`
+- `docs/decisions/**`
+- `docs/adr/**`
+
+Anything you write to those files becomes a project memory automatically. Disable with `mnemo init` (no `--with-hooks`).
+
+## Recall scoring
+
+```
+score = 0.7 × cosine_similarity + 0.2 × recency + 0.1 × access_boost
+```
+
+Recency decays with a 30-day half-life. Access boost saturates at 20 reads.
+
+## Layout
+
+```
+@mnemo-mcp/core   — pure TS memory engine
+@mnemo-mcp/server    — MCP server (drop into Claude Code)
+@mnemo-mcp/cli    — terminal commands + hook handlers + init
+```
+
+## Roadmap
+
+- ✅ **v0.1** — core engine + CLI
+- ✅ **v0.2** — MCP server (5 tools)
+- ✅ **v0.3** — hooks (session-start, pre-task, post-edit)
+- ✅ **v0.4** — `/mnemo` skill
+- ✅ **v1.0** — `mnemo init`, beefier doctor, CI, polish
+- ⏳ **v1.1** — team mode (git-synced shared memory)
+- ⏳ **v2.0** — opt-in hosted sync, web UI
+
+## Development
+
+```bash
+npm install
+npm test                                    # fast (44 tests, hash embedder)
+MNEMO_TEST_ONNX=1 MNEMO_E2E=1 npm test     # full incl. real ONNX (~5s)
+npm run build
+npm run lint
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/assets/skill/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: mnemo
+description: Persistent memory for the current session. Use this skill whenever the user asks you to remember a fact, recall something they told you before, or when starting work where prior context might exist (conventions, decisions, file purposes, preferences).
+---
+
+# Mnemo — persistent memory
+
+You have access to a persistent memory layer via these MCP tools:
+
+- `mnemo_recall(query, k?, scope?)` — semantic search across stored memories
+- `mnemo_remember(content, scope?, tags?)` — capture a new memory
+- `mnemo_forget(id)` — delete a memory
+- `mnemo_list(scope?, limit?)` — browse recent memories
+- `mnemo_stats()` — show memory engine status
+
+## When to use each
+
+**`mnemo_recall`** — call this BEFORE answering anything where prior context might help:
+- "what's our convention for X?"
+- "how did we decide to handle Y?"
+- "why is Z structured this way?"
+- whenever you're starting a task in an unfamiliar area of the codebase
+
+Use natural-language queries. Don't try to construct keyword searches — the index is semantic.
+
+**`mnemo_remember`** — call this when:
+- The user explicitly asks ("remember this", "save this for later")
+- You make or affirm a non-obvious decision (capture it as `scope: "project"`)
+- The user states a personal preference that applies across projects (capture as `scope: "global"`)
+- You finish a task and notice something worth not having to rediscover
+
+Default scope is `"project"` (auto-tied to the current repo).
+
+**`mnemo_forget`** — only when the user explicitly asks to forget, OR when you discover a memory contradicts current reality and should be replaced.
+
+## Examples
+
+User: "we always use Vitest, never Jest"
+→ `mnemo_remember({ content: "we always use Vitest, never Jest", scope: "global" })`
+
+User: "what test framework do we use?"
+→ `mnemo_recall({ query: "test framework preference", k: 3 })` then synthesize the answer.
+
+User: "forget that pnpm thing"
+→ `mnemo_list({ limit: 50 })` to find it, then `mnemo_forget({ id: "..." })`.
+
+## Discipline
+
+- Don't capture things that are already in CLAUDE.md or other always-loaded files (Mnemo is for the long tail that those files can't carry)
+- Don't capture transient task state — capture lasting facts
+- Prefer global scope for cross-project preferences; default to project scope otherwise
+- When recall returns nothing useful, say so plainly — don't guess or hallucinate from low-similarity hits

package/bin/mnemo.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/index.js');

package/dist/commands/doctor.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerDoctor(program: Command): void;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmFrD"}

package/dist/commands/doctor.js

@@ -0,0 +1,88 @@
+import { Mnemo, paths, resolveDataDir } from '@mnemo-mcp/core';
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import chalk from 'chalk';
+export function registerDoctor(program) {
+    program
+        .command('doctor')
+        .description('Diagnose your Mnemo installation and Claude Code integration')
+        .option('--data-dir <path>', 'Memory data directory override')
+        .option('--scope <scope>', 'user (default) or project', 'user')
+        .action(async (opts) => {
+        const dataDir = resolveDataDir(opts.dataDir);
+        const p = paths(dataDir);
+        const claudeDir = process.env.MNEMO_CLAUDE_DIR ??
+            (opts.scope === 'project' ? join(process.cwd(), '.claude') : join(homedir(), '.claude'));
+        const settingsFile = join(claudeDir, 'settings.json');
+        const skillFile = join(claudeDir, 'skills', 'mnemo', 'SKILL.md');
+        const checks = [];
+        // ---- memory engine ----
+        checks.push({ name: 'data dir', ok: existsSync(dataDir), detail: dataDir });
+        checks.push({ name: 'database', ok: existsSync(p.dbFile), detail: p.dbFile });
+        checks.push({ name: 'vector index', ok: existsSync(p.indexFile), detail: p.indexFile });
+        const embedderType = (process.env.MNEMO_EMBEDDER === 'hash' ? 'hash' : 'onnx');
+        let openOk = false;
+        let total = 0;
+        try {
+            const m = await Mnemo.open({ dataDir, embedderType });
+            const stats = await m.stats();
+            total = stats.totalMemories;
+            await m.close();
+            openOk = true;
+        }
+        catch (err) {
+            checks.push({ name: 'mnemo opens', ok: false, detail: err.message });
+        }
+        if (openOk) {
+            checks.push({ name: 'mnemo opens', ok: true, detail: `${embedderType} embedder, ${total} memories` });
+        }
+        // ---- claude code integration ----
+        checks.push({ name: 'claude config dir', ok: existsSync(claudeDir), detail: claudeDir });
+        checks.push({ name: 'mnemo skill', ok: existsSync(skillFile), detail: skillFile });
+        let mcpOk = false;
+        let hooksOk = false;
+        if (existsSync(settingsFile)) {
+            try {
+                const cfg = JSON.parse(readFileSync(settingsFile, 'utf8'));
+                const mcp = cfg.mcpServers?.mnemo;
+                mcpOk = !!mcp;
+                const hooks = cfg.hooks;
+                hooksOk = !!hooks?.SessionStart || !!hooks?.PostToolUse || !!hooks?.PreToolUse;
+            }
+            catch { }
+        }
+        checks.push({ name: 'mcp registered', ok: mcpOk, detail: settingsFile });
+        checks.push({ name: 'hooks installed', ok: hooksOk, detail: 'optional — run `mnemo init --with-hooks` to enable' });
+        let allOk = true;
+        let warnings = 0;
+        for (const c of checks) {
+            let tag;
+            if (c.ok) {
+                tag = chalk.green('OK ');
+            }
+            else if (c.name === 'hooks installed') {
+                tag = chalk.yellow('WARN');
+                warnings++;
+            }
+            else {
+                tag = chalk.red('FAIL');
+                allOk = false;
+            }
+            console.log(`${tag} ${c.name.padEnd(22)} ${chalk.dim(c.detail)}`);
+        }
+        console.log('');
+        if (allOk && warnings === 0) {
+            console.log(chalk.green('healthy'));
+        }
+        else if (allOk) {
+            console.log(chalk.yellow(`healthy with ${warnings} warning${warnings === 1 ? '' : 's'}`));
+        }
+        else {
+            console.log(chalk.red('issues detected'));
+            console.log(chalk.dim('try `mnemo init` to install missing pieces'));
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/edit.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerEdit(program: Command): void;
+//# sourceMappingURL=edit.d.ts.map

package/dist/commands/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/commands/edit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkEnD"}

package/dist/commands/edit.js

@@ -0,0 +1,88 @@
+import { Mnemo } from '@mnemo-mcp/core';
+import { spawnSync } from 'node:child_process';
+import { mkdtempSync, readFileSync, writeFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import chalk from 'chalk';
+export function registerEdit(program) {
+    program
+        .command('edit <id>')
+        .description('Edit a memory in $EDITOR (or pass --content / --tags non-interactively)')
+        .option('-c, --content <text>', 'Replace content directly without opening editor')
+        .option('-t, --tags <list>', 'Replace tags (comma-separated)')
+        .option('--expires-in <duration>', 'Set TTL (e.g. 30d). Pass empty to clear.')
+        .option('--data-dir <path>', 'Data directory override')
+        .action(async (id, opts) => {
+        const embedderType = (process.env.MNEMO_EMBEDDER === 'hash' ? 'hash' : 'onnx');
+        const m = await Mnemo.open({ dataDir: opts.dataDir, embedderType });
+        try {
+            const list = await m.list({ includeExpired: true });
+            const match = list.find(r => r.id === id || r.id.startsWith(id));
+            if (!match) {
+                console.log(chalk.yellow(`no memory matches "${id}"`));
+                process.exitCode = 1;
+                return;
+            }
+            let nextContent;
+            let nextTags;
+            if (opts.content !== undefined) {
+                nextContent = opts.content;
+            }
+            else if (opts.tags === undefined && opts.expiresIn === undefined) {
+                // Interactive editor mode
+                nextContent = await editInTemp(match.content);
+                if (nextContent === null || nextContent.trim() === '') {
+                    console.log(chalk.dim('aborted (empty or unchanged)'));
+                    return;
+                }
+            }
+            if (opts.tags !== undefined) {
+                nextTags = opts.tags.split(',').map(t => t.trim()).filter(Boolean);
+            }
+            const fields = {};
+            if (nextContent !== undefined && nextContent !== match.content)
+                fields.content = nextContent;
+            if (nextTags !== undefined)
+                fields.tags = nextTags;
+            if (opts.expiresIn !== undefined) {
+                if (opts.expiresIn === '')
+                    fields.expiresAt = null;
+                else {
+                    const { expiresAtFromTtl } = await import('@mnemo-mcp/core');
+                    const exp = expiresAtFromTtl(opts.expiresIn);
+                    if (exp === null) {
+                        console.error(chalk.red('invalid --expires-in value:'), opts.expiresIn);
+                        process.exitCode = 2;
+                        return;
+                    }
+                    fields.expiresAt = exp;
+                }
+            }
+            if (Object.keys(fields).length === 0) {
+                console.log(chalk.dim('no changes'));
+                return;
+            }
+            const updated = await m.update(match.id, fields);
+            console.log(chalk.green('updated'), chalk.dim(updated.id.slice(0, 8)));
+        }
+        finally {
+            await m.close();
+        }
+    });
+}
+async function editInTemp(initial) {
+    const editor = process.env.EDITOR ?? process.env.VISUAL ?? 'vi';
+    const dir = mkdtempSync(join(tmpdir(), 'mnemo-edit-'));
+    const file = join(dir, 'memory.txt');
+    writeFileSync(file, initial);
+    try {
+        const result = spawnSync(editor, [file], { stdio: 'inherit' });
+        if (result.status !== 0)
+            return '';
+        return readFileSync(file, 'utf8');
+    }
+    finally {
+        rmSync(dir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=edit.js.map

package/dist/commands/edit.js.map

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

package/dist/commands/export.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerExport(program: Command): void;
+//# sourceMappingURL=export.d.ts.map

package/dist/commands/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiBrD"}

package/dist/commands/export.js

@@ -0,0 +1,23 @@
+import { writeFile } from 'node:fs/promises';
+import { Mnemo } from '@mnemo-mcp/core';
+import chalk from 'chalk';
+export function registerExport(program) {
+    program
+        .command('export')
+        .description('Export all memories to a JSON file')
+        .requiredOption('-o, --out <file>', 'Output file path')
+        .option('--data-dir <path>', 'Data directory override')
+        .action(async (opts) => {
+        const embedderType = (process.env.MNEMO_EMBEDDER === 'hash' ? 'hash' : 'onnx');
+        const m = await Mnemo.open({ dataDir: opts.dataDir, embedderType });
+        try {
+            const dump = await m.export();
+            await writeFile(opts.out, JSON.stringify(dump, null, 2));
+            console.log(chalk.green('exported'), dump.length, 'memories →', opts.out);
+        }
+        finally {
+            await m.close();
+        }
+    });
+}
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,oCAAoC,CAAC;SACjD,cAAc,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;SACtD,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,IAAU,EAAE,EAAE;QAC3B,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAoB,CAAC;QAClG,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5E,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/forget.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerForget(program: Command): void;
+//# sourceMappingURL=forget.d.ts.map

package/dist/commands/forget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.d.ts","sourceRoot":"","sources":["../../src/commands/forget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqBrD"}

package/dist/commands/forget.js

@@ -0,0 +1,26 @@
+import { Mnemo } from '@mnemo-mcp/core';
+import chalk from 'chalk';
+export function registerForget(program) {
+    program
+        .command('forget <id>')
+        .description('Delete a memory by id (full or 8-char prefix)')
+        .option('--data-dir <path>', 'Data directory override')
+        .action(async (id, opts) => {
+        const embedderType = (process.env.MNEMO_EMBEDDER === 'hash' ? 'hash' : 'onnx');
+        const m = await Mnemo.open({ dataDir: opts.dataDir, embedderType });
+        try {
+            const candidates = await m.list({});
+            const match = candidates.find(r => r.id === id || r.id.startsWith(id));
+            if (!match) {
+                console.log(chalk.yellow(`no memory matches "${id}"`));
+                return;
+            }
+            await m.forget(match.id);
+            console.log(chalk.green('forgotten'), chalk.dim(match.id.slice(0, 8)));
+        }
+        finally {
+            await m.close();
+        }
+    });
+}
+//# sourceMappingURL=forget.js.map

package/dist/commands/forget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forget.js","sourceRoot":"","sources":["../../src/commands/forget.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,+CAA+C,CAAC;SAC5D,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,EAAU,EAAE,IAAU,EAAE,EAAE;QACvC,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAoB,CAAC;QAClG,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACpC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;YACvE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC,CAAC;gBACvD,OAAO;YACT,CAAC;YACD,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/hook.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerHook(program: Command): void;
+//# sourceMappingURL=hook.d.ts.map

package/dist/commands/hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook.d.ts","sourceRoot":"","sources":["../../src/commands/hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiCnD"}

package/dist/commands/hook.js

@@ -0,0 +1,77 @@
+import { runSessionStart } from '../hooks/session-start.js';
+import { runPreTask } from '../hooks/pre-task.js';
+import { runPostEdit } from '../hooks/post-edit.js';
+import { runUserPromptSubmit } from '../hooks/user-prompt-submit.js';
+const HANDLERS = {
+    'session-start': runSessionStart,
+    'pre-task': runPreTask,
+    'post-edit': runPostEdit,
+    'user-prompt-submit': runUserPromptSubmit,
+};
+async function readStdin() {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        if (process.stdin.isTTY)
+            return resolve({});
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', chunk => { data += chunk; });
+        process.stdin.on('end', () => {
+            if (!data.trim())
+                return resolve({});
+            try {
+                resolve(JSON.parse(data));
+            }
+            catch {
+                resolve({});
+            }
+        });
+        process.stdin.on('error', reject);
+    });
+}
+export function registerHook(program) {
+    program
+        .command('hook <name>')
+        .description('Run a Claude Code hook handler. Reads payload JSON from stdin.')
+        .option('--print-json', 'Print Claude Code hook JSON envelope', false)
+        .action(async (name, opts) => {
+        const handler = HANDLERS[name];
+        if (!handler) {
+            process.stderr.write(`unknown hook "${name}". Known: ${Object.keys(HANDLERS).join(', ')}\n`);
+            process.exit(2);
+        }
+        const payload = await readStdin();
+        let text = '';
+        try {
+            text = await handler(payload);
+        }
+        catch (err) {
+            // Hooks fail open — never block Claude Code.
+            process.stderr.write(`mnemo hook ${name} error: ${err.message}\n`);
+            process.exit(0);
+        }
+        if (!text)
+            return;
+        if (opts.printJson) {
+            const envelope = {
+                hookSpecificOutput: {
+                    hookEventName: hookEventNameFor(name),
+                    additionalContext: text,
+                },
+            };
+            process.stdout.write(JSON.stringify(envelope));
+        }
+        else {
+            process.stdout.write(text);
+        }
+    });
+}
+function hookEventNameFor(name) {
+    switch (name) {
+        case 'session-start': return 'SessionStart';
+        case 'pre-task': return 'PreToolUse';
+        case 'post-edit': return 'PostToolUse';
+        case 'user-prompt-submit': return 'UserPromptSubmit';
+        default: return name;
+    }
+}
+//# sourceMappingURL=hook.js.map

package/dist/commands/hook.js.map

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

package/dist/commands/import.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerImport(program: Command): void;
+//# sourceMappingURL=import.d.ts.map

package/dist/commands/import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.d.ts","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiBrD"}

package/dist/commands/import.js

@@ -0,0 +1,23 @@
+import { readFile } from 'node:fs/promises';
+import { Mnemo } from '@mnemo-mcp/core';
+import chalk from 'chalk';
+export function registerImport(program) {
+    program
+        .command('import <file>')
+        .description('Import memories from a JSON file')
+        .option('--data-dir <path>', 'Data directory override')
+        .action(async (file, opts) => {
+        const embedderType = (process.env.MNEMO_EMBEDDER === 'hash' ? 'hash' : 'onnx');
+        const m = await Mnemo.open({ dataDir: opts.dataDir, embedderType });
+        try {
+            const raw = await readFile(file, 'utf8');
+            const records = JSON.parse(raw);
+            await m.import(records);
+            console.log(chalk.green('imported'), records.length, 'memories');
+        }
+        finally {
+            await m.close();
+        }
+    });
+}
+//# sourceMappingURL=import.js.map

package/dist/commands/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO;SACJ,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,kCAAkC,CAAC;SAC/C,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,IAAU,EAAE,EAAE;QACzC,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAoB,CAAC;QAClG,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACzC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACnE,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from 'commander';
+export declare function registerInit(program: Command): void;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBzC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiEnD"}