Summary

ReflexioAI/claude-smart transforms AI coding assistants like Claude Code and Codex from passive memory users into active learners. It enables them to durably acquire skills from user corrections and successful patterns, preventing repeated mistakes and optimizing future workflows. This plugin targets developers seeking more efficient and reliable AI-assisted coding by building persistent, reusable knowledge.

How It Works

It employs a "learning, not memory" approach, extracting actionable skills and preferences from interactions, not just logging events. User corrections and successful patterns are distilled into structured, deduplicated rules. Lifecycle hooks automatically capture turns, tool calls, and responses. An internal engine (reflexio) processes these into project-specific and shared skills. Learned artifacts are injected via hybrid search (vector + BM25) for efficient context retrieval, avoiding prompt bloat.

Quick Start & Requirements

Install via npx claude-smart install (Claude Code) or npx claude-smart install --host codex (Codex), or through the Claude Code plugin marketplace. Prerequisites include Node.js and Python 3.12+. Initial setup requires network access for dependencies and models. Platforms: Apple Silicon macOS 14+, Windows x64, Linux (local hooks). Intel Macs, older macOS, Windows ARM unsupported due to dependency limits. Dashboard: http://localhost:3001.

Highlighted Details

• Durable Learning: Corrections become structured, deduplicated rules, not transcript replays.
• Automatic & Self-Tuning: Learning is automatic via hooks; rules are continuously refined, scopes adjusted, and stale rules archived.
• Local & Private: All processing, including ONNX embedding, is local; no external API calls.
• Hybrid Search: Skills and preferences indexed via vector + BM25 for fast, robust retrieval.
• Offline Resilience: Buffers data locally for later sync if the backend is unavailable.

Maintenance & Community

Built on reflexio and Python 3.12+. Issues on GitHub. No specific community channels or contributors detailed.

Licensing & Compatibility

Apache License 2.0, permitting commercial use. Incompatible with Claude Code Cowork, claude.ai/code web, or remote Codex without local hooks.

Limitations & Caveats

Limited OS/hardware support (no Intel Mac, older macOS, Windows ARM) due to dependency issues. Network required for install. Remote/web AI without local plugin execution incompatible.