@mnemo-mcp/cli 1.0.0

package/dist/commands/init.js

@@ -0,0 +1,153 @@
+import { mkdir, copyFile, writeFile, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import chalk from 'chalk';
+const HERE = dirname(fileURLToPath(import.meta.url));
+const SKILL_SRC = join(HERE, '..', '..', 'assets', 'skill', 'SKILL.md');
+export function registerInit(program) {
+    program
+        .command('init')
+        .description('Install Mnemo into Claude Code (MCP server, skill, optional hooks)')
+        .option('--dry-run', 'Show what would change without writing', false)
+        .option('--with-hooks', 'Also install Claude Code hooks for auto-capture', false)
+        .option('--scope <scope>', 'user (default) or project', 'user')
+        .action(async (opts) => {
+        const claudeDir = process.env.MNEMO_CLAUDE_DIR ??
+            (opts.scope === 'project' ? join(process.cwd(), '.claude') : join(homedir(), '.claude'));
+        const settingsFile = join(claudeDir, 'settings.json');
+        const skillDir = join(claudeDir, 'skills', 'mnemo');
+        const skillFile = join(skillDir, 'SKILL.md');
+        const steps = [
+            {
+                label: `ensure ${claudeDir} exists`,
+                run: async () => { await mkdir(claudeDir, { recursive: true }); },
+            },
+            {
+                label: `install skill → ${skillFile}`,
+                run: async () => {
+                    await mkdir(skillDir, { recursive: true });
+                    await copyFile(SKILL_SRC, skillFile);
+                },
+            },
+            {
+                label: `register MCP server in ${settingsFile}`,
+                run: async () => { await mergeSettings(settingsFile, mcpPatch()); },
+            },
+        ];
+        if (opts.withHooks) {
+            steps.push({
+                label: `add hooks to ${settingsFile}`,
+                run: async () => { await mergeSettings(settingsFile, hooksPatch()); },
+            });
+        }
+        console.log(chalk.bold(`Mnemo init (scope: ${opts.scope}${opts.dryRun ? ', dry-run' : ''})`));
+        for (const s of steps) {
+            if (opts.dryRun) {
+                console.log(chalk.dim('  would'), s.label);
+            }
+            else {
+                try {
+                    await s.run();
+                    console.log(chalk.green('  ok '), s.label);
+                }
+                catch (err) {
+                    console.log(chalk.red('  fail'), s.label, chalk.dim(`(${err.message})`));
+                    process.exitCode = 1;
+                    return;
+                }
+            }
+        }
+        if (!opts.dryRun) {
+            console.log('');
+            console.log(chalk.bold('Done.'), 'Restart Claude Code, then try:');
+            console.log('  /mnemo  — see the skill load');
+            console.log('  ask Claude to recall something — it will use mnemo_recall');
+            console.log('');
+            console.log(chalk.dim('Run `mnemo doctor` to verify everything works.'));
+        }
+    });
+}
+function mcpPatch() {
+    return {
+        mcpServers: {
+            mnemo: {
+                command: 'npx',
+                args: ['-y', '@mnemo-mcp/server'],
+            },
+        },
+    };
+}
+function hooksPatch() {
+    return {
+        hooks: {
+            SessionStart: [
+                {
+                    hooks: [
+                        { type: 'command', command: 'npx -y @mnemo-mcp/cli hook session-start --print-json' },
+                    ],
+                },
+            ],
+            UserPromptSubmit: [
+                {
+                    hooks: [
+                        { type: 'command', command: 'npx -y @mnemo-mcp/cli hook user-prompt-submit --print-json' },
+                    ],
+                },
+            ],
+            PreToolUse: [
+                {
+                    matcher: 'Task',
+                    hooks: [
+                        { type: 'command', command: 'npx -y @mnemo-mcp/cli hook pre-task --print-json' },
+                    ],
+                },
+            ],
+            PostToolUse: [
+                {
+                    matcher: 'Edit|Write|MultiEdit',
+                    hooks: [
+                        { type: 'command', command: 'npx -y @mnemo-mcp/cli hook post-edit' },
+                    ],
+                },
+            ],
+        },
+    };
+}
+async function mergeSettings(file, patch) {
+    await mkdir(dirname(file), { recursive: true });
+    let existing = {};
+    if (existsSync(file)) {
+        try {
+            existing = JSON.parse(await readFile(file, 'utf8'));
+        }
+        catch {
+            // backup the broken file before overwriting
+            await writeFile(file + '.mnemo-backup', await readFile(file, 'utf8'));
+            existing = {};
+        }
+    }
+    const merged = deepMerge(existing, patch);
+    await writeFile(file, JSON.stringify(merged, null, 2));
+}
+function deepMerge(a, b) {
+    const out = { ...a };
+    for (const [k, v] of Object.entries(b)) {
+        const existing = out[k];
+        if (Array.isArray(existing) && Array.isArray(v)) {
+            out[k] = [...existing, ...v];
+        }
+        else if (isPlainObject(existing) && isPlainObject(v)) {
+            out[k] = deepMerge(existing, v);
+        }
+        else {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/list.d.ts

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

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

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

package/dist/commands/list.js

@@ -0,0 +1,31 @@
+import { Mnemo } from '@mnemo-mcp/core';
+import chalk from 'chalk';
+import { formatRecord } from '../output.js';
+export function registerList(program) {
+    program
+        .command('list')
+        .description('List memories (most recent first)')
+        .option('-s, --scope <scope>', 'project | global', 'global')
+        .option('-l, --limit <n>', 'Max records to show', '20')
+        .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 list = await m.list({
+                scope: opts.scope,
+                limit: Number(opts.limit),
+            });
+            if (list.length === 0) {
+                console.log(chalk.dim('no memories yet — try `mnemo remember "..."`'));
+                return;
+            }
+            for (const r of list)
+                console.log(formatRecord(r));
+        }
+        finally {
+            await m.close();
+        }
+    });
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5C,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,mCAAmC,CAAC;SAChD,MAAM,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,QAAQ,CAAC;SAC3D,MAAM,CAAC,iBAAiB,EAAE,qBAAqB,EAAE,IAAI,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,IAAI,CAAC;gBACxB,KAAK,EAAE,IAAI,CAAC,KAA6B;gBACzC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;aAC1B,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC,CAAC;gBACvE,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/prune.d.ts

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

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

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

package/dist/commands/prune.js

@@ -0,0 +1,82 @@
+import { Mnemo } from '@mnemo-mcp/core';
+import chalk from 'chalk';
+import { createInterface } from 'node:readline/promises';
+import { stdin, stdout } from 'node:process';
+export function registerPrune(program) {
+    program
+        .command('prune')
+        .description('Drop expired, duplicate, or low-value memories (interactive by default)')
+        .option('--dry-run', 'Show what would be pruned without deleting', false)
+        .option('-y, --yes', 'Skip confirmation', false)
+        .option('--no-expired', 'Do not drop expired memories')
+        .option('--duplicate-threshold <n>', 'Cosine similarity above which to dedupe (0 disables)', '0.97')
+        .option('--min-access-count <n>', 'Drop memories accessed fewer than this (0 = off)', '0')
+        .option('--stale-after-days <n>', 'Combined with --min-access-count: drop if older AND under-accessed', '30')
+        .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 {
+            // Always do a dry run first to show the user
+            const preview = await m.prune({
+                expired: opts.noExpired ? false : true,
+                duplicateThreshold: Number(opts.duplicateThreshold),
+                minAccessCount: Number(opts.minAccessCount),
+                staleAfterDays: Number(opts.staleAfterDays),
+                dryRun: true,
+            });
+            const totalCandidates = preview.expired.length + preview.duplicates.length + preview.stale.length;
+            if (totalCandidates === 0) {
+                console.log(chalk.green('nothing to prune'));
+                return;
+            }
+            if (preview.expired.length) {
+                console.log(chalk.bold(`expired: ${preview.expired.length}`));
+                preview.expired.slice(0, 5).forEach(r => console.log('  ', chalk.dim(r.id.slice(0, 8)), r.content.slice(0, 80)));
+                if (preview.expired.length > 5)
+                    console.log(chalk.dim(`  …and ${preview.expired.length - 5} more`));
+            }
+            if (preview.duplicates.length) {
+                console.log(chalk.bold(`duplicates: ${preview.duplicates.length}`));
+                preview.duplicates.slice(0, 5).forEach(d => console.log('  ', chalk.dim(d.dropped.id.slice(0, 8)), '→ kept', chalk.dim(d.kept.id.slice(0, 8)), '·', d.dropped.content.slice(0, 60)));
+                if (preview.duplicates.length > 5)
+                    console.log(chalk.dim(`  …and ${preview.duplicates.length - 5} more`));
+            }
+            if (preview.stale.length) {
+                console.log(chalk.bold(`stale (low-access + old): ${preview.stale.length}`));
+                preview.stale.slice(0, 5).forEach(r => console.log('  ', chalk.dim(r.id.slice(0, 8)), r.content.slice(0, 80)));
+                if (preview.stale.length > 5)
+                    console.log(chalk.dim(`  …and ${preview.stale.length - 5} more`));
+            }
+            if (opts.dryRun) {
+                console.log(chalk.dim(`(dry run — pass --yes or omit --dry-run to delete ${totalCandidates})`));
+                return;
+            }
+            if (!opts.yes) {
+                if (!stdin.isTTY) {
+                    console.log(chalk.yellow('non-interactive: pass --yes to confirm'));
+                    return;
+                }
+                const rl = createInterface({ input: stdin, output: stdout });
+                const ans = await rl.question(chalk.yellow(`Delete ${totalCandidates} memories? [y/N] `));
+                rl.close();
+                if (ans.trim().toLowerCase() !== 'y') {
+                    console.log(chalk.dim('cancelled'));
+                    return;
+                }
+            }
+            const result = await m.prune({
+                expired: opts.noExpired ? false : true,
+                duplicateThreshold: Number(opts.duplicateThreshold),
+                minAccessCount: Number(opts.minAccessCount),
+                staleAfterDays: Number(opts.staleAfterDays),
+                dryRun: false,
+            });
+            console.log(chalk.green('pruned'), result.totalDeleted, 'memories');
+        }
+        finally {
+            await m.close();
+        }
+    });
+}
+//# sourceMappingURL=prune.js.map

