@membank/cli 0.2.0 → 0.4.0

package/README.md

@@ -33,7 +33,7 @@ Options:
 --json             Machine-readable output
 ```
 
-Supported harnesses: `claude-code`, `copilot`, `codex`, `opencode`
+Supported harnesses: `claude-code`, `copilot`, `codex`, `opencode` (see `membank setup` for harness-specific setup instructions)
 
 ## Commands
 
@@ -125,6 +125,16 @@ Output session context formatted for a harness. Called automatically by session
 membank inject --harness claude-code --scope <project-scope>
 ```
 
+### `membank dashboard`
+
+Start the web dashboard for browsing and managing memories.
+
+```bash
+membank dashboard
+```
+
+Opens http://localhost:3847 by default. Features: full-text search, filtering by type/scope/pin status, edit memory metadata, view dedup reviews, and storage statistics.
+
 ## Global flags
 
 ```
@@ -143,11 +153,9 @@ Starts the stdio MCP server. This is what harnesses connect to — `setup` write
 
 ## Session hooks
 
-`setup` installs two hooks:
-
-**Session start** — calls `membank inject` to prepend pinned memories into the LLM context at the beginning of every session.
+`setup` installs a hook for Claude Code that injects memories at the start of each session:
 
-**Session stop (Claude Code only)** — prompts the LLM to review the session and call `save_memory` for any notable corrections, preferences, or decisions.
+**SessionStart** — calls `membank inject` to prepend pinned memories into the LLM context at the beginning of every session.
 
 ## Requirements
 

package/dist/index.mjs

@@ -2,11 +2,12 @@
 import { DatabaseManager, EmbeddingService, MEMORY_TYPE_VALUES, MemoryRepository, QueryEngine, SessionContextBuilder, resolveScope } from "@membank/core";
 import { startServer } from "@membank/mcp";
 import { Command } from "commander";
+import { startDashboard } from "@membank/dashboard";
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
-import { homedir, tmpdir } from "node:os";
 import * as readline from "node:readline";
 import { createInterface } from "node:readline";
+import { homedir, tmpdir } from "node:os";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { EventEmitter } from "node:events";
@@ -30,6 +31,11 @@ async function addCommand(content, options, formatter, db, embeddingService) {
 	}
 }
 //#endregion
+//#region src/commands/dashboard.ts
+async function dashboardCommand(opts) {
+	await startDashboard({ port: opts.port !== void 0 ? parseInt(opts.port, 10) : void 0 });
+}
+//#endregion
 //#region src/commands/delete.ts
 async function deleteCommand(id, db, formatter, prompt) {
 	if (db.db.prepare(`SELECT id FROM memories WHERE id = ?`).get(id) === void 0) {
@@ -128,7 +134,7 @@ async function importCommand(filePath, db, formatter, prompt) {
 }
 //#endregion
 //#region src/commands/inject.ts
-const MEMORY_GUIDANCE = "[Memory Guidance]: query_memory before answering on topics where past preferences, corrections, or decisions may apply; save_memory when user corrects you, states a preference, makes a decision, or shares something worth retaining across sessions; update_memory to refine an existing memory (query first to find it) or to set pinned=true/false; delete_memory when a memory is wrong or no longer relevant; pin high-value memories that should always appear at session start";
+const MEMORY_GUIDANCE = "[Memory Guidance]: Persistent memory is available via query_memory, save_memory, update_memory, delete_memory. Skipping save_memory when the user gives a correction or preference means they have to repeat themselves next session — that is the failure mode to avoid. Skipping query_memory on topics that touch prior decisions means contradicting yourself. Default to saving (type: correction|preference|decision|learning|fact) when in doubt; rely on dedup to handle redundancy. Pin anything that should appear at every session start.";
 function formatContext(ctx) {
 	const lines = [];
 	const statParts = Object.entries(ctx.stats).filter(([, count]) => count > 0).map(([type, count]) => `${count} ${type}${count !== 1 ? "s" : ""}`);
@@ -140,20 +146,10 @@ function formatContext(ctx) {
 	lines.push(MEMORY_GUIDANCE);
 	return lines.join("\n");
 }
-async function injectCommand(opts) {
-	const projectScope = opts.scope ?? await resolveScope();
-	const db = DatabaseManager.open();
-	let text;
-	try {
-		text = formatContext(new SessionContextBuilder(db).getSessionContext(projectScope));
-	} finally {
-		db.close();
-	}
-	if (!text) process.exit(0);
-	const harness = opts.harness;
+function outputAdditionalContext(text, harness, eventName) {
 	if (harness === "claude-code") {
 		process.stdout.write(JSON.stringify({ hookSpecificOutput: {
-			hookEventName: "SessionStart",
+			hookEventName: eventName,
 			additionalContext: text
 		} }));
 		return;
@@ -164,6 +160,23 @@ async function injectCommand(opts) {
 	}
 	process.stdout.write(`${text}\n`);
 }
+async function handleSessionStart(opts) {
+	const projectScope = opts.scope ?? await resolveScope();
+	const db = DatabaseManager.open();
+	let text;
+	try {
+		text = formatContext(new SessionContextBuilder(db).getSessionContext(projectScope));
+	} finally {
+		db.close();
+	}
+	if (!text) process.exit(0);
+	const harness = opts.harness;
+	outputAdditionalContext(text, harness, "SessionStart");
+}
+async function injectCommand(opts) {
+	if (opts.event !== void 0 && opts.event !== "session-start") process.exit(0);
+	await handleSessionStart(opts);
+}
 //#endregion
 //#region src/commands/list.ts
 async function listCommand(options, formatter) {
@@ -225,303 +238,6 @@ async function statsCommand(formatter) {
 	}
 }
 //#endregion
-//#region src/setup/injection-hook-writer.ts
-const defaultPathResolver$1 = { home: () => {
-	const h = process.env.HOME ?? process.env.USERPROFILE;
-	if (!h) throw new Error("Cannot determine home directory");
-	return h;
-} };
-function readJson$1(path) {
-	try {
-		return JSON.parse(readFileSync(path, "utf8"));
-	} catch {
-		return {};
-	}
-}
-function writeJsonAtomic$1(path, data) {
-	mkdirSync(dirname(path), { recursive: true });
-	const tmp = join(mkdtempSync(join(tmpdir(), "membank-hook-")), "cfg.json");
-	writeFileSync(tmp, JSON.stringify(data, null, 2));
-	renameSync(tmp, path);
-}
-function getHooksArray(group) {
-	if (typeof group !== "object" || group === null) return [];
-	const h = group.hooks;
-	return Array.isArray(h) ? h : [];
-}
-function findMembankHookCommand(hooks, pattern) {
-	for (const h of hooks) {
-		if (typeof h !== "object" || h === null) continue;
-		if ("command" in h && typeof h.command === "string" && h.command.includes(pattern)) return h.command;
-		if ("bash" in h && typeof h.bash === "string" && h.bash.includes(pattern)) return h.bash;
-	}
-	return "";
-}
-function containsMembankInject(hooks) {
-	return findMembankHookCommand(hooks, "@membank/cli inject") !== "";
-}
-function extractInjectCommand(hooks) {
-	return findMembankHookCommand(hooks, "@membank/cli inject");
-}
-const writers$1 = {
-	"claude-code": {
-		replacement: "npx @membank/cli inject --harness claude-code",
-		write(resolver, overwrite = false) {
-			const cfgPath = join(resolver.home(), ".claude", "settings.json");
-			const cfg = readJson$1(cfgPath);
-			const hooks = cfg.hooks;
-			const existingGroups = Array.isArray(hooks?.SessionStart) ? hooks.SessionStart : [];
-			const innerHooks = existingGroups.flatMap(getHooksArray);
-			if (!overwrite && containsMembankInject(innerHooks)) return {
-				status: "already-configured",
-				existing: extractInjectCommand(innerHooks),
-				replacement: this.replacement
-			};
-			const filteredGroups = overwrite ? existingGroups.filter((g) => !containsMembankInject(getHooksArray(g))) : existingGroups;
-			writeJsonAtomic$1(cfgPath, {
-				...cfg,
-				hooks: {
-					...hooks ?? {},
-					SessionStart: [...filteredGroups, {
-						matcher: "",
-						hooks: [{
-							type: "command",
-							command: this.replacement
-						}]
-					}]
-				}
-			});
-			return { status: "written" };
-		}
-	},
-	"copilot-cli": {
-		replacement: "npx @membank/cli inject --harness copilot-cli",
-		write(resolver, overwrite = false) {
-			const cfgPath = join(resolver.home(), ".copilot", "settings.json");
-			const cfg = readJson$1(cfgPath);
-			const hooks = cfg.hooks;
-			const existingHooks = Array.isArray(hooks?.sessionStart) ? hooks.sessionStart : [];
-			if (!overwrite && containsMembankInject(existingHooks)) return {
-				status: "already-configured",
-				existing: extractInjectCommand(existingHooks),
-				replacement: this.replacement
-			};
-			const filteredHooks = overwrite ? existingHooks.filter((h) => !containsMembankInject([h])) : existingHooks;
-			writeJsonAtomic$1(cfgPath, {
-				version: cfg.version ?? 1,
-				...cfg,
-				hooks: {
-					...hooks ?? {},
-					sessionStart: [...filteredHooks, {
-						type: "command",
-						bash: this.replacement,
-						timeoutSec: 30
-					}]
-				}
-			});
-			return { status: "written" };
-		}
-	},
-	codex: {
-		replacement: "npx @membank/cli inject --harness codex",
-		write(resolver, overwrite = false) {
-			const cfgPath = join(resolver.home(), ".codex", "hooks.json");
-			const cfg = readJson$1(cfgPath);
-			const hooks = cfg.hooks;
-			const existingGroups = Array.isArray(hooks?.SessionStart) ? hooks.SessionStart : [];
-			const innerHooks = existingGroups.flatMap(getHooksArray);
-			if (!overwrite && containsMembankInject(innerHooks)) return {
-				status: "already-configured",
-				existing: extractInjectCommand(innerHooks),
-				replacement: this.replacement
-			};
-			const filteredGroups = overwrite ? existingGroups.filter((g) => !containsMembankInject(getHooksArray(g))) : existingGroups;
-			writeJsonAtomic$1(cfgPath, {
-				...cfg,
-				hooks: {
-					...hooks ?? {},
-					SessionStart: [...filteredGroups, {
-						matcher: "",
-						hooks: [{
-							type: "command",
-							command: this.replacement,
-							timeout: 30
-						}]
-					}]
-				}
-			});
-			return { status: "written" };
-		}
-	},
-	opencode: {
-		replacement: "npx @membank/cli inject",
-		write(resolver, overwrite = false) {
-			const pluginPath = join(resolver.home(), ".config", "opencode", "plugins", "membank.js");
-			if (!overwrite && existsSync(pluginPath)) {
-				const existing = readFileSync(pluginPath, "utf8");
-				if (existing.includes("@membank/cli inject")) return {
-					status: "already-configured",
-					existing: existing.trim(),
-					replacement: newOpencodePlugin()
-				};
-			}
-			mkdirSync(dirname(pluginPath), { recursive: true });
-			writeFileSync(pluginPath, `${newOpencodePlugin()}\n`, "utf8");
-			return { status: "written" };
-		}
-	}
-};
-function newOpencodePlugin(includeIdle = false) {
-	return [
-		"export default {",
-		"  hooks: {",
-		"    \"session.start\": async ({ $ }) => {",
-		"      return await $`npx @membank/cli inject`.text();",
-		"    },",
-		...includeIdle ? [
-			"    \"session.idle\": async ({ $ }) => {",
-			"      return await $`npx @membank/cli stop-hook --harness opencode`.text();",
-			"    },"
-		] : [],
-		"  },",
-		"};"
-	].join("\n");
-}
-const STOP_HOOK_PROMPT = "Review this session and consider whether any user preferences, corrections, decisions, or learnings are worth saving for future sessions. If so, use the save_memory MCP tool to store them. Be selective — only save what would genuinely help in a future conversation. Skip ephemeral task details.";
-function containsMembankStopHookCmd(hooks) {
-	return findMembankHookCommand(hooks, "@membank/cli stop-hook") !== "";
-}
-function extractStopHookCmd(hooks) {
-	return findMembankHookCommand(hooks, "@membank/cli stop-hook");
-}
-function containsMembankStopPrompt(stopGroups) {
-	return stopGroups.some((g) => getHooksArray(g).some((h) => typeof h === "object" && h !== null && "type" in h && h.type === "prompt" && "prompt" in h && typeof h.prompt === "string" && h.prompt.includes("save_memory")));
-}
-function extractStopPrompt(stopGroups) {
-	for (const g of stopGroups) for (const h of getHooksArray(g)) if (typeof h === "object" && h !== null && "type" in h && h.type === "prompt" && "prompt" in h && typeof h.prompt === "string" && h.prompt.includes("save_memory")) return h.prompt;
-	return "";
-}
-const stopHookWriters = {
-	"claude-code": { write(resolver, overwrite = false) {
-		const cfgPath = join(resolver.home(), ".claude", "settings.json");
-		const cfg = readJson$1(cfgPath);
-		const hooks = cfg.hooks;
-		const existingStop = Array.isArray(hooks?.Stop) ? hooks.Stop : [];
-		if (!overwrite && containsMembankStopPrompt(existingStop)) return {
-			status: "already-configured",
-			existing: extractStopPrompt(existingStop),
-			replacement: STOP_HOOK_PROMPT
-		};
-		const filteredStop = overwrite ? existingStop.filter((g) => !containsMembankStopPrompt([g])) : existingStop;
-		writeJsonAtomic$1(cfgPath, {
-			...cfg,
-			hooks: {
-				...hooks ?? {},
-				Stop: [...filteredStop, { hooks: [{
-					type: "prompt",
-					prompt: STOP_HOOK_PROMPT
-				}] }]
-			}
-		});
-		return { status: "written" };
-	} },
-	"copilot-cli": { write(resolver, overwrite = false) {
-		const cfgPath = join(resolver.home(), ".copilot", "settings.json");
-		const cfg = readJson$1(cfgPath);
-		const replacement = "npx @membank/cli stop-hook --harness copilot-cli";
-		const hooks = cfg.hooks;
-		const existingStop = Array.isArray(hooks?.stop) ? hooks.stop : [];
-		if (!overwrite && containsMembankStopHookCmd(existingStop)) return {
-			status: "already-configured",
-			existing: extractStopHookCmd(existingStop),
-			replacement
-		};
-		const filteredStop = overwrite ? existingStop.filter((h) => !containsMembankStopHookCmd([h])) : existingStop;
-		writeJsonAtomic$1(cfgPath, {
-			version: cfg.version ?? 1,
-			...cfg,
-			hooks: {
-				...hooks ?? {},
-				stop: [...filteredStop, {
-					type: "command",
-					bash: replacement,
-					timeoutSec: 30
-				}]
-			}
-		});
-		return { status: "written" };
-	} },
-	codex: { write(resolver, overwrite = false) {
-		const cfgPath = join(resolver.home(), ".codex", "hooks.json");
-		const cfg = readJson$1(cfgPath);
-		const replacement = "npx @membank/cli stop-hook --harness codex";
-		const hooks = cfg.hooks;
-		const existingGroups = Array.isArray(hooks?.Stop) ? hooks.Stop : [];
-		const innerHooks = existingGroups.flatMap(getHooksArray);
-		if (!overwrite && containsMembankStopHookCmd(innerHooks)) return {
-			status: "already-configured",
-			existing: extractStopHookCmd(innerHooks),
-			replacement
-		};
-		const filteredGroups = overwrite ? existingGroups.filter((g) => !containsMembankStopHookCmd(getHooksArray(g))) : existingGroups;
-		writeJsonAtomic$1(cfgPath, {
-			...cfg,
-			hooks: {
-				...hooks ?? {},
-				Stop: [...filteredGroups, {
-					matcher: "",
-					hooks: [{
-						type: "command",
-						command: replacement,
-						timeout: 30
-					}]
-				}]
-			}
-		});
-		return { status: "written" };
-	} },
-	opencode: { write(resolver, overwrite = false) {
-		const pluginPath = join(resolver.home(), ".config", "opencode", "plugins", "membank.js");
-		if (!overwrite && existsSync(pluginPath)) {
-			const existing = readFileSync(pluginPath, "utf8");
-			if (existing.includes("@membank/cli stop-hook")) return {
-				status: "already-configured",
-				existing: existing.trim(),
-				replacement: newOpencodePlugin(true)
-			};
-		}
-		mkdirSync(dirname(pluginPath), { recursive: true });
-		writeFileSync(pluginPath, `${newOpencodePlugin(true)}\n`, "utf8");
-		return { status: "written" };
-	} }
-};
-var InjectionHookWriter = class {
-	#resolver;
-	constructor(resolver = defaultPathResolver$1) {
-		this.#resolver = resolver;
-	}
-	write(harness, overwrite) {
-		const writer = writers$1[harness];
-		if (!writer) return { status: "not-supported" };
-		return writer.write(this.#resolver, overwrite);
-	}
-	writeStopHook(harness, overwrite) {
-		const writer = stopHookWriters[harness];
-		if (!writer) return { status: "not-supported" };
-		return writer.write(this.#resolver, overwrite);
-	}
-};
-//#endregion
-//#region src/commands/stop-hook.ts
-function stopHookCommand(opts) {
-	const { harness } = opts;
-	if (harness === "copilot-cli" || harness === "codex") {
-		process.stdout.write(JSON.stringify({ systemMessage: STOP_HOOK_PROMPT }));
-		return;
-	}
-	process.stdout.write(`${STOP_HOOK_PROMPT}\n`);
-}
-//#endregion
 //#region src/commands/unpin.ts
 function unpinCommand(id, formatter, db) {
 	const ownDb = db === void 0;
@@ -668,7 +384,7 @@ async function execFileNoThrow(cmd, args) {
 }
 //#endregion
 //#region src/setup/harness-config-writer.ts
-const defaultPathResolver = {
+const defaultPathResolver$1 = {
 	home: () => {
 		const h = process.env.HOME ?? process.env.USERPROFILE;
 		if (!h) throw new Error("Cannot determine home directory");
@@ -676,14 +392,14 @@ const defaultPathResolver = {
 	},
 	cwd: () => process.cwd()
 };
-function readJson(path) {
+function readJson$1(path) {
 	try {
 		return JSON.parse(readFileSync(path, "utf8"));
 	} catch {
 		return {};
 	}
 }
-function writeJsonAtomic(path, data) {
+function writeJsonAtomic$1(path, data) {
 	mkdirSync(dirname(path), { recursive: true });
 	const tmp = join(mkdtempSync(join(tmpdir(), "membank-")), "cfg.json");
 	writeFileSync(tmp, JSON.stringify(data, null, 2));
@@ -700,9 +416,9 @@ const MEMBANK_NPX_ARGS = [
 	"@membank/cli@latest",
 	"--mcp"
 ];
-const writers = {
+const writers$1 = {
 	"claude-code": { async write(resolver, run, { overwrite = false } = {}) {
-		const configured = hasKey(readJson(join(resolver.home(), ".claude.json")).mcpServers, "membank");
+		const configured = hasKey(readJson$1(join(resolver.home(), ".claude.json")).mcpServers, "membank");
 		if (configured && !overwrite) return { status: "already-configured" };
 		if (configured) {
 			const remove = await run("claude", [
@@ -730,9 +446,9 @@ const writers = {
 	} },
 	copilot: { async write(resolver, _run, { overwrite = false } = {}) {
 		const cfgPath = join(resolver.home(), ".copilot", "mcp-config.json");
-		const cfg = readJson(cfgPath);
+		const cfg = readJson$1(cfgPath);
 		if (hasKey(cfg.mcpServers, "membank") && !overwrite) return { status: "already-configured" };
-		writeJsonAtomic(cfgPath, {
+		writeJsonAtomic$1(cfgPath, {
 			...cfg,
 			mcpServers: {
 				...cfg.mcpServers,
@@ -771,9 +487,9 @@ const writers = {
 	} },
 	opencode: { async write(resolver, _run, { overwrite = false } = {}) {
 		const cfgPath = join(resolver.home(), ".config", "opencode", "opencode.json");
-		const cfg = readJson(cfgPath);
+		const cfg = readJson$1(cfgPath);
 		if (hasKey(cfg.mcp, "membank") && !overwrite) return { status: "already-configured" };
-		writeJsonAtomic(cfgPath, {
+		writeJsonAtomic$1(cfgPath, {
 			...cfg,
 			mcp: {
 				...cfg.mcp,
@@ -790,21 +506,232 @@ const writers = {
 		return { status: "written" };
 	} }
 };
-const SUPPORTED_HARNESSES = Object.keys(writers);
+const SUPPORTED_HARNESSES = Object.keys(writers$1);
 var HarnessConfigWriter = class {
 	#resolver;
 	#run;
-	constructor(resolver = defaultPathResolver, run = execFileNoThrow) {
+	constructor(resolver = defaultPathResolver$1, run = execFileNoThrow) {
 		this.#resolver = resolver;
 		this.#run = run;
 	}
 	async write(harness, { overwrite = false } = {}) {
-		const writer = writers[harness];
+		const writer = writers$1[harness];
 		if (!writer) throw new Error(`Unknown harness: ${harness}`);
 		return writer.write(this.#resolver, this.#run, { overwrite });
 	}
 };
 //#endregion
+//#region src/setup/injection-hook-writer.ts
+const defaultPathResolver = { home: () => {
+	const h = process.env.HOME ?? process.env.USERPROFILE;
+	if (!h) throw new Error("Cannot determine home directory");
+	return h;
+} };
+function readJson(path) {
+	try {
+		return JSON.parse(readFileSync(path, "utf8"));
+	} catch {
+		return {};
+	}
+}
+function writeJsonAtomic(path, data) {
+	mkdirSync(dirname(path), { recursive: true });
+	const tmp = join(mkdtempSync(join(tmpdir(), "membank-hook-")), "cfg.json");
+	writeFileSync(tmp, JSON.stringify(data, null, 2));
+	renameSync(tmp, path);
+}
+function getHooksArray(group) {
+	if (typeof group !== "object" || group === null) return [];
+	const h = group.hooks;
+	return Array.isArray(h) ? h : [];
+}
+function findMembankHookCommand(hooks, pattern) {
+	for (const h of hooks) {
+		if (typeof h !== "object" || h === null) continue;
+		if ("command" in h && typeof h.command === "string" && h.command.includes(pattern)) return h.command;
+		if ("bash" in h && typeof h.bash === "string" && h.bash.includes(pattern)) return h.bash;
+	}
+	return "";
+}
+function containsMembankInject(hooks) {
+	return findMembankHookCommand(hooks, "@membank/cli") !== "";
+}
+function extractInjectCommand(hooks) {
+	return findMembankHookCommand(hooks, "@membank/cli");
+}
+function filterOutMembank(groups) {
+	return groups.filter((g) => !containsMembankInject(getHooksArray(g)));
+}
+function filterOutMembankFlat(hooks) {
+	return hooks.filter((h) => !containsMembankInject([h]));
+}
+function pruneNestedEvent(hooks, eventKey) {
+	const existing = hooks[eventKey];
+	if (!Array.isArray(existing)) return;
+	const cleaned = filterOutMembank(existing);
+	if (cleaned.length === 0) delete hooks[eventKey];
+	else hooks[eventKey] = cleaned;
+}
+function pruneFlatEvent(hooks, eventKey) {
+	const existing = hooks[eventKey];
+	if (!Array.isArray(existing)) return;
+	const cleaned = filterOutMembankFlat(existing);
+	if (cleaned.length === 0) delete hooks[eventKey];
+	else hooks[eventKey] = cleaned;
+}
+const writers = {
+	"claude-code": {
+		inspect(resolver) {
+			const hooks = readJson(join(resolver.home(), ".claude", "settings.json")).hooks ?? {};
+			return {
+				status: "ready",
+				hooks: [{
+					event: "SessionStart",
+					command: "npx @membank/cli@latest inject --harness claude-code",
+					existingCommand: extractInjectCommand((Array.isArray(hooks.SessionStart) ? hooks.SessionStart : []).flatMap(getHooksArray)) || null
+				}]
+			};
+		},
+		write(resolver, events) {
+			const cfgPath = join(resolver.home(), ".claude", "settings.json");
+			const cfg = readJson(cfgPath);
+			const hooks = cfg.hooks ?? {};
+			const newHooks = { ...hooks };
+			pruneNestedEvent(newHooks, "UserPromptSubmit");
+			pruneNestedEvent(newHooks, "PostToolUseFailure");
+			if (events.includes("SessionStart")) newHooks.SessionStart = [...filterOutMembank(Array.isArray(hooks.SessionStart) ? hooks.SessionStart : []), {
+				matcher: "",
+				hooks: [{
+					type: "command",
+					command: "npx @membank/cli@latest inject --harness claude-code"
+				}]
+			}];
+			writeJsonAtomic(cfgPath, {
+				...cfg,
+				hooks: newHooks
+			});
+			return { status: "written" };
+		}
+	},
+	"copilot-cli": {
+		inspect(resolver) {
+			const hooks = readJson(join(resolver.home(), ".copilot", "settings.json")).hooks ?? {};
+			return {
+				status: "ready",
+				hooks: [{
+					event: "sessionStart",
+					command: "npx @membank/cli@latest inject --harness copilot-cli",
+					existingCommand: extractInjectCommand(Array.isArray(hooks.sessionStart) ? hooks.sessionStart : []) || null
+				}]
+			};
+		},
+		write(resolver, events) {
+			const cfgPath = join(resolver.home(), ".copilot", "settings.json");
+			const cfg = readJson(cfgPath);
+			const hooks = cfg.hooks ?? {};
+			const newHooks = { ...hooks };
+			pruneFlatEvent(newHooks, "userPromptSubmitted");
+			pruneFlatEvent(newHooks, "postToolUseFailure");
+			if (events.includes("sessionStart")) newHooks.sessionStart = [...filterOutMembankFlat(Array.isArray(hooks.sessionStart) ? hooks.sessionStart : []), {
+				type: "command",
+				bash: "npx @membank/cli@latest inject --harness copilot-cli",
+				timeoutSec: 30
+			}];
+			writeJsonAtomic(cfgPath, {
+				version: cfg.version ?? 1,
+				...cfg,
+				hooks: newHooks
+			});
+			return { status: "written" };
+		}
+	},
+	codex: {
+		inspect(resolver) {
+			const hooks = readJson(join(resolver.home(), ".codex", "hooks.json")).hooks ?? {};
+			return {
+				status: "ready",
+				hooks: [{
+					event: "SessionStart",
+					command: "npx @membank/cli@latest inject --harness codex",
+					existingCommand: extractInjectCommand((Array.isArray(hooks.SessionStart) ? hooks.SessionStart : []).flatMap(getHooksArray)) || null
+				}]
+			};
+		},
+		write(resolver, events) {
+			const cfgPath = join(resolver.home(), ".codex", "hooks.json");
+			const cfg = readJson(cfgPath);
+			const hooks = cfg.hooks ?? {};
+			const newHooks = { ...hooks };
+			pruneNestedEvent(newHooks, "UserPromptSubmit");
+			pruneNestedEvent(newHooks, "PostToolUse");
+			if (events.includes("SessionStart")) newHooks.SessionStart = [...filterOutMembank(Array.isArray(hooks.SessionStart) ? hooks.SessionStart : []), {
+				matcher: "",
+				hooks: [{
+					type: "command",
+					command: "npx @membank/cli@latest inject --harness codex",
+					timeout: 30
+				}]
+			}];
+			writeJsonAtomic(cfgPath, {
+				...cfg,
+				hooks: newHooks
+			});
+			return { status: "written" };
+		}
+	},
+	opencode: {
+		inspect(resolver) {
+			const pluginPath = join(resolver.home(), ".config", "opencode", "plugins", "membank.js");
+			let existingCommand = null;
+			if (existsSync(pluginPath)) {
+				if (readFileSync(pluginPath, "utf8").includes("@membank/cli")) existingCommand = pluginPath;
+			}
+			return {
+				status: "ready",
+				hooks: [{
+					event: "plugin",
+					command: pluginPath,
+					existingCommand
+				}]
+			};
+		},
+		write(resolver, events) {
+			if (events.length === 0) return { status: "written" };
+			const pluginPath = join(resolver.home(), ".config", "opencode", "plugins", "membank.js");
+			mkdirSync(dirname(pluginPath), { recursive: true });
+			writeFileSync(pluginPath, `${newOpencodePlugin()}\n`, "utf8");
+			return { status: "written" };
+		}
+	}
+};
+function newOpencodePlugin() {
+	return [
+		"export default {",
+		"  hooks: {",
+		"    \"session.start\": async ({ $ }) => {",
+		"      return await $`npx @membank/cli@latest inject`.text();",
+		"    },",
+		"  },",
+		"};"
+	].join("\n");
+}
+var InjectionHookWriter = class {
+	#resolver;
+	constructor(resolver = defaultPathResolver) {
+		this.#resolver = resolver;
+	}
+	inspect(harness) {
+		const writer = writers[harness];
+		if (!writer) return { status: "not-supported" };
+		return writer.inspect(this.#resolver);
+	}
+	write(harness, events) {
+		const writer = writers[harness];
+		if (!writer) return { status: "not-supported" };
+		return writer.write(this.#resolver, events);
+	}
+};
+//#endregion
 //#region src/setup/model-downloader.ts
 const MODEL_NAME = "Xenova/bge-small-en-v1.5";
 var ModelDownloadError = class extends Error {
@@ -954,7 +881,6 @@ var SetupOrchestrator = class {
 				detectedHarnesses: [],
 				configuredHarnesses: [],
 				injectionHooksConfigured: [],
-				stopHooksConfigured: [],
 				modelDownloaded: false
 			}));
 			return [];
@@ -968,10 +894,7 @@ var SetupOrchestrator = class {
 			out("Planned changes (dry-run — no files written):");
 			for (const h of detected) {
 				out(`  ⚠ ${h.name}: would write MCP config`);
-				if (this.#hookWriter) {
-					out(`  ⚠ ${h.name}: would write injection hook config`);
-					out(`  ⚠ ${h.name}: would write stop hook config`);
-				}
+				if (this.#hookWriter) out(`  ⚠ ${h.name}: would write injection hook config`);
 			}
 			out("");
 			out("  ⚠ Model download: skipped (dry-run)");
@@ -1038,11 +961,8 @@ var SetupOrchestrator = class {
 		}
 		out("");
 		const injectionHooksConfigured = [];
-		const stopHooksConfigured = [];
 		if (this.#hookWriter) {
-			const w = this.#hookWriter;
-			injectionHooksConfigured.push(...await this.#runHookLoop(detected, "injection hook", (h, ow) => w.write(h, ow), yes, out));
-			stopHooksConfigured.push(...await this.#runHookLoop(detected, "stop hook", (h, ow) => w.writeStopHook(h, ow), yes, out));
+			injectionHooksConfigured.push(...await this.#runHookSetup(detected, yes, out));
 			out("");
 		}
 		let modelDownloaded = false;
@@ -1056,7 +976,6 @@ var SetupOrchestrator = class {
 				detectedHarnesses: detected.map((h) => h.name),
 				configuredHarnesses: results.filter((r) => r.status === "written").map((r) => r.harness),
 				injectionHooksConfigured,
-				stopHooksConfigured,
 				modelDownloaded
 			};
 			this.#out(JSON.stringify(output));
@@ -1066,28 +985,33 @@ var SetupOrchestrator = class {
 		}
 		return results;
 	}
-	async #runHookLoop(detected, label, write, yes, out) {
+	async #runHookSetup(detected, yes, out) {
 		const configured = [];
+		const w = this.#hookWriter;
 		for (const h of detected) try {
-			const result = write(h.name);
-			if (result.status === "not-supported") continue;
-			if (result.status === "written") {
-				out(`  ✓ ${h.name}: ${label} written`);
-				configured.push(h.name);
+			const inspected = w.inspect(h.name);
+			if (inspected.status === "not-supported") continue;
+			const toWrite = [];
+			for (const hook of inspected.hooks) if (hook.existingCommand === null) {
+				out(`  ${h.name}: ${hook.event} injection hook`);
+				out(`    Command: ${hook.command}`);
+				if (yes || await this.#prompter(`  Configure ${hook.event} injection hook for ${h.name}?`)) toWrite.push(hook.event);
 			} else {
-				out(`  ⚠ ${h.name}: ${label} already configured`);
-				out(`    Current: ${result.existing}`);
-				out(`    New:     ${result.replacement}`);
-				if (yes || await this.#prompter(`  Replace ${label} for ${h.name}?`)) {
-					if (write(h.name, true).status === "written") {
-						out(`  ✓ ${h.name}: ${label} replaced`);
-						configured.push(h.name);
-					}
-				}
+				out(`  ⚠ ${h.name}: ${hook.event} injection hook already configured`);
+				out(`    Current: ${hook.existingCommand}`);
+				if (hook.existingCommand !== hook.command) out(`    New:     ${hook.command}`);
+				if (yes || await this.#prompter(`  Replace ${hook.event} injection hook for ${h.name}?`)) toWrite.push(hook.event);
+			}
+			if (toWrite.length > 0) {
+				w.write(h.name, toWrite);
+				const skippedCount = inspected.hooks.length - toWrite.length;
+				const label = skippedCount > 0 ? `${toWrite.length} injection hook(s) written, ${skippedCount} skipped` : `${toWrite.length} injection hook(s) written`;
+				out(`  ✓ ${h.name}: ${label}`);
+				configured.push(h.name);
 			}
 		} catch (err) {
 			const msg = err instanceof Error ? err.message : String(err);
-			out(`  ✗ ${h.name} ${label}: ${msg}`);
+			out(`  ✗ ${h.name} injection hooks: ${msg}`);
 		}
 		return configured;
 	}
@@ -1221,7 +1145,7 @@ program.command("import <file>").description("import memories from a JSON export
 		db.close();
 	}
 });
-program.command("inject").description("output session context for harness injection (used by setup hooks)").option("--harness <name>", "format output for a specific harness (claude-code|copilot-cli|codex|opencode)").option("--scope <scope>", "project scope override (default: auto-detect from git remote)").action(async (cmdOptions) => {
+program.command("inject").description("output session context for harness injection (used by setup hooks)").option("--harness <name>", "format output for a specific harness (claude-code|copilot-cli|codex|opencode)").option("--scope <scope>", "project scope override (default: auto-detect from git remote)").option("--event <event>", "hook event type (only session-start is supported; other values no-op for legacy hook compatibility)", "session-start").action(async (cmdOptions) => {
 	try {
 		await injectCommand(cmdOptions);
 	} catch (err) {
@@ -1229,9 +1153,6 @@ program.command("inject").description("output session context for harness inject
 		process.exit(2);
 	}
 });
-program.command("stop-hook").description("output session-end prompt for harness stop hooks (called by hooks, not users)").option("--harness <name>", "harness name (copilot-cli, codex, opencode)").action((cmdOptions) => {
-	stopHookCommand(cmdOptions);
-});
 program.command("setup").description("detect installed harnesses and write MCP config for each").option("--yes", "skip all confirmation prompts").option("--dry-run", "print planned changes without writing any file").option("--harness <name>", "target only the named harness (skip detection)").action(async (cmdOptions) => {
 	const globalOpts = program.opts();
 	const autoYes = cmdOptions.yes === true || globalOpts.yes === true;
@@ -1263,6 +1184,14 @@ program.command("setup").description("detect installed harnesses and write MCP c
 		process.exit(2);
 	}
 });
+program.command("dashboard").description("open the memory management dashboard in the browser").option("--port <port>", "port to listen on (default: 3847, fallback to random)").action(async (cmdOptions) => {
+	try {
+		await dashboardCommand(cmdOptions);
+	} catch (err) {
+		process.stderr.write(`${err instanceof Error ? err.message : String(err)}\n`);
+		process.exit(2);
+	}
+});
 program.on("command:*", () => {
 	program.outputHelp();
 	process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@membank/cli",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -17,8 +17,9 @@
     "@huggingface/transformers": "^4.2.0",
     "commander": "^14.0.3",
     "ora": "^9.4.0",
-    "@membank/core": "0.2.0",
-    "@membank/mcp": "0.2.0"
+    "@membank/core": "0.4.0",
+    "@membank/dashboard": "0.2.0",
+    "@membank/mcp": "0.4.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",