@agentmemory/agentmemory 0.9.26 → 0.9.28

package/dist/cli.mjs

@@ -1,14 +1,15 @@
 #!/usr/bin/env node
-import { i as generateId } from "./schema-Dsr_V2Wp.mjs";
-import { n as resolveAdapter, r as runAdapter } from "./connect-bmZ5eqYN.mjs";
-import { r as setBootVerbose } from "./logger-yHTcEBAI.mjs";
-import { t as VERSION } from "./version-BMFYFFut.mjs";
+import { a as runAdapter, i as resolveAdapter, r as knownAgents, t as ADAPTERS } from "./connect-JnsJXc68.mjs";
+import { i as generateId } from "./schema-CNiCWzV9.mjs";
+import { r as setBootVerbose } from "./logger-BEB7pCI9.mjs";
+import { i as VERSION, n as getAllTools, t as ESSENTIAL_TOOLS } from "./tools-registry-D3NEoe5m.mjs";
 import { execFileSync, spawn, spawnSync } from "node:child_process";
-import { closeSync, constants, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, readdirSync, readlinkSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
+import { appendFileSync, closeSync, constants, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, readdirSync, readlinkSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
 import { delimiter, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { homedir, platform } from "node:os";
 import * as p from "@clack/prompts";
+import pc from "picocolors";
 import { copyFile, mkdir } from "node:fs/promises";
 //#region src/cli/doctor-diagnostics.ts
 /** Common placeholder values shipped in .env.example. */
@@ -436,7 +437,8 @@ const DEFAULTS = {
 	skipNpxHint: false,
 	skipGlobalInstall: false,
 	skipConsoleInstall: false,
-	firstRunAt: null
+	firstRunAt: null,
+	injectContextChosen: false
 };
 function prefsDir() {
 	return join(homedir(), ".agentmemory");
@@ -492,95 +494,14 @@ function isFirstRun() {
 //#endregion
 //#region src/cli/onboarding.ts
 const __dirname$1 = dirname(fileURLToPath(import.meta.url));
-const NATIVE_AGENTS = [
-	{
-		value: "claude-code",
-		label: "Claude Code",
-		glyph: "⟁"
-	},
-	{
-		value: "copilot-cli",
-		label: "GitHub Copilot CLI",
-		glyph: "◈"
-	},
-	{
-		value: "codex",
-		label: "Codex",
-		glyph: "◎"
-	},
-	{
-		value: "openhuman",
-		label: "OpenHuman",
-		glyph: "◇"
-	},
-	{
-		value: "openclaw",
-		label: "OpenClaw",
-		glyph: "◇"
-	},
-	{
-		value: "hermes",
-		label: "Hermes",
-		glyph: "◇"
-	},
-	{
-		value: "pi",
-		label: "Pi",
-		glyph: "◇"
-	},
-	{
-		value: "cursor",
-		label: "Cursor",
-		glyph: "◫"
-	},
-	{
-		value: "gemini-cli",
-		label: "Gemini CLI",
-		glyph: "✦"
-	}
-];
-const MCP_AGENTS = [
-	{
-		value: "opencode",
-		label: "OpenCode",
-		glyph: "⬡"
-	},
-	{
-		value: "cline",
-		label: "Cline",
-		glyph: "◇"
-	},
-	{
-		value: "goose",
-		label: "Goose",
-		glyph: "◇"
-	},
-	{
-		value: "kilo",
-		label: "Kilo",
-		glyph: "◇"
-	},
-	{
-		value: "aider",
-		label: "Aider",
-		glyph: "◇"
-	},
-	{
-		value: "claude-desktop",
-		label: "Claude Desktop",
-		glyph: "⟁"
-	},
-	{
-		value: "windsurf",
-		label: "Windsurf",
-		glyph: "◇"
-	},
-	{
-		value: "roo",
-		label: "Roo",
-		glyph: "◇"
-	}
-];
+const AGENT_GLYPH = {
+	"claude-code": "⟁",
+	"copilot-cli": "◈",
+	codex: "◎",
+	cursor: "◫",
+	"gemini-cli": "✦",
+	opencode: "⬡"
+};
 const PROVIDERS = [
 	{
 		value: "anthropic",
@@ -613,16 +534,20 @@ const PROVIDERS = [
 		envKey: null
 	}
 ];
+const PROVIDER_COST_HINTS = {
+	anthropic: "rough cost: a fast Haiku-class model keeps compress/consolidate at fractions of a cent per session.",
+	openai: "rough cost: a mini-class model keeps compress/consolidate at fractions of a cent per session.",
+	gemini: "rough cost: a Flash-class model keeps compress/consolidate at fractions of a cent per session.",
+	openrouter: "rough cost: pick a small model; spend tracks your chosen model's per-token price.",
+	minimax: "rough cost: scales with the MiniMax model price per token."
+};
 function buildAgentOptions() {
-	return [...NATIVE_AGENTS.map((a) => ({
-		value: a.value,
-		label: `${a.glyph} ${a.label}`,
-		hint: "native plugin"
-	})), ...MCP_AGENTS.map((a) => ({
-		value: a.value,
-		label: `${a.glyph} ${a.label}`,
-		hint: "MCP server"
-	}))];
+	const options = ADAPTERS.map((a) => ({
+		value: a.name,
+		label: `${AGENT_GLYPH[a.name] ?? "◇"} ${a.displayName}`,
+		hint: a.category === "native" ? "native plugin" : "MCP server"
+	}));
+	return [...options.filter((o) => o.hint === "native plugin"), ...options.filter((o) => o.hint === "MCP server")];
 }
 function getInitialAgentValues(env = process.env) {
 	if (env["COPILOT_CLI"] === "1" || env["COPILOT_AGENT_SESSION_ID"]) return ["copilot-cli"];
@@ -715,7 +640,12 @@ async function runOnboarding() {
 	}
 	const provider = providerPicked === "skip" ? null : providerPicked;
 	const agents = agentsPicked ?? [];
+	if (provider) {
+		const hint = PROVIDER_COST_HINTS[provider];
+		if (hint) p.log.info(hint);
+	}
 	const envPath = await seedEnvFile(provider);
+	await maybePromptContextInjection(envPath);
 	writePrefs({
 		lastAgent: agents[0] ?? null,
 		lastAgents: agents,
@@ -737,6 +667,33 @@ async function runOnboarding() {
 		provider
 	};
 }
+function enableInjectContextInEnv(envPath) {
+	if (!envPath || !existsSync(envPath)) return false;
+	try {
+		const current = readFileSync(envPath, "utf-8");
+		if (/^\s*AGENTMEMORY_INJECT_CONTEXT\s*=\s*true\b/m.test(current)) return true;
+		appendFileSync(envPath, `${current.length > 0 && !current.endsWith("\n") ? "\n" : ""}AGENTMEMORY_INJECT_CONTEXT=true\n`, { mode: 384 });
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function maybePromptContextInjection(envPath) {
+	if (readPrefs().injectContextChosen) return;
+	const enable = await p.confirm({
+		message: "Enable automatic context injection so the agent recalls past sessions without being asked? [y/N]",
+		initialValue: false
+	});
+	if (p.isCancel(enable)) {
+		p.cancel("Setup cancelled. Re-run any time with: agentmemory --reset");
+		process.exit(0);
+	}
+	p.log.info("Cost note: injection spends session tokens proportional to tool-call frequency. Default is off.");
+	writePrefs({ injectContextChosen: true });
+	if (enable === true) if (enableInjectContextInEnv(envPath)) p.log.success("Context injection enabled (AGENTMEMORY_INJECT_CONTEXT=true).");
+	else p.log.warn("Could not update ~/.agentmemory/.env. Set AGENTMEMORY_INJECT_CONTEXT=true there to enable it.");
+	else p.log.info("Context injection left off. Set AGENTMEMORY_INJECT_CONTEXT=true later to enable.");
+}
 async function wireSelectedAgents(agents) {
 	p.note("Wire selected agents now?", "next step");
 	const confirmed = await p.confirm({
@@ -809,6 +766,18 @@ async function wireSelectedAgents(agents) {
 }
 //#endregion
 //#region src/cli.ts
+const c = {
+	url: pc.cyan,
+	ok: pc.green,
+	warn: pc.yellow,
+	err: pc.red,
+	cmd: (s) => pc.bold(pc.cyan(s)),
+	label: pc.bold,
+	dim: pc.dim,
+	accent: (s) => pc.bold(pc.yellow(s))
+};
+const ALL_TOOLS_COUNT = getAllTools().length;
+const CORE_TOOLS_COUNT = getAllTools().filter((t) => ESSENTIAL_TOOLS.has(t.name)).length;
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const args = process.argv.slice(2);
 const IS_WINDOWS = platform() === "win32";
@@ -840,6 +809,19 @@ function iiiReleaseUrl() {
 function vlog(msg) {
 	if (IS_VERBOSE) p.log.info(`[verbose] ${msg}`);
 }
+function wrapList(items, indent, width = 78) {
+	const lines = [];
+	let line = "";
+	for (const item of items) {
+		const joined = line ? `${line}, ${item}` : item;
+		if (line && indent + joined.length > width) {
+			lines.push(`${line},`);
+			line = item;
+		} else line = joined;
+	}
+	lines.push(line);
+	return lines.join(`\n${" ".repeat(indent)}`);
+}
 if (args.includes("--help") || args.includes("-h")) {
 	console.log(`
 agentmemory — persistent memory for AI coding agents
@@ -849,9 +831,8 @@ Usage: agentmemory [command] [options]
 Commands:
   (default)          Start agentmemory worker
   init               Copy bundled .env.example to ~/.agentmemory/.env if absent
-  connect [agent]    Wire agentmemory into an installed agent (claude-code,
-                     copilot-cli, codex, cursor, gemini-cli, openclaw,
-                     hermes, pi, openhuman).
+  connect [agent]    Wire agentmemory into an installed agent
+                     (${wrapList(knownAgents(), 21)}).
                      No arg = interactive picker. --all wires every detected agent.
                      --dry-run shows what would change. --force re-installs.
   status             Show connection status, memory count, flags, and health
@@ -860,7 +841,9 @@ Commands:
                      --dry-run: show what each fix would do, don't execute
   remove             Cleanly uninstall agentmemory (pidfile, state, .env, binaries).
                      --force: skip confirmations · --keep-data: keep memory data
-  demo               Seed sample sessions and show recall in action
+  demo [--serve]     Seed sample sessions and show recall in action.
+                     --serve boots the server, runs the demo, and stops it
+                     in one command (no second terminal).
   upgrade            Upgrade local deps + iii runtime (best effort)
   stop [--force]     Stop the running iii-engine started by this CLI.
                      --force bypasses the Docker-heuristic guard and signals
@@ -876,9 +859,14 @@ Options:
   --help, -h         Show this help
   --verbose, -v      Show engine stderr, boot log, and diagnostic info
   --reset            Wipe ~/.agentmemory/preferences.json and re-run onboarding
-  --tools all|core   Tool visibility (default: all = 51 tools; core = 8 essentials)
+  --tools all|core   Tool visibility (default: all = ${ALL_TOOLS_COUNT} tools; core = ${CORE_TOOLS_COUNT} essentials)
   --no-engine        Skip auto-starting iii-engine
-  --port <N>         Override REST port (default: 3111)
+  --port <N>         Override REST port (default: 3111). Streams (N+1), viewer
+                     (N+2), and iii engine (N+46023) auto-derive from N so a
+                     single flag relocates the whole quartet.
+  --instance <N>     Shortcut for --port (3111 + N*100) to run multiple
+                     daemons side-by-side without env gymnastics.
+                     --instance 1 -> 3211/3212/3213/49234, etc. (max N=50)
 
 Environment:
   AGENTMEMORY_URL              Full REST base URL (e.g. http://localhost:3111).
@@ -902,9 +890,21 @@ Quick start:
 	process.exit(0);
 }
 const toolsIdx = args.indexOf("--tools");
-if (toolsIdx !== -1 && args[toolsIdx + 1]) process.env["AGENTMEMORY_TOOLS"] = args[toolsIdx + 1];
+if (toolsIdx !== -1 && args[toolsIdx + 1]) {
+	const toolsMode = args[toolsIdx + 1];
+	if (toolsMode !== "all" && toolsMode !== "core") p.log.warn(`Unknown --tools value "${toolsMode}" (valid: all, core); falling back to all.`);
+	process.env["AGENTMEMORY_TOOLS"] = toolsMode;
+}
 const portIdx = args.indexOf("--port");
 if (portIdx !== -1 && args[portIdx + 1]) process.env["III_REST_PORT"] = args[portIdx + 1];
+const instanceIdx = args.indexOf("--instance");
+if (instanceIdx !== -1 && args[instanceIdx + 1]) {
+	const n = parseInt(args[instanceIdx + 1] || "", 10);
+	if (Number.isFinite(n) && n >= 0 && n <= 50) {
+		const base = 3111 + n * 100;
+		if (!process.env["III_REST_PORT"]) process.env["III_REST_PORT"] = String(base);
+	}
+}
 const skipEngine = args.includes("--no-engine");
 function getRestPort() {
 	const url = process.env["AGENTMEMORY_URL"];
@@ -948,7 +948,7 @@ function getViewerUrl() {
 	}
 }
 function getStreamPort() {
-	return parseInt(process.env["III_STREAM_PORT"] || "", 10) || parseInt(process.env["III_STREAMS_PORT"] || "", 10) || 3112;
+	return parseInt(process.env["III_STREAM_PORT"] || "", 10) || parseInt(process.env["III_STREAMS_PORT"] || "", 10) || getRestPort() + 1;
 }
 function getEnginePort() {
 	const explicit = parseInt(process.env["III_ENGINE_PORT"] || "", 10);
@@ -958,7 +958,7 @@ function getEnginePort() {
 		const parsed = new URL(url).port;
 		if (parsed) return parseInt(parsed, 10);
 	} catch {}
-	return 49134;
+	return getRestPort() + 46023;
 }
 async function isEngineRunning() {
 	try {
@@ -1175,8 +1175,8 @@ async function maybeOfferGlobalInstall() {
 	if (runCommand(npmBin, [
 		"install",
 		"-g",
-		`@agentmemory/agentmemory@0.9.26`
-	], { label: `Installing @agentmemory/agentmemory@0.9.26 globally` })) {
+		`@agentmemory/agentmemory@0.9.28`
+	], { label: `Installing @agentmemory/agentmemory@0.9.28 globally` })) {
 		p.log.success("Installed globally. `agentmemory stop` etc. will now work in new shells.");
 		writePrefs({ skipGlobalInstall: true });
 	} else p.log.warn("Global install failed. Try manually: npm install -g @agentmemory/agentmemory");
@@ -1194,7 +1194,11 @@ function detectIiiConsole() {
 	};
 	return { kind: "missing" };
 }
-const III_CONSOLE_INSTALL_CMD = "curl -fsSL https://install.iii.dev/iii/main/install.sh | sh";
+const III_CONSOLE_INSTALL_CMD = `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=${IIPINNED_VERSION} sh`;
+function iiiConsoleInstallHint() {
+	if (!IS_WINDOWS) return III_CONSOLE_INSTALL_CMD;
+	return `# PowerShell:\n  $env:VERSION = "${IIPINNED_VERSION}"\n  iwr -useb https://install.iii.dev/iii/main/install.sh -OutFile install.sh\n  bash install.sh   # WSL or Git Bash required\n# Or grab the pinned release directly:\n  https://github.com/iii-hq/iii/releases/tag/iii%2Fv${IIPINNED_VERSION}`;
+}
 async function ensureIiiConsole() {
 	const state = detectIiiConsole();
 	if (state.kind === "installed") return state;
@@ -1212,11 +1216,11 @@ async function ensureIiiConsole() {
 	const shBin = whichBinary("sh");
 	const curlBin = whichBinary("curl");
 	if (!shBin || !curlBin) {
-		p.log.warn(`curl or sh not found. Install manually:\n  ${III_CONSOLE_INSTALL_CMD}`);
+		p.log.warn(`curl or sh not found. Install manually:\n  ${iiiConsoleInstallHint()}`);
 		return state;
 	}
 	if (!runCommand(shBin, ["-c", III_CONSOLE_INSTALL_CMD], { label: "Installing iii console" })) {
-		p.log.warn(`iii console install failed. Re-run manually:\n  ${III_CONSOLE_INSTALL_CMD}`);
+		p.log.warn(`iii console install failed. Re-run manually:\n  ${iiiConsoleInstallHint()}`);
 		return state;
 	}
 	return detectIiiConsole();
@@ -1233,7 +1237,7 @@ function adoptRunningEngine() {
 			configPath: findIiiConfig() || "",
 			attached: true
 		});
-		if (enginePid && !existingPid) p.log.info(`Attached to existing iii-engine (pid ${enginePid})`);
+		if (enginePid && !existingPid) p.log.info(c.ok(`Attached to existing iii-engine (pid ${enginePid})`));
 	} catch (err) {
 		vlog(`adoptRunningEngine: ${err instanceof Error ? err.message : String(err)}`);
 	}
@@ -1335,7 +1339,7 @@ function startIiiBin(iiiBin, configPath) {
 		binPath: iiiBin
 	});
 	spawnEngineBackground(iiiBin, ["--config", configPath], "iii-engine");
-	s.stop("iii-engine process started");
+	s.stop(c.ok("iii-engine process started"));
 	return true;
 }
 function pickCompatibleIii(candidates) {
@@ -1355,7 +1359,7 @@ async function startEngine() {
 	let iiiBin = pickCompatibleIii([pathIii, ...fallbacks]);
 	if (iiiBin && configPath) {
 		if (iiiBin !== pathIii) {
-			p.log.info(`Using iii at: ${iiiBin} (v${IIPINNED_VERSION})`);
+			p.log.info(`Using iii at: ${c.dim(iiiBin)} (v${c.accent(IIPINNED_VERSION)})`);
 			process.env["PATH"] = `${dirname(iiiBin)}${delimiter}${process.env["PATH"] ?? ""}`;
 		}
 		return startIiiBin(iiiBin, configPath);
@@ -1528,17 +1532,17 @@ function printReadyHint(consoleState) {
 	const engineHost = getEngineHost();
 	const streamUrl = `ws://${engineHost}:${getStreamPort()}`;
 	const engineUrl = `ws://${engineHost}:${getEnginePort()}`;
-	const consoleLine = consoleState.kind === "installed" ? `iii console  ${consoleState.binPath}  (run: ${consoleState.binPath} -p <port>)` : `iii console  (install: ${III_CONSOLE_INSTALL_CMD})`;
+	const consoleLine = consoleState.kind === "installed" ? `${c.label("iii console")}  ${c.dim(consoleState.binPath)}  ${c.dim(`(run: ${consoleState.binPath} -p <port>)`)}` : `${c.label("iii console")}  ${c.dim(`(install: ${iiiConsoleInstallHint()})`)}`;
 	const lines = [
-		`REST API     ${restUrl}`,
-		`Viewer       ${viewerUrl}`,
-		`Streams      ${streamUrl}`,
-		`Engine       ${engineUrl}`,
+		`${c.label("REST API")}     ${c.url(restUrl)}`,
+		`${c.label("Viewer")}       ${c.url(viewerUrl)}`,
+		`${c.label("Streams")}      ${c.url(streamUrl)}`,
+		`${c.label("Engine")}       ${c.url(engineUrl)}`,
 		consoleLine
 	];
-	p.note(lines.join("\n"), `agentmemory v${VERSION}`);
+	p.note(lines.join("\n"), `agentmemory v${c.accent(VERSION)}`);
 	const demoCommand = isInvokedViaNpx() ? "npx @agentmemory/agentmemory demo" : "agentmemory demo";
-	process.stdout.write(`\nTry: ${demoCommand}\n`);
+	process.stdout.write(`\n${c.dim("Try:")} ${c.cmd(demoCommand)}\n`);
 }
 async function main() {
 	if (IS_RESET) resetPrefs();
@@ -1548,7 +1552,7 @@ async function main() {
 	if (firstRun || IS_RESET) await runOnboarding();
 	if (skipEngine) {
 		if (IS_VERBOSE) p.log.info("Skipping engine check (--no-engine)");
-		await import("./src-u7kAEUC0.mjs");
+		await import("./src-CzgoepGU.mjs");
 		if (await waitForAgentmemoryReady(15e3)) {
 			const consoleState = await ensureIiiConsole();
 			await maybeOfferGlobalInstall();
@@ -1560,21 +1564,38 @@ async function main() {
 		if (IS_VERBOSE) p.log.success("iii-engine is running");
 		const persisted = readEngineState();
 		const attachedBin = (persisted?.kind === "native" && persisted.binPath && existsSync(persisted.binPath) ? persisted.binPath : null) ?? whichBinary("iii") ?? fallbackIiiPaths().find((p) => existsSync(p)) ?? null;
-		if (attachedBin) {
-			const detected = iiiBinVersion(attachedBin);
-			if (detected && detected !== IIPINNED_VERSION) {
-				p.log.error(`Attached iii-engine appears to be v${detected} (from ${attachedBin}) but agentmemory v${VERSION} hard-pins v${IIPINNED_VERSION}. Engine API drift causes runtime failures (e.g. state::list-not-found on v0.13.0+). Stop the running engine (\`agentmemory stop --force\`) and re-run \`agentmemory\` to install the pinned engine into ~/.agentmemory/bin without touching ${attachedBin}. Or set AGENTMEMORY_III_VERSION=${detected} to override at your own risk.`);
-				process.exit(1);
+		const detected = attachedBin ? iiiBinVersion(attachedBin) : null;
+		if (detected === IIPINNED_VERSION) {
+			adoptRunningEngine();
+			await import("./src-CzgoepGU.mjs");
+			if (await waitForAgentmemoryReady(15e3)) {
+				const consoleState = await ensureIiiConsole();
+				await maybeOfferGlobalInstall();
+				printReadyHint(consoleState);
 			}
+			return;
 		}
-		adoptRunningEngine();
-		await import("./src-u7kAEUC0.mjs");
-		if (await waitForAgentmemoryReady(15e3)) {
-			const consoleState = await ensureIiiConsole();
-			await maybeOfferGlobalInstall();
-			printReadyHint(consoleState);
-		}
-		return;
+		const detectedLabel = detected ? `v${detected}` : "an unverified version";
+		const base = isInvokedViaNpx() ? "npx @agentmemory/agentmemory" : "agentmemory";
+		p.log.error(`Another iii-engine (${detectedLabel}) is running on port ${getEnginePort()}, and agentmemory needs its own pinned v${IIPINNED_VERSION}.`);
+		p.note([
+			`agentmemory only supports iii-engine v${IIPINNED_VERSION}. It will not adopt or change the running engine (${detectedLabel}).`,
+			"",
+			c.label("Switch to the pinned engine in two steps:"),
+			"",
+			`  1. Stop the running engine:`,
+			`       ${c.cmd(`${base} stop --force`)}`,
+			`     ${c.dim(`(or stop your own iii however you started it — agentmemory leaves your global iii untouched)`)}`,
+			"",
+			`  2. Start agentmemory. It downloads and runs the pinned`,
+			`     v${IIPINNED_VERSION} into ~/.agentmemory/bin automatically:`,
+			`       ${c.cmd(base)}`,
+			"",
+			c.dim(`Step 2 needs no manual install. To install iii v${IIPINNED_VERSION} yourself (replaces your global iii), curl:`),
+			`     ${c.cmd(III_CONSOLE_INSTALL_CMD)}`,
+			`     ${c.dim("or download the release:")} ${c.url(`https://github.com/iii-hq/iii/releases/tag/iii%2Fv${IIPINNED_VERSION}`)}`
+		].join("\n"), "engine conflict");
+		process.exit(1);
 	}
 	if (!await startEngine()) {
 		p.log.error("Could not start iii-engine.");
@@ -1595,7 +1616,7 @@ async function main() {
 			else p.log.info("No stderr was captured. Re-run with --verbose for more detail.");
 			p.note([
 				"Common causes:",
-				"  - iii-engine version mismatch — reinstall the latest binary",
+				`  - iii-engine version mismatch — reinstall the pinned v${IIPINNED_VERSION} binary`,
 				"    (sh script on macOS/Linux, GitHub release zip on Windows)",
 				"  - Docker Desktop not running (if you're using the Docker path)",
 				"  - Port already in use (see below)",
@@ -1616,8 +1637,8 @@ async function main() {
 		}
 		process.exit(1);
 	}
-	s.stop("iii-engine is ready");
-	await import("./src-u7kAEUC0.mjs");
+	s.stop(c.ok("iii-engine is ready"));
+	await import("./src-CzgoepGU.mjs");
 	if (await waitForAgentmemoryReady(15e3)) {
 		const consoleState = await ensureIiiConsole();
 		await maybeOfferGlobalInstall();
@@ -1675,7 +1696,7 @@ async function runStatus() {
 		const pctSaved = estFullTokens > 0 ? Math.round(tokensSaved / estFullTokens * 100) : 0;
 		p.log.success(`Connected — v${version} at ${base}`);
 		const lines = [
-			`Health:       ${status === "healthy" ? "✓ healthy" : status}`,
+			`Health:       ${status === "healthy" ? pc.green("✓ healthy") : pc.yellow(status)}`,
 			`Sessions:     ${sessions}`,
 			`Observations: ${obsCount}`,
 			`Memories:     ${memCount}`,
@@ -1683,7 +1704,7 @@ async function runStatus() {
 			`Circuit:      ${cb}`,
 			`Heap:         ${heapMB} MB`,
 			`Uptime:       ${uptime}s`,
-			`Viewer:       ${getViewerUrl()}`
+			`Viewer:       ${c.url(getViewerUrl())}`
 		];
 		if (obsCount > 0) {
 			lines.push("");
@@ -1692,9 +1713,9 @@ async function runStatus() {
 			lines.push(`  Injected:     ~${estInjectedTokens.toLocaleString()} tokens`);
 		}
 		if (flagsRes) {
-			const provider = flagsRes.provider === "llm" ? "✓ llm" : "✗ noop (no key)";
-			const embed = flagsRes.embeddingProvider === "embeddings" ? "✓ embeddings" : "bm25-only";
-			const flagRows = (flagsRes.flags || []).map((f) => `  ${f.enabled ? "✓" : "✗"} ${f.key.padEnd(32)} ${f.label}`);
+			const provider = flagsRes.provider === "llm" ? pc.green("✓ llm") : pc.yellow("✗ noop (no key)");
+			const embed = flagsRes.embeddingProvider === "embeddings" ? pc.green("✓ embeddings") : pc.dim("bm25-only");
+			const flagRows = (flagsRes.flags || []).map((f) => `  ${f.enabled ? pc.green("✓") : pc.dim("✗")} ${pc.bold(f.key.padEnd(32))} ${f.label}`);
 			lines.push("");
 			lines.push(`Provider:     ${provider}`);
 			lines.push(`Embeddings:   ${embed}`);
@@ -1715,7 +1736,7 @@ async function runStatus() {
 	}
 }
 function formatChecks(checks) {
-	return checks.map((c) => `${c.ok ? "✓" : "✗"} ${c.name}${c.hint ? `\n   ${c.hint}` : ""}`).join("\n");
+	return checks.map((c) => `${c.ok ? pc.green("✓") : pc.red("✗")} ${c.name}${c.hint ? `\n   ${c.hint}` : ""}`).join("\n");
 }
 function findLatestDebugLog(debugDir) {
 	const latestLink = join(debugDir, "latest");
@@ -2251,15 +2272,63 @@ async function runInit() {
 	].join("\n"), "Next steps");
 	p.outro(`Edit ${target} and you're set.`);
 }
+async function startServerForDemo() {
+	if (await isAgentmemoryReady()) return async () => {};
+	const startedEngine = !await isEngineRunning();
+	if (startedEngine) {
+		if (!await startEngine()) {
+			p.log.error("Could not start iii-engine for the demo.");
+			p.note(installInstructions().join("\n"), "Setup required");
+			process.exit(1);
+		}
+		if (!await waitForEngine(15e3)) {
+			p.log.error("iii-engine did not become ready within 15s.");
+			process.exit(1);
+		}
+	}
+	await import("./src-CzgoepGU.mjs");
+	if (!await waitForAgentmemoryReady(15e3)) {
+		p.log.error("agentmemory worker did not become ready within 15s.");
+		process.exit(1);
+	}
+	return async () => {
+		if (!startedEngine) return;
+		const port = getRestPort();
+		const state = readEngineState();
+		if (state?.kind === "docker") {
+			await stopDockerEngine(state.composeFile, port).catch(() => {});
+			return;
+		}
+		const pids = new Set(findEnginePidsByPort(port));
+		const pidfilePid = readEnginePidfile();
+		if (pidfilePid) pids.add(pidfilePid);
+		for (const pid of pids) await signalAndWait(pid, "SIGTERM", 3e3).catch(() => {});
+		clearEnginePidfile();
+		clearEngineState();
+		clearWorkerPidfile();
+	};
+}
 async function runDemo() {
 	const port = getRestPort();
 	const base = `http://localhost:${port}`;
 	p.intro("agentmemory demo");
-	if (!await isAgentmemoryReady()) {
+	const serve = args.includes("--serve");
+	let teardown = async () => {};
+	if (serve) teardown = await startServerForDemo();
+	else if (!await isAgentmemoryReady()) {
 		p.log.error(`agentmemory worker not reachable on port ${port} (livez probe failed). Something may be on the port but it isn't serving /agentmemory/*.`);
 		p.log.info("Start it with: npx @agentmemory/agentmemory");
+		p.log.info("Or run a one-command demo with: npx @agentmemory/agentmemory demo --serve");
 		process.exit(1);
 	}
+	try {
+		await runDemoBody(base);
+	} finally {
+		await teardown();
+	}
+	if (serve) process.exit(0);
+}
+async function runDemoBody(base) {
 	const demoProject = "/tmp/agentmemory-demo";
 	const sessions = buildDemoSessions();
 	const sSeed = p.spinner();
@@ -2281,14 +2350,14 @@ async function runDemo() {
 		`Project:       ${demoProject}`,
 		`Sessions:      ${sessions.length} seeded (${totalObs} observations)`,
 		"",
-		"Search results:",
-		...results.flatMap((r) => [`  "${r.query}"`, `    → ${r.hits} hit(s), top: ${r.topTitle.slice(0, 60)}`]),
+		c.label("Search results:"),
+		...results.flatMap((r) => [`  ${c.label(`"${r.query}"`)}`, `    ${c.dim("→")} ${c.ok(`${r.hits} hit(s)`)}, top: ${r.topTitle.slice(0, 60)}`]),
 		"",
-		`Notice: searching "database performance optimization"`,
-		`found the N+1 query fix — keyword matching can't do that.`,
+		c.accent(`Notice: searching "database performance optimization"`),
+		c.accent(`found the N+1 query fix — keyword matching can't do that.`),
 		"",
-		`Viewer:        ${getViewerUrl()}`,
-		`Clean up with: curl -X DELETE "${base}/agentmemory/sessions?project=${demoProject}"`
+		`Viewer:        ${c.url(getViewerUrl())}`,
+		`Clean up with: ${c.dim(`curl -X DELETE "${base}/agentmemory/sessions?project=${demoProject}"`)}`
 	];
 	p.note(lines.join("\n"), "demo complete");
 	p.log.success("agentmemory is working. Point your agent at it and get back to coding.");
@@ -2302,7 +2371,7 @@ function runCommand(command, commandArgs, options = { label: "command" }) {
 		encoding: "utf-8"
 	});
 	if (result.status === 0) {
-		spinner.stop(`${options.label} ✓`);
+		spinner.stop(`${options.label} ${pc.green("✓")}`);
 		return true;
 	}
 	const stderr = (result.stderr || "").toString().trim();
@@ -2313,7 +2382,7 @@ function runCommand(command, commandArgs, options = { label: "command" }) {
 		p.log.warn(msg.slice(0, 300));
 		return false;
 	}
-	spinner.stop(`${options.label} ✗`);
+	spinner.stop(`${options.label} ${pc.red("✗")}`);
 	p.log.error(msg.slice(0, 300));
 	return false;
 }
@@ -2525,19 +2594,19 @@ async function runStop() {
 		process.exit(1);
 	}
 	let allStopped = true;
-	for (const pid of candidates) {
+	for (const pid of workerCandidates) {
 		const s = p.spinner();
-		s.start(`Stopping iii-engine (pid ${pid})...`);
-		const ok = await signalAndWait(pid, "SIGTERM", 3e3);
-		s.stop(ok ? `Stopped pid ${pid}` : `Failed to stop pid ${pid}`);
+		s.start(`Stopping agentmemory worker (pid ${pid})... [flushing state]`);
+		const ok = await signalAndWait(pid, "SIGTERM", 5e3);
+		s.stop(ok ? `Stopped worker pid ${pid}` : `Failed to stop worker pid ${pid}`);
 		if (!ok) allStopped = false;
 	}
-	for (const pid of workerCandidates) {
-		if (candidates.has(pid)) continue;
+	for (const pid of candidates) {
+		if (workerCandidates.has(pid)) continue;
 		const s = p.spinner();
-		s.start(`Stopping agentmemory worker (pid ${pid})...`);
+		s.start(`Stopping iii-engine (pid ${pid})...`);
 		const ok = await signalAndWait(pid, "SIGTERM", 3e3);
-		s.stop(ok ? `Stopped worker pid ${pid}` : `Failed to stop worker pid ${pid}`);
+		s.stop(ok ? `Stopped pid ${pid}` : `Failed to stop pid ${pid}`);
 		if (!ok) allStopped = false;
 	}
 	clearEnginePidfile();
@@ -2550,10 +2619,10 @@ async function runStop() {
 	p.outro("Stopped. Memories persisted to disk; restart anytime with: npx @agentmemory/agentmemory");
 }
 async function runMcp() {
-	await import("./standalone-C1yPO519.mjs");
+	await import("./standalone-YsZFFQBM.mjs");
 }
 async function runConnectCmd() {
-	const { runConnect } = await import("./connect-bmZ5eqYN.mjs").then((n) => n.t);
+	const { runConnect } = await import("./connect-JnsJXc68.mjs").then((n) => n.n);
 	await runConnect(args.slice(1));
 }
 async function runImportJsonl() {