claude-smart plugin
A self-improvement plugin for Claude Code, Codex and OpenCode: turns corrections into rules the agent follows in later sessions
- 794 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- Reads turns, tool calls and replies and stores them locally
- Runs a background service, hooks and a web dashboard on your machine
Install
- Works in
Manual install
npx claude-smart installRestart Claude Code after installing.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Reads turns, tool calls and replies and stores them locally
- Runs a background service, hooks and a web dashboard on your machine
This is third-party code. Review the repository files before installing.
What it does
This is a self-improvement plugin for Claude Code, Codex and OpenCode. Through lifecycle hooks it watches your turns, tool calls and the agent's replies, and turns corrections and working paths into durable rules the agent follows in later sessions. It builds three kinds of artifacts: project-scoped preferences, project-specific skills and shared skills that transfer across projects. Rules do not just accumulate, they get refined: near-duplicates merge and stale ones are archived. Everything runs locally without external calls: semantic search runs on an in-process ONNX embedder, data lives in home directories, and a web dashboard lets you browse history and edit skills.
Who it is for. For developers who want the agent to retain their rules and stop repeating the same mistakes.
Good fit when
- The agent keeps repeating the same mistakes
- You want to lock in project rules and proven paths across sessions
- You want memory and learning kept fully local, without external services
Not a fit when
- You work in Cowork, claude.ai web or a remote environment without local hooks
- A local background service and history storage are undesirable
Example request
Remember that in this repo the local stack starts with pnpm dev:all, not npm run devLimitations
It needs Node.js 20+ and Python 3.12+ plus the host CLI installed. It does not work in Claude Code Cowork, claude.ai web or remote environments without local hooks, since the local backend and home directories are unreachable there. On first run it downloads embedding model weights of about 86 MB once. The plugin reads the contents of your sessions and stores them locally.
How to disable. Run npx claude-smart uninstall (for Codex or OpenCode add --host codex or --host opencode) and restart the host. Data in ~/.reflexio/ and ~/.claude-smart/ is preserved and can be deleted by hand.
FAQ
Does data leave my machine?
No. Everything is stored locally and semantic search runs on an in-process ONNX embedder with no external calls.
How is this different from memory?
Memory records what happened. The plugin extracts rules with when-to-apply triggers from corrections and follows them in new sessions.
Discussion
No questions or reviews yet.
Related
PluginsA Claude Code plugin with hooks and 26 skills: measures what the agent knows, blocks edits until code is read, keeps memory
claude-mods adds 112 skills, 3 agents and 3 commands to Claude Code: stacks, agent operation, defense, session continuity.
A Claude Code plugin with correction memory: every fix becomes a rule, plus topic wikis, hooks and dozens of skills
AI Builder Club Skills
AI Builder Club — Skills
A Claude Code plugin marketplace to make a repo agent-ready and run compounding agent loops
Multi-agent orchestration for Claude Code: teams, roles, autopilot and task routing across skills and subagents
A self-learning skill layer for Claude Code that distills skills from your sessions, updates them in use and prunes the unused
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| claude-smart (this card) | no | 794 | |
| Agent Apprenticeship | no | 1,603 | a CLI for training agents |
| Homunculus | no | 398 | a Claude Code plugin that records how you work |
README in short
The README describes claude-smart as a self-improvement plugin for Claude Code, Codex and OpenCode that turns corrections and working paths into rules rather than just recording events. It builds project preferences, project skills and shared skills, refining and merging them over time. All data and search are local: an in-process ONNX embedder, hybrid search and storage in home directories. It ships a web dashboard, slash commands and a manual learning marker. Installation is via npx, the license is Apache-2.0, and the reflexio engine is open source.