package/dist/commands/prune.js.map

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

package/dist/commands/recall.d.ts

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

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

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

package/dist/commands/recall.js

@@ -0,0 +1,50 @@
+import { Mnemo, projectHashOf, sinceFromAgo } from '@mnemo-mcp/core';
+import chalk from 'chalk';
+import { formatHit } from '../output.js';
+const SOURCES = ['manual', 'auto-edit', 'auto-task', 'imported'];
+export function registerRecall(program) {
+    program
+        .command('recall <query...>')
+        .description('Semantic search across memories')
+        .option('-k, --top <n>', 'Number of hits', '5')
+        .option('-s, --scope <scope>', 'project | global | all', 'all')
+        .option('--min-score <n>', 'Minimum composite score', '0')
+        .option('--tag <tags>', 'Comma-separated tags (memory must have ALL)')
+        .option('--source <sources>', `Comma-separated sources (${SOURCES.join('|')})`)
+        .option('--since <duration>', 'Only memories updated within (e.g. 7d, 24h, 30m)')
+        .option('--include-expired', 'Include expired memories', false)
+        .option('--data-dir <path>', 'Data directory override')
+        .action(async (queryParts, opts) => {
+        const query = queryParts.join(' ');
+        const embedderType = (process.env.MNEMO_EMBEDDER === 'hash' ? 'hash' : 'onnx');
+        const m = await Mnemo.open({ dataDir: opts.dataDir, embedderType });
+        try {
+            const projectHash = opts.scope === 'project' ? projectHashOf(process.cwd()) : undefined;
+            const tags = opts.tag ? opts.tag.split(',').map(t => t.trim()).filter(Boolean) : undefined;
+            const source = opts.source
+                ? opts.source.split(',').map(s => s.trim()).filter(Boolean)
+                : undefined;
+            const since = sinceFromAgo(opts.since);
+            const hits = await m.recall(query, {
+                k: Number(opts.top),
+                scope: opts.scope,
+                projectHash,
+                minScore: Number(opts.minScore),
+                tags,
+                source,
+                since,
+                includeExpired: opts.includeExpired,
+            });
+            if (hits.length === 0) {
+                console.log(chalk.yellow('no matching memories'));
+                return;
+            }
+            for (const h of hits)
+                console.log(formatHit(h));
+        }
+        finally {
+            await m.close();
+        }
+    });
+}
+//# sourceMappingURL=recall.js.map

