claude-smart

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