claude-smart 0.2.46 → 0.2.48

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
   "plugins": [
     {
       "name": "claude-smart",
-      "version": "0.2.46",
+      "version": "0.2.48",
       "source": "./plugin",
       "description": "Turns corrections into Preferences, Project-specific skills, and Shared skills — uses Claude Code, Codex, or OpenCode as the LLM backend (no external API key required)"
     }

package/README.md

@@ -13,7 +13,7 @@
     <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License">
   </a>
   <a href="plugin/pyproject.toml">
-    <img src="https://img.shields.io/badge/version-0.2.46-green.svg" alt="Version">
+    <img src="https://img.shields.io/badge/version-0.2.48-green.svg" alt="Version">
   </a>
   <a href="plugin/pyproject.toml">
     <img src="https://img.shields.io/badge/python-%3E%3D3.12-brightgreen.svg" alt="Python">
@@ -27,6 +27,9 @@
   <a href="https://discord.gg/7fnCxahase">
     <img src="https://img.shields.io/badge/Discord-Join%20community-5865F2?logo=discord&logoColor=white" alt="Discord">
   </a>
+  <a href="https://github.com/ReflexioAI/reflexio">
+    <img src="https://img.shields.io/github/stars/ReflexioAI/reflexio?style=flat&logo=github&label=Star%20reflexio&color=yellow&cacheSeconds=3600" alt="Star reflexio on GitHub">
+  </a>
 </p>
 
 <p align="center">
@@ -47,6 +50,10 @@
   <b>vs <code>claude-mem</code>:</b> ~3× better at turning your corrections into rules Claude follows, ~50% more of your guidance is retained. <a href="EXPERIMENT.md"><b>Read the benchmark →</b></a>
 </p>
 
+<p align="center">
+  ⭐ Built on the open-source <a href="https://github.com/ReflexioAI/reflexio"><b>reflexio</b></a> engine — if claude-smart helps you, <a href="https://github.com/ReflexioAI/reflexio"><b>star reflexio on GitHub</b></a>.
+</p>
+
 ---
 
 ## Quick Start
@@ -54,12 +61,12 @@
 ### Claude Code
 
 ```bash
-npx claude-smart install     # or: uvx claude-smart install
+npx claude-smart install
 ```
 
 Then restart Claude Code.
 
-Requires Node.js (for `npx`) or uv (for `uvx`) to already exist.
+Requires Node.js (for `npx`) to already exist.
 
 Alternatively, install via Claude Code's plugin marketplace:
 
@@ -71,7 +78,7 @@ claude plugin install claude-smart@reflexioai
 To uninstall:
 
 ```bash
-npx claude-smart uninstall     # or: uvx claude-smart uninstall
+npx claude-smart uninstall
 ```
 
 Or, if installed via the plugin marketplace:
@@ -104,9 +111,9 @@ Restart Codex after uninstalling. The uninstaller stops local claude-smart servi
 npx claude-smart install --host opencode
 ```
 
-Then restart OpenCode in your project so it loads the plugin from `opencode.json`, the documented project config file. If that project does not already have a root config but does have `.opencode/opencode.json` or `.opencode/opencode.jsonc`, the installer updates that existing file instead of creating a second config. If both locations exist, the root config wins. Use `--global` to install into `~/.config/opencode/opencode.json` for all OpenCode projects on this machine. When run through `npx`, long-lived local services are prepared from OpenCode's installed plugin package on the next OpenCode launch instead of from npm's temporary `npx` cache.
+Then restart OpenCode in your project so it loads the plugin from `opencode.json`, the documented project config file. If that project does not already have a root config but does have `.opencode/opencode.json` or `.opencode/opencode.jsonc`, the installer updates that existing file instead of creating a second config. If both locations exist, the root config wins. Use `--global` to install into `~/.config/opencode/opencode.json` for all OpenCode projects on this machine. The installer copies the active package to `~/.claude-smart/opencode/claude-smart`, prepares that runtime immediately, and writes a `file://` plugin entry so OpenCode reloads the same prepared package after restart.
 
-OpenCode support is new and uses OpenCode's npm plugin loader to inject relevant learned context before each model request. Learning extraction runs `opencode run --pure` from an isolated temp project, so it uses OpenCode's default model unless you set `CLAUDE_SMART_OPENCODE_MODEL=provider/model`. Set that env var if your normal project config pins a different provider or model.
+OpenCode support is new and uses OpenCode's plugin loader to inject relevant learned context before each model request. Learning extraction runs `opencode run --pure` from an isolated temp project, so it uses OpenCode's default model unless you set `CLAUDE_SMART_OPENCODE_MODEL=provider/model`. Set that env var if your normal project config pins a different provider or model.
 
 To uninstall:
 
@@ -114,7 +121,7 @@ To uninstall:
 npx claude-smart uninstall --host opencode
 ```
 
-Restart OpenCode after uninstalling. The uninstaller removes only the `claude-smart` entry from OpenCode's plugin list; learned data under `~/.reflexio/` and `~/.claude-smart/` is preserved and shared across hosts.
+Restart OpenCode after uninstalling. The uninstaller removes the `claude-smart` entry from OpenCode's plugin list and deletes the copied OpenCode package; learned data under `~/.reflexio/` and `~/.claude-smart/` is preserved and shared across hosts.
 
 Developing the plugin itself? See [DEVELOPER.md](./DEVELOPER.md#developing-locally) for what the installer does, manual toggles via `/plugins`, and clone-based development.
 
@@ -194,10 +201,10 @@ Under the hood: hooks watch your turns, tool calls, and assistant replies, auto-
 **Citations.** At the end of a reply, the assistant may append a short marker:
 
 ```
-✨ 2 claude-smart learnings applied [cs:s1-252,p1-5aed]
+✨ claude-smart rule applied: [git safety](http://localhost:3001/rules/s1-123) | [brief answer preference](http://localhost:3001/rules/p1-pref) · [⚡Reflexio](https://github.com/ReflexioAI/reflexio)
 ```
 
-That signals a preference (`p…`) or skill (`s…`) materially shaped the reply.
+That signals a preference or skill materially shaped the reply.
 Open the session's detail page in the [dashboard](http://localhost:3001) to see the exact cited item.
 
 See [ARCHITECTURE.md](./ARCHITECTURE.md) for hooks, data flow, and reflexio details.
@@ -235,6 +242,7 @@ Advanced users can tune claude-smart via environment variables — see [DEVELOPE
 | `~/.codex/config.toml` | Codex plugin state, hook feature flags, and per-hook trust entries after `claude-smart install --host codex`. |
 | `~/.codex/plugins/cache/reflexioai/claude-smart/<version>/` | Codex's cached install of the `claude-smart` plugin from the `ReflexioAI` marketplace. |
 | `opencode.json` / `opencode.jsonc`, or existing `.opencode/opencode.json*` | OpenCode local plugin config patched by `claude-smart install --host opencode`; the installer updates only the claude-smart entry in OpenCode's plugin list. |
+| `~/.claude-smart/opencode/claude-smart/` | OpenCode's stable local copy of the active npm package. OpenCode config points here with `file://` so restarts do not re-resolve `claude-smart` from npm. |
 | `~/.reflexio/plugin-root` | Self-healed symlink to the active plugin dir (managed by `ensure-plugin-root.sh` — written on install, refreshed each `SessionStart`). Claude Code slash commands and Codex shell-command helpers resolve through it, so don't delete it; if you do, the next session will recreate it. |
 | `~/.claude-smart/sessions/{session_id}.jsonl` | Per-session buffer. User turns, assistant turns, tool invocations, `{"published_up_to": N}` watermarks. Safe to inspect and safe to delete — everything past the latest watermark has already been written to reflexio's DB. |
 | `~/.claude-smart/node/current/` | Private Node.js/npm runtime used by hooks and the dashboard after install. |
@@ -246,7 +254,7 @@ For troubleshooting, see [TROUBLESHOOTING.md](./TROUBLESHOOTING.md).
 
 ## Powered by Reflexio
 
-claude-smart is powered by [**Reflexio**](https://reflexio.ai) — the self-improving engine that turns interactions into durable, reusable skills.
+claude-smart is powered by [**Reflexio**](https://github.com/ReflexioAI/reflexio) ([reflexio.ai](https://reflexio.ai)) — the open-source self-improving engine that turns interactions into durable, reusable skills. If claude-smart is useful to you, **[⭐ star reflexio on GitHub](https://github.com/ReflexioAI/reflexio)**.
 
 ---
 
@@ -265,4 +273,4 @@ See the [LICENSE](LICENSE) file for details.
 
 ---
 
-**Powered by** [Reflexio](https://reflexio.ai) · **Runs on** [Claude Code](https://claude.com/claude-code), Codex, and OpenCode · **Written in** Python 3.12+
+**Powered by** [Reflexio](https://github.com/ReflexioAI/reflexio) · **Runs on** [Claude Code](https://claude.com/claude-code), Codex, and OpenCode · **Written in** Python 3.12+

package/bin/claude-smart.js

@@ -25,7 +25,9 @@ const {
   mkdirSync,
   readFileSync,
   readdirSync,
+  realpathSync,
   renameSync,
+  rmdirSync,
   rmSync,
   statSync,
   symlinkSync,
@@ -33,13 +35,14 @@ const {
 } = require("fs");
 const https = require("https");
 const { arch, homedir, platform, release, tmpdir } = require("os");
-const { dirname, join } = require("path");
+const { dirname, join, resolve } = require("path");
+const { fileURLToPath, pathToFileURL } = require("url");
 
 const PLUGIN_SPEC = "claude-smart@reflexioai";
 const CODEX_MARKETPLACE_NAME = "reflexioai";
 const CODEX_MARKETPLACE_DISPLAY_NAME = "ReflexioAI";
 const CODEX_PLUGIN_ID = `claude-smart@${CODEX_MARKETPLACE_NAME}`;
-const OPENCODE_PLUGIN_SPEC = "claude-smart";
+const OPENCODE_BARE_PLUGIN_SPEC = "claude-smart";
 const OPENCODE_CONFIG_NAMES = ["opencode.json", "opencode.jsonc"];
 const REFLEXIO_ENV_PATH = join(homedir(), ".reflexio", ".env");
 const MANAGED_REFLEXIO_URL = "https://www.reflexio.ai/";
@@ -50,6 +53,9 @@ const CLAUDE_SMART_USE_LOCAL_EMBEDDING_ENV = "CLAUDE_SMART_USE_LOCAL_EMBEDDING";
 const REFLEXIO_USER_ID_ENV = "REFLEXIO_USER_ID";
 const REFLEXIO_DIR = join(homedir(), ".reflexio");
 const CLAUDE_SMART_STATE_DIR = join(homedir(), ".claude-smart");
+const OPENCODE_LOCAL_PACKAGE_DIR = join(CLAUDE_SMART_STATE_DIR, "opencode", "claude-smart");
+const OPENCODE_PACKAGE_LOCK_TIMEOUT_MS = 120_000;
+const OPENCODE_PACKAGE_LOCK_STALE_MS = 10 * 60_000;
 const CODEX_CONFIG_PATH = join(homedir(), ".codex", "config.toml");
 const PACKAGE_ROOT = dirname(dirname(__filename));
 const CODEX_MARKETPLACE_DIR = join(
@@ -96,6 +102,7 @@ const COPYTREE_IGNORE_NAMES = new Set([
   ".venv",
   ".pytest_cache",
   ".ruff_cache",
+  ".git",
   "node_modules",
   ".next",
 ]);
@@ -450,7 +457,41 @@ function opencodePluginSpec(entry) {
   return null;
 }
 
-function patchOpenCodePluginConfig(configPath, { install }) {
+function opencodeLocalPluginSpec(packageRoot = OPENCODE_LOCAL_PACKAGE_DIR) {
+  return pathToFileURL(packageRoot).href;
+}
+
+function isOpenCodeLocalPackagePath(packagePath) {
+  return (
+    sameRealPath(packagePath, OPENCODE_LOCAL_PACKAGE_DIR) ||
+    resolve(packagePath) === resolve(OPENCODE_LOCAL_PACKAGE_DIR)
+  );
+}
+
+function isOpenCodeClaudeSmartSpec(spec) {
+  if (!spec) return false;
+  if (spec === OPENCODE_BARE_PLUGIN_SPEC || spec.startsWith(`${OPENCODE_BARE_PLUGIN_SPEC}@`)) {
+    return true;
+  }
+  if (!spec.startsWith("file://")) return false;
+  let packagePath = null;
+  try {
+    packagePath = fileURLToPath(spec);
+  } catch {
+    return false;
+  }
+  if (isOpenCodeLocalPackagePath(packagePath)) return true;
+  try {
+    const manifest = JSON.parse(readFileSync(join(packagePath, "package.json"), "utf8"));
+    if (manifest && manifest.name === OPENCODE_BARE_PLUGIN_SPEC) return true;
+  } catch {
+    // Missing or malformed manifests are not enough to identify arbitrary file specs.
+  }
+  return false;
+}
+
+function patchOpenCodePluginConfig(configPath, { install, pluginSpec = null }) {
+  const resolvedPluginSpec = install ? (pluginSpec || opencodeLocalPluginSpec()) : pluginSpec;
   const data = readJsoncObject(configPath);
   for (const field of ["plugins", "plugin"]) {
     if (data[field] !== undefined && !Array.isArray(data[field])) {
@@ -461,8 +502,8 @@ function patchOpenCodePluginConfig(configPath, { install }) {
     ...(Array.isArray(data.plugin) ? data.plugin : []),
     ...(Array.isArray(data.plugins) ? data.plugins : []),
   ];
-  const kept = current.filter((entry) => opencodePluginSpec(entry) !== OPENCODE_PLUGIN_SPEC);
-  const next = install ? [...kept, OPENCODE_PLUGIN_SPEC] : kept;
+  const kept = current.filter((entry) => !isOpenCodeClaudeSmartSpec(opencodePluginSpec(entry)));
+  const next = install ? [...kept, resolvedPluginSpec] : kept;
   const changed =
     data.plugins !== undefined ||
     (Array.isArray(data.plugin)
@@ -484,10 +525,6 @@ function patchOpenCodePluginConfig(configPath, { install }) {
   return { changed: true, configPath, backupPath };
 }
 
-function isNpxPackageRoot(path) {
-  return path.split(/[\\/]+/).includes("_npx");
-}
-
 function hasExtractionProvider() {
   if ((process.env.REFLEXIO_API_KEY || "").trim()) return true;
   const cliPath = (process.env.CLAUDE_SMART_CLI_PATH || "").trim();
@@ -600,6 +637,130 @@ function forcePluginRoot(pluginRoot) {
   }
 }
 
+function sameRealPath(left, right) {
+  try {
+    return realpathSync(left) === realpathSync(right);
+  } catch {
+    return false;
+  }
+}
+
+function pathEntryExists(path) {
+  try {
+    lstatSync(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function fileSha256(path) {
+  return crypto.createHash("sha256").update(readFileSync(path)).digest("hex");
+}
+
+function verifyOpenCodePluginPackage(packageRoot) {
+  const sourceScript = join(PACKAGE_ROOT, "plugin", "scripts", "smart-install.sh");
+  const copiedScript = join(packageRoot, "plugin", "scripts", "smart-install.sh");
+  for (const file of [join(packageRoot, "package.json"), copiedScript]) {
+    if (!existsSync(file)) {
+      throw new Error(`OpenCode local plugin package is missing ${file}`);
+    }
+  }
+  if (fileSha256(sourceScript) !== fileSha256(copiedScript)) {
+    throw new Error(
+      "OpenCode local plugin package does not match the installed claude-smart package",
+    );
+  }
+}
+
+function sleepSync(ms) {
+  Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+}
+
+function withOpenCodePackageInstallLock(fn) {
+  const lockDir = join(dirname(OPENCODE_LOCAL_PACKAGE_DIR), ".install.lock");
+  mkdirSync(dirname(OPENCODE_LOCAL_PACKAGE_DIR), { recursive: true });
+  const deadline = Date.now() + OPENCODE_PACKAGE_LOCK_TIMEOUT_MS;
+  while (true) {
+    try {
+      mkdirSync(lockDir);
+      break;
+    } catch (err) {
+      if (!err || err.code !== "EEXIST") throw err;
+      try {
+        if (Date.now() - statSync(lockDir).mtimeMs > OPENCODE_PACKAGE_LOCK_STALE_MS) {
+          rmSync(lockDir, { recursive: true, force: true });
+          continue;
+        }
+      } catch (statErr) {
+        if (statErr && statErr.code !== "ENOENT") throw statErr;
+      }
+      if (Date.now() >= deadline) {
+        throw new Error(`timed out waiting for OpenCode package install lock at ${lockDir}`);
+      }
+      sleepSync(100);
+    }
+  }
+  try {
+    return fn();
+  } finally {
+    rmSync(lockDir, { recursive: true, force: true });
+  }
+}
+
+function uniqueOpenCodePackagePath(prefix) {
+  return join(
+    dirname(OPENCODE_LOCAL_PACKAGE_DIR),
+    `${prefix}-${process.pid}-${Date.now()}-${crypto.randomBytes(4).toString("hex")}`,
+  );
+}
+
+function replaceOpenCodePluginPackage(stagedPackage, packageRoot) {
+  const backupPackage = uniqueOpenCodePackagePath(".claude-smart-previous");
+  let backupCreated = false;
+  try {
+    if (pathEntryExists(packageRoot)) {
+      renameSync(packageRoot, backupPackage);
+      backupCreated = true;
+    }
+    renameSync(stagedPackage, packageRoot);
+    if (backupCreated) {
+      rmSync(backupPackage, { recursive: true, force: true });
+    }
+  } catch (err) {
+    if (backupCreated && !existsSync(packageRoot) && existsSync(backupPackage)) {
+      renameSync(backupPackage, packageRoot);
+    }
+    throw err;
+  }
+}
+
+function installOpenCodePluginPackage() {
+  const packageRoot = OPENCODE_LOCAL_PACKAGE_DIR;
+  if (sameRealPath(PACKAGE_ROOT, packageRoot)) {
+    verifyOpenCodePluginPackage(packageRoot);
+    return packageRoot;
+  }
+  return withOpenCodePackageInstallLock(() => {
+    const stagedPackage = uniqueOpenCodePackagePath(".claude-smart-copy");
+    rmSync(stagedPackage, { recursive: true, force: true });
+    try {
+      cpSync(PACKAGE_ROOT, stagedPackage, {
+        recursive: true,
+        force: true,
+        verbatimSymlinks: false,
+        filter: shouldCopyPath,
+      });
+      verifyOpenCodePluginPackage(stagedPackage);
+      replaceOpenCodePluginPackage(stagedPackage, packageRoot);
+      verifyOpenCodePluginPackage(packageRoot);
+      return packageRoot;
+    } finally {
+      rmSync(stagedPackage, { recursive: true, force: true });
+    }
+  });
+}
+
 async function bootstrapClaudeCodeInstall() {
   const pluginRoot = findClaudeCodePluginRoot();
   if (!pluginRoot) {
@@ -694,6 +855,18 @@ function runChecked(command, args, options = {}) {
   });
 }
 
+function runSilentStatus(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    cwd: options.cwd,
+    env: options.env || process.env,
+    shell: isWindows() && /\.(?:cmd|bat)$/i.test(command),
+    stdio: "ignore",
+    windowsHide: true,
+  });
+  if (result.error || result.signal) return 1;
+  return typeof result.status === "number" ? result.status : 1;
+}
+
 function runPluginService(pluginRoot, scriptName, subcommand, envOverrides = {}) {
   const script = join(pluginRoot, "scripts", scriptName);
   if (!existsSync(script)) return false;
@@ -1092,6 +1265,59 @@ async function installVendoredReflexio(pluginRoot, uv, env) {
   if (code !== 0) throw new Error(`vendored Reflexio install failed in ${pluginRoot}`);
 }
 
+async function syncPluginPythonEnv(pluginRoot, uv, env) {
+  let code = await runChecked(
+    uv,
+    ["sync", "--locked", "--python", "3.12", "--quiet"],
+    { cwd: pluginRoot, env },
+  );
+  if (code === 0) return;
+
+  const lockIsFresh = runSilentStatus(
+    uv,
+    ["lock", "--check", "--python", "3.12"],
+    { cwd: pluginRoot, env },
+  ) === 0;
+  if (lockIsFresh) {
+    process.stderr.write(
+      `warning: quiet uv sync failed in ${pluginRoot}; retrying with full output.\n`,
+    );
+    code = await runChecked(
+      uv,
+      ["sync", "--locked", "--python", "3.12"],
+      { cwd: pluginRoot, env },
+    );
+    if (code !== 0) throw new Error(`uv sync failed in ${pluginRoot}`);
+    return;
+  }
+
+  process.stderr.write(
+    "warning: plugin/uv.lock is out of sync; refreshing local lockfile and retrying uv sync.\n",
+  );
+  code = await runChecked(
+    uv,
+    ["lock", "--python", "3.12"],
+    { cwd: pluginRoot, env },
+  );
+  if (code !== 0) throw new Error(`uv lock failed in ${pluginRoot}`);
+  code = await runChecked(
+    uv,
+    ["sync", "--python", "3.12", "--quiet"],
+    { cwd: pluginRoot, env },
+  );
+  if (code !== 0) {
+    process.stderr.write(
+      `warning: quiet uv sync failed in ${pluginRoot} after refreshing plugin/uv.lock; retrying with full output.\n`,
+    );
+    code = await runChecked(
+      uv,
+      ["sync", "--python", "3.12"],
+      { cwd: pluginRoot, env },
+    );
+  }
+  if (code !== 0) throw new Error(`uv sync failed in ${pluginRoot}`);
+}
+
 async function bootstrapPluginRuntime(pluginRoot, options = {}) {
   assertSupportedRuntimePlatform();
   process.stdout.write("Preparing claude-smart runtime for hooks...\n");
@@ -1113,27 +1339,12 @@ async function bootstrapPluginRuntime(pluginRoot, options = {}) {
     );
     if (lockCode !== 0) throw new Error(`uv lock failed in ${pluginRoot}`);
   }
-  let code = await runChecked(
-    uv,
-    ["sync", "--locked", "--python", "3.12", "--quiet"],
-    { cwd: pluginRoot, env },
-  );
-  if (code !== 0) {
-    process.stderr.write(
-      `warning: quiet uv sync failed in ${pluginRoot}; retrying with full output.\n`,
-    );
-    code = await runChecked(
-      uv,
-      ["sync", "--locked", "--python", "3.12"],
-      { cwd: pluginRoot, env },
-    );
-  }
-  if (code !== 0) throw new Error(`uv sync failed in ${pluginRoot}`);
+  await syncPluginPythonEnv(pluginRoot, uv, env);
   await installVendoredReflexio(pluginRoot, uv, env);
 
   const dashboardDir = join(pluginRoot, "dashboard");
   if (existsSync(dashboardDir)) {
-    code = await runChecked(nodeRuntime.npm, ["ci"], { cwd: dashboardDir, env });
+    let code = await runChecked(nodeRuntime.npm, ["ci"], { cwd: dashboardDir, env });
     if (code !== 0) throw new Error(`npm ci failed in ${dashboardDir}`);
     code = await runChecked(nodeRuntime.npm, ["run", "build"], { cwd: dashboardDir, env });
     if (code !== 0) throw new Error(`npm run build failed in ${dashboardDir}`);
@@ -1169,9 +1380,10 @@ function printHelp() {
       "  7. Restart Codex.",
       "",
       "OpenCode install:",
-      "  1. Adds \"claude-smart\" to OpenCode's plugin list in opencode.json",
-      "  2. Prepares local services now for stable installs; npx prepares on next OpenCode launch",
-      "  3. Restart OpenCode.",
+      `  1. Copies this package to ${OPENCODE_LOCAL_PACKAGE_DIR}`,
+      "  2. Adds that local file:// package to OpenCode's plugin list in opencode.json",
+      "  3. Prepares local services now from the copied plugin runtime",
+      "  4. Restart OpenCode.",
       "",
       "Update:",
       "  npx claude-smart update                        Reinstall Claude Code support from this package",
@@ -1894,43 +2106,44 @@ async function runInstallOpenCode(args) {
     process.exit(1);
   }
 
-  const pluginRoot = join(PACKAGE_ROOT, "plugin");
+  let packageRoot;
+  try {
+    packageRoot = installOpenCodePluginPackage();
+  } catch (err) {
+    process.stderr.write(
+      `error: could not prepare claude-smart OpenCode package: ${err && err.message ? err.message : err}\n`,
+    );
+    process.exit(1);
+  }
+  const pluginRoot = join(packageRoot, "plugin");
+  const pluginSpec = opencodeLocalPluginSpec(packageRoot);
   let result;
-  if (isNpxPackageRoot(PACKAGE_ROOT)) {
-    try {
-      result = patchOpenCodePluginConfig(opencodeConfigPath(args), { install: true });
-    } catch (err) {
-      process.stderr.write(`error: could not update OpenCode config: ${err && err.message ? err.message : err}\n`);
-      process.exit(1);
-    }
-    process.stdout.write(
-      "Skipped starting claude-smart services from npx's temporary package cache; OpenCode will prepare the runtime from its installed plugin package on next launch.\n",
+  try {
+    await bootstrapPluginRuntime(pluginRoot, { readOnly, patchCodexHooks: false });
+  } catch (err) {
+    process.stderr.write(
+      `error: claude-smart OpenCode setup failed during dependency bootstrap: ${err && err.message ? err.message : err}\n`,
     );
-  } else {
-    try {
-      await bootstrapPluginRuntime(pluginRoot, { readOnly, patchCodexHooks: false });
-    } catch (err) {
-      process.stderr.write(
-        `error: claude-smart OpenCode setup failed during dependency bootstrap: ${err && err.message ? err.message : err}\n`,
-      );
-      process.exit(1);
-    }
-    try {
-      result = patchOpenCodePluginConfig(opencodeConfigPath(args), { install: true });
-    } catch (err) {
-      process.stderr.write(`error: could not update OpenCode config: ${err && err.message ? err.message : err}\n`);
-      stopClaudeSmartServices(pluginRoot);
-      process.exit(1);
-    }
-    if (readOnly) {
-      process.stdout.write("Installed read-only hook manifest; publish interactions hooks are disabled.\n");
-    }
-    if (startBackendService(pluginRoot, "opencode")) {
-      process.stdout.write("Started claude-smart backend service.\n");
-    }
-    if (refreshDashboardService(pluginRoot)) {
-      process.stdout.write("Refreshed claude-smart dashboard service.\n");
-    }
+    process.exit(1);
+  }
+  try {
+    result = patchOpenCodePluginConfig(opencodeConfigPath(args), {
+      install: true,
+      pluginSpec,
+    });
+  } catch (err) {
+    process.stderr.write(`error: could not update OpenCode config: ${err && err.message ? err.message : err}\n`);
+    stopClaudeSmartServices(pluginRoot);
+    process.exit(1);
+  }
+  if (readOnly) {
+    process.stdout.write("Installed read-only hook manifest; publish interactions hooks are disabled.\n");
+  }
+  if (startBackendService(pluginRoot, "opencode")) {
+    process.stdout.write("Started claude-smart backend service.\n");
+  }
+  if (refreshDashboardService(pluginRoot)) {
+    process.stdout.write("Refreshed claude-smart dashboard service.\n");
   }
   if (result.backupPath) {
     process.stdout.write(`Saved a comment-preserving backup of your previous config at ${result.backupPath}.\n`);
@@ -1938,7 +2151,8 @@ async function runInstallOpenCode(args) {
   process.stdout.write(
     [
       "",
-      `${result.changed ? "Updated" : "OpenCode config already includes"} "${OPENCODE_PLUGIN_SPEC}" in ${result.configPath}.`,
+      `${result.changed ? "Updated" : "OpenCode config already includes"} "${pluginSpec}" in ${result.configPath}.`,
+      `Prepared claude-smart OpenCode package at ${packageRoot}.`,
       "claude-smart OpenCode support is installed.",
       "Restart OpenCode in your project so it loads the plugin.",
       "",
@@ -1975,6 +2189,7 @@ async function runUninstallCodex() {
 
 async function runUninstallOpenCode(args) {
   stopClaudeSmartServices(join(PACKAGE_ROOT, "plugin"));
+  stopClaudeSmartServices(join(OPENCODE_LOCAL_PACKAGE_DIR, "plugin"));
   let result;
   try {
     result = patchOpenCodePluginConfig(opencodeConfigPath(args), { install: false });
@@ -1985,12 +2200,18 @@ async function runUninstallOpenCode(args) {
   if (result.backupPath) {
     process.stdout.write(`Saved a comment-preserving backup of your previous config at ${result.backupPath}.\n`);
   }
+  rmSync(OPENCODE_LOCAL_PACKAGE_DIR, { recursive: true, force: true });
+  try {
+    rmdirSync(dirname(OPENCODE_LOCAL_PACKAGE_DIR));
+  } catch {
+    // Keep the parent when it still contains future OpenCode state.
+  }
   process.stdout.write(
     [
       "",
       result.changed
-        ? `Removed "${OPENCODE_PLUGIN_SPEC}" from ${result.configPath}.`
-        : `OpenCode config did not include "${OPENCODE_PLUGIN_SPEC}".`,
+        ? `Removed claude-smart OpenCode plugin entries from ${result.configPath}.`
+        : "OpenCode config did not include claude-smart.",
       "Restart OpenCode to apply.",
       ...LOCAL_DATA_NOTICE,
       "",
@@ -2050,7 +2271,8 @@ module.exports = {
   configureReflexioSetup,
   patchCodexHooksForNode,
   opencodeConfigPath,
-  isNpxPackageRoot,
+  opencodeLocalPluginSpec,
+  installOpenCodePluginPackage,
   patchOpenCodePluginConfig,
   hasExtractionProvider,
   platformSupportError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-smart",
-  "version": "0.2.46",
+  "version": "0.2.48",
   "description": "Self-improving Claude Code, Codex, and OpenCode plugin that turns corrections into Preferences, Project-specific skills, and Shared skills",
   "keywords": [
     "claude",

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-smart",
-  "version": "0.2.46",
+  "version": "0.2.48",
   "description": "Self-improving Claude Code, Codex, and OpenCode plugin that turns corrections into Preferences, Project-specific skills, and Shared skills",
   "author": {
     "name": "Yi Lu"

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-smart",
-  "version": "0.2.46",
+  "version": "0.2.48",
   "description": "Self-improving coding assistant plugin — learns from corrections across sessions via reflexio",
   "author": {
     "name": "Yi Lu"