package/dist/commands/recall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.js","sourceRoot":"","sources":["../../src/commands/recall.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,YAAY,EAAqB,MAAM,iBAAiB,CAAC;AACxF,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAazC,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,CAAU,CAAC;AAE1E,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,OAAO;SACJ,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,iCAAiC,CAAC;SAC9C,MAAM,CAAC,eAAe,EAAE,gBAAgB,EAAE,GAAG,CAAC;SAC9C,MAAM,CAAC,qBAAqB,EAAE,wBAAwB,EAAE,KAAK,CAAC;SAC9D,MAAM,CAAC,iBAAiB,EAAE,yBAAyB,EAAE,GAAG,CAAC;SACzD,MAAM,CAAC,cAAc,EAAE,6CAA6C,CAAC;SACrE,MAAM,CAAC,oBAAoB,EAAE,4BAA4B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;SAC9E,MAAM,CAAC,oBAAoB,EAAE,kDAAkD,CAAC;SAChF,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,EAAE,KAAK,CAAC;SAC9D,MAAM,CAAC,mBAAmB,EAAE,yBAAyB,CAAC;SACtD,MAAM,CAAC,KAAK,EAAE,UAAoB,EAAE,IAAU,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,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,WAAW,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACxF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3F,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM;gBACxB,CAAC,CAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAoB;gBAC/E,CAAC,CAAC,SAAS,CAAC;YACd,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE;gBACjC,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAqC;gBACjD,WAAW;gBACX,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAC/B,IAAI;gBACJ,MAAM;gBACN,KAAK;gBACL,cAAc,EAAE,IAAI,CAAC,cAAc;aACpC,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC;gBAClD,OAAO;YACT,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/remember.d.ts

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

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

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

