Add the marketplace and install the plugin

/plugin marketplace add ReflexioAI/claude-smart
/plugin install claude-smart@reflexioai

npx claude-smart install

uvx claude-smart install

Restart Claude Code

Close and reopen Claude Code so the plugin's hooks are registered. The first session will take a few extra seconds — the Setup hook syncs the Python environment, downloads the ONNX embedder (~80 MB), and prebuilds the dashboard.

Verify the backend is up

On SessionStart, claude-smart spawns a local Reflexio backend on localhost:8081 and a dashboard on localhost:3001. Check the backend:

curl http://localhost:8081/health
# {"status":"healthy"}

Then open http://localhost:3001 in a browser to see the dashboard.

Check what Claude is being told

Inside Claude Code, run:

/show

On a brand-new install, this prints empty sections. As you work, profiles and playbook rules populate here — /show always reflects the exact markdown that SessionStart injects into Claude's system prompt.

Teach it your first rule

Have a short conversation that contains a correction, for example:

You: run the tests Claude: runs npm test You: stop — in this repo always pass --run, watch mode hangs CI

Then force extraction instead of waiting for the end of the session:

/learn

Wait 20–30 seconds, then run /show again. The new rule appears in the Project Playbook section. It will be reinjected on every future session in this project.