open-mem 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.14.0] - 2026-02-23
+
+### Added
+- **Interactive setup wizard** — `npx open-mem` now launches a beautiful interactive onboarding wizard (powered by `@clack/prompts`) that guides users through provider selection, dashboard, workflow mode, and context file configuration. Use `--quick` to skip the wizard.
+- **OpenCode session bridge** — when no API key is configured, open-mem automatically routes AI compression through OpenCode's own session model. Zero-config AI compression for all users, regardless of auth method (env vars, OAuth, Copilot, etc.).
+- **Smart provider detection** — at plugin init, queries OpenCode's configured providers via the SDK client and gives actionable guidance instead of generic warnings.
+
+### Changed
+- `chat.message` hook now accepts the new OpenCode model format (`{ providerID, modelID }` object alongside legacy string).
+- Auto-detect provider option updated to reflect automatic OpenCode fallback — no separate API key warning removed.
+- Wizard messaging reflects that AI compression works out-of-the-box without extra configuration.
+
 ## [0.13.0] - 2026-02-23
 
 ### Added

package/bin/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // open-mem — Plugin Installer for OpenCode
-// Usage: npx open-mem [--global] [--force] [--uninstall] [--dry-run] [--help] [--version]
+// Usage: npx open-mem [--global] [--force] [--quick] [--uninstall] [--dry-run] [--help] [--version]
 
 import fs from "node:fs";
 import os from "node:os";
@@ -36,6 +36,7 @@ const flagDryRun = args.includes("--dry-run");
 const flagForce = args.includes("--force");
 const flagHelp = args.includes("--help") || args.includes("-h");
 const flagVersion = args.includes("--version") || args.includes("-v");
