![\"claude-smart\"](\"assets/claude-smart-icon.png\"){kind=icon}
\n\n \n
\n \n ![\"License\"](\"https://img.shields.io/badge/License-Apache%202.0-blue.svg\"){kind=icon}
\n \n \n ![\"Version\"](\"https://img.shields.io/badge/version-0.3.3-green.svg\"){kind=icon}
\n \n \n ![\"Python\"](\"https://img.shields.io/badge/python-%3E%3D3.12-brightgreen.svg\"){kind=icon}
\n \n \n ![\"Node\"](\"https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg\"){kind=icon}
\n \n \n ![\"Hosts\"](\"https://img.shields.io/badge/hosts-Claude%20Code%20%2B%20Codex%20%2B%20OpenCode-purple.svg\"){kind=icon}
\n \n \n ![\"Discord\"](\"https://img.shields.io/badge/Discord-Join%20community-5865F2?logo=discord&logoColor=white\"){kind=icon}
![\"Star](\"https://img.shields.io/github/stars/ReflexioAI/reflexio?style=flat&logo=github&label=Star%20reflexio&color=yellow&cacheSeconds=3600\")
\n Quick Start •\n How It Works •\n Commands •\n Dashboard •\n Configuration •\n Troubleshooting •\n License\n
\n\n\n claude-smart learns from your corrections and 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.\n
\n\n\n vs claude-mem: ~3× better at turning your corrections into rules Claude follows, ~50% more of your guidance is retained. Read the benchmark →\n
\n ⭐ Built on the open-source reflexio engine — if claude-smart helps you, star reflexio on GitHub.\n
\n\n---\n\n## Quick Start\n\nRequires Node.js 20+ (for `npx`) and the host CLI you're installing into (`claude`, `codex`, or `opencode`) on `PATH`.\n\n### Claude Code\n\n```bash\nnpx claude-smart install\n```\n\nThen restart Claude Code.\n\n### Codex\n\n```bash\nnpx claude-smart install --host codex\n```\n\nThen fully quit and reopen Codex so hooks reload.\n\n### OpenCode\n\n```bash\nnpx claude-smart install --host opencode\n```\n\nThen restart OpenCode in your project so it loads the plugin from `opencode.json`. Add `--global` to install for all OpenCode projects on this machine instead.\n\n### Uninstall\n\n```bash\nnpx claude-smart uninstall # Claude Code\nnpx claude-smart uninstall --host codex # Codex\nnpx claude-smart uninstall --host opencode # OpenCode\n```\n\nRestart the host afterward. Learned data under `~/.reflexio/` and `~/.claude-smart/` is preserved and shared across hosts, so you can uninstall or switch hosts without losing skills or preferences.\n\nFor per-host details — what the installers and uninstallers touch, OpenCode config resolution and model/env overrides, and Windows notes — see [Host install notes](./DEVELOPER.md#host-install-notes) in DEVELOPER.md. Developing the plugin itself? See [Developing locally](./DEVELOPER.md#developing-locally).\n\n> **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.\n\n---\n\n## Why Learning, Not Memory\n\nMost memory tools just record. Claude remembers what happened, but doesn't change what it does next.\n\n`claude-smart` focuses on learning instead.\n\nFour things this changes:\n\n- 💡 **Stop repeating the same mistakes:** Produces actionable skills Claude can follow next time; memory only records what happened.\n\n > *Example:* a deploy fails after Claude bumps `prisma` from 5.x to 6.0; you tell it to roll back because 6.0 breaks nested writes in your order flow.\n ![\"Preferences](\"assets/preferences_dashboard.png\")
\n ![\"Skills](\"assets/skills_dashboard.png\")
\n