claude-smart 0.2.23 → 0.2.25

package/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "reflexioai",
+  "interface": {
+    "displayName": "ReflexioAI"
+  },
+  "plugins": [
+    {
+      "name": "claude-smart",
+      "source": {
+        "source": "local",
+        "path": "./plugin"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Productivity"
+    }
+  ]
+}

package/README.md

@@ -6,14 +6,14 @@
   claude-smart
 </h1>
 
-<h4 align="center">The <a href="https://claude.com/claude-code" target="_blank">Claude Code</a> plugin that makes Claude Code self-improve as you use it — so Claude Code stops repeating mistakes and gets better every session.</h4>
+<h4 align="center">A local learning plugin for <a href="https://claude.com/claude-code" target="_blank">Claude Code</a> and Codex that turns corrections into durable rules your coding assistant follows in future sessions.</h4>
 
 <p align="center">
   <a href="LICENSE">
     <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.23-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">
@@ -22,7 +22,7 @@
     <img src="https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg" alt="Node">
   </a>
   <a href="#quick-start">
-    <img src="https://img.shields.io/badge/llm-claude%20code%20cli-purple.svg" alt="LLM">
+    <img src="https://img.shields.io/badge/hosts-Claude%20Code%20%2B%20Codex-purple.svg" alt="Hosts">
   </a>
   <a href="https://discord.gg/Jbft3jPn">
     <img src="https://img.shields.io/badge/Discord-Join%20Chat-5865F2?logo=discord&logoColor=white" alt="Discord">
@@ -32,7 +32,7 @@
 <p align="center">
   <a href="#quick-start">Quick Start</a> •
   <a href="#how-it-works">How It Works</a> •
-  <a href="#slash-commands">Slash Commands</a> •
+  <a href="#commands">Commands</a> •
   <a href="#dashboard">Dashboard</a> •
   <a href="#configuration">Configuration</a> •
   <a href="TROUBLESHOOTING.md">Troubleshooting</a> •
@@ -40,7 +40,7 @@
 </p>
 
 <p align="center">
-  It learns both corrections and successful execution patterns—so Claude Code avoids repeating mistakes and reuses what works. Project-specific skills capture repo-local rules, and shared skills roll up durable patterns for reuse across projects.
+  It learns both corrections and successful execution patterns—so your coding assistant avoids repeating mistakes and reuses what works. Project-specific skills capture repo-local rules, and shared skills roll up durable patterns for reuse across projects.
 </p>
 
 <p align="center">
@@ -55,7 +55,7 @@ Most memory solutions are still mostly informative—Claude remembers what happe
 
 `claude-smart` focuses on learning instead.
 
-Four ways this changes what Claude Code can do for you:
+Four ways this changes what your coding assistant can do for you:
 
 - 💡 **Stop repeating the same mistakes:** Produces actionable skills Claude can follow next time; memory only records what happened.
 
@@ -78,6 +78,8 @@ Four ways this changes what Claude Code can do for you:
 
 ## Quick Start
 
+### Claude Code
+
 ```bash
 claude plugin marketplace add ReflexioAI/claude-smart
 claude plugin install claude-smart@reflexioai
@@ -108,10 +110,50 @@ Or, if you already have Node.js or uv:
 npx claude-smart uninstall     # or: uvx claude-smart uninstall
 ```
 
