claude-smart 0.2.24 → 0.2.25

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.24-green.svg" alt="Version">
+    <img src="https://img.shields.io/badge/version-0.2.25-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">
@@ -118,13 +118,18 @@ You need the `codex` CLI on `PATH` and Node.js available for `npx`:
 npx claude-smart install --host codex
 ```
 
-The helper registers the bundled **ReflexioAI** marketplace with Codex and
-enables Codex plugin hooks. Then:
+The helper registers the bundled **ReflexioAI** marketplace with Codex, enables
+Codex's `plugin_hooks` feature, installs `claude-smart` into Codex's local
+plugin cache, and enables it in `~/.codex/config.toml`. Hooks are not active in
+already-running Codex windows; after the command finishes:
 
-1. Fully quit and reopen Codex in your project.
-2. Run `/plugins`.
-3. Install `claude-smart` from the **ReflexioAI** marketplace.
-4. Restart Codex again so hooks reload.
+1. Fully quit and reopen Codex in your project so hooks reload.
+2. Run `/plugins` only if you want to verify `claude-smart` shows as installed
+   from the **ReflexioAI** marketplace.
+
+If you install or toggle `claude-smart` manually from `/plugins`, still run
+`npx claude-smart install --host codex` once afterward so `plugin_hooks` is
+enabled and the cache/config are prepared.
 
 Do not create a `~/plugins/claude-smart` symlink for a normal `npx` install;
 that symlink is only for plugin development from a cloned checkout.
@@ -186,7 +191,7 @@ claude-smart builds three artifacts as you work and injects the relevant ones in
 
 Skills clean themselves up: correct the same thing twice and they merge; change your mind and the old one is archived.
 
-Under the hood: hooks watch your turns, tool calls, and assistant replies, auto-flagging corrections (or anything you flag with `/learn`). At session end (or on `/learn`), [reflexio](https://github.com/ReflexioAI/reflexio) — the self-improving engine that powers claude-smart — extracts preferences and project-specific skills, then rolls durable patterns into shared skills. On each new user prompt, claude-smart searches for matching context and injects only the relevant hits. Run `/show` or the equivalent CLI command to audit the current learned state. Everything runs on your machine.
+Under the hood: hooks watch your turns, tool calls, and assistant replies, auto-flagging corrections (or anything you flag with `/claude-smart:learn`). At session end (or on `/claude-smart:learn`), [reflexio](https://github.com/ReflexioAI/reflexio) — the self-improving engine that powers claude-smart — extracts preferences and project-specific skills, then rolls durable patterns into shared skills. On each new user prompt, claude-smart searches for matching context and injects only the relevant hits. Run `/claude-smart:show` or the equivalent CLI command to audit the current learned state. Everything runs on your machine.
 
 **Citations.** At the end of a reply, the assistant may append a short marker:
 
@@ -205,16 +210,17 @@ See [ARCHITECTURE.md](./ARCHITECTURE.md) for hooks, data flow, and reflexio deta
 
 ## Commands
 
-Claude Code installs these as slash commands. In Codex, run the equivalent shell
-command directly, or ask Codex to run it.
+Claude Code installs these as plugin slash commands. Codex does not currently
+support these plugin-provided slash commands, so run the equivalent shell command
+directly, or ask Codex to run it.
 
 | Claude Code | Codex / shell | What it does |
 | --- | --- | --- |
-| `/dashboard` | `bash ~/.reflexio/plugin-root/scripts/dashboard-open.sh` | Open the dashboard in your browser, auto-starting the reflexio backend and dashboard services if they aren't already running. |
-| `/show` | `bash ~/.reflexio/plugin-root/scripts/cli.sh show` | Print current project-specific skills, shared skills, and the current project's preferences so you can audit learned state manually. |
-| `/learn [note]` | `bash ~/.reflexio/plugin-root/scripts/cli.sh learn --note "optional note"` | Flag the most recent turn as a correction (for cases the automatic heuristic missed) and force reflexio to run extraction *now* on the session's unpublished interactions. The optional note becomes the correction description the extractor sees. |
-| `/restart` | `bash ~/.reflexio/plugin-root/scripts/cli.sh restart` | Restart the reflexio backend and dashboard to pick up new changes (e.g. after upgrading the plugin or editing local reflexio code). |
-| `/clear-all` | `bash ~/.reflexio/plugin-root/scripts/cli.sh clear-all --yes` | **Destructive.** Delete *all* reflexio interactions, preferences, and skills. Use when you want to wipe learned state and start fresh. |
+| `/claude-smart:dashboard` | `bash ~/.reflexio/plugin-root/scripts/dashboard-open.sh` | Open the dashboard in your browser, auto-starting the reflexio backend and dashboard services if they aren't already running. |
+| `/claude-smart:show` | `bash ~/.reflexio/plugin-root/scripts/cli.sh show` | Print current project-specific skills, shared skills, and the current project's preferences so you can audit learned state manually. |
+| `/claude-smart:learn [note]` | `bash ~/.reflexio/plugin-root/scripts/cli.sh learn --note "optional note"` | Flag the most recent turn as a correction (for cases the automatic heuristic missed) and force reflexio to run extraction *now* on the session's unpublished interactions. The optional note becomes the correction description the extractor sees. |
+| `/claude-smart:restart` | `bash ~/.reflexio/plugin-root/scripts/cli.sh restart` | Restart the reflexio backend and dashboard to pick up new changes (e.g. after upgrading the plugin or editing local reflexio code). |
+| `/claude-smart:clear-all` | `bash ~/.reflexio/plugin-root/scripts/cli.sh clear-all --yes` | **Destructive.** Delete *all* reflexio interactions, preferences, and skills. Use when you want to wipe learned state and start fresh. |
 
 ---
 
@@ -231,7 +237,7 @@ Advanced users can tune claude-smart via environment variables — see [DEVELOPE
 | `.claude/settings.local.json` or `~/.claude/settings.json` | Claude Code hook environment, such as `CLAUDE_SMART_ENABLE_OPTIMIZER`; use project-local settings for one repo or user settings for all projects. |
 | `~/.codex/config.toml` | Codex feature flags, including `plugin_hooks = true` 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. |
-| `~/.reflexio/plugin-root` | Self-healed symlink to the active plugin dir (managed by `ensure-plugin-root.sh` — written on install, refreshed each `SessionStart`). Slash commands resolve through it, so don't delete it; if you do, the next session will recreate it. |
+| `~/.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. |
 | `~/.cache/chroma/onnx_models/all-MiniLM-L6-v2/` | Cached ONNX weights (~86 MB, downloaded once). Delete to force a re-download. |
 

