claude-smart
The Claude Code plugin that makes Claude Code self-improve as you use it — so Claude Code stops repeating mistakes and gets better every session.
Quick Start •
How It Works •
Slash Commands •
Dashboard •
Configuration •
Troubleshooting •
License
It learns both corrections and successful execution patterns—so Claude Code avoids repeating mistakes and reuses what works. Playbook rules travel with you across every project; per-project profiles capture how you like to work on each repo.
Head-to-head vs claude-mem. Evaluated across 12 scripted scenarios.
~2.7× higher overall quality · Right user correction learnt every time vs none · See EXPERIMENT.md for details.
Why Learning, Not Memory
Most memory solutions are still mostly informative—Claude remembers what happened, without necessarily changing what it does next.
claude-smart focuses on learning instead.
Four ways this changes what Claude Code can do for you:
-
💡 Stop repeating the same mistakes: Produces actionable playbooks Claude can follow next time; memory only records what happened.
Example: you tell Claude to stop running npm test without --run because watch mode hangs.
Memory: “user was annoyed about npm test hanging”
Learning: “always pass --run to npm test in this repo — default watch mode blocks CI”
-
🚀 Start from the optimized path: Preserves and optimizes execution paths so Claude can reuse what already works.
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.
Memory: “user mentioned that npm run dev did not work”
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.
-
🌐 Global playbook, project-scoped profiles: Session memory disappears with the conversation. The playbook persists globally — rules learned in one repo are available in every repo you work in — while user profiles stay scoped to the current project so per-repo preferences don't leak across projects.
-
🪶 Better context without prompt bloat: Distilled, deduplicated playbooks stay in dozens of tokens—not thousands—even as the project grows.
Quick Start
npx claude-smart install # or: uvx claude-smart install
Or run the equivalent marketplace commands directly via the Claude Code CLI:
claude plugin marketplace add ReflexioAI/claude-smart
claude plugin install claude-smart@reflexioai
Then restart Claude Code.
To uninstall:
npx claude-smart uninstall # or: uvx claude-smart uninstall
Or run the equivalent command directly via the Claude Code CLI:
claude plugin uninstall claude-smart@reflexioai
Local data under ~/.reflexio/ and ~/.claude-smart/ is left in place — remove manually if desired.
Developing the plugin itself? See DEVELOPER.md.
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.
Key Features