+const flagQuick = args.includes("--quick");
 
 // ── unknown flag validation ─────────────────────────────────────────
 const KNOWN_FLAGS = new Set([
@@ -43,6 +44,7 @@ const KNOWN_FLAGS = new Set([
 	"--uninstall",
 	"--dry-run",
 	"--force",
+	"--quick",
 	"--help",
 	"-h",
 	"--version",
@@ -91,7 +93,8 @@ ${BOLD}USAGE${RESET}
   npx open-mem [flags]
 
 ${BOLD}FLAGS${RESET}
-  ${DIM}(none)${RESET}        Add open-mem to local .opencode/opencode.json
+  ${DIM}(none)${RESET}        Interactive setup wizard (TTY only)
+  --quick       Skip wizard, install directly (non-interactive)
   --global      Target ~/.config/opencode/opencode.json instead
   --uninstall   Remove open-mem from all discovered config files
   --dry-run     Preview changes without writing anything
@@ -627,19 +630,239 @@ ${BOLD}Next steps:${RESET}
 	process.stdout.write(`\n${BOLD}Docs:${RESET} ${DOCS_URL}\n`);
 }
 
+// ── wizard flow ────────────────────────────────────────────────────────
+
+async function runWizard() {
+	const p = await import("@clack/prompts");
+
+	p.intro("open-mem — setup wizard");
+
+	// Detect if plugin is already installed somewhere
+	const existingLocal = findUp(process.cwd());
+	const globalDir = path.join(os.homedir(), ".config", "opencode");
+	const existingGlobal = ["opencode.jsonc", "opencode.json"]
+		.map((n) => path.join(globalDir, n))
+		.find((p) => fs.existsSync(p));
+
+	let alreadyInstalled = false;
+	for (const cfgPath of [existingLocal, existingGlobal].filter(Boolean)) {
+		const cfg = readConfig(cfgPath);
+		if (cfg && cfg.data && findPluginEntry(cfg.data) !== -1) {
+			alreadyInstalled = true;
+			p.log.info(`Plugin already configured in ${cfgPath} — reconfiguring settings.`);
+			break;
+		}
+	}
+
+	const answers = await p.group({
+		scope: () => p.select({
+			message: "Where to install?",
+			options: [
+				{ value: "local", label: "This project", hint: ".opencode/opencode.json" },
+				{ value: "global", label: "Global", hint: "~/.config/opencode/opencode.json" },
+			],
+		}),
+
+		provider: () => p.select({
+			message: "AI compression provider",
+			options: [
+				{ value: "auto", label: "Auto-detect", hint: "uses your environment keys, or OpenCode's model as fallback — recommended" },
+				{ value: "google", label: "Google Gemini", hint: "free tier available" },
+				{ value: "anthropic", label: "Anthropic", hint: "Claude models" },
+				{ value: "bedrock", label: "AWS Bedrock", hint: "uses AWS credentials" },
+				{ value: "openai", label: "OpenAI", hint: "GPT models" },
+				{ value: "openrouter", label: "OpenRouter", hint: "100+ models" },
+				{ value: "none", label: "None", hint: "basic metadata only, no AI key needed" },
+			],
+		}),
+
+		dashboard: () => p.confirm({
+			message: "Enable web dashboard?",
+			initialValue: false,
+		}),
+
+		mode: () => p.select({
+			message: "Workflow mode",
+			options: [
+				{ value: "code", label: "Code", hint: "optimized for coding sessions — default" },
+				{ value: "research", label: "Research", hint: "broader knowledge capture" },
+			],
+		}),
+
+		folderContext: () => p.select({
+			message: "Auto-generate context files per folder?",
+			options: [
+				{ value: "AGENTS.md", label: "AGENTS.md", hint: "OpenCode default" },
+				{ value: "CLAUDE.md", label: "CLAUDE.md", hint: "for Claude Code users" },
+				{ value: "disabled", label: "Disabled", hint: "no auto-generated files" },
+			],
+		}),
+	}, {
+		onCancel: () => {
+			p.cancel("Setup cancelled.");
+			process.exit(0);
+		},
+	});
+
+	// Apply the configuration
+	const s = p.spinner();
+
+	// 1. Add plugin to opencode config (unless already installed)
+	if (!alreadyInstalled) {
+		s.start("Adding open-mem to OpenCode config");
+		const isGlobal = answers.scope === "global";
+
+		// Determine target path based on wizard scope answer
+		let target;
+		if (isGlobal) {
+			const gDir = path.join(os.homedir(), ".config", "opencode");
+			target = ["opencode.jsonc", "opencode.json"]
+				.map((n) => path.join(gDir, n))
+				.find((p) => fs.existsSync(p)) || path.join(gDir, "opencode.json");
+		} else {
+			const found = findUp(process.cwd());
+			target = found || path.join(process.cwd(), ".opencode", "opencode.json");
+		}
+
+		const config = readConfig(target);
+		if (!config) {
+			writeNewConfig(target);
+		} else if (config.data) {
+			addPluginEntry(target, config.raw, config.data);
+		} else {
+			p.log.error(`Could not parse ${target} — fix the JSON/JSONC syntax first.`);
+			process.exit(1);
+		}
+		s.stop("Plugin configured");
+	}
+
+	// 2. Write .open-mem/config.json (only if non-default choices)
+	const projectConfig = {};
+	if (answers.provider !== "auto" && answers.provider !== "none" && answers.provider !== "google") {
+		projectConfig.provider = answers.provider;
+	}
+	if (answers.dashboard) {
+		projectConfig.dashboardEnabled = true;
+	}
+	if (answers.mode !== "code") {
+		projectConfig.mode = answers.mode;
+	}
+	if (answers.folderContext === "disabled") {
+		projectConfig.folderContextEnabled = false;
+	} else if (answers.folderContext === "CLAUDE.md") {
+		projectConfig.folderContextFilename = "CLAUDE.md";
+	}
+
+	if (Object.keys(projectConfig).length > 0) {
+		s.start("Writing project config");
+		const configDir = path.join(process.cwd(), ".open-mem");
+		const configPath = path.join(configDir, "config.json");
+
+		// Read existing config if present, merge
+		let existing = {};
+		if (fs.existsSync(configPath)) {
+			try { existing = JSON.parse(fs.readFileSync(configPath, "utf8")); } catch {}
+		}
+
+		const merged = { ...existing, ...projectConfig };
+
+		if (flagDryRun) {
+			s.stop("Project config (dry-run)");
+			p.log.info(`Would write to ${configPath}:`);
+			p.log.message(JSON.stringify(merged, null, 2));
+		} else {
+			fs.mkdirSync(configDir, { recursive: true });
+			fs.writeFileSync(configPath, JSON.stringify(merged, null, 2) + "\n", "utf8");
+			s.stop("Project config saved");
+		}
+	}
+
+	// 3. Show summary
+	const providerLabels = {
+		auto: "Auto-detect",
+		google: "Google Gemini",
+		anthropic: "Anthropic",
+		bedrock: "AWS Bedrock",
+		openai: "OpenAI",
+		openrouter: "OpenRouter",
+		none: "None (basic extractor)",
+	};
+
+	const summaryLines = [
+		`Provider:    ${providerLabels[answers.provider]}`,
+		`Dashboard:   ${answers.dashboard ? "enabled" : "disabled"}`,
+		`Mode:        ${answers.mode}`,
+		`Context:     ${answers.folderContext === "disabled" ? "disabled" : answers.folderContext}`,
+	];
+	p.note(summaryLines.join("\n"), "Configuration");
+	if (answers.provider === "auto") {
+		const detected = detectAIProviders();
+		if (detected.length > 0) {
+			const names = detected.map((d) => d.name).join(", ");
+			p.log.info(`AI compression: ${names} detected \u2014 will use directly`);
+		} else {
+			p.log.info("AI compression: will use your OpenCode session model automatically");
+			p.log.message("  No separate API key needed \u2014 open-mem piggybacks on your active provider.");
+			p.log.message("  Optional: set GOOGLE_GENERATIVE_AI_API_KEY for a dedicated (free) compression model.");
+		}
+	}
+
+	// 4. Show env var instructions for chosen provider
+	const envVarInstructions = {
+		auto: null,
+		google: "export GOOGLE_GENERATIVE_AI_API_KEY=...  # free key: https://aistudio.google.com/apikey",
+		anthropic: "export ANTHROPIC_API_KEY=sk-ant-...",
+		bedrock: "# Configure AWS credentials (AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY or AWS_PROFILE)",
+		openai: "export OPENAI_API_KEY=sk-...",
+		openrouter: "export OPENROUTER_API_KEY=sk-or-...",
+		none: null,
+	};
+
+	if (envVarInstructions[answers.provider]) {
+		p.note(envVarInstructions[answers.provider], "Set this environment variable");
+	}
+
+	if (answers.dashboard) {
+		p.log.info("Dashboard will be available at http://localhost:3737");
+	}
+
+	p.outro("open-mem is ready! Start OpenCode to begin.");
+}
+
 // ── main ────────────────────────────────────────────────────────────
 
-async function main() {
-	const version = getVersion();
+function printHeader(version) {
 	process.stdout.write(
 		`\n${BOLD}open-mem${RESET}${version ? ` ${DIM}v${version}${RESET}` : ""} ${DIM}— Persistent memory plugin for OpenCode${RESET}\n\n`,
 	);
-
-	if (flagDryRun) info(`${YELLOW}Dry-run mode${RESET} — no files will be modified.\n`);
-
+}
+async function main() {
+	const version = getVersion();
+	// Flags that bypass the wizard entirely
 	if (flagUninstall) {
+		printHeader(version);
+		if (flagDryRun) info(`${YELLOW}Dry-run mode${RESET} — no files will be modified.\n`);
 		await uninstall();
+		return;
+	}
+
+	// Interactive wizard: default when TTY and no bypass flags
+	const useWizard = process.stdout.isTTY && process.stdin.isTTY && !flagQuick && !flagForce && !flagGlobal;
+
+	if (useWizard) {
+		try {
+			await runWizard();
+		} catch (e) {
+			// If clack fails to load or crashes, fall back to quick install
+			warn(`Wizard failed (${e.message}), falling back to quick install.`);
+			printHeader(version);
+			if (flagDryRun) info(`${YELLOW}Dry-run mode${RESET} — no files will be modified.\n`);
+			await install();
+		}
 	} else {
+		// Quick install (existing behavior)
+		printHeader(version);
+		if (flagDryRun) info(`${YELLOW}Dry-run mode${RESET} — no files will be modified.\n`);
 		await install();
 	}
 }

package/dist/ai/opencode-bridge.d.ts

@@ -0,0 +1,27 @@
+import type { LanguageModel } from "ai";
+/**
+ * Create a generateText-compatible function that routes through OpenCode's session API.
+ *
+ * This creates a dedicated background session for open-mem's AI calls,
+ * reuses it across all compression/summarization requests, and extracts
+ * the text response.
+ */
+export declare function createOpenCodeBridge(client: unknown): {
+    generateText: (options: {
+        model: LanguageModel;
+        prompt?: string;
+        system?: string;
+        maxOutputTokens?: number;
+        [key: string]: any;
+    }) => Promise<{
+        text: string;
+        finishReason: string;
+        usage: {
+            promptTokens: number;
+            completionTokens: number;
+            totalTokens: number;
+        };
+    }>;
+    cleanup: () => Promise<void>;
+} | null;
+//# sourceMappingURL=opencode-bridge.d.ts.map

package/dist/ai/opencode-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-bridge.d.ts","sourceRoot":"","sources":["../../src/ai/opencode-bridge.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAWxC;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO;4BAuCR;QAC1C,KAAK,EAAE,aAAa,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACnB,KAAG,OAAO,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,gBAAgB,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/E,CAAC;mBAgCwB,OAAO,CAAC,IAAI,CAAC;SAYvC"}

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

@@ -22,8 +22,12 @@ export declare function persistChatMessage(input: ChatCaptureInput): boolean;
 export declare function createChatCaptureHook(observations: ObservationRepository, sessions: SessionRepository, projectPath: string, sensitivePatterns?: string[]): (input: {
     sessionID: string;
     agent?: string;
-    model?: string;
+    model?: string | {
+        providerID: string;
+        modelID: string;
+    };
     messageID?: string;
+    variant?: string;
 }, output: {
     message: unknown;
     parts: unknown[];

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

@@ -1 +1 @@
-{"version":3,"file":"chat-capture.d.ts","sourceRoot":"","sources":["../../src/hooks/chat-capture.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AA6CxD,MAAM,WAAW,gBAAgB;IAChC,YAAY,EAAE,qBAAqB,CAAC;IACpC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAgDnE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,YAAY,EAAE,qBAAqB,EACnC,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,EAAE,MAAM,EACnB,iBAAiB,GAAE,MAAM,EAAO,IAG/B,OAAO;IACN,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,EACD,QAAQ;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,KAC5C,OAAO,CAAC,IAAI,CAAC,CAqBhB"}
+{"version":3,"file":"chat-capture.d.ts","sourceRoot":"","sources":["../../src/hooks/chat-capture.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AA6CxD,MAAM,WAAW,gBAAgB;IAChC,YAAY,EAAE,qBAAqB,CAAC;IACpC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAgDnE;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACpC,YAAY,EAAE,qBAAqB,EACnC,QAAQ,EAAE,iBAAiB,EAC3B,WAAW,EAAE,MAAM,EACnB,iBAAiB,GAAE,MAAM,EAAO,IAG/B,OAAO;IACN,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,EACD,QAAQ;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,KAC5C,OAAO,CAAC,IAAI,CAAC,CAqBhB"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgDA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA2ClD;;;GAGG;AACH,wBAA8B,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CA4RvE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgDA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA8FlD;;;GAGG;AACH,wBAA8B,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAuTvE"}