codemem 0.20.3 → 0.20.5-alpha.1

package/.opencode/lib/compat.js

@@ -1,5 +1,5 @@
 export const parseSemver = (value) => {
-  const match = String(value || "").trim().match(/^(\d+)\.(\d+)\.(\d+)$/);
+  const match = String(value || "").trim().match(/^(\d+)\.(\d+)\.(\d+)(?:-.*)?$/);
   if (!match) return null;
   return [Number(match[1]), Number(match[2]), Number(match[3])];
 };

package/.opencode/plugins/codemem.js

@@ -15,7 +15,7 @@ import {
 
 const TRUTHY_VALUES = ["1", "true", "yes"];
 const DISABLED_VALUES = ["0", "false", "off"];
-const PINNED_BACKEND_VERSION = "0.20.3";
+const PINNED_BACKEND_VERSION = "0.20.5-alpha.1";
 
 const normalizeEnvValue = (value) => (value || "").toLowerCase();
 const envHasValue = (value, truthyValues) =>

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

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAEN,KAAK,uBAAuB,EAG5B,MAAM,uBAAuB,CAAC;AAQ/B,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKhE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASjD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQ9D;AAED,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,WAAW,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,GAAG,IAAI,CAGf;AA0KD,wBAAgB,yBAAyB,CACxC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,uBAAuB,EACnC,QAAQ,GAAE,MAAM,EAAqB,GACnC,MAAM,EAAE,CAgBV;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAS9D;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUpF;AAiMD,eAAO,MAAM,YAAY,SAuBtB,CAAC"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAEN,KAAK,uBAAuB,EAG5B,MAAM,uBAAuB,CAAC;AAQ/B,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAKhE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASjD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQ9D;AAED,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,WAAW,EAAE,MAAM,GAAG,IAAI,GACxB,MAAM,GAAG,IAAI,CAGf;AAmLD,wBAAgB,yBAAyB,CACxC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,uBAAuB,EACnC,QAAQ,GAAE,MAAM,EAAqB,GACnC,MAAM,EAAE,CAgBV;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAS9D;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUpF;AA+OD,eAAO,MAAM,YAAY,SAuBtB,CAAC"}

package/dist/commands/setup.d.ts

@@ -4,9 +4,9 @@
  * Replaces Python's install_plugin_cmd + install_mcp_cmd.
  *
  * What it does:
- * 1. Copies the plugin file to ~/.config/opencode/plugin/codemem.js
- * 2. Adds/updates the MCP entry in ~/.config/opencode/opencode.json
- * 3. Copies the compat lib to ~/.config/opencode/lib/compat.js
+ * 1. Adds "codemem" to the plugin array in ~/.config/opencode/opencode.jsonc
+ * 2. Adds/updates the MCP entry in ~/.config/opencode/opencode.jsonc
+ * 3. For Claude Code: installs MCP config and guides marketplace plugin install
  *
  * Designed to be safe to run repeatedly (idempotent unless --force).
  */

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

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmKpC,eAAO,MAAM,YAAY,SA6BtB,CAAC"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyQpC,eAAO,MAAM,YAAY,SA6BtB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8BH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8HpC,eAAO,MAAM,WAAW,SAE+B,CAAC"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/commands/sync.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8BH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwHpC,eAAO,MAAM,WAAW,SAE+B,CAAC"}