-Local data under `~/.reflexio/` and `~/.claude-smart/` is left in place — remove manually if desired.
+### Codex
+
+You need the `codex` CLI on `PATH` and Node.js available for `npx`:
+
+```bash
+npx claude-smart install --host codex
+```
+
+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 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.
+
+Installing from a clone is only for plugin development; see
+[DEVELOPER.md](./DEVELOPER.md#developing-locally).
+
+Codex and Claude Code intentionally share the same `CLAUDE_SMART_*` environment
+variables, `~/.reflexio/` data, `~/.claude-smart/` session buffers, backend,
+dashboard, and learned skills/preferences.
+
+
+To uninstall:
+
+```bash
+npx claude-smart uninstall --host codex
+```
+
+This removes the Codex marketplace registration, installed plugin config, and
+Codex plugin cache. Local data under `~/.reflexio/` and `~/.claude-smart/` is
+left in place — remove manually if desired. Restart Codex after uninstalling.
 
 Developing the plugin itself? See [DEVELOPER.md](./DEVELOPER.md#developing-locally).
-> **Not supported:** Claude Code Cowork and claude.ai/code web — they run in a remote sandbox, so the local backend/dashboard and `~/.reflexio/` aren't reachable.
+> **Not supported:** Claude Code Cowork, claude.ai/code web, or remote Codex environments without local plugin hooks — they run outside your local machine, so the local backend/dashboard and `~/.reflexio/` aren't reachable.
 
 ---
 
@@ -124,13 +166,13 @@ Developing the plugin itself? See [DEVELOPER.md](./DEVELOPER.md#developing-local
 - 🔌 **No external API call** — semantic search runs on an in-process ONNX embedder (all-MiniLM-L6-v2), and all data (preferences, skills, interaction buffers) is stored locally on your machine (`~/.reflexio/` and `~/.claude-smart/`).
 - 🔎 **Hybrid search** — Skills and preferences are indexed with vector + BM25 search for fast, robust retrieval.
 - 🧪 **Offline resilience** — If the reflexio backend is down, hooks buffer to disk; the next successful publish drains them.
-- 🧰 **Manual correction marker** — `/claude-smart:learn` flags the last turn as a correction so the extractor weights it heavily.
+- 🧰 **Manual correction marker** — `/claude-smart:learn` in Claude Code, or `bash ~/.reflexio/plugin-root/scripts/cli.sh learn` in Codex, flags the last turn as a correction so the extractor weights it heavily.
 
 ---
 
 ## Dashboard
 
-A web UI for browsing session histories, inspecting preferences, and editing project-specific and shared skills. The dashboard auto-starts alongside the backend, so you can open **http://localhost:3001** directly. Or run `/claude-smart:dashboard` in Claude Code to launch dashboard in browser.
+A web UI for browsing session histories, inspecting preferences, and editing project-specific and shared skills. The dashboard auto-starts alongside the backend, so you can open **http://localhost:3001** directly. Or run `/claude-smart:dashboard` in Claude Code to launch dashboard in browser. In Codex, run `bash ~/.reflexio/plugin-root/scripts/dashboard-open.sh`.
 
 <p align="center">
   <img src="assets/preferences_dashboard.png" alt="Preferences dashboard" width="49%">
@@ -141,7 +183,7 @@ A web UI for browsing session histories, inspecting preferences, and editing pro
 
 ## How It Works
 
-claude-smart builds three artifacts as you work and injects the relevant ones into Claude:
+claude-smart builds three artifacts as you work and injects the relevant ones into Claude Code or Codex:
 
 - **Preferences** (project-scoped) — how you work in this specific repo (stack, role, small quirks). *e.g.* "uses pnpm, not npm"; "prefers terse answers"; "backend engineer — explain frontend with backend analogues."
 - **Project-specific skills** — durable rules with triggers and rationales learned from corrections in a project. *e.g.* "always pass `--run` to `npm test` — watch mode hangs CI."
@@ -149,32 +191,36 @@ 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 Claude's 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` 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 (`cs-cite`).** At the end of a reply, Claude may run:
+**Citations.** At the end of a reply, the assistant may append a short marker:
 
 ```
-⏺ Bash(cs-cite s1-252,p1-5aed)
-  ⎿  (No output)
-
-⏺ ✨ 2 claude-smart learnings applied
+✨ 2 claude-smart learnings applied [cs:s1-252,p1-5aed]
 ```
 
-That signals a preference (`p…`) or skill (`s…`) materially shaped the reply. Open the interaction's detail page in the [dashboard](#dashboard) to see the exact cited item.
+That signals a preference (`p…`) or skill (`s…`) materially shaped the reply.
+Standalone wrappers like `✨abc123✨` are not claude-smart citations and will not
+link back to dashboard entries. Open the interaction's detail page in the
+[dashboard](#dashboard) to see the exact cited item.
 
 See [ARCHITECTURE.md](./ARCHITECTURE.md) for hooks, data flow, and reflexio details.
 
 ---
 
-## Slash Commands
+## Commands
 
-| Command | What it does |
-| --- | --- |
-| `/dashboard` | Open the dashboard in your browser, auto-starting the reflexio backend and dashboard services if they aren't already running. |
-| `/show` | Print current project-specific skills, shared skills, and the current project's preferences so you can audit learned state manually. |
-| `/learn [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` | Restart the reflexio backend and dashboard to pick up new changes (e.g. after upgrading the plugin or editing local reflexio code). |
-| `/clear-all` | **Destructive.** Delete *all* reflexio interactions, preferences, and skills. Use when you want to wipe learned state and start fresh. |
+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 |
+| --- | --- | --- |
+| `/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. |
 
 ---
 
@@ -189,7 +235,9 @@ Advanced users can tune claude-smart via environment variables — see [DEVELOPE
 | `~/.reflexio/data/reflexio.db` | Source of truth for learned preferences, skills, interactions, full-text indexes, and embedding tables (plus `.db-shm` / `.db-wal` WAL sidecars). Inspect with `sqlite3`. |
 | `~/.reflexio/.env` | Provider config — `CLAUDE_SMART_USE_LOCAL_CLI`, `CLAUDE_SMART_USE_LOCAL_EMBEDDING`, any optional API keys. |
 | `.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. |
-| `~/.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. |
+| `~/.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`). 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. |
 
@@ -211,4 +259,4 @@ See the [LICENSE](LICENSE) file for details.
 
 ---
 
-**Built on** [reflexio](https://github.com/ReflexioAI/reflexio) · **Runs on** [Claude Code](https://claude.com/claude-code) · **Written in** Python 3.12+
+**Built on** [reflexio](https://github.com/ReflexioAI/reflexio) · **Runs on** [Claude Code](https://claude.com/claude-code) and Codex · **Written in** Python 3.12+

package/bin/claude-smart.js

@@ -1,22 +1,75 @@
 #!/usr/bin/env node
 /**
- * npx claude-smart install — thin wrapper around the native Claude Code
- * plugin CLI. Registers the GitHub marketplace, installs the plugin, and
- * seeds ~/.reflexio/.env with the two local-provider flags so reflexio
- * can route generation through the local `claude` CLI with no API key.
+ * 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.
  *
  * Keep this file dependency-free — it runs via `npx` with no install step.
  */
 "use strict";
 
-const { execFileSync, execSync, spawn } = require("child_process");
-const { appendFileSync, existsSync, mkdirSync, readFileSync } = require("fs");
+const { execSync, spawn } = require("child_process");
+const {
+  appendFileSync,
+  cpSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  rmSync,
+  writeFileSync,
+} = require("fs");
 const { homedir } = 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";
+const CODEX_PLUGIN_ID = `claude-smart@${CODEX_MARKETPLACE_NAME}`;
 const REFLEXIO_ENV_PATH = join(homedir(), ".reflexio", ".env");
+const CODEX_CONFIG_PATH = join(homedir(), ".codex", "config.toml");
+const PACKAGE_ROOT = dirname(dirname(__filename));
+const CODEX_MARKETPLACE_DIR = join(
+  homedir(),
+  ".claude",
+  "plugins",
+  "marketplaces",
+  CODEX_MARKETPLACE_NAME,
+);
+const CODEX_MARKETPLACE_PLUGIN_PATH = join("plugins", "claude-smart");
+const CODEX_PLUGIN_CACHE_DIR = join(
+  homedir(),
+  ".codex",
+  "plugins",
+  "cache",
+  CODEX_MARKETPLACE_NAME,
+  "claude-smart",
+);
+const CODEX_REQUIRED_FILES = [
+  ".agents/plugins/marketplace.json",
+  "plugin/.codex-plugin/plugin.json",
+  "plugin/hooks/codex-hooks.json",
+  "plugin/scripts/_codex_env.sh",
+];
+const CODEX_CLI_TIMEOUT_MS = 30_000;
+const COPYTREE_IGNORE_NAMES = new Set([
+  "__pycache__",
+  ".venv",
+  ".pytest_cache",
+  ".ruff_cache",
+  "node_modules",
+  ".next",
+]);
+
+function shouldCopyPath(src) {
+  const base = src.split(/[\\/]/).pop() || "";
+  if (COPYTREE_IGNORE_NAMES.has(base)) return false;
+  if (base.endsWith(".pyc") || base.endsWith(".pyo")) return false;
+  return true;
+}
 
 function runClaude(args, { spinnerLabel } = {}) {
   const useSpinner = Boolean(spinnerLabel) && process.stdout.isTTY && !process.env.CI;
@@ -80,7 +133,11 @@ function runClaude(args, { spinnerLabel } = {}) {
 }
 
 function hasClaudeCli() {
-  const probe = process.platform === "win32" ? "where claude" : "command -v claude";
+  return hasCli("claude");
+}
+
+function hasCli(name) {
+  const probe = process.platform === "win32" ? `where ${name}` : `command -v ${name}`;
   try {
     execSync(probe, { stdio: "ignore" });
     return true;
@@ -89,6 +146,30 @@ function hasClaudeCli() {
   }
 }
 
+function runCodex(args) {
+  return new Promise((resolve) => {
+    const child = spawn("codex", args, {
+      stdio: "inherit",
+      timeout: CODEX_CLI_TIMEOUT_MS,
+      killSignal: "SIGTERM",
+    });
+    let timedOut = false;
+    child.on("exit", (code, signal) => {
+      if (signal === "SIGTERM" && code === null) {
+        timedOut = true;
+        process.stderr.write(
+          `error: codex ${args.join(" ")} timed out after ${CODEX_CLI_TIMEOUT_MS / 1000}s\n`,
+        );
+        resolve(124);
+        return;
+      }
+      if (timedOut) return;
+      resolve(typeof code === "number" ? code : 1);
+    });
+    child.on("error", () => resolve(1));
+  });
+}
+
 function seedReflexioEnv() {
   mkdirSync(dirname(REFLEXIO_ENV_PATH), { recursive: true });
   const existing = existsSync(REFLEXIO_ENV_PATH)
@@ -106,19 +187,28 @@ function seedReflexioEnv() {
 function printHelp() {
   process.stdout.write(
     [
-      "claude-smart — install helper for the Claude Code plugin",
+      "claude-smart — install helper for Claude Code and Codex",
       "",
       "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 uninstall --host codex        Remove the Codex marketplace registration",
       "  npx claude-smart --help                        Show this help",
       "",
-      "What it does:",
+      "Claude Code install:",
       "  1. claude plugin marketplace add <source>",
       `  2. claude plugin install ${PLUGIN_SPEC}`,
       "  3. Appends CLAUDE_SMART_USE_LOCAL_CLI=1 and CLAUDE_SMART_USE_LOCAL_EMBEDDING=1",
       "     to ~/.reflexio/.env (idempotent).",
       "",
+      "Codex install:",
+      `  1. Copies the bundled marketplace to ${CODEX_MARKETPLACE_DIR}`,
+      "  2. codex plugin marketplace add <copied marketplace>",
+      "  3. codex features enable plugin_hooks",
+      "  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",
       "",
@@ -140,6 +230,165 @@ function parseSource(args) {
   return value;
 }
 
+function parseHost(args) {
+  const idx = args.indexOf("--host");
+  if (idx === -1) return "claude-code";
+  const value = args[idx + 1];
+  if (!value) {
+    process.stderr.write("error: --host requires a value: claude-code or codex\n");
+    process.exit(1);
+  }
+  if (value !== "claude-code" && value !== "codex") {
+    process.stderr.write("error: --host must be claude-code or codex\n");
+    process.exit(1);
+  }
+  return value;
+}
+
+function copyCodexMarketplace() {
+  for (const rel of CODEX_REQUIRED_FILES) {
+    const path = join(PACKAGE_ROOT, rel);
+    if (!existsSync(path)) {
+      process.stderr.write(
+        `error: published package is missing ${rel}; reinstall claude-smart or use a newer release\n`,
+      );
+      process.exit(1);
+    }
+  }
+
+  rmSync(CODEX_MARKETPLACE_DIR, { recursive: true, force: true });
+  mkdirSync(join(CODEX_MARKETPLACE_DIR, ".agents", "plugins"), { recursive: true });
+  mkdirSync(join(CODEX_MARKETPLACE_DIR, "plugins"), { recursive: true });
+
+  writeFileSync(
+    join(CODEX_MARKETPLACE_DIR, ".agents", "plugins", "marketplace.json"),
+    JSON.stringify(
+      {
+        name: CODEX_MARKETPLACE_NAME,
+        interface: { displayName: CODEX_MARKETPLACE_DISPLAY_NAME },
+        plugins: [
+          {
+            name: "claude-smart",
+            source: {
+              source: "local",
+              path: `./${CODEX_MARKETPLACE_PLUGIN_PATH}`,
+            },
+            policy: {
+              installation: "AVAILABLE",
+              authentication: "ON_INSTALL",
+            },
+            category: "Productivity",
+          },
+        ],
+      },
+      null,
+      2,
+    ) + "\n",
+  );
+
+  cpSync(join(PACKAGE_ROOT, "plugin"), join(CODEX_MARKETPLACE_DIR, CODEX_MARKETPLACE_PLUGIN_PATH), {
+    recursive: true,
+    force: true,
+    verbatimSymlinks: false,
+    filter: shouldCopyPath,
+  });
+
+  for (const rel of ["README.md", "LICENSE", "package.json"]) {
+    const src = join(PACKAGE_ROOT, rel);
+    if (existsSync(src)) {
+      cpSync(src, join(CODEX_MARKETPLACE_DIR, rel), {
+        recursive: true,
+        force: true,
+        verbatimSymlinks: false,
+      });
+    }
+  }
+  return CODEX_MARKETPLACE_DIR;
+}
+
+function removeTomlSections(path, { exact, prefixes = [] }) {
+  if (!existsSync(path)) return true;
+  const text = readFileSync(path, "utf8");
+  if (!text) return true;
+
+  let changed = false;
+  let dropping = false;
+  const lines = text.split(/(?<=\n)/);
+  const kept = [];
+  for (const line of lines) {
+    const match = line.match(/^\s*\[([^\]]+)\]\s*(?:#.*)?$/);
+    if (match) {
+      const name = match[1].trim();
+      dropping = exact.has(name) || prefixes.some((prefix) => name.startsWith(prefix));
+      changed = changed || dropping;
+    }
+    if (!dropping) kept.push(line);
+  }
+  if (changed) writeFileSync(path, kept.join(""));
+  return true;
+}
+
+function cleanupCodexInstallState() {
+  removeTomlSections(CODEX_CONFIG_PATH, {
+    exact: new Set([
+      `plugins."${CODEX_PLUGIN_ID}"`,
+      `marketplaces.${CODEX_MARKETPLACE_NAME}`,
+    ]),
+    prefixes: [`hooks.state."${CODEX_PLUGIN_ID}:`],
+  });
+  rmSync(CODEX_MARKETPLACE_DIR, { recursive: true, force: true });
+  rmSync(CODEX_PLUGIN_CACHE_DIR, { recursive: true, force: true });
+  try {
+    rmSync(dirname(CODEX_PLUGIN_CACHE_DIR), { recursive: false, force: true });
+  } catch {
+    // Leave the marketplace cache parent if Codex has other entries there.
+  }
+}
+
+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(
@@ -160,7 +409,12 @@ async function runUpdate() {
   process.stdout.write("\nclaude-smart updated. Restart Claude Code to apply.\n");
 }
 
-async function runUninstall() {
+async function runUninstall(args) {
+  if (parseHost(args) === "codex") {
+    await runUninstallCodex();
+    return;
+  }
+
   if (!hasClaudeCli()) {
     process.stderr.write(
       "error: 'claude' CLI not found on PATH. " +
@@ -190,6 +444,11 @@ async function runUninstall() {
 }
 
 async function runInstall(args) {
+  if (parseHost(args) === "codex") {
+    await runInstallCodex();
+    return;
+  }
+
   if (!hasClaudeCli()) {
     process.stderr.write(
       "error: 'claude' CLI not found on PATH. " +
@@ -232,6 +491,91 @@ async function runInstall(args) {
   );
 }
 
+async function runInstallCodex() {
+  if (!hasCli("codex")) {
+    process.stderr.write("error: 'codex' CLI not found on PATH. Install Codex first.\n");
+    process.exit(1);
+  }
+
+  const marketplaceRoot = copyCodexMarketplace();
+  process.stdout.write(`Prepared Codex marketplace at ${marketplaceRoot}.\n`);
+
+  let code = await runCodex(["plugin", "marketplace", "add", marketplaceRoot]);
+  if (code !== 0) {
+    process.stderr.write(
+      `warning: \`codex plugin marketplace add ${marketplaceRoot}\` failed; retrying after removing ${CODEX_MARKETPLACE_NAME}.\n`,
+    );
+    await runCodex(["plugin", "marketplace", "remove", CODEX_MARKETPLACE_NAME]);
+    code = await runCodex(["plugin", "marketplace", "add", marketplaceRoot]);
+  }
+  if (code !== 0) {
+    process.stderr.write(
+      `error: could not register Codex marketplace. Run manually: codex plugin marketplace add ${marketplaceRoot}\n`,
+    );
+    process.exit(code);
+  }
+
+  code = await runCodex(["features", "enable", "plugin_hooks"]);
+  if (code !== 0) {
+    process.stderr.write("error: could not enable Codex plugin_hooks feature.\n");
+    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`);
+  }
+
+  process.stdout.write(
+    [
+      "",
+      "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"),
+  );
+}
+
+async function runUninstallCodex() {
+  if (!hasCli("codex")) {
+    process.stdout.write("Codex CLI not found; skipping marketplace removal.\n");
+    cleanupCodexInstallState();
+    return;
+  }
+
+  const code = await runCodex(["plugin", "marketplace", "remove", CODEX_MARKETPLACE_NAME]);
+  if (code !== 0) {
+    process.stderr.write(
+      `warning: Codex marketplace removal failed; remove manually with: codex plugin marketplace remove ${CODEX_MARKETPLACE_NAME}\n`,
+    );
+  }
+  cleanupCodexInstallState();
+
+  process.stdout.write(
+    [
+      "",
+      "claude-smart Codex plugin and marketplace state removed. Restart Codex to apply.",
+      "Codex's global plugin_hooks feature and local data under ~/.reflexio/ and ~/.claude-smart/ were left in place.",
+      "",
+    ].join("\n"),
+  );
+}
+
 async function main() {
   const args = process.argv.slice(2);
   const cmd = args[0] || "install";
@@ -252,7 +596,7 @@ async function main() {
   }
 
   if (cmd === "uninstall") {
-    await runUninstall();
+    await runUninstall(args.slice(1));
     return;
   }