claude-smart 0.2.28 → 0.2.30

package/README.md

@@ -6,14 +6,14 @@
   claude-smart
 </h1>
 
-<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>
+<h4 align="center">A self-improvement plugin for <a href="https://claude.com/claude-code" target="_blank">Claude Code</a> and Codex that turns interactions into durable skills they follow 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.28-green.svg" alt="Version">
+    <img src="https://img.shields.io/badge/version-0.2.30-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">
@@ -24,9 +24,6 @@
   <a href="#quick-start">
     <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">
-  </a>
 </p>
 
 <p align="center">
@@ -40,22 +37,22 @@
 </p>
 
 <p align="center">
-  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.
+  claude-smart learns from your corrections <i>and</i> from what's already working — so the assistant stops repeating mistakes and reuses proven paths. Project-specific skills capture repo-local rules, and shared skills roll up durable patterns for reuse across projects.
 </p>
 
 <p align="center">
-  <b>vs <code>claude-mem</code>:</b> ~3× better at turning your corrections into rules Claude follows, ~50% more of what you tell Claude sticks. <a href="EXPERIMENT.md"><b>Read the benchmark →</b></a>
+  <b>vs <code>claude-mem</code>:</b> ~3× better at turning your corrections into rules Claude follows, ~50% more of your guidance is retained. <a href="EXPERIMENT.md"><b>Read the benchmark →</b></a>
 </p>
 
 ---
 
 ## Why Learning, Not Memory
 
-Most memory solutions are still mostly informative—Claude remembers what happened, without necessarily changing what it does next.
+Most memory tools just record. Claude remembers what happened, but doesn't change what it does next.
 
 `claude-smart` focuses on learning instead.
 
-Four ways this changes what your coding assistant can do for you:
+Four things this changes:
 
 - 💡 **Stop repeating the same mistakes:** Produces actionable skills Claude can follow next time; memory only records what happened.
 
@@ -63,12 +60,12 @@ Four ways this changes what your coding assistant can do for you:
   > **Memory:** “deploy broke after prisma bump; user rolled back”<br>
   > **Learning:** “treat major-version bumps of ORMs/DB drivers as breaking — verify with integration tests, not just unit tests”
 
-- 🚀 **Start from the optimized path:** Preserves and optimizes execution paths so Claude can reuse what already works.
+- 🚀 **Start from the optimized path:** Records and optimizes the steps that worked so Claude can reuse them, instead of re-exploring each session.
   > *Example:* Claude spends several iterations trying to start the local dev environment before discovering that this repo requires `pnpm dev:all` instead of the usual `npm run dev`.<br>
   > **Memory:** “user mentioned that `npm run dev` did not work”<br>
   > **Learning:** “for this repo, always use `pnpm dev:all` to start the full local stack — `npm run dev` only starts the frontend and causes missing service errors”
 
-  Instead of re-exploring, Claude starts from the proven path—reducing planning steps, latency, and token usage.
+  Instead of re-exploring, Claude Code starts from the proven path—reducing planning steps, latency, and token usage.
 
 - 🌐 **Project-specific and shared skills:** Session memory disappears with the conversation. Project-specific skills preserve repo-local rules, while shared skills roll up patterns that should transfer across projects. Preferences stay scoped to the current project so per-repo preferences don't leak across projects.
 
@@ -95,10 +92,6 @@ claude plugin marketplace add ReflexioAI/claude-smart
 claude plugin install claude-smart@reflexioai
 ```
 
-The plugin Setup hook installs its own `uv`, Python 3.12 environment, and
-private Node.js/npm runtime under `~/.claude-smart/` when they are missing, so
-you do not need to install Python or Node globally for the plugin/dashboard.
-
 To uninstall:
 
 ```bash
@@ -133,6 +126,19 @@ Developing the plugin itself? See [DEVELOPER.md](./DEVELOPER.md#developing-local
 
 > **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.
 
+### Vanilla OS support
+
+| Platform | Status | Notes |
+| --- | --- | --- |
+| Apple Silicon macOS 14+ | Supported | Runtime bootstrap installs private Node/npm, uv, Python 3.12 deps, and dashboard deps. |
+| Windows x64 | Supported | Runtime bootstrap uses PowerShell for uv/Node archive extraction and patches Codex hooks to the Node wrapper. |
+| Linux | Supported when host hooks are local | Existing Linux behavior is preserved; install coverage depends on available Python wheels. |
+| Intel Mac, macOS 13 or older, Windows ARM | Not supported | Current local embedding/ML dependencies do not publish a complete native wheel set for these targets. |
+
+Network access is required during first install for npm, PyPI/uv, Node.js, and
+the first local embedding model download. The ONNX model cache lives at
+`~/.cache/chroma/onnx_models/all-MiniLM-L6-v2/`.
+
 ---
 
 ## Key Features
@@ -150,7 +156,7 @@ Developing the plugin itself? See [DEVELOPER.md](./DEVELOPER.md#developing-local
 
 ## 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. In Codex, run `bash ~/.reflexio/plugin-root/scripts/dashboard-open.sh`.
+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 open it in your 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%">
@@ -216,6 +222,7 @@ Advanced users can tune claude-smart via environment variables — see [DEVELOPE
 | `~/.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. |
+| `~/.claude-smart/node/current/` | Private Node.js/npm runtime used by hooks and the dashboard after install. |
 | `~/.cache/chroma/onnx_models/all-MiniLM-L6-v2/` | Cached ONNX weights (~86 MB, downloaded once). Delete to force a re-download. |
 
 For troubleshooting, see [TROUBLESHOOTING.md](./TROUBLESHOOTING.md).