package/dist/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { DEFAULT_COORDINATOR_DB_PATH, MemoryStore, ObserverClient, RawEventSweeper, VERSION, backfillTagsText, backfillVectors, buildRawEventEnvelopeFromHook, connect, coordinatorCreateInviteAction, coordinatorImportInviteAction, coordinatorListJoinRequestsAction, coordinatorReviewJoinRequestAction, createCoordinatorApp, deactivateLowSignalMemories, deactivateLowSignalObservations, ensureDeviceIdentity, exportMemories, fingerprintPublicKey, getRawEventStatus, importMemories, initDatabase, isEmbeddingDisabled, loadPublicKey, loadSqliteVec, rawEventsGate, readCodememConfigFile, readImportPayload, resolveDbPath, resolveProject, retryRawEventFailures, runSyncDaemon, runSyncPass, schema, setPeerProjectFilter, stripJsonComments, stripPrivateObj, stripTrailingCommas, syncPassPreflight, updatePeerAddresses, vacuumDatabase, writeCodememConfigFile } from "@codemem/core";
+import { DEFAULT_COORDINATOR_DB_PATH, MemoryStore, ObserverClient, RawEventSweeper, VERSION, backfillTagsText, backfillVectors, buildRawEventEnvelopeFromHook, connect, coordinatorCreateInviteAction, coordinatorImportInviteAction, coordinatorListJoinRequestsAction, coordinatorReviewJoinRequestAction, createCoordinatorApp, deactivateLowSignalMemories, deactivateLowSignalObservations, ensureDeviceIdentity, exportMemories, fingerprintPublicKey, getRawEventStatus, importMemories, initDatabase, isEmbeddingDisabled, loadPublicKey, loadSqliteVec, rawEventsGate, readCodememConfigFile, readCoordinatorSyncConfig, readImportPayload, resolveDbPath, resolveProject, retryRawEventFailures, runSyncDaemon, runSyncPass, schema, setPeerProjectFilter, stripJsonComments, stripPrivateObj, stripTrailingCommas, syncPassPreflight, updatePeerAddresses, vacuumDatabase, writeCodememConfigFile } from "@codemem/core";
 import { Command } from "commander";
 import omelette from "omelette";
-import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { styleText } from "node:util";
 import * as p from "@clack/prompts";
 import { homedir, networkInterfaces } from "node:os";
@@ -1020,6 +1020,14 @@ async function waitForProcessExit(pid, timeoutMs = 5e3) {
 		await new Promise((resolve) => setTimeout(resolve, 100));
 	}
 }