package/dist/commands/remember.js

@@ -0,0 +1,42 @@
+import { Mnemo, projectHashOf, expiresAtFromTtl } from '@mnemo-mcp/core';
+import chalk from 'chalk';
+export function registerRemember(program) {
+    program
+        .command('remember <content...>')
+        .description('Capture a memory')
+        .option('-g, --global', 'Store as global (cross-project) memory', false)
+        .option('-t, --tags <list>', 'Comma-separated tags', '')
+        .option('--expires-in <duration>', 'Auto-forget after (e.g. 30d, 12h, 7d)')
+        .option('--dedup-threshold <n>', 'Cosine similarity above which to update existing instead of inserting (0 disables)', '0.95')
+        .option('--data-dir <path>', 'Data directory override')
+        .action(async (contentParts, opts) => {
+        const content = contentParts.join(' ');
+        const tags = opts.tags ? opts.tags.split(',').map(t => t.trim()).filter(Boolean) : [];
+        const embedderType = (process.env.MNEMO_EMBEDDER === 'hash' ? 'hash' : 'onnx');
+        const m = await Mnemo.open({ dataDir: opts.dataDir, embedderType });
+        try {
+            const expiresAt = expiresAtFromTtl(opts.expiresIn);
+            if (opts.expiresIn && expiresAt === null) {
+                console.error(chalk.red('invalid --expires-in value:'), opts.expiresIn, chalk.dim('(use 30d, 12h, 45m, 10s, 2w)'));
+                process.exitCode = 2;
+                return;
+            }
+            const rec = await m.capture({
+                content,
+                scope: opts.global ? 'global' : 'project',
+                projectHash: opts.global ? null : projectHashOf(process.cwd()),
+                tags,
+                source: 'manual',
+                expiresAt,
+                dedupThreshold: Number(opts.dedupThreshold),
+            });
+            const verb = m.lastCaptureDeduped ? chalk.cyan('updated') : chalk.green('saved');
+            const ttl = expiresAt ? chalk.dim(` (expires ${new Date(expiresAt).toISOString().slice(0, 10)})`) : '';
+            console.log(verb, chalk.dim(rec.id.slice(0, 8)) + ttl);
+        }
+        finally {
+            await m.close();
+        }
+    });
+}
+//# sourceMappingURL=remember.js.map

package/dist/commands/remember.js.map

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

package/dist/commands/stats.d.ts

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

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

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

package/dist/commands/stats.js

