claude-smart 0.2.41 → 0.2.43

package/.claude-plugin/marketplace.json

@@ -0,0 +1,17 @@
+{
+  "name": "reflexioai",
+  "owner": {
+    "name": "Yi Lu"
+  },
+  "metadata": {
+    "description": "claude-smart — self-improving Claude Code and Codex plugin via reflexio"
+  },
+  "plugins": [
+    {
+      "name": "claude-smart",
+      "version": "0.2.43",
+      "source": "./plugin",
+      "description": "Turns user corrections into project-specific and shared skills via reflexio — uses Claude Code or Codex 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.41-green.svg" alt="Version">
+    <img src="https://img.shields.io/badge/version-0.2.43-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">

package/bin/claude-smart.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 /**
  * npx claude-smart install — thin wrapper around the native host plugin
- * CLIs. For Claude Code it registers the GitHub marketplace and installs the
- * plugin. For Codex it copies the bundled local marketplace, registers it,
- * and enables plugin hooks. Both paths seed ~/.reflexio/.env with the two
- * local-provider flags so reflexio can route generation through local tools
- * with no API key. Managed/read-only/global setup is handled by
- * `npx claude-smart setup`, which writes ~/.reflexio/.env before running this
- * installer.
+ * CLIs. Both Claude Code and Codex install from the bundled marketplace in
+ * this npm package: Claude Code registers the package root as a local
+ * marketplace, and Codex copies the bundled plugin into its own marketplace
+ * wrapper. Both paths seed ~/.reflexio/.env with the two local-provider flags
+ * so reflexio can route generation through local tools with no API key.
+ * Managed/read-only/global setup is handled by `npx claude-smart setup`,
+ * which writes ~/.reflexio/.env before running this installer.
  *
  * Keep this file dependency-free — it runs via `npx` with no install step.
  */
@@ -33,7 +33,6 @@ const https = require("https");
 const { arch, homedir, platform, release, tmpdir } = require("os");
 const { dirname, join } = require("path");
 
-const DEFAULT_MARKETPLACE_SOURCE = "ReflexioAI/claude-smart";
 const PLUGIN_SPEC = "claude-smart@reflexioai";
 const CODEX_MARKETPLACE_NAME = "reflexioai";
 const CODEX_MARKETPLACE_DISPLAY_NAME = "ReflexioAI";
@@ -358,7 +357,7 @@ function findClaudeCodePluginRoot() {
       }
     }
   } catch {
-    // Fall through to marketplace/package fallbacks.
+    // Fall through to marketplace fallback.
   }
   candidates.sort((a, b) => {
     const versionCompare = compareSemverLikePathNames(b, a);
@@ -369,9 +368,13 @@ function findClaudeCodePluginRoot() {
       return 0;
     }
   });
+  // PACKAGE_ROOT/plugin is intentionally NOT a fallback: under `npx` it
+  // points at /root/.npm/_npx/<hash>/.../plugin which npm may prune between
+  // invocations, breaking the editable claude_smart install (.pth dangles,
+  // venv survives) and confusing every later `uv sync`. Require `claude
+  // plugin install` to have populated the cache dir instead, and fail loud.
   const fallbacks = [
     join(homedir(), ".claude", "plugins", "marketplaces", CODEX_MARKETPLACE_NAME, "plugin"),
-    join(PACKAGE_ROOT, "plugin"),
   ];
   for (const candidate of [...candidates, ...fallbacks]) {
     if (
@@ -429,7 +432,19 @@ function forcePluginRoot(pluginRoot) {
 async function bootstrapClaudeCodeInstall() {
   const pluginRoot = findClaudeCodePluginRoot();
   if (!pluginRoot) {
-    throw new Error("could not locate installed Claude Code plugin root after install");
+    const cacheRoot = join(
+      homedir(),
+      ".claude",
+      "plugins",
+      "cache",
+      CODEX_MARKETPLACE_NAME,
+      "claude-smart",
+    );
+    throw new Error(
+      `claude plugin install did not populate ${cacheRoot}. ` +
+        "Open Claude Code, run /plugins, verify claude-smart is installed " +
+        "from the ReflexioAI marketplace, then rerun `npx claude-smart install`.",
+    );
   }
   forcePluginRoot(pluginRoot);
   const bash = resolveCommand(isWindows() ? ["bash.exe", "bash"] : ["bash"]);
@@ -960,13 +975,12 @@ function printHelp() {
       "Usage:",
       "  npx claude-smart install                       Install the plugin into Claude Code",
       "  npx claude-smart install --host codex          Register the plugin marketplace for Codex",
-      "  npx claude-smart install --source <owner/repo> Override the marketplace source",
       "  npx claude-smart setup                         Configure managed/read-only/global setup",
       "  npx claude-smart uninstall --host codex        Remove the Codex marketplace registration",
       "  npx claude-smart --help                        Show this help",
       "",
       "Claude Code install:",
-      "  1. claude plugin marketplace add <source>",
+      "  1. claude plugin marketplace add <this package>",
       `  2. claude plugin install ${PLUGIN_SPEC}`,
       "  3. Reads ~/.reflexio/.env when managed/read-only setup was configured.",
       "",
@@ -980,7 +994,8 @@ function printHelp() {
       "  7. Restart Codex.",
       "",
       "Update:",
-      "  npx claude-smart update                        Update to the latest version",
+      "  npx claude-smart update                        Reinstall Claude Code support from this package",
+      "  npx claude-smart update --host codex           Reinstall Codex support from this package",
       "  npx claude-smart setup                         Configure managed/read-only/global setup",
       "",
       "Uninstall:",
@@ -990,17 +1005,6 @@ function printHelp() {
   );
 }
 
-function parseSource(args) {
-  const idx = args.indexOf("--source");
-  if (idx === -1) return DEFAULT_MARKETPLACE_SOURCE;
-  const value = args[idx + 1];
-  if (!value) {
-    process.stderr.write("error: --source requires a value (e.g. owner/repo)\n");
-    process.exit(1);
-  }
-  return value;
-}
-
 function parseHost(args) {
   const idx = args.indexOf("--host");
   if (idx === -1) return "claude-code";
@@ -1396,33 +1400,53 @@ function installCodexPluginCache(pluginRoot) {
   return cacheDir;
 }
 
-async function runUpdate(args) {
-  const setup = configureReflexioSetup();
-  if (!hasClaudeCli()) {
-    process.stderr.write(
-      "error: 'claude' CLI not found on PATH. " +
-        "Install Claude Code first: https://claude.com/claude-code\n",
-    );
-    process.exit(1);
+function findCodexPluginRoot() {
+  const candidates = [];
+  try {
+    for (const entry of readdirSync(CODEX_PLUGIN_CACHE_DIR, { withFileTypes: true })) {
+      if (!entry.isDirectory()) continue;
+      const candidate = join(CODEX_PLUGIN_CACHE_DIR, entry.name);
+      if (
+        existsSync(join(candidate, "pyproject.toml")) &&
+        existsSync(join(candidate, "scripts", "smart-install.sh"))
+      ) {
+        candidates.push(candidate);
+      }
+    }
+  } catch {
+    // No Codex cache yet.
   }
-
-  const code = await runClaude(["plugin", "update", PLUGIN_SPEC], {
-    spinnerLabel: "Checking for claude-smart updates…",
+  candidates.sort((a, b) => {
+    const versionCompare = compareSemverLikePathNames(b, a);
+    if (versionCompare !== 0) return versionCompare;
+    try {
+      return statSync(b).mtimeMs - statSync(a).mtimeMs;
+    } catch {
+      return 0;
+    }
   });
-  if (code !== 0) {
-    process.stderr.write(`error: \`claude plugin update ${PLUGIN_SPEC}\` failed (exit ${code})\n`);
-    process.exit(code);
+  return candidates[0] || null;
+}
+
+async function runUpdate(args) {
+  if (parseHost(args) === "codex") {
+    await runUpdateCodex(args);
+    return;
   }
 
-  process.stdout.write("\nclaude-smart updated. Restart Claude Code to apply.\n");
   const pluginRoot = findClaudeCodePluginRoot();
   if (pluginRoot) {
-    restorePublishHooksFromSource(pluginRoot);
-    if (setup.readOnly) {
-      prunePublishHooksForReadOnly(pluginRoot);
-      process.stdout.write("Installed read-only hook manifest; publish interactions hooks are disabled.\n");
-    }
+    stopClaudeSmartServices(pluginRoot);
   }
+  process.stdout.write("Updating claude-smart by reinstalling from this package...\n");
+  await runInstall(args, { retryInstallAfterUninstall: true });
+}
+
+async function runUpdateCodex(args) {
+  const pluginRoot = findCodexPluginRoot() || join(PACKAGE_ROOT, "plugin");
+  stopClaudeSmartServices(pluginRoot);
+  process.stdout.write("Updating claude-smart Codex support by reinstalling from this package...\n");
+  await runInstallCodex(args);
 }
 
 async function runUninstall(args) {
@@ -1475,7 +1499,7 @@ async function runSetup(args) {
   if (code !== 0) process.exit(code);
 }
 
-async function runInstall(args) {
+async function runInstall(args, options = {}) {
   if (parseHost(args) === "codex") {
     await runInstallCodex(args);
     return;
@@ -1489,7 +1513,7 @@ async function runInstall(args) {
     process.exit(1);
   }
 
-  const source = parseSource(args);
+  const source = PACKAGE_ROOT;
   const setup = configureReflexioSetup();
   const readOnly = setup.readOnly;
 
@@ -1499,7 +1523,21 @@ async function runInstall(args) {
   ];
 
   for (const step of steps) {
-    const code = await runClaude(step.args, { spinnerLabel: step.label });
+    let code = await runClaude(step.args, { spinnerLabel: step.label });
+    if (
+      code !== 0 &&
+      options.retryInstallAfterUninstall &&
+      step.args[0] === "plugin" &&
+      step.args[1] === "install"
+    ) {
+      process.stderr.write(
+        `warning: \`claude ${step.args.join(" ")}\` failed (exit ${code}); retrying after uninstalling ${PLUGIN_SPEC}.\n`,
+      );
+      await runClaude(["plugin", "uninstall", PLUGIN_SPEC], {
+        spinnerLabel: "Removing existing claude-smart install…",
+      });
+      code = await runClaude(step.args, { spinnerLabel: step.label });
+    }
     if (code !== 0) {
       process.stderr.write(
         `error: \`claude ${step.args.join(" ")}\` failed (exit ${code})\n`,

package/package.json

@@ -1,14 +1,20 @@
 {
   "name": "claude-smart",
-  "version": "0.2.41",
-  "description": "Self-improving Claude Code plugin — learns from corrections via reflexio",
+  "version": "0.2.43",
+  "description": "Self-improving Claude Code and Codex plugin — turns corrections into durable skills via reflexio",
   "keywords": [
     "claude",
     "claude-code",
+    "claude-code-plugin",
+    "codex",
+    "codex-plugin",
+    "memory",
+    "agent-memory",
     "plugin",
     "reflexio",
     "self-improvement",
-    "playbook",
+    "self-improving-agents",
+    "skills",
     "learning"
   ],
   "homepage": "https://github.com/ReflexioAI/claude-smart#readme",
@@ -29,6 +35,7 @@
     "bin",
     "scripts/setup-claude-smart.sh",
     ".agents/plugins/marketplace.json",
+    ".claude-plugin/marketplace.json",
     "plugin",
     "!plugin/**/__pycache__",
     "!plugin/**/*.py[cod]",

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

@@ -1,17 +1,23 @@
 {
   "name": "claude-smart",
-  "version": "0.2.41",
-  "description": "Self-improving Claude Code plugin — learns from corrections across sessions via reflexio",
+  "version": "0.2.43",
+  "description": "Self-improving Claude Code and Codex plugin — turns corrections into durable skills via reflexio",
   "author": {
     "name": "Yi Lu"
   },
   "keywords": [
     "claude",
     "claude-code",
+    "claude-code-plugin",
+    "codex",
+    "codex-plugin",
+    "memory",
+    "agent-memory",
     "plugin",
     "reflexio",
     "self-improvement",
-    "playbook",
+    "self-improving-agents",
+    "skills",
     "learning"
   ]
 }

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

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

package/plugin/README.md

@@ -1,8 +1,8 @@
 # claude-smart
 
-Self-improving [Claude Code](https://claude.com/claude-code) plugin — turns your corrections into durable rules that Claude Code follows in future sessions, via [reflexio](https://github.com/ReflexioAI/reflexio).
+Self-improving [Claude Code](https://claude.com/claude-code) and Codex plugin — turns your corrections into durable skills that future sessions follow, via [reflexio](https://github.com/ReflexioAI/reflexio).
 
-This directory is the published Python package (`claude-smart` on PyPI) and the Claude Code plugin payload shipped through the marketplace. For the project overview, install instructions, benchmarks, and feature walkthrough, see the [top-level README](https://github.com/ReflexioAI/claude-smart#readme).
+This directory is the published Python package (`claude-smart` on PyPI) and the Claude Code/Codex plugin payload shipped through the marketplace. For the project overview, install instructions, benchmarks, and feature walkthrough, see the [top-level README](https://github.com/ReflexioAI/claude-smart#readme).
 
 ## Install
 

package/plugin/dashboard/next.config.ts

@@ -1,7 +1,15 @@
 import type { NextConfig } from "next";
+import path from "path";
 
+// Pin Turbopack's workspace root to this dashboard directory. When the
+// plugin is installed via npx (e.g. ~/.npm/_npx/<hash>/node_modules/...),
+// Next would otherwise detect the npx parent's package-lock.json as the
+// workspace root and panic in `next build` ("Failed to write app endpoint
+// /page"). Pinning the root avoids that misdetection.
 const nextConfig: NextConfig = {
-  /* config options here */
+  turbopack: {
+    root: path.resolve(__dirname),
+  },
 };
 
 export default nextConfig;

package/plugin/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "claude-smart"
-version = "0.2.41"
-description = "Self-improving Claude Code plugin — learns from corrections via reflexio"
+version = "0.2.43"
+description = "Self-improving Claude Code and Codex plugin — turns corrections into durable skills via reflexio"
 readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [

package/plugin/scripts/_lib.sh

@@ -220,6 +220,97 @@ importlib.import_module(sys.argv[1])
 PY
 }
 
+claude_smart_canonical_dir() {
+  local dir
+  dir="$1"
+  [ -d "$dir" ] || return 1
+  (cd "$dir" 2>/dev/null && pwd -P)
+}
+
+# True when $1 canonicalizes to a plugin directory that physically lives
+# *inside* ~/.reflexio. claude-smart's real install never places the live
+# plugin tree there: the only entry under ~/.reflexio is the `plugin-root`
+# symlink, whose `pwd -P` resolves to a cache dir *outside* ~/.reflexio
+# (~/.claude, ~/.codex, or the npm global). So any plugin root that resolves
+# to a descendant of ~/.reflexio is a stray host-made copy — e.g. the Windows
+# cwd-derived `CUsers...` directories from issue #65 — that we must not
+# bootstrap a heavy .venv/node_modules into.
+#
+# Detection is structural (descendant-of-~/.reflexio + plugin markers) rather
+# than name-based on purpose: the host mangles the cwd differently per drive
+# and user dir (C:\Users -> CUsers..., D:\repos -> Drepos..., varying case),
+# so matching a fixed prefix like `Cu*` misses most real copies.
+claude_smart_is_reflexio_session_copy() {
+  local plugin_root reflexio_root
+  plugin_root="$(claude_smart_canonical_dir "$1" 2>/dev/null || true)"
+  [ -n "$plugin_root" ] || return 1
+  # Must look like a plugin root — not ~/.reflexio/data, /configs, or .env.
+  [ -f "$plugin_root/pyproject.toml" ] || return 1
+  [ -d "$plugin_root/scripts" ] || return 1
+  reflexio_root="$(claude_smart_canonical_dir "$HOME/.reflexio" 2>/dev/null || true)"
+  [ -n "$reflexio_root" ] || return 1
+  # Descendant of ~/.reflexio. The trailing slash on the subject plus the
+  # "/" before * pins the boundary so a sibling like ~/.reflexio-bak/plugin
+  # does not match.
+  case "$plugin_root/" in
+    "$reflexio_root"/*) return 0 ;;
+  esac
+  return 1
+}
+
+claude_smart_stable_plugin_root_for_session_copy() {
+  local current candidate current_real candidate_real glob
+  current="$1"
+  if ! claude_smart_is_reflexio_session_copy "$current"; then
+    return 1
+  fi
+  current_real="$(claude_smart_canonical_dir "$current" 2>/dev/null || true)"
+
+  for candidate in \
+    "$HOME/.reflexio/plugin-root" \
+    "$HOME/.claude/plugins/marketplaces/reflexioai/plugin" \
+    "$HOME/.codex/plugins/cache/reflexioai/claude-smart/current"
+  do
+    [ -f "$candidate/pyproject.toml" ] || continue
+    candidate_real="$(claude_smart_canonical_dir "$candidate" 2>/dev/null || true)"
+    [ -n "$candidate_real" ] || continue
+    [ "$candidate_real" != "$current_real" ] || continue
+    if claude_smart_is_reflexio_session_copy "$candidate_real"; then
+      continue
+    fi
+    printf '%s\n' "$candidate_real"
+    return 0
+  done
+
+  for glob in "$HOME/.claude/plugins/cache/reflexioai/claude-smart"/* "$HOME/.codex/plugins/cache/reflexioai/claude-smart"/*; do
+    [ -f "$glob/pyproject.toml" ] || continue
+    candidate_real="$(claude_smart_canonical_dir "$glob" 2>/dev/null || true)"
+    [ -n "$candidate_real" ] || continue
+    [ "$candidate_real" != "$current_real" ] || continue
+    if claude_smart_is_reflexio_session_copy "$candidate_real"; then
+      continue
+    fi
+    printf '%s\n' "$candidate_real"
+    return 0
+  done
+  return 1
+}
+
+claude_smart_reexec_stable_plugin_root_if_needed() {
+  local plugin_root script stable
+  plugin_root="$1"
+  script="$2"
+  stable="$(claude_smart_stable_plugin_root_for_session_copy "$plugin_root" 2>/dev/null || true)"
+  [ -n "$stable" ] || return 0
+  # `-f` not `-x`: we re-run via `exec bash <script>`, which does not need the
+  # executable bit. Cached copies on Windows/NTFS often lack +x, so requiring
+  # -x would no-op the guard on the very platform issue #65 affects.
+  [ -f "$stable/scripts/$script" ] || return 0
+  echo "[claude-smart] redirecting stray plugin copy under ~/.reflexio ($plugin_root) to stable root $stable" >&2
+  shift 2
+  exec bash "$stable/scripts/$script" "$@"
+}
+
 claude_smart_download() {
   local url dest src _CS_PY
   url="$1"

package/plugin/scripts/backend-service.sh

@@ -45,6 +45,7 @@ fi
 # CLI dir (commonly ~/.local/bin or /opt/homebrew/bin). Pin the CLI
 # explicitly if we can resolve it from our own (post-login-path) PATH.
 PLUGIN_ROOT="$(cd "$HERE/.." && pwd)"
+claude_smart_reexec_stable_plugin_root_if_needed "$PLUGIN_ROOT" "backend-service.sh" "$@"
 
 if [ -z "${CLAUDE_SMART_CLI_PATH:-}" ]; then
   if [ "${CLAUDE_SMART_HOST:-claude-code}" = "codex" ]; then
@@ -138,20 +139,27 @@ port_occupied() {
   (echo >"/dev/tcp/127.0.0.1/$PORT") 2>/dev/null
 }
 
-# Reap any reflexio/uvicorn listener still holding $PORT after the PID
-# file kill. Filters by cmdline so we don't knock over an unrelated
-# service a user has bound to 8071 — symmetric with start's refusal to
-# stomp on a foreign listener. Silent on failure.
+# Reap listeners still holding the given port after the PID file kill
+# when their command line matches one of the supplied patterns. Filters
+# by cmdline so we don't knock over an
+# unrelated service a user has bound there — symmetric with start's
+# refusal to stomp on a foreign listener. Silent on failure.
 reap_port_listeners() {
+  port="${1:-$PORT}"
+  shift || true
+  [ "$#" -eq 0 ] && return 0
   command -v lsof >/dev/null 2>&1 || return 0
-  candidates=$(lsof -ti:"$PORT" 2>/dev/null) || candidates=""
+  candidates=$(lsof -ti:"$port" 2>/dev/null) || candidates=""
   [ -z "$candidates" ] && return 0
   ours=""
   for pid in $candidates; do
     cmdline=$(ps -p "$pid" -o command= 2>/dev/null || true)
-    case "$cmdline" in
-      *reflexio*|*uvicorn*) ours="$ours $pid" ;;
-    esac
+    for pattern in "$@"; do
+      if [[ "$cmdline" == $pattern ]]; then
+        ours="$ours $pid"
+        break
+      fi
+    done
   done
   [ -z "$ours" ] && return 0
   # shellcheck disable=SC2086
@@ -166,16 +174,33 @@ reap_port_listeners() {
   kill -KILL $remaining 2>/dev/null || true
 }
 
-# Full shutdown: kill the recorded process group (if any) then sweep the
-# port for surviving reflexio listeners. Used by both `stop` and the
-# opt-in `session-end` path so a stale/missing PID file doesn't produce
-# a silent no-op.
+# Describe what (if anything) is currently listening on $1. Returns
+# "<command> (pid <pid>)" or empty if the port is free or lsof is
+# unavailable. Used to make port-conflict log lines diagnosable.
+port_holder() {
+  command -v lsof >/dev/null 2>&1 || return 0
+  lsof -i:"$1" -sTCP:LISTEN -P -n 2>/dev/null \
+    | awk 'NR==2 {print $1" (pid "$2")"; exit}'
+}
+
+# Full shutdown: kill the recorded process group (if any) then sweep
+# both the backend port and the embedding-service port for surviving
+# reflexio listeners. Used by both `stop` and the opt-in `session-end`
+# path so a stale/missing PID file doesn't produce a silent no-op, and
+# so a stale embedding service on EMBEDDING_PORT doesn't block the next
+# fresh boot (e.g. when codex-hook.js falls back to 8072 for the main
+# backend because 8071 is held by another app).
 full_stop() {
   if [ -f "$PID_FILE" ]; then
     kill_group "$(cat "$PID_FILE" 2>/dev/null)"
     rm -f "$PID_FILE"
   fi
-  reap_port_listeners
+  reap_port_listeners "$PORT" '*reflexio*' '*uvicorn*'
+  if [ -n "${EMBEDDING_PORT:-}" ] && [ "$EMBEDDING_PORT" != "$PORT" ]; then
+    reap_port_listeners "$EMBEDDING_PORT" \
+      '*reflexio.server.llm.embedding_service:app*' \
+      '*reflexio*embedding_service*'
+  fi
 }
 
 case "$CMD" in
@@ -195,8 +220,14 @@ case "$CMD" in
     if is_our_backend_running; then emit_ok; exit 0; fi
     if port_occupied; then
       # Something answered the TCP probe but /health didn't — don't
-      # start a second uvicorn on top of it.
-      claude_smart_append_capped_log "$LOG_FILE" "$LOG_MAX_BYTES" "[claude-smart] backend: port $PORT held by another process; skipping"
+      # start a second uvicorn on top of it. Surface the holder so the
+      # user knows which process to quit (common case: editor/dev tool
+      # squatting 8071) instead of silently failing.
+      holder="$(port_holder "$PORT" 2>/dev/null || true)"
+      msg="[claude-smart] backend: port $PORT held by another process${holder:+ ($holder)}; skipping start"
+      claude_smart_append_capped_log "$LOG_FILE" "$LOG_MAX_BYTES" "$msg"
+      echo "$msg" >&2
+      echo "Free port $PORT (or stop the process above) and run /claude-smart:restart again." >&2
       emit_ok; exit 0
     fi
     if ! command -v uv >/dev/null 2>&1; then

package/plugin/scripts/cli.sh

@@ -18,6 +18,7 @@ claude_smart_prepend_node_bins
 claude_smart_source_reflexio_env
 
 PLUGIN_ROOT="$(cd "$HERE/.." && pwd)"
+claude_smart_reexec_stable_plugin_root_if_needed "$PLUGIN_ROOT" "cli.sh" "$@"
 
 # If the Setup hook recorded an install failure, surface that reason
 # instead of falling through to a generic "uv not found" — mirrors the
@@ -45,7 +46,7 @@ if ! command -v uv >/dev/null 2>&1; then
   fi
   if [ -x "$PLUGIN_ROOT/scripts/smart-install.sh" ]; then
     echo "claude-smart: 'uv' not found — bootstrapping dependencies (~1-3 min on first install)..." >&2
-    CLAUDE_SMART_BOOTSTRAPPING=1 bash "$PLUGIN_ROOT/scripts/smart-install.sh" >&2
+    CLAUDE_SMART_BOOTSTRAPPING=1 bash "$PLUGIN_ROOT/scripts/smart-install.sh" >/dev/null
     claude_smart_prepend_astral_bins
     claude_smart_prepend_node_bins
   fi
@@ -63,4 +64,31 @@ if ! command -v uv >/dev/null 2>&1; then
   fi
 fi
 
+# Slash commands run synchronously and surface stderr directly to the user,
+# so a bare `python -m claude_smart.cli` ModuleNotFoundError leaks to the
+# transcript when the install is mid-bootstrap (e.g. SessionStart's
+# background smart-install.sh hasn't finished yet). Mirror hook_entry.sh's
+# ensure_hook_package_importable check: run smart-install.sh inline once,
+# then re-check, then surface either the install-failed marker reason or a
+# clear "still bootstrapping" message instead of letting Python crash.
+if ! claude_smart_python_imports "$PLUGIN_ROOT" claude_smart.cli; then
+  if [ "${CLAUDE_SMART_BOOTSTRAPPING:-}" != "1" ] \
+     && [ -x "$PLUGIN_ROOT/scripts/smart-install.sh" ]; then
+    echo "claude-smart: finishing install (~1-3 min on first install)..." >&2
+    CLAUDE_SMART_BOOTSTRAPPING=1 bash "$PLUGIN_ROOT/scripts/smart-install.sh" >/dev/null || true
+  fi
+  if ! claude_smart_python_imports "$PLUGIN_ROOT" claude_smart.cli; then
+    if [ -f "$FAILURE_MARKER" ]; then
+      msg="$(head -n 1 "$FAILURE_MARKER" 2>/dev/null || echo "")"
+      [ -n "$msg" ] || msg="unknown error"
+      echo "claude-smart is not installed correctly: $msg" >&2
+      echo "Re-run the plugin's Setup (restart Claude Code) or fix the underlying issue and delete $FAILURE_MARKER to retry." >&2
+    else
+      echo "claude-smart: claude_smart package is not importable in $PLUGIN_ROOT/.venv." >&2
+      echo "Run $PLUGIN_ROOT/scripts/smart-install.sh manually to diagnose." >&2
+    fi
+    exit 1
+  fi
+fi
+
 exec uv run --project "$PLUGIN_ROOT" --no-sync --quiet python -m claude_smart.cli "$@"