package/bin/claude-smart.js

@@ -206,7 +206,8 @@ function printHelp() {
       `  1. Copies the bundled marketplace to ${CODEX_MARKETPLACE_DIR}`,
       "  2. codex plugin marketplace add <copied marketplace>",
       "  3. codex features enable plugin_hooks",
-      "  4. Fully quit and reopen Codex, run /plugins, install claude-smart, then restart Codex.",
+      "  4. Installs claude-smart into Codex's plugin cache and enables it",
+      "  5. Restart Codex.",
       "",
       "Update:",
       "  npx claude-smart update                        Update to the latest version",
@@ -344,6 +345,50 @@ function cleanupCodexInstallState() {
   }
 }
 
+function setCodexPluginEnabled() {
+  const sectionName = `plugins."${CODEX_PLUGIN_ID}"`;
+  removeTomlSections(CODEX_CONFIG_PATH, { exact: new Set([sectionName]) });
+  const existing = existsSync(CODEX_CONFIG_PATH)
+    ? readFileSync(CODEX_CONFIG_PATH, "utf8")
+    : "";
+  let next = existing;
+  if (next && !next.endsWith("\n")) next += "\n";
+  if (next.trim()) next += "\n";
+  next += `[${sectionName}]\nenabled = true\n`;
+  mkdirSync(dirname(CODEX_CONFIG_PATH), { recursive: true });
+  writeFileSync(CODEX_CONFIG_PATH, next);
+}
+
+function codexPluginVersion(pluginRoot) {
+  try {
+    const manifest = JSON.parse(
+      readFileSync(join(pluginRoot, ".codex-plugin", "plugin.json"), "utf8"),
+    );
+    return typeof manifest.version === "string" && manifest.version
+      ? manifest.version
+      : null;
+  } catch {
+    return null;
+  }
+}
+
+function installCodexPluginCache(pluginRoot) {
+  const version = codexPluginVersion(pluginRoot);
+  if (!version) {
+    throw new Error(`missing version in ${join(pluginRoot, ".codex-plugin", "plugin.json")}`);
+  }
+  const cacheDir = join(CODEX_PLUGIN_CACHE_DIR, version);
+  rmSync(cacheDir, { recursive: true, force: true });
+  mkdirSync(dirname(cacheDir), { recursive: true });
+  cpSync(pluginRoot, cacheDir, {
+    recursive: true,
+    force: true,
+    verbatimSymlinks: false,
+  });
+  setCodexPluginEnabled();
+  return cacheDir;
+}
+
 async function runUpdate() {
   if (!hasClaudeCli()) {
     process.stderr.write(
@@ -476,6 +521,20 @@ async function runInstallCodex() {
     process.exit(code);
   }
 
+  let cacheDir = null;
+  try {
+    cacheDir = installCodexPluginCache(join(marketplaceRoot, CODEX_MARKETPLACE_PLUGIN_PATH));
+    process.stdout.write(`Installed Codex plugin cache at ${cacheDir}.\n`);
+  } catch (err) {
+    process.stderr.write(
+      `error: automatic Codex plugin install failed: ${err && err.message ? err.message : err}\n`,
+    );
+    process.stderr.write(
+      `Open Codex, run /plugins, and install claude-smart from the ${CODEX_MARKETPLACE_DISPLAY_NAME} marketplace manually.\n`,
+    );
+    process.exit(1);
+  }
+
   const added = seedReflexioEnv();
   if (added.length > 0) {
     process.stdout.write(`Seeded ${REFLEXIO_ENV_PATH} with ${added.join(", ")}.\n`);
@@ -484,8 +543,8 @@ async function runInstallCodex() {
   process.stdout.write(
     [
       "",
-      "claude-smart Codex support is prepared.",
-      `Fully quit and reopen Codex, run /plugins, install claude-smart from the ${CODEX_MARKETPLACE_DISPLAY_NAME} marketplace, then restart Codex so hooks reload.`,
+      "claude-smart Codex support is installed.",
+      `Restart Codex so the installed plugin and hooks reload. /plugins should show claude-smart as installed from the ${CODEX_MARKETPLACE_DISPLAY_NAME} marketplace.`,
       "Local data is shared with Claude Code under ~/.reflexio/ and ~/.claude-smart/.",
       "",
     ].join("\n"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-smart",
-  "version": "0.2.24",
+  "version": "0.2.25",
   "description": "Self-improving Claude Code plugin — learns from corrections via reflexio",
   "keywords": [
     "claude",

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

@@ -1,6 +1,6 @@
 {
   "name": "claude-smart",
-  "version": "0.2.24",
+  "version": "0.2.25",
   "description": "Self-improving Claude Code plugin — learns from corrections across sessions via reflexio",
   "author": {
     "name": "Yi Lu"

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

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

package/plugin/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "claude-smart"
-version = "0.2.24"
+version = "0.2.25"
 description = "Self-improving Claude Code plugin — learns from corrections via reflexio"
 readme = "README.md"
 requires-python = ">=3.12"

package/plugin/src/claude_smart/cli.py

@@ -315,6 +315,59 @@ def _remove_toml_sections(
     return True
 
 
+def _set_codex_plugin_enabled(path: Path) -> bool:
+    """Write Codex's installed-plugin config section for claude-smart."""
+    section_name = f'plugins."{_CODEX_PLUGIN_ID}"'
+    if not _remove_toml_sections(path, exact={section_name}):
+        return False
+    try:
+        text = path.read_text() if path.exists() else ""
+    except OSError:
+        return False
+    if text and not text.endswith("\n"):
+        text += "\n"
+    if text.strip():
+        text += "\n"
+    text += f"[{section_name}]\nenabled = true\n"
+    try:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        path.write_text(text)
+    except OSError:
+        return False
+    return True
+
+
+def _codex_plugin_version(plugin_root: Path) -> str | None:
+    try:
+        manifest = json.loads(
+            (plugin_root / ".codex-plugin" / "plugin.json").read_text()
+        )
+    except (OSError, json.JSONDecodeError):
+        return None
+    version = manifest.get("version")
+    return version if isinstance(version, str) and version else None
+
+
+def _install_codex_plugin_cache(plugin_root: Path) -> tuple[bool, str]:
+    """Best-effort local install equivalent to selecting Install in /plugins."""
+    version = _codex_plugin_version(plugin_root)
+    if not version:
+        return (
+            False,
+            f"missing version in {plugin_root / '.codex-plugin' / 'plugin.json'}",
+        )
+    cache_dir = _CODEX_PLUGIN_CACHE_DIR / version
+    try:
+        shutil.rmtree(cache_dir, ignore_errors=True)
+        cache_dir.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copytree(plugin_root, cache_dir, symlinks=False, ignore=_COPYTREE_IGNORE)
+    except OSError as exc:
+        return False, f"could not write Codex plugin cache: {exc}"
+    if not _set_codex_plugin_enabled(_CODEX_CONFIG_PATH):
+        return False, f"could not enable {_CODEX_PLUGIN_ID} in {_CODEX_CONFIG_PATH}"
+    return True, f"installed Codex plugin cache at {cache_dir}"
+
+
 def _cleanup_codex_install_state() -> bool:
     """Remove Codex's local install artifacts while preserving shared learning data.
 
@@ -446,14 +499,30 @@ def cmd_install_codex(_args: argparse.Namespace) -> int:
     else:
         sys.stderr.write(f"warning: {registration_msg}\n")
 
+    installed = False
+    install_msg = "marketplace registration failed"
     if registered:
+        installed, install_msg = _install_codex_plugin_cache(
+            marketplace_root / _CODEX_LOCAL_PLUGIN_PATH
+        )
+        if installed:
+            sys.stdout.write(f"{install_msg}.\n")
+        else:
+            sys.stderr.write(f"warning: {install_msg}\n")
+
+    if registered and installed:
+        sys.stdout.write(
+            "\nclaude-smart Codex support is installed.\n"
+            "Restart Codex so the installed plugin and hooks reload. /plugins should "
+            f"show claude-smart as installed from the {_CODEX_MARKETPLACE_DISPLAY_NAME} marketplace. "
+            "Uninstall removes the plugin cache and marketplace registration but leaves "
+            "shared claude-smart data and Codex's global plugin_hooks feature intact.\n"
+        )
+    elif registered:
         sys.stdout.write(
-            "\nclaude-smart Codex support is prepared.\n"
+            "\nclaude-smart Codex marketplace is prepared, but automatic plugin install failed.\n"
             "Fully quit and reopen Codex in this repo, run /plugins, install claude-smart from "
-            f"the {_CODEX_MARKETPLACE_DISPLAY_NAME} marketplace if it is not already installed, "
-            "then restart Codex so hooks reload. Uninstall removes the marketplace "
-            "registration but leaves shared claude-smart data and Codex's global "
-            "plugin_hooks feature intact.\n"
+            f"the {_CODEX_MARKETPLACE_DISPLAY_NAME} marketplace, and restart Codex so hooks reload.\n"
         )
     else:
         sys.stdout.write(
@@ -462,7 +531,7 @@ def cmd_install_codex(_args: argparse.Namespace) -> int:
             "then fully quit and reopen Codex, run /plugins, install claude-smart from the "
             f"{_CODEX_MARKETPLACE_DISPLAY_NAME} marketplace, and restart Codex so hooks reload.\n"
         )
-    return 0 if hooks_ok and registered else 1
+    return 0 if hooks_ok and registered and installed else 1
 
 
 def cmd_install(args: argparse.Namespace) -> int:

package/plugin/uv.lock

@@ -419,7 +419,7 @@ wheels = [
 
 [[package]]
 name = "claude-smart"
-version = "0.2.24"
+version = "0.2.25"
 source = { editable = "." }
 dependencies = [
     { name = "chromadb" },