@@ -0,0 +1,19 @@
+import { Mnemo } from '@mnemo-mcp/core';
+import { formatStats } from '../output.js';
+export function registerStats(program) {
+    program
+        .command('stats')
+        .description('Show storage and index stats')
+        .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 {
+            console.log(formatStats(await m.stats()));
+        }
+        finally {
+            await m.close();
+        }
+    });
+}
+//# sourceMappingURL=stats.js.map

package/dist/commands/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../src/commands/stats.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAI3C,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,8BAA8B,CAAC;SAC3C,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,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC5C,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/hooks/capture-rules.d.ts

@@ -0,0 +1,3 @@
+export declare function shouldAutoCapture(filePath: string): boolean;
+export declare function snippet(content: string, maxLen?: number): string;
+//# sourceMappingURL=capture-rules.d.ts.map

package/dist/hooks/capture-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-rules.d.ts","sourceRoot":"","sources":["../../src/hooks/capture-rules.ts"],"names":[],"mappings":"AASA,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAM,GAAG,MAAM,CAI7D"}

package/dist/hooks/capture-rules.js

@@ -0,0 +1,18 @@
+const AUTO_CAPTURE_PATTERNS = [
+    /(^|\/)CLAUDE\.md$/i,
+    /(^|\/)AGENTS\.md$/i,
+    /(^|\/)GEMINI\.md$/i,
+    /\.adr\.md$/i,
+    /(^|\/)docs\/decisions\//i,
+    /(^|\/)docs\/adr\//i,
+];
+export function shouldAutoCapture(filePath) {
+    return AUTO_CAPTURE_PATTERNS.some(p => p.test(filePath));
+}
+export function snippet(content, maxLen = 500) {
+    const trimmed = content.trim();
+    if (trimmed.length <= maxLen)
+        return trimmed;
+    return trimmed.slice(0, maxLen) + '…';
+}
+//# sourceMappingURL=capture-rules.js.map

package/dist/hooks/capture-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-rules.js","sourceRoot":"","sources":["../../src/hooks/capture-rules.ts"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,GAAa;IACtC,oBAAoB;IACpB,oBAAoB;IACpB,oBAAoB;IACpB,aAAa;IACb,0BAA0B;IAC1B,oBAAoB;CACrB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,MAAM,GAAG,GAAG;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,OAAO,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,OAAO,CAAC;IAC7C,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,GAAG,CAAC;AACxC,CAAC"}

package/dist/hooks/post-edit.d.ts

@@ -0,0 +1,18 @@
+type Payload = {
+    tool_name?: string;
+    tool_input?: {
+        file_path?: string;
+        new_string?: string;
+        content?: string;
+        old_string?: string;
+    };
+    cwd?: string;
+};
+/**
+ * Auto-capture rule: only the *new* content of a matching file edit gets stored.
+ * For Edit tool calls we use `new_string` (the diff insertion), not the whole file.
+ * For Write tool calls we use the full content but truncated.
+ */
+export declare function runPostEdit(payload: Payload): Promise<string>;
+export {};
+//# sourceMappingURL=post-edit.d.ts.map

package/dist/hooks/post-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-edit.d.ts","sourceRoot":"","sources":["../../src/hooks/post-edit.ts"],"names":[],"mappings":"AAGA,KAAK,OAAO,GAAG;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE;QACX,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA4BnE"}

package/dist/hooks/post-edit.js

@@ -0,0 +1,38 @@
+import { Mnemo, projectHashOf } from '@mnemo-mcp/core';
+import { shouldAutoCapture, snippet } from './capture-rules.js';
+/**
+ * Auto-capture rule: only the *new* content of a matching file edit gets stored.
+ * For Edit tool calls we use `new_string` (the diff insertion), not the whole file.
+ * For Write tool calls we use the full content but truncated.
+ */
+export async function runPostEdit(payload) {
+    const filePath = payload.tool_input?.file_path;
+    if (!filePath || !shouldAutoCapture(filePath))
+        return '';
+    const isEdit = payload.tool_name === 'Edit' || payload.tool_name === 'MultiEdit';
+    const newPart = payload.tool_input?.new_string;
+    const fullContent = payload.tool_input?.content;
+    const captured = isEdit && newPart ? newPart : fullContent ?? newPart ?? '';
+    if (!captured.trim())
+        return '';
+    const cwd = payload.cwd ?? process.cwd();
+    const projectHash = projectHashOf(cwd);
+    const embedderType = (process.env.MNEMO_EMBEDDER === 'hash' ? 'hash' : 'onnx');
+    const m = await Mnemo.open({ embedderType });
+    try {
+        const rec = await m.capture({
+            content: `${filePath}: ${snippet(captured)}`,
+            scope: 'project',
+            projectHash,
+            tags: ['auto-edit'],
+            source: 'auto-edit',
+            dedupThreshold: 0.92, // generous threshold for auto-captured snippets
+        });
+        const verb = m.lastCaptureDeduped ? 'updated' : 'captured';
+        return `mnemo: ${verb} ${rec.id.slice(0, 8)} from ${filePath}`;
+    }
+    finally {
+        await m.close();
+    }
+}
+//# sourceMappingURL=post-edit.js.map