+async function waitForPortRelease(host, port, timeoutMs = 1e4) {
+	const deadline = Date.now() + timeoutMs;
+	while (Date.now() < deadline) {
+		if (!await isPortOpen(host, port)) return true;
+		await new Promise((resolve) => setTimeout(resolve, 200));
+	}
+	return false;
+}
 async function stopExistingViewer(dbPath, target) {
 	const pidPath = pidFilePath(dbPath);
 	const record = readViewerPidRecord(dbPath);
@@ -1112,7 +1120,7 @@ async function startBackgroundViewer(invocation) {
 	p.outro(`Viewer started in background (pid ${child.pid}) at http://${invocation.host}:${invocation.port}`);
 }
 async function startForegroundViewer(invocation) {
-	const { createApp, closeStore, getStore } = await import("@codemem/server");
+	const { createApp, createSyncApp, closeStore, getStore } = await import("@codemem/server");
 	const { serve } = await import("@hono/node-server");
 	if (invocation.dbPath) process.env.CODEMEM_DB = invocation.dbPath;
 	if (await isPortOpen(invocation.host, invocation.port)) {
@@ -1137,15 +1145,16 @@ async function startForegroundViewer(invocation) {
 	sweeper.start();
 	const syncAbort = new AbortController();
 	let syncRunning = false;
-	const config = readCodememConfigFile();
-	if (config.sync_enabled === true || process.env.CODEMEM_SYNC_ENABLED?.toLowerCase() === "true" || process.env.CODEMEM_SYNC_ENABLED === "1") {
+	const syncConfig = readCoordinatorSyncConfig(readCodememConfigFile());
+	const syncEnabled = syncConfig.syncEnabled;
+	if (syncEnabled) {
 		syncRunning = true;
-		const syncIntervalS = typeof config.sync_interval_s === "number" ? config.sync_interval_s : 120;
+		const syncIntervalS = syncConfig.syncIntervalS;
 		runSyncDaemon({
 			dbPath: resolveDbPath(invocation.dbPath ?? void 0),
 			intervalS: syncIntervalS,
-			host: invocation.host,
-			port: invocation.port,
+			host: syncConfig.syncHost,
+			port: syncConfig.syncPort,
 			signal: syncAbort.signal
 		}).catch((err) => {
 			const msg = err instanceof Error ? err.message : String(err);
@@ -1154,13 +1163,30 @@ async function startForegroundViewer(invocation) {
 			syncRunning = false;
 		});
 	}
-	const app = createApp({
+	const appOpts = {
 		storeFactory: () => store,
 		sweeper,
 		observer
-	});
+	};
+	const app = createApp(appOpts);
 	const dbPath = resolveDbPath(invocation.dbPath ?? void 0);
 	const pidPath = pidFilePath(dbPath);
+	let syncServer = null;
+	let syncListenerReady = false;
+	if (syncEnabled) {
+		syncServer = serve({
+			fetch: createSyncApp(appOpts).fetch,
+			hostname: syncConfig.syncHost,
+			port: syncConfig.syncPort
+		}, (info) => {
+			syncListenerReady = true;
+			p.log.step(`Sync protocol listening on http://${info.address}:${info.port}`);
+		});
+		syncServer.on("error", (err) => {
+			if (!syncListenerReady && err.code === "EADDRINUSE") p.log.warn(`Sync port ${syncConfig.syncPort} already in use; peer sync protocol unavailable`);
+			else p.log.warn(`Sync listener error: ${err.message}`);
+		});
+	}
 	const server = serve({
 		fetch: app.fetch,
 		hostname: invocation.host,
@@ -1186,13 +1212,21 @@ async function startForegroundViewer(invocation) {
 		p.outro("shutting down");
 		syncAbort.abort();
 		await sweeper.stop();
-		server.close(() => {
-			try {
-				rmSync(pidPath);
-			} catch {}
-			closeStore();
-			process.exit(0);
-		});
+		await new Promise((resolve) => {
+			let remaining = syncServer ? 2 : 1;
+			const done = () => {
+				if (--remaining === 0) resolve();
+			};
+			syncServer?.close(done);
+			server.close(done);
+		}).catch(() => {});
+		try {
+			rmSync(pidPath);
+		} catch {}
+		closeStore();
+		process.exit(0);
+	};
+	const forceShutdown = () => {
 		setTimeout(() => {
 			try {
 				rmSync(pidPath);
@@ -1202,9 +1236,11 @@ async function startForegroundViewer(invocation) {
 		}, 5e3).unref();
 	};
 	process.on("SIGINT", () => {
+		forceShutdown();
 		shutdown();
 	});
 	process.on("SIGTERM", () => {
+		forceShutdown();
 		shutdown();
 	});
 }
@@ -1222,6 +1258,7 @@ async function runServeInvocation(invocation) {
 				p.outro("done");
 				return;
 			}
+			if (!await waitForPortRelease(invocation.host, invocation.port)) p.log.warn(`Port ${invocation.port} still in use after stop — restart may fail`);
 		} else if (invocation.mode === "stop") {
 			p.intro("codemem viewer");
 			p.outro("No background viewer found");
@@ -1285,9 +1322,9 @@ function writeJsonConfig(path, data) {
 * Replaces Python's install_plugin_cmd + install_mcp_cmd.
 *
 * What it does:
-* 1. Copies the plugin file to ~/.config/opencode/plugin/codemem.js
-* 2. Adds/updates the MCP entry in ~/.config/opencode/opencode.json
-* 3. Copies the compat lib to ~/.config/opencode/lib/compat.js
+* 1. Adds "codemem" to the plugin array in ~/.config/opencode/opencode.jsonc
+* 2. Adds/updates the MCP entry in ~/.config/opencode/opencode.jsonc
+* 3. For Claude Code: installs MCP config and guides marketplace plugin install
 *
 * Designed to be safe to run repeatedly (idempotent unless --force).
 */
@@ -1297,57 +1334,93 @@ function opencodeConfigDir() {
 function claudeConfigDir() {
 	return join(homedir(), ".claude");
 }
-/**
-* Find the plugin source file — walk up from this module's location
-* to find the .opencode/plugins/codemem.js in the package tree.
-*/
-function findPluginSource() {
-	let dir = dirname(import.meta.url.replace("file://", ""));
-	for (let i = 0; i < 6; i++) {
-		const candidate = join(dir, ".opencode", "plugins", "codemem.js");
-		if (existsSync(candidate)) return candidate;
-		const nmCandidate = join(dir, "node_modules", "codemem", ".opencode", "plugins", "codemem.js");
-		if (existsSync(nmCandidate)) return nmCandidate;
-		const parent = dirname(dir);
-		if (parent === dir) break;
-		dir = parent;
+/** The npm package name used in the OpenCode plugin array. */
+var OPENCODE_PLUGIN_SPEC = "codemem";
+/** Remove legacy copied plugin JS file from ~/.config/opencode/plugins/codemem.js */
+function migrateLegacyOpencodePlugin() {
+	const legacyPlugin = join(opencodeConfigDir(), "plugins", "codemem.js");
+	const legacyCompat = join(opencodeConfigDir(), "lib", "compat.js");
+	if (existsSync(legacyPlugin)) try {
+		rmSync(legacyPlugin);
+		p.log.step("Removed legacy copied plugin: ~/.config/opencode/plugins/codemem.js");
+	} catch {
+		p.log.warn("Could not remove legacy plugin file — remove manually if needed");
 	}
-	return null;
+	if (existsSync(legacyCompat)) try {
+		rmSync(legacyCompat);
+		p.log.step("Removed legacy compat lib: ~/.config/opencode/lib/compat.js");
+	} catch {}
 }
-function findCompatSource() {
-	let dir = dirname(import.meta.url.replace("file://", ""));
-	for (let i = 0; i < 6; i++) {
-		const candidate = join(dir, ".opencode", "lib", "compat.js");
-		if (existsSync(candidate)) return candidate;
-		const nmCandidate = join(dir, "node_modules", "codemem", ".opencode", "lib", "compat.js");
-		if (existsSync(nmCandidate)) return nmCandidate;
-		const legacyCandidate = join(dir, "node_modules", "@kunickiaj", "codemem", ".opencode", "lib", "compat.js");
-		if (existsSync(legacyCandidate)) return legacyCandidate;
-		const parent = dirname(dir);
-		if (parent === dir) break;
-		dir = parent;
+/** Detect and upgrade legacy uvx/uv-based MCP entries in OpenCode config. */
+function migrateLegacyOpencodeMcp(config) {
+	const mcpConfig = config.mcp;
+	if (!mcpConfig || typeof mcpConfig !== "object") return false;
+	const entry = mcpConfig.codemem;
+	if (!entry || typeof entry !== "object") return false;
+	const command = entry.command;
+	if (Array.isArray(command) && command.some((arg) => typeof arg === "string" && (arg === "uvx" || arg === "uv")) || typeof command === "string" && (command === "uvx" || command === "uv")) {
+		p.log.step("Upgrading legacy uvx MCP entry to npx");
+		mcpConfig.codemem = {
+			type: "local",
+			command: [
+				"npx",
+				"codemem",
+				"mcp"
+			],
+			enabled: true
+		};
+		return true;
 	}
-	return null;
+	return false;
+}
+/** Detect and upgrade legacy uvx-based MCP entries in Claude settings. */
+function migrateLegacyClaudeMcp(settings) {
+	const mcpServers = settings.mcpServers;
+	if (!mcpServers || typeof mcpServers !== "object") return false;
+	const entry = mcpServers.codemem;
+	if (!entry || typeof entry !== "object") return false;
+	const command = entry.command;
+	const args = entry.args;
+	if (typeof command === "string" && (command === "uvx" || command === "uv") || Array.isArray(args) && args.some((arg) => typeof arg === "string" && (arg.startsWith("codemem==") || arg === "uvx"))) {
+		p.log.step("Upgrading legacy uvx Claude MCP entry to npx");
+		mcpServers.codemem = {
+			command: "npx",
+			args: [
+				"-y",
+				"codemem",
+				"mcp"
+			]
+		};
+		return true;
+	}
+	return false;
 }
 function installPlugin(force) {
-	const source = findPluginSource();
-	if (!source) {
-		p.log.error("Plugin file not found in package tree");
+	migrateLegacyOpencodePlugin();
+	const configPath = resolveOpencodeConfigPath(opencodeConfigDir());
+	let config;
+	try {
+		config = loadJsoncConfig(configPath);
+	} catch (err) {
+		p.log.error(`Failed to parse ${configPath}: ${err instanceof Error ? err.message : String(err)}`);
 		return false;
 	}
-	const destDir = join(opencodeConfigDir(), "plugins");
-	const dest = join(destDir, "codemem.js");
-	if (existsSync(dest) && !force) p.log.info(`Plugin already installed at ${dest}`);
-	else {
-		mkdirSync(destDir, { recursive: true });
-		copyFileSync(source, dest);
-		p.log.success(`Plugin installed: ${dest}`);
+	let plugins = config.plugin;
+	if (!Array.isArray(plugins)) plugins = [];
+	const hasCodemem = plugins.some((entry) => typeof entry === "string" && (entry === OPENCODE_PLUGIN_SPEC || entry.startsWith(`${OPENCODE_PLUGIN_SPEC}@`)));
+	if (hasCodemem && !force) {
+		p.log.info(`Plugin "${OPENCODE_PLUGIN_SPEC}" already in plugin array`);
+		return true;
 	}
-	const compatSource = findCompatSource();
-	if (compatSource) {
-		const compatDir = join(opencodeConfigDir(), "lib");
-		mkdirSync(compatDir, { recursive: true });
-		copyFileSync(compatSource, join(compatDir, "compat.js"));
+	if (hasCodemem && force) plugins = plugins.filter((entry) => typeof entry !== "string" || entry !== OPENCODE_PLUGIN_SPEC && !entry.startsWith(`${OPENCODE_PLUGIN_SPEC}@`));
+	plugins.push(OPENCODE_PLUGIN_SPEC);
+	config.plugin = plugins;
+	try {
+		writeJsonConfig(configPath, config);
+		p.log.success(`Plugin "${OPENCODE_PLUGIN_SPEC}" added to ${configPath}`);
+	} catch (err) {
+		p.log.error(`Failed to write ${configPath}: ${err instanceof Error ? err.message : String(err)}`);
+		return false;
 	}
 	return true;
 }
@@ -1362,20 +1435,23 @@ function installMcp(force) {
 	}
 	let mcpConfig = config.mcp;
 	if (mcpConfig == null || typeof mcpConfig !== "object" || Array.isArray(mcpConfig)) mcpConfig = {};
-	if ("codemem" in mcpConfig && !force) {
+	const migrated = migrateLegacyOpencodeMcp(config);
+	if ("codemem" in mcpConfig && !force && !migrated) {
 		p.log.info(`MCP entry already exists in ${configPath}`);
 		return true;
 	}
-	mcpConfig.codemem = {
-		type: "local",
-		command: [
-			"npx",
-			"codemem",
-			"mcp"
-		],
-		enabled: true
-	};
-	config.mcp = mcpConfig;
+	if (!migrated) {
+		mcpConfig.codemem = {
+			type: "local",
+			command: [
+				"npx",
+				"codemem",
+				"mcp"
+			],
+			enabled: true
+		};
+		config.mcp = mcpConfig;
+	}
 	try {
 		writeJsonConfig(configPath, config);
 		p.log.success(`MCP entry installed: ${configPath}`);
@@ -1385,6 +1461,12 @@ function installMcp(force) {
 	}
 	return true;
 }
+function isClaudeHooksPluginInstalled() {
+	const pluginDir = join(claudeConfigDir(), "plugins", "codemem");
+	if (existsSync(pluginDir)) return true;
+	if (existsSync(join(pluginDir, "hooks", "hooks.json"))) return true;
+	return false;
+}
 function installClaudeMcp(force) {
 	const settingsPath = join(claudeConfigDir(), "settings.json");
 	let settings;
@@ -1395,22 +1477,36 @@ function installClaudeMcp(force) {
 	}
 	let mcpServers = settings.mcpServers;
 	if (mcpServers == null || typeof mcpServers !== "object" || Array.isArray(mcpServers)) mcpServers = {};
-	if ("codemem" in mcpServers && !force) {
-		p.log.info(`Claude MCP entry already exists in ${settingsPath}`);
-		return true;
-	}
-	mcpServers.codemem = {
-		command: "npx",
-		args: ["codemem", "mcp"]
-	};
-	settings.mcpServers = mcpServers;
-	try {
-		writeJsonConfig(settingsPath, settings);
-		p.log.success(`Claude MCP entry installed: ${settingsPath}`);
-	} catch (err) {
-		p.log.error(`Failed to write ${settingsPath}: ${err instanceof Error ? err.message : String(err)}`);
-		return false;
+	const migrated = migrateLegacyClaudeMcp(settings);
+	if ("codemem" in mcpServers && !force && !migrated) p.log.info(`Claude MCP entry already exists in ${settingsPath}`);
+	else {
+		if (!migrated) {
+			mcpServers.codemem = {
+				command: "npx",
+				args: [
+					"-y",
+					"codemem",
+					"mcp"
+				]
+			};
+			settings.mcpServers = mcpServers;
+		}
+		try {
+			writeJsonConfig(settingsPath, settings);
+			p.log.success(`Claude MCP entry installed: ${settingsPath}`);
+		} catch (err) {
+			p.log.error(`Failed to write ${settingsPath}: ${err instanceof Error ? err.message : String(err)}`);
+			return false;
+		}
 	}
+	if (!isClaudeHooksPluginInstalled() || force) {
+		p.log.info("To install the Claude Code hooks plugin, run in Claude Code:");
+		p.log.info("  /plugin marketplace add kunickiaj/codemem");
+		p.log.info("  /plugin install codemem");
+		p.log.info("");
+		p.log.info("To update an existing install:");
+		p.log.info("  /plugin marketplace update codemem-marketplace");
+	} else p.log.info("Claude Code hooks plugin appears to be installed");
 	return true;
 }
 var setupCommand = new Command("setup").configureHelp(helpStyle).description("Install codemem plugin + MCP config for OpenCode and Claude Code").option("--force", "overwrite existing installations").option("--opencode-only", "only install for OpenCode").option("--claude-only", "only install for Claude Code").action((opts) => {
@@ -1572,22 +1668,11 @@ function parseStoredAddressEndpoint(value) {
 async function runServeLifecycle(action, opts) {
 	if (opts.user === false || opts.system === true) p.log.warn("TS sync lifecycle currently manages the local viewer process, not separate user/system services.");
 	if (action === "start") {
-		const config = readCodememConfigFile();
-		if (config.sync_enabled !== true) {
+		if (readCodememConfigFile().sync_enabled !== true) {
 			p.log.error("Sync is disabled. Run `codemem sync enable` first.");
 			process.exitCode = 1;
 			return;
 		}
-		const configuredHost = typeof config.sync_host === "string" ? config.sync_host : "0.0.0.0";
-		const configuredPort = typeof config.sync_port === "number" ? String(config.sync_port) : "7337";
-		opts.host ??= configuredHost;
-		opts.port ??= configuredPort;
-	} else if (action === "restart") {
-		const config = readCodememConfigFile();
-		const configuredHost = typeof config.sync_host === "string" ? config.sync_host : "0.0.0.0";
-		const configuredPort = typeof config.sync_port === "number" ? String(config.sync_port) : "7337";
-		opts.host ??= configuredHost;
-		opts.port ??= configuredPort;
 	}
 	const args = buildServeLifecycleArgs(action, opts, process.argv[1] ?? "", process.execArgv);
 	await new Promise((resolve, reject) => {