claude-smart 0.2.31 → 0.2.33

package/plugin/scripts/_lib.sh

@@ -32,6 +32,59 @@ claude_smart_prepend_node_bins() {
   export PATH="$_CS_NODE_ROOT/bin:$_CS_NODE_ROOT:$PATH"
 }
 
+claude_smart_env_unquote() {
+  local value first last
+  value="$1"
+  first="${value%"${value#?}"}"
+  last="${value#"${value%?}"}"
+  if { [ "$first" = '"' ] && [ "$last" = '"' ]; } || { [ "$first" = "'" ] && [ "$last" = "'" ]; }; then
+    value="${value#?}"
+    value="${value%?}"
+  fi
+  printf '%s\n' "$value"
+}
+
+claude_smart_source_reflexio_env() {
+  local env_file line key value
+  env_file="$HOME/.reflexio/.env"
+  [ -f "$env_file" ] || return 0
+  while IFS= read -r line || [ -n "$line" ]; do
+    line="${line#"${line%%[![:space:]]*}"}"
+    line="${line%"${line##*[![:space:]]}"}"
+    [ -n "$line" ] || continue
+    case "$line" in
+      \#*) continue ;;
+      export\ *) line="${line#export }" ;;
+    esac
+    key="${line%%=*}"
+    [ "$key" != "$line" ] || continue
+    value="${line#*=}"
+    key="${key%"${key##*[![:space:]]}"}"
+    value="${value#"${value%%[![:space:]]*}"}"
+    value="${value%"${value##*[![:space:]]}"}"
+    case "$key" in
+      REFLEXIO_URL|REFLEXIO_API_KEY|REFLEXIO_USER_ID|CLAUDE_SMART_USE_LOCAL_CLI|CLAUDE_SMART_USE_LOCAL_EMBEDDING|CLAUDE_SMART_BACKEND_AUTOSTART|CLAUDE_SMART_DASHBOARD_AUTOSTART|CLAUDE_SMART_CLI_PATH|CLAUDE_SMART_CLI_TIMEOUT|CLAUDE_SMART_STATE_DIR|CLAUDE_SMART_ENABLE_OPTIMIZER)
+        if [ -z "$(eval "printf '%s' \"\${$key:-}\"")" ]; then
+          value="$(claude_smart_env_unquote "$value")"
+          export "$key=$value"
+        fi
+        ;;
+    esac
+  done < "$env_file"
+}
+
+claude_smart_reflexio_url_is_remote() {
+  local url
+  url="${REFLEXIO_URL:-}"
+  [ -n "$url" ] || return 1
+  case "$url" in
+    http://localhost|http://localhost/|http://localhost:*|http://127.0.0.1|http://127.0.0.1/|http://127.0.0.1:*|http://0.0.0.0|http://0.0.0.0/|http://0.0.0.0:*|http://\[::1\]|http://\[::1\]/|http://\[::1\]:*)
+      return 1
+      ;;
+  esac
+  return 0
+}
+
 claude_smart_is_internal_invocation_env() {
   if [ "${CLAUDE_SMART_INTERNAL:-}" = "1" ]; then
     return 0
@@ -42,6 +95,14 @@ claude_smart_is_internal_invocation_env() {
   return 1
 }
 
+claude_smart_emit_continue() {
+  if [ "${CLAUDE_SMART_HOST:-claude-code}" = "codex" ]; then
+    echo '{"continue":true}'
+  else
+    echo '{"continue":true,"suppressOutput":true}'
+  fi
+}
+
 claude_smart_dashboard_unavailable_marker() {
   printf '%s\n' "$HOME/.claude-smart/dashboard-unavailable"
 }

package/plugin/scripts/backend-service.sh

@@ -22,6 +22,7 @@ HERE="$(cd "$(dirname "$0")" && pwd)"
 . "$HERE/_lib.sh"
 claude_smart_source_login_path
 claude_smart_prepend_astral_bins
+claude_smart_source_reflexio_env
 
 CMD="${1:-start}"
 PORT=8071
@@ -67,7 +68,7 @@ LOG_MAX_BYTES="$(claude_smart_log_max_bytes)"
 mkdir -p "$STATE_DIR"
 claude_smart_trim_log_file "$LOG_FILE" "$LOG_MAX_BYTES"
 
-emit_ok() { echo '{"continue":true,"suppressOutput":true}'; }
+emit_ok() { claude_smart_emit_continue; }
 
 emit_start_failure() {
   reason="$1"
@@ -182,6 +183,10 @@ case "$CMD" in
     if claude_smart_is_internal_invocation_env; then
       emit_ok; exit 0
     fi
+    if claude_smart_reflexio_url_is_remote; then
+      claude_smart_append_capped_log "$LOG_FILE" "$LOG_MAX_BYTES" "[claude-smart] backend: remote REFLEXIO_URL configured; skipping local backend start"
+      emit_ok; exit 0
+    fi
     # Opt-out: users who don't want the backend managed by the hook can
     # set CLAUDE_SMART_BACKEND_AUTOSTART=0.
     if [ "${CLAUDE_SMART_BACKEND_AUTOSTART:-1}" = "0" ]; then
@@ -269,7 +274,13 @@ case "$CMD" in
     emit_ok
     ;;
   status)
-    if is_our_backend_running; then echo "running on http://localhost:$PORT"; else echo "not running"; fi
+    if claude_smart_reflexio_url_is_remote; then
+      echo "remote configured at $REFLEXIO_URL"
+    elif is_our_backend_running; then
+      echo "running on http://localhost:$PORT"
+    else
+      echo "not running"
+    fi
     ;;
   *)
     emit_ok

package/plugin/scripts/cli.sh

@@ -15,6 +15,7 @@ HERE="$(cd "$(dirname "$0")" && pwd)"
 claude_smart_source_login_path
 claude_smart_prepend_astral_bins
 claude_smart_prepend_node_bins
+claude_smart_source_reflexio_env
 
 PLUGIN_ROOT="$(cd "$HERE/.." && pwd)"
 

package/plugin/scripts/codex-hook.js

@@ -16,7 +16,46 @@ const DASHBOARD_PORT = 3001;
 const LOG_MAX_BYTES = 10000000;
 
 function emitOk() {
-  process.stdout.write('{"continue":true,"suppressOutput":true}\n');
+  process.stdout.write('{"continue":true}\n');
+}
+
+function emitHookOk() {
+  process.stdout.write('{"continue":true}\n');
+}
+
+function emitNormalizedHookOutput(stdout) {
+  const lines = String(stdout || "")
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean);
+  if (lines.length === 0) {
+    emitHookOk();
+    return;
+  }
+
+  const merged = {};
+  for (const line of lines) {
+    let parsed;
+    try {
+      parsed = JSON.parse(line);
+    } catch {
+      appendLog("backend.log", `[claude-smart] codex hook emitted non-JSON stdout: ${line.slice(0, 500)}`);
+      emitHookOk();
+      return;
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      appendLog("backend.log", `[claude-smart] codex hook emitted non-object JSON stdout: ${line.slice(0, 500)}`);
+      emitHookOk();
+      return;
+    }
+    Object.assign(merged, parsed);
+  }
+
+  if (!Object.prototype.hasOwnProperty.call(merged, "continue")) {
+    merged.continue = true;
+  }
+  delete merged.suppressOutput;
+  process.stdout.write(`${JSON.stringify(merged)}\n`);
 }
 
 function ensureDir(dir) {
@@ -121,6 +160,57 @@ function writeBackendUrl(port) {
   fs.writeFileSync(backendUrlFile(), `http://localhost:${port}/\n`);
 }
 
+function unquoteEnvValue(value) {
+  const trimmed = String(value || "").trim();
+  if (trimmed.length >= 2) {
+    const first = trimmed[0];
+    const last = trimmed[trimmed.length - 1];
+    if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+      return trimmed.slice(1, -1);
+    }
+  }
+  return trimmed;
+}
+
+function loadReflexioEnv() {
+  const file = path.join(REFLEXIO_DIR, ".env");
+  let text;
+  try {
+    text = fs.readFileSync(file, "utf8");
+  } catch {
+    return;
+  }
+  const allowed = new Set([
+    "REFLEXIO_URL",
+    "REFLEXIO_API_KEY",
+    "REFLEXIO_USER_ID",
+    "CLAUDE_SMART_USE_LOCAL_CLI",
+    "CLAUDE_SMART_USE_LOCAL_EMBEDDING",
+    "CLAUDE_SMART_BACKEND_AUTOSTART",
+    "CLAUDE_SMART_DASHBOARD_AUTOSTART",
+    "CLAUDE_SMART_CLI_PATH",
+    "CLAUDE_SMART_CLI_TIMEOUT",
+    "CLAUDE_SMART_STATE_DIR",
+    "CLAUDE_SMART_ENABLE_OPTIMIZER",
+  ]);
+  for (const rawLine of text.split(/\r?\n/)) {
+    let line = rawLine.trim();
+    if (!line || line.startsWith("#")) continue;
+    if (line.startsWith("export ")) line = line.slice("export ".length).trimStart();
+    const eq = line.indexOf("=");
+    if (eq < 0) continue;
+    const key = line.slice(0, eq).trim();
+    if (!allowed.has(key) || process.env[key]) continue;
+    process.env[key] = unquoteEnvValue(line.slice(eq + 1));
+  }
+}
+
+function reflexioUrlIsRemote() {
+  const url = process.env.REFLEXIO_URL || "";
+  if (!url) return false;
+  return !/^http:\/\/(?:localhost|127\.0\.0\.1|0\.0\.0\.0|\[::1\])(?::\d+)?\/?$/i.test(url);
+}
+
 function codexCompatPath(root) {
   const filename = process.platform === "win32"
     ? "codex-claude-compat.cmd"
@@ -294,6 +384,11 @@ async function startBackend(root) {
     emitOk();
     return;
   }
+  if (reflexioUrlIsRemote()) {
+    appendLog("backend.log", "[claude-smart] backend: remote REFLEXIO_URL configured; skipping local backend start");
+    emitOk();
+    return;
+  }
   const pidFile = path.join(STATE_DIR, "backend.pid");
   for (const port of [DEFAULT_BACKEND_PORT, FALLBACK_BACKEND_PORT]) {
     if (pidAlive(readPid(pidFile)) && await healthOk(port, "/health")) {
@@ -419,7 +514,7 @@ function runHook(root, event) {
     }
     if (!uv) {
       appendLog("backend.log", "[claude-smart] hook: uv not on PATH after installer; skipping");
-      emitOk();
+      emitHookOk();
       return 0;
     }
   }
@@ -434,17 +529,20 @@ function runHook(root, event) {
         REFLEXIO_URL: readBackendUrl(),
         CLAUDE_SMART_HOST: "codex",
         CLAUDE_SMART_CLI_PATH: process.env.CLAUDE_SMART_CLI_PATH || codexCompatPath(root),
+        CLAUDE_SMART_CITATION_LINK_STYLE: process.env.CLAUDE_SMART_CITATION_LINK_STYLE || "osc8",
       },
       input,
-      stdio: ["pipe", "inherit", "inherit"],
+      stdio: ["pipe", "pipe", "inherit"],
       windowsHide: true,
     },
   );
+  emitNormalizedHookOutput(result.stdout);
   return typeof result.status === "number" ? result.status : 1;
 }
 
 async function main() {
   prependRuntimePath();
+  loadReflexioEnv();
   const root = pluginRoot();
   process.env.PLUGIN_ROOT = root;
   process.env.CLAUDE_PLUGIN_ROOT = root;

package/plugin/scripts/dashboard-service.sh

@@ -23,6 +23,7 @@ HERE="$(cd "$(dirname "$0")" && pwd)"
 . "$HERE/_lib.sh"
 claude_smart_source_login_path
 claude_smart_prepend_node_bins
+claude_smart_source_reflexio_env
 
 CMD="${1:-start}"
 PORT=3001
@@ -36,7 +37,7 @@ PID_FILE="$STATE_DIR/dashboard.pid"
 LOG_FILE="$STATE_DIR/dashboard.log"
 mkdir -p "$STATE_DIR"
 
-emit_ok() { echo '{"continue":true,"suppressOutput":true}'; }
+emit_ok() { claude_smart_emit_continue; }
 
 # Tree-kill the recorded process. Delegates to claude_smart_kill_tree
 # (POSIX: signal the process group; Windows: taskkill /T /F /PID).
@@ -45,15 +46,96 @@ kill_group() {
 }
 
 # True if the marker header served by app/api/health is present on the
-# port. Requires curl — absence is reported as false.
+# port. Requires curl — absence is reported as false. This deliberately
+# accepts any claude-smart dashboard, including stale cache versions, so
+# stop/uninstall can safely reap them without touching foreign listeners.
 marker_responds() {
   command -v curl >/dev/null 2>&1 || return 1
   curl -sfI "http://127.0.0.1:$PORT/api/health" 2>/dev/null \
     | grep -qi '^x-claude-smart-dashboard:'
 }
 
-# True only if *our* dashboard is on the port. Uses the marker header so a
-# foreign listener on 3001 doesn't cause us to silently skip starting.
+dashboard_health_headers() {
+  command -v curl >/dev/null 2>&1 || return 1
+  curl -sfI --connect-timeout 2 --max-time 5 "http://127.0.0.1:$PORT/api/health" 2>/dev/null
+}
+
+header_value_from() {
+  header_name="$1"
+  awk -v wanted="$header_name" '
+    BEGIN { wanted = tolower(wanted) ":" }
+    {
+      line = $0
+      sub(/\r$/, "", line)
+      lower = tolower(line)
+      if (index(lower, wanted) == 1) {
+        sub(/^[^:]*:[[:space:]]*/, "", line)
+        print line
+        exit
+      }
+    }
+  '
+}
+
+canonical_dir() {
+  dir="$1"
+  (cd "$dir" 2>/dev/null && pwd -P) || printf '%s\n' "$dir"
+}
+
+normalize_identity_path() {
+  path="$1"
+  if claude_smart_is_windows; then
+    if command -v cygpath >/dev/null 2>&1; then
+      path="$(cygpath -u "$path" 2>/dev/null || printf '%s\n' "$path")"
+    else
+      path="$(
+        printf '%s\n' "$path" | awk '{
+          gsub(/\\/, "/")
+          if ($0 ~ /^[A-Za-z]:/) {
+            drive = tolower(substr($0, 1, 1))
+            sub(/^[A-Za-z]:/, "/" drive)
+          }
+          print
+        }'
+      )"
+    fi
+  fi
+  while [ "${path%/}" != "$path" ] && [ "$path" != "/" ]; do
+    path="${path%/}"
+  done
+  printf '%s\n' "$path"
+}
+
+# True only if *this plugin root's* dashboard is on the port. The generic
+# x-claude-smart-dashboard marker is intentionally not enough: after an
+# install/update, an older cache can keep serving port 3001 until restarted.
+dashboard_matches_current_root() {
+  expected_root="$(normalize_identity_path "$(canonical_dir "$PLUGIN_ROOT")")"
+  headers="$(dashboard_health_headers)" || return 1
+  printf '%s\n' "$headers" | grep -qi '^x-claude-smart-dashboard:' || return 1
+  actual_root="$(printf '%s\n' "$headers" | header_value_from "x-claude-smart-plugin-root")"
+  [ -n "$actual_root" ] || return 1
+  actual_root="$(normalize_identity_path "$actual_root")"
+  [ "$actual_root" = "$expected_root" ]
+}
+
+# Kill a claude-smart dashboard listener currently holding the port. Gated by
+# marker_responds so a foreign app on 3001 is never killed.
+stop_dashboard_listener() {
+  marker_responds || return 0
+  command -v lsof >/dev/null 2>&1 || return 0
+  port_pid=$(lsof -t -i ":$PORT" -sTCP:LISTEN 2>/dev/null | head -n1)
+  [ -n "$port_pid" ] || return 0
+  kill -TERM "$port_pid" 2>/dev/null || true
+  for _ in 1 2 3 4 5; do
+    kill -0 "$port_pid" 2>/dev/null || return 0
+    sleep 0.2
+  done
+  kill -KILL "$port_pid" 2>/dev/null || true
+}
+
+# True only if *our* dashboard is on the port. Uses plugin-root identity so a
+# stale claude-smart listener doesn't cause us to silently skip starting.
 is_our_dashboard_running() {
   if [ -f "$PID_FILE" ]; then
     pid=$(cat "$PID_FILE" 2>/dev/null || echo "")
@@ -62,7 +144,7 @@ is_our_dashboard_running() {
       # don't claim "running" when the server crashed but the group leader
       # lingered.
       if command -v curl >/dev/null 2>&1; then
-        marker_responds && return 0
+        dashboard_matches_current_root && return 0
       else
         # No curl — fall back to PID liveness alone.
         return 0
@@ -71,7 +153,7 @@ is_our_dashboard_running() {
   fi
   # No PID or dead PID — probe the port for our marker (recovers after a
   # stale PID file from a crash).
-  marker_responds && return 0
+  dashboard_matches_current_root && return 0
   return 1
 }
 
@@ -97,6 +179,10 @@ case "$CMD" in
     fi
     if [ ! -d "$DASHBOARD_DIR" ]; then emit_ok; exit 0; fi
     if is_our_dashboard_running; then claude_smart_clear_dashboard_unavailable; emit_ok; exit 0; fi
+    if marker_responds; then
+      echo "[claude-smart] dashboard: stale claude-smart dashboard on port $PORT; restarting from $PLUGIN_ROOT" >>"$LOG_FILE"
+      stop_dashboard_listener
+    fi
     if port_occupied; then
       echo "[claude-smart] dashboard: port $PORT held by another process; skipping" >>"$LOG_FILE"
       emit_ok; exit 0
@@ -152,7 +238,7 @@ case "$CMD" in
     echo "$dash_pid" > "$PID_FILE"
     dashboard_ready=0
     for _ in 1 2 3 4 5; do
-      if marker_responds; then
+      if dashboard_matches_current_root; then
         dashboard_ready=1
         claude_smart_clear_dashboard_unavailable
         break
@@ -169,21 +255,11 @@ case "$CMD" in
       kill_group "$(cat "$PID_FILE" 2>/dev/null)"
       rm -f "$PID_FILE"
     fi
-    # Fallback: if our dashboard is still responding on the port (e.g.,
+    # Fallback: if a claude-smart dashboard is still responding on the port (e.g.,
     # was started outside this script, or the PGID kill missed because
     # the process wasn't the group leader) kill whoever owns the port.
     # Gated on the marker header so we never touch a foreign listener.
-    if marker_responds && command -v lsof >/dev/null 2>&1; then
-      port_pid=$(lsof -t -i ":$PORT" -sTCP:LISTEN 2>/dev/null | head -n1)
-      if [ -n "$port_pid" ]; then
-        kill -TERM "$port_pid" 2>/dev/null || true
-        for _ in 1 2 3 4 5; do
-          kill -0 "$port_pid" 2>/dev/null || break
-          sleep 0.2
-        done
-        kill -KILL "$port_pid" 2>/dev/null || true
-      fi
-    fi
+    stop_dashboard_listener
     emit_ok
     ;;
   session-end)

package/plugin/scripts/hook_entry.sh

@@ -18,16 +18,21 @@ case "$EVENT" in
     EVENT="${2:-}"
     ;;
 esac
-if [ -z "$EVENT" ]; then
-  echo '{"continue":true,"suppressOutput":true}'
-  exit 0
+export CLAUDE_SMART_HOST="$HOST"
+if [ "$HOST" = "codex" ] && [ -z "${CLAUDE_SMART_CITATION_LINK_STYLE:-}" ]; then
+  export CLAUDE_SMART_CITATION_LINK_STYLE="osc8"
 fi
 
 HERE="$(cd "$(dirname "$0")" && pwd)"
 # shellcheck source=_lib.sh
 . "$HERE/_lib.sh"
+if [ -z "$EVENT" ]; then
+  claude_smart_emit_continue
+  exit 0
+fi
+
 if claude_smart_is_internal_invocation_env; then
-  echo '{"continue":true,"suppressOutput":true}'
+  claude_smart_emit_continue
   exit 0
 fi
 # Pick up uv from the user's login-shell PATH (covers ~/.local/bin populated
@@ -37,6 +42,7 @@ claude_smart_source_login_path
 # Explicit fallback for the astral.sh installer's default paths, in case
 # the user's login-shell rc hasn't yet been re-sourced to pick them up.
 claude_smart_prepend_astral_bins
+claude_smart_source_reflexio_env
 
 PLUGIN_ROOT="$(cd "$HERE/.." && pwd)"
 
@@ -70,7 +76,7 @@ print(json.dumps({
 }))
 PY
     else
-      echo '{"continue":true,"suppressOutput":true}'
+      claude_smart_emit_continue
     fi
     exit 0
   fi
@@ -82,7 +88,7 @@ if ! command -v uv >/dev/null 2>&1; then
   # the same installer detached so normal work is not blocked by first-run
   # dependency setup.
   if [ "${CLAUDE_SMART_BOOTSTRAPPING:-}" = "1" ]; then
-    echo '{"continue":true,"suppressOutput":true}'
+    claude_smart_emit_continue
     exit 0
   fi
   if [ -x "$PLUGIN_ROOT/scripts/smart-install.sh" ]; then
@@ -102,7 +108,7 @@ if ! command -v uv >/dev/null 2>&1; then
     fi
   fi
   if ! command -v uv >/dev/null 2>&1; then
-    echo '{"continue":true,"suppressOutput":true}'
+    claude_smart_emit_continue
     exit 0
   fi
 fi

package/plugin/scripts/smart-install.sh

@@ -14,6 +14,7 @@ HERE="$(cd "$(dirname "$0")" && pwd)"
 claude_smart_source_login_path
 claude_smart_prepend_astral_bins
 claude_smart_prepend_node_bins
+claude_smart_source_reflexio_env
 
 PLUGIN_ROOT="$(cd "$HERE/.." && pwd)"
 REPO_ROOT="$(cd "$HERE/../.." && pwd)"
@@ -47,7 +48,7 @@ acquire_install_lock() {
     exec 9>"$INSTALL_LOCK"
     if ! flock 9; then
       echo "[claude-smart] install lock failed; continuing without serialization" >&2
-      echo '{"continue":true,"suppressOutput":true}'
+      claude_smart_emit_continue
       exit 0
     fi
     return 0
@@ -91,7 +92,7 @@ write_failure() {
   } > "$FAILURE_MARKER"
   rm -f "$SUCCESS_MARKER"
   echo "[claude-smart] install failed: $reason" >&2
-  echo '{"continue":true,"suppressOutput":true}'
+  claude_smart_emit_continue
   exit 0
 }
 
@@ -105,8 +106,10 @@ install_complete() {
   command -v uv >/dev/null 2>&1 || return 1
   [ -d "$PLUGIN_ROOT/.venv" ] || return 1
   [ -f "$HOME/.reflexio/.env" ] || return 1
-  grep -q '^CLAUDE_SMART_USE_LOCAL_CLI=' "$HOME/.reflexio/.env" || return 1
-  grep -q '^CLAUDE_SMART_USE_LOCAL_EMBEDDING=' "$HOME/.reflexio/.env" || return 1
+  if [ -z "${REFLEXIO_API_KEY:-}" ]; then
+    grep -q '^CLAUDE_SMART_USE_LOCAL_CLI=' "$HOME/.reflexio/.env" || return 1
+    grep -q '^CLAUDE_SMART_USE_LOCAL_EMBEDDING=' "$HOME/.reflexio/.env" || return 1
+  fi
   if [ -d "$PLUGIN_ROOT/dashboard" ]; then
     [ -d "$PLUGIN_ROOT/dashboard/.next" ] || [ -f "$MARKER_DIR/dashboard-build.pid" ] || [ -f "$(claude_smart_dashboard_unavailable_marker)" ] || return 1
   fi
@@ -360,7 +363,7 @@ fi
 preflight_supported_runtime_platform
 
 if install_complete; then
-  echo '{"continue":true,"suppressOutput":true}'
+  claude_smart_emit_continue
   exit 0
 fi
 
@@ -431,13 +434,15 @@ fi
 REFLEXIO_ENV="$HOME/.reflexio/.env"
 mkdir -p "$(dirname "$REFLEXIO_ENV")"
 touch "$REFLEXIO_ENV"
-if ! grep -q '^CLAUDE_SMART_USE_LOCAL_CLI=' "$REFLEXIO_ENV"; then
-  printf '\n# Route reflexio generation through the local Claude Code CLI\nCLAUDE_SMART_USE_LOCAL_CLI=1\n' >> "$REFLEXIO_ENV"
-  echo "[claude-smart] appended CLAUDE_SMART_USE_LOCAL_CLI=1 to $REFLEXIO_ENV" >&2
-fi
-if ! grep -q '^CLAUDE_SMART_USE_LOCAL_EMBEDDING=' "$REFLEXIO_ENV"; then
-  printf '# Use the in-process ONNX embedder (chromadb) — no API key for semantic search\nCLAUDE_SMART_USE_LOCAL_EMBEDDING=1\n' >> "$REFLEXIO_ENV"
-  echo "[claude-smart] appended CLAUDE_SMART_USE_LOCAL_EMBEDDING=1 to $REFLEXIO_ENV" >&2
+if [ -z "${REFLEXIO_API_KEY:-}" ]; then
+  if ! grep -q '^CLAUDE_SMART_USE_LOCAL_CLI=' "$REFLEXIO_ENV"; then
+    printf '\n# Route reflexio generation through the local Claude Code CLI\nCLAUDE_SMART_USE_LOCAL_CLI=1\n' >> "$REFLEXIO_ENV"
+    echo "[claude-smart] appended CLAUDE_SMART_USE_LOCAL_CLI=1 to $REFLEXIO_ENV" >&2
+  fi
+  if ! grep -q '^CLAUDE_SMART_USE_LOCAL_EMBEDDING=' "$REFLEXIO_ENV"; then
+    printf '# Use the in-process ONNX embedder (chromadb) — no API key for semantic search\nCLAUDE_SMART_USE_LOCAL_EMBEDDING=1\n' >> "$REFLEXIO_ENV"
+    echo "[claude-smart] appended CLAUDE_SMART_USE_LOCAL_EMBEDDING=1 to $REFLEXIO_ENV" >&2
+  fi
 fi
 # Migrate stale REFLEXIO_URL from reflexio's library default (8081) to the
 # plugin backend port (8071). Matches the quoted and unquoted forms but
@@ -511,4 +516,4 @@ fi
 
 write_success_marker
 echo "[claude-smart] install complete. Backend and dashboard auto-start on session start." >&2
-echo '{"continue":true,"suppressOutput":true}'
+claude_smart_emit_continue