package/dist/hooks/post-edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-edit.js","sourceRoot":"","sources":["../../src/hooks/post-edit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAahE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAgB;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC;IAC/C,IAAI,CAAC,QAAQ,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,KAAK,MAAM,IAAI,OAAO,CAAC,SAAS,KAAK,WAAW,CAAC;IACjF,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC;IAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,IAAI,OAAO,IAAI,EAAE,CAAC;IAC5E,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAoB,CAAC;IAClG,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC;YAC1B,OAAO,EAAE,GAAG,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,EAAE;YAC5C,KAAK,EAAE,SAAS;YAChB,WAAW;YACX,IAAI,EAAE,CAAC,WAAW,CAAC;YACnB,MAAM,EAAE,WAAW;YACnB,cAAc,EAAE,IAAI,EAAE,gDAAgD;SACvE,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QAC3D,OAAO,UAAU,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC;IACjE,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/hooks/pre-task.d.ts

@@ -0,0 +1,10 @@
+type Payload = {
+    tool_input?: {
+        description?: string;
+        prompt?: string;
+    };
+    cwd?: string;
+};
+export declare function runPreTask(payload: Payload): Promise<string>;
+export {};
+//# sourceMappingURL=pre-task.d.ts.map

package/dist/hooks/pre-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-task.d.ts","sourceRoot":"","sources":["../../src/hooks/pre-task.ts"],"names":[],"mappings":"AAEA,KAAK,OAAO,GAAG;IACb,UAAU,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBlE"}

package/dist/hooks/pre-task.js

@@ -0,0 +1,22 @@
+import { Mnemo, projectHashOf } from '@mnemo-mcp/core';
+export async function runPreTask(payload) {
+    const description = payload.tool_input?.description ?? payload.tool_input?.prompt ?? '';
+    if (!description.trim())
+        return '';
+    const cwd = payload.cwd ?? process.cwd();
+    const projectHash = projectHashOf(cwd);
+    const embedderType = (process.env.MNEMO_EMBEDDER === 'hash' ? 'hash' : 'onnx');
+    const m = await Mnemo.open({ embedderType });
+    try {
+        const hits = await m.recall(description, { k: 3, scope: 'all', minScore: 0.3 });
+        const projectHits = hits.filter(h => h.record.scope === 'global' || h.record.projectHash === projectHash);
+        if (projectHits.length === 0)
+            return '';
+        const lines = ['## Relevant memories', ...projectHits.map(h => `- ${h.record.content}`)];
+        return lines.join('\n');
+    }
+    finally {
+        await m.close();
+    }
+}
+//# sourceMappingURL=pre-task.js.map

package/dist/hooks/pre-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-task.js","sourceRoot":"","sources":["../../src/hooks/pre-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAOvD,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAgB;IAC/C,MAAM,WAAW,GACf,OAAO,CAAC,UAAU,EAAE,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,CAAC;IACtE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAoB,CAAC;IAClG,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QAChF,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;QAC1G,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,CAAC,sBAAsB,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACzF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/hooks/session-start.d.ts

@@ -0,0 +1,8 @@
+type Payload = {
+    session_id?: string;
+    source?: string;
+    cwd?: string;
+};
+export declare function runSessionStart(payload: Payload): Promise<string>;
+export {};
+//# sourceMappingURL=session-start.d.ts.map

package/dist/hooks/session-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":"AAEA,KAAK,OAAO,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtE,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBvE"}