@cortexkit/opencode-magic-context 0.2.1 → 0.2.3

package/README.md

@@ -25,20 +25,54 @@
 
 ---
 
+## What is Magic Context?
+
+Your agent should never stop working to manage its own context. Magic Context is an OpenCode plugin that handles it entirely in the background:
+
+**1.** Transparent context compaction via a background historian — the main agent keeps working while a separate model compresses older conversation. All operations are **cache-aware** and deferred to avoid wasting cached prefixes.
+
+**2.** Cross-session project memory — architecture decisions, constraints, and preferences persist across conversations.
+
+**3.** Overnight dreamer agent that consolidates, deduplicates, and promotes memories into canonical facts, plus maintains codebase documentation.
+
+**4.** On-demand sidekick that augments prompts with relevant project context.
+
+---
+
 ## Get Started
 
-Add to your OpenCode config (`opencode.json` or `opencode.jsonc`):
+### Quick Setup (Recommended)
 
-```jsonc
-{
-  "plugins": ["@cortexkit/opencode-magic-context@latest"]
-}
+Run the interactive setup wizard — it detects your models, configures everything, and handles compatibility:
+
+**macOS / Linux:**
+```bash
+curl -fsSL https://raw.githubusercontent.com/cortexkit/opencode-magic-context/master/scripts/install.sh | bash
+```
+
+**Windows (PowerShell):**
+```powershell
+irm https://raw.githubusercontent.com/cortexkit/opencode-magic-context/master/scripts/install.ps1 | iex
+```
+
+**Or run directly (any OS):**
+```bash
+bunx @cortexkit/opencode-magic-context setup
 ```
 
-Magic Context conflicts with OpenCode's built-in compaction — the two cannot run together. To disable it:
+The wizard will:
+1. Check your OpenCode installation and available models
+2. Add the plugin and disable built-in compaction
+3. Help you pick models for historian, dreamer, and sidekick
+4. Handle oh-my-opencode compatibility if needed
+
+### Manual Setup
+
+Add to your OpenCode config (`opencode.json` or `opencode.jsonc`):
 
 ```jsonc
 {
+  "plugin": ["@cortexkit/opencode-magic-context"],
   "compaction": {
     "auto": false,
     "prune": false
@@ -46,6 +80,8 @@ Magic Context conflicts with OpenCode's built-in compaction — the two cannot r
 }
 ```
 
+> **Why disable compaction?** Magic Context manages context itself — built-in compaction interferes with its cache-aware deferred operations and would cause duplicate compression.
+
 Create `magic-context.jsonc` in your project root, `.opencode/`, or `~/.config/opencode/`:
 
 ```jsonc
@@ -63,19 +99,21 @@ Create `magic-context.jsonc` in your project root, `.opencode/`, or `~/.config/o
 
 That's it. Everything else has sensible defaults. Project config merges on top of user-wide settings.
 
----
+### Oh-My-OpenCode Users
 
-## What is Magic Context?
-
-AI coding agents forget everything the moment a conversation gets long enough. Context windows fill up, old messages get dropped, and the agent loses track of decisions it made twenty minutes ago.
-
-Magic Context fixes this with a background historian — a separate, lightweight model that compresses older conversation into structured summaries and durable facts while the main agent keeps working. The agent never stops to summarize its own history. It never notices the rewriting happening beneath it.
-
-Every mutation is **cache-aware**. Drops and rewrites are queued until the provider's cached prefix expires, so you're not paying to throw away work that's already cached.
+If you use [oh-my-opencode](https://github.com/code-yeongyu/oh-my-opencode), disable the hooks that conflict with Magic Context in your `oh-my-opencode.json`:
 
-Across sessions, architecture decisions, constraints, and preferences persist in a **cross-session memory** system. A new conversation starts with everything the previous one learned, without replaying old transcripts.
+```json
+{
+  "disabled_hooks": [
+    "context-window-monitor",
+    "preemptive-compaction",
+    "anthropic-context-window-limit-recovery"
+  ]
+}
+```
 
-And overnight, a **dreamer** agent consolidates, verifies, and improves memories — checking them against the actual codebase and merging duplicates into clean canonical facts.
+The setup wizard handles this automatically if it detects an oh-my-opencode config.
 
 ---
 

package/dist/cli/config-paths.d.ts

@@ -0,0 +1,9 @@
+export interface ConfigPaths {
+    configDir: string;
+    opencodeConfig: string;
+    opencodeConfigFormat: "json" | "jsonc" | "none";
+    magicContextConfig: string;
+    omoConfig: string | null;
+}
+export declare function detectConfigPaths(): ConfigPaths;
+//# sourceMappingURL=config-paths.d.ts.map

package/dist/cli/config-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-paths.d.ts","sourceRoot":"","sources":["../../src/cli/config-paths.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAChD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AA+BD,wBAAgB,iBAAiB,IAAI,WAAW,CA2B/C"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/opencode-helpers.d.ts

@@ -0,0 +1,19 @@
+export declare function isOpenCodeInstalled(): boolean;
+export declare function getOpenCodeVersion(): string | null;
+export declare function getAvailableModels(): string[];
+/** Group models by provider for display */
+export declare function groupModelsByProvider(models: string[]): Map<string, string[]>;
+/** Get unique providers from model list */
+export declare function getProviders(models: string[]): string[];
+/** Filter models matching any of the given patterns */
+export declare function filterModels(models: string[], patterns: string[]): string[];
+/**
+ * Build a curated model selection list for a given role.
+ * Returns models ordered by recommendation priority.
+ */
+export declare function buildModelSelection(allModels: string[], role: "historian" | "dreamer" | "sidekick"): {
+    label: string;
+    value: string;
+    recommended?: boolean;
+}[];
+//# sourceMappingURL=opencode-helpers.d.ts.map

package/dist/cli/opencode-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-helpers.d.ts","sourceRoot":"","sources":["../../src/cli/opencode-helpers.ts"],"names":[],"mappings":"AAEA,wBAAgB,mBAAmB,IAAI,OAAO,CAO7C;AAED,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAMlD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAU7C;AAED,2CAA2C;AAC3C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAU7E;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CASvD;AAED,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAE3E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAC/B,SAAS,EAAE,MAAM,EAAE,EACnB,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,UAAU,GAC3C;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,CA0E3D"}

package/dist/cli/prompts.d.ts

@@ -0,0 +1,12 @@
+export declare function closePrompts(): void;
+export declare function confirm(message: string, defaultYes?: boolean): Promise<boolean>;
+export declare function selectOne(message: string, options: {
+    label: string;
+    value: string;
+    recommended?: boolean;
+}[]): Promise<string>;
+export declare function selectMultiple(message: string, options: {
+    label: string;
+    value: string;
+}[]): Promise<string[]>;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/cli/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/cli/prompts.ts"],"names":[],"mappings":"AAwBA,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAKlF;AAED,wBAAsB,SAAS,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE,GACnE,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,wBAAsB,cAAc,CAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GAC5C,OAAO,CAAC,MAAM,EAAE,CAAC,CAcnB"}

package/dist/cli/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function runSetup(): Promise<number>;
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/cli/setup.ts"],"names":[],"mappings":"AAmJA,wBAAsB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CA8KhD"}

package/dist/cli.js

@@ -0,0 +1,451 @@
+#!/usr/bin/env node
+
+// src/cli/setup.ts
+import { existsSync as existsSync2, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+
+// src/cli/config-paths.ts
+import { existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+function getConfigDir() {
+  const envDir = process.env.OPENCODE_CONFIG_DIR?.trim();
+  if (envDir)
+    return envDir;
+  switch (process.platform) {
+    case "win32": {
+      const appData = process.env.APPDATA || join(homedir(), "AppData", "Roaming");
+      return join(appData, "opencode");
+    }
+    case "darwin":
+    case "linux":
+    default: {
+      const xdgConfig = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
+      return join(xdgConfig, "opencode");
+    }
+  }
+}
+function findOmoConfig(configDir) {
+  const locations = [
+    join(configDir, "oh-my-opencode.jsonc"),
+    join(configDir, "oh-my-opencode.json")
+  ];
+  for (const loc of locations) {
+    if (existsSync(loc))
+      return loc;
+  }
+  return null;
+}
+function detectConfigPaths() {
+  const configDir = getConfigDir();
+  let opencodeConfig;
+  let opencodeConfigFormat;
+  const jsoncPath = join(configDir, "opencode.jsonc");
+  const jsonPath = join(configDir, "opencode.json");
+  if (existsSync(jsoncPath)) {
+    opencodeConfig = jsoncPath;
+    opencodeConfigFormat = "jsonc";
+  } else if (existsSync(jsonPath)) {
+    opencodeConfig = jsonPath;
+    opencodeConfigFormat = "json";
+  } else {
+    opencodeConfig = jsonPath;
+    opencodeConfigFormat = "none";
+  }
+  return {
+    configDir,
+    opencodeConfig,
+    opencodeConfigFormat,
+    magicContextConfig: join(configDir, "magic-context.jsonc"),
+    omoConfig: findOmoConfig(configDir)
+  };
+}
+
+// src/cli/opencode-helpers.ts
+import { execSync } from "node:child_process";
+function isOpenCodeInstalled() {
+  try {
+    execSync("opencode --version", { stdio: "pipe" });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getOpenCodeVersion() {
+  try {
+    return execSync("opencode --version", { stdio: "pipe" }).toString().trim();
+  } catch {
+    return null;
+  }
+}
+function getAvailableModels() {
+  try {
+    const output = execSync("opencode models", { stdio: "pipe" }).toString().trim();
+    return output.split(`
+`).map((l) => l.trim()).filter(Boolean);
+  } catch {
+    return [];
+  }
+}
+function buildModelSelection(allModels, role) {
+  const result = [];
+  const added = new Set;
+  const addIfAvailable = (pattern, recommended = false) => {
+    const matches = allModels.filter((m) => m === pattern || m.endsWith(`/${pattern}`));
+    for (const m of matches) {
+      if (!added.has(m)) {
+        added.add(m);
+        result.push({
+          label: m,
+          value: m,
+          recommended: recommended && result.length === 0
+        });
+      }
+    }
+  };
+  if (role === "historian") {
+    addIfAvailable("claude-sonnet-4-6", true);
+    addIfAvailable("claude-sonnet-4-5");
+    addIfAvailable("gemini-3.1-pro");
+    addIfAvailable("gpt-5.4");
+    addIfAvailable("glm-5");
+    addIfAvailable("minimax-m2.7");
+    for (const m of allModels.filter((m2) => m2.startsWith("github-copilot/"))) {
+      if (!added.has(m)) {
+        added.add(m);
+        result.push({ label: `${m} (free with Copilot)`, value: m });
+      }
+    }
+  } else if (role === "dreamer") {
+    for (const m of allModels.filter((m2) => m2.startsWith("ollama/"))) {
+      if (!added.has(m)) {
+        added.add(m);
+        result.push({ label: `${m} (local)`, value: m, recommended: result.length === 0 });
+      }
+    }
+    addIfAvailable("claude-sonnet-4-6", result.length === 0);
+    addIfAvailable("gemini-3-flash");
+    addIfAvailable("glm-5");
+    addIfAvailable("minimax-m2.7");
+    addIfAvailable("gpt-5.4-mini");
+    for (const m of allModels.filter((m2) => m2.startsWith("github-copilot/"))) {
+      if (!added.has(m)) {
+        added.add(m);
+        result.push({ label: `${m} (free with Copilot)`, value: m });
+      }
+    }
+  } else if (role === "sidekick") {
+    for (const m of allModels.filter((m2) => m2.startsWith("cerebras/"))) {
+      if (!added.has(m)) {
+        added.add(m);
+        result.push({
+          label: `${m} (fastest)`,
+          value: m,
+          recommended: result.length === 0
+        });
+      }
+    }
+    addIfAvailable("gpt-5-nano");
+    addIfAvailable("gemini-3-flash");
+    addIfAvailable("gpt-5.4-mini");
+  }
+  return result;
+}
+
+// src/cli/prompts.ts
+import { createReadStream } from "node:fs";
+import { createInterface } from "node:readline";
+function getInput() {
+  if (!process.stdin.isTTY) {
+    try {
+      return createReadStream("/dev/tty");
+    } catch {}
+  }
+  return process.stdin;
+}
+var rl = createInterface({ input: getInput(), output: process.stdout });
+function ask(question) {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => resolve(answer.trim()));
+  });
+}
+function closePrompts() {
+  rl.close();
+}
+async function confirm(message, defaultYes = true) {
+  const hint = defaultYes ? "Y/n" : "y/N";
+  const answer = await ask(`  ${message} [${hint}] `);
+  if (answer === "")
+    return defaultYes;
+  return answer.toLowerCase().startsWith("y");
+}
+async function selectOne(message, options) {
+  console.log(`  ${message}`);
+  console.log("");
+  for (let i = 0;i < options.length; i++) {
+    const opt = options[i];
+    const rec = opt.recommended ? " (recommended)" : "";
+    const num = `${i + 1}`.padStart(3);
+    console.log(`  ${num}) ${opt.label}${rec}`);
+  }
+  console.log("");
+  while (true) {
+    const answer = await ask("  Enter number: ");
+    const idx = Number.parseInt(answer, 10) - 1;
+    if (idx >= 0 && idx < options.length) {
+      return options[idx].value;
+    }
+    console.log("  Invalid selection, try again.");
+  }
+}
+
+// src/cli/setup.ts
+var PLUGIN_NAME = "@cortexkit/opencode-magic-context";
+function printStep(step, total, message) {
+  console.log(`  [${step}/${total}] ${message}`);
+}
+function printSuccess(message) {
+  console.log(`  ✓ ${message}`);
+}
+function printWarning(message) {
+  console.log(`  ⚠ ${message}`);
+}
+function printInfo(message) {
+  console.log(`  → ${message}`);
+}
+function ensureDir(dir) {
+  if (!existsSync2(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+function stripJsoncComments(text) {
+  return text.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "");
+}
+function readJsonc(path) {
+  const content = readFileSync(path, "utf-8");
+  try {
+    return JSON.parse(stripJsoncComments(content));
+  } catch {
+    return {};
+  }
+}
+function writeJsonc(path, data) {
+  writeFileSync(path, JSON.stringify(data, null, 2) + `
+`);
+}
+function addPluginToOpenCodeConfig(configPath, format) {
+  ensureDir(dirname(configPath));
+  if (format === "none") {
+    const config2 = {
+      plugin: [PLUGIN_NAME],
+      compaction: { auto: false, prune: false }
+    };
+    writeJsonc(configPath, config2);
+    return;
+  }
+  const config = readJsonc(configPath);
+  const plugins = config.plugin ?? [];
+  const hasPlugin = plugins.some((p) => p === PLUGIN_NAME || p.startsWith(`${PLUGIN_NAME}@`));
+  if (!hasPlugin) {
+    plugins.push(PLUGIN_NAME);
+    config.plugin = plugins;
+  }
+  const compaction = config.compaction ?? {};
+  compaction.auto = false;
+  compaction.prune = false;
+  config.compaction = compaction;
+  writeJsonc(configPath, config);
+}
+function writeMagicContextConfig(configPath, options) {
+  const config = {};
+  if (options.historianModel) {
+    config.historian = { model: options.historianModel };
+  }
+  if (options.dreamerEnabled) {
+    const dreamer = { enabled: true };
+    if (options.dreamerModel) {
+      dreamer.model = options.dreamerModel;
+    }
+    config.dreamer = dreamer;
+  } else {
+    config.dreamer = { enabled: false };
+  }
+  if (options.sidekickEnabled) {
+    const sidekick = { enabled: true };
+    if (options.sidekickModel) {
+      sidekick.model = options.sidekickModel;
+    }
+    config.sidekick = sidekick;
+  }
+  writeJsonc(configPath, config);
+}
+function disableOmoHooks(omoConfigPath) {
+  const config = readJsonc(omoConfigPath);
+  const disabledHooks = config.disabled_hooks ?? [];
+  const hooksToDisable = [
+    "context-window-monitor",
+    "preemptive-compaction",
+    "anthropic-context-window-limit-recovery"
+  ];
+  for (const hook of hooksToDisable) {
+    if (!disabledHooks.includes(hook)) {
+      disabledHooks.push(hook);
+    }
+  }
+  config.disabled_hooks = disabledHooks;
+  writeJsonc(omoConfigPath, config);
+}
+async function runSetup() {
+  console.log("");
+  console.log("  ✨ Magic Context — Setup Wizard");
+  console.log("  ═══════════════════════════════");
+  console.log("");
+  const totalSteps = 8;
+  let step = 1;
+  printStep(step++, totalSteps, "Checking OpenCode installation...");
+  const installed = isOpenCodeInstalled();
+  if (!installed) {
+    printWarning("OpenCode not found on PATH.");
+    const shouldContinue = await confirm("Continue setup anyway?", false);
+    if (!shouldContinue) {
+      console.log("");
+      printInfo("Install OpenCode: https://opencode.ai");
+      console.log("");
+      closePrompts();
+      return 1;
+    }
+  } else {
+    const version = getOpenCodeVersion();
+    printSuccess(`OpenCode ${version ?? ""} detected`);
+  }
+  console.log("");
+  printStep(step++, totalSteps, "Fetching available models...");
+  const allModels = installed ? getAvailableModels() : [];
+  if (allModels.length > 0) {
+    printSuccess(`Found ${allModels.length} models`);
+  } else {
+    printWarning("No models found (OpenCode not installed or no providers configured)");
+    printInfo("You can configure models manually in magic-context.jsonc later");
+  }
+  console.log("");
+  const paths = detectConfigPaths();
+  printStep(step++, totalSteps, "Configuring OpenCode...");
+  addPluginToOpenCodeConfig(paths.opencodeConfig, paths.opencodeConfigFormat);
+  printSuccess(`Plugin added to ${paths.opencodeConfig}`);
+  printInfo("Disabled built-in compaction (auto=false, prune=false)");
+  printInfo("Magic Context handles context management — built-in compaction would interfere");
+  console.log("");
+  printStep(step++, totalSteps, "Configure historian (background context compressor)...");
+  console.log("");
+  let historianModel = null;
+  if (allModels.length > 0) {
+    const historianOptions = buildModelSelection(allModels, "historian");
+    if (historianOptions.length > 0) {
+      historianModel = await selectOne("Select a model for historian (compresses conversation history):", historianOptions);
+      printSuccess(`Historian model: ${historianModel}`);
+    } else {
+      printInfo("No suitable historian models found. Using built-in fallback chain.");
+    }
+  } else {
+    printInfo("Skipping model selection (no models available). Using built-in fallback chain.");
+  }
+  console.log("");
+  printStep(step++, totalSteps, "Configure dreamer (overnight memory maintenance)...");
+  console.log("");
+  printInfo("The dreamer runs overnight to consolidate, verify, and maintain project memories.");
+  const dreamerEnabled = await confirm("Enable dreamer?", true);
+  let dreamerModel = null;
+  if (dreamerEnabled && allModels.length > 0) {
+    const dreamerOptions = buildModelSelection(allModels, "dreamer");
+    if (dreamerOptions.length > 0) {
+      dreamerModel = await selectOne("Select a model for dreamer (runs in background, local LLMs ideal):", dreamerOptions);
+      printSuccess(`Dreamer model: ${dreamerModel}`);
+    } else {
+      printInfo("No suitable dreamer models found. Using built-in fallback chain.");
+    }
+  } else if (dreamerEnabled) {
+    printInfo("Using built-in fallback chain for dreamer.");
+  }
+  console.log("");
+  printStep(step++, totalSteps, "Configure sidekick (on-demand prompt augmentation)...");
+  console.log("");
+  printInfo("Sidekick augments prompts with project context via /ctx-aug command.");
+  const sidekickEnabled = await confirm("Enable sidekick?", false);
+  let sidekickModel = null;
+  if (sidekickEnabled && allModels.length > 0) {
+    const sidekickOptions = buildModelSelection(allModels, "sidekick");
+    if (sidekickOptions.length > 0) {
+      sidekickModel = await selectOne("Select a model for sidekick (fast models preferred):", sidekickOptions);
+      printSuccess(`Sidekick model: ${sidekickModel}`);
+    } else {
+      printInfo("No suitable sidekick models found. Using built-in fallback chain.");
+    }
+  } else if (sidekickEnabled) {
+    printInfo("Using built-in fallback chain for sidekick.");
+  }
+  console.log("");
+  writeMagicContextConfig(paths.magicContextConfig, {
+    historianModel,
+    dreamerEnabled,
+    dreamerModel,
+    sidekickEnabled,
+    sidekickModel
+  });
+  printSuccess(`Config written to ${paths.magicContextConfig}`);
+  console.log("");
+  printStep(step++, totalSteps, "Checking for oh-my-opencode...");
+  if (paths.omoConfig) {
+    printWarning(`Found oh-my-opencode config: ${paths.omoConfig}`);
+    printInfo("The following hooks may interfere with Magic Context:");
+    console.log("    • context-window-monitor");
+    console.log("    • preemptive-compaction");
+    console.log("    • anthropic-context-window-limit-recovery");
+    console.log("");
+    const shouldDisable = await confirm("Disable these hooks in oh-my-opencode?", true);
+    if (shouldDisable) {
+      disableOmoHooks(paths.omoConfig);
+      printSuccess("Hooks disabled in oh-my-opencode config");
+    } else {
+      printWarning("Skipped — you may experience context management conflicts");
+    }
+  } else {
+    printSuccess("No oh-my-opencode config found (no conflicts)");
+  }
+  console.log("");
+  console.log("  ═══════════════════════════════");
+  console.log("  ✨ Setup complete!");
+  console.log("");
+  console.log("  What was configured:");
+  console.log(`    • Plugin: ${PLUGIN_NAME}`);
+  console.log(`    • Compaction: disabled (Magic Context manages context)`);
+  if (historianModel)
+    console.log(`    • Historian: ${historianModel}`);
+  if (dreamerEnabled)
+    console.log(`    • Dreamer: enabled${dreamerModel ? ` (${dreamerModel})` : ""}`);
+  if (sidekickEnabled)
+    console.log(`    • Sidekick: enabled${sidekickModel ? ` (${sidekickModel})` : ""}`);
+  console.log("");
+  console.log("  Run 'opencode' to start!");
+  console.log("");
+  closePrompts();
+  return 0;
+}
+
+// src/cli/index.ts
+var command = process.argv[2];
+if (command === "setup") {
+  runSetup().then((code) => process.exit(code));
+} else {
+  console.log("");
+  console.log("  Magic Context CLI");
+  console.log("  ─────────────────");
+  console.log("");
+  console.log("  Commands:");
+  console.log("    setup    Interactive setup wizard");
+  console.log("");
+  console.log("  Usage:");
+  console.log("    bunx @cortexkit/opencode-magic-context setup");
+  console.log("    npx @cortexkit/opencode-magic-context setup");
+  console.log("");
+  process.exit(command ? 1 : 0);
+}

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@cortexkit/opencode-magic-context",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "description": "OpenCode plugin for Magic Context — cross-session memory and context management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "bin": {
+    "opencode-magic-context": "dist/cli.js"
+  },
   "author": "ualtinok",
   "license": "MIT",
   "keywords": [
@@ -23,10 +26,11 @@
   },
   "files": [
     "dist",
+    "scripts/install.sh",
     "README.md"
   ],
   "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target bun --format esm --external @huggingface/transformers --external @opencode-ai/plugin && tsc --emitDeclarationOnly",
+    "build": "bun build src/index.ts --outdir dist --target bun --format esm --external @huggingface/transformers --external @opencode-ai/plugin && bun build src/cli/index.ts --outfile dist/cli.js --target node --format esm && tsc --emitDeclarationOnly",
     "typecheck": "tsc --noEmit && tsc -p tsconfig.scripts.json",
     "test": "bun test",
     "lint": "biome check .",

package/scripts/install.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Magic Context — Interactive Setup
+# Usage: curl -fsSL https://raw.githubusercontent.com/cortexkit/opencode-magic-context/master/scripts/install.sh | bash
+
+PACKAGE="@cortexkit/opencode-magic-context"
+
+main() {
+  echo ""
+  echo "  ✨ Magic Context — Setup"
+  echo "  ────────────────────────"
+  echo ""
+
+  # Detect runtime
+  if command -v bun &>/dev/null; then
+    echo "  → Using bun"
+    echo ""
+    bunx "$PACKAGE" setup </dev/tty
+  elif command -v npx &>/dev/null; then
+    echo "  → Using npx"
+    echo ""
+    npx -y "$PACKAGE" setup </dev/tty
+  else
+    echo "  ✗ Neither bun nor npx found."
+    echo ""
+    echo "  Install one of:"
+    echo "    • bun:  curl -fsSL https://bun.sh/install | bash"
+    echo "    • node: https://nodejs.org"
+    echo ""
+    exit 1
+  fi
+}
+
+main "$@"