claude-reflect
A self-learning system for Claude Code that captures corrections, positive feedback, and preferences — then syncs them to CLAUDE.md and AGENTS.md.
What is claude-reflect?
A self-learning system for Claude Code that captures corrections, positive feedback, and preferences — then syncs them to CLAUDE.md and AGENTS.md.
Overview of claude-reflect
What it is
claude-reflect is a self-learning system for Claude Code that captures corrections, positive feedback, and preferences, then syncs them to CLAUDE.md and AGENTS.md. It is an open-source tool available under the MIT license. The system can be run as a Python plugin or as a mod (reflect-mod) for Claude Code 2.1.286 or newer. It is designed to turn corrections and workflow patterns into permanent memory and reusable skills.
Key features
- Permanent Memory: Corrections sync to CLAUDE.md, so Claude remembers across sessions.
- Skill Discovery: Analyzes session history to find repeating patterns and generates reusable commands.
- Multi-language: AI understands corrections in any language.
- Skill Improvement: Corrections made during a
/deploycommand improve the deploy skill itself.
Use cases
Claude-reflect is useful for users who want Claude Code to learn from corrections over time, reducing the need to repeat the same instructions. It can be used to capture workflow patterns from past sessions and turn them into reusable commands. It also supports multi-language corrections, making it suitable for non-English users. The tool can sync learnings to multiple targets, including project-specific CLAUDE.md files and AGENTS.md for compatibility with Codex, Cursor, Aider, Jules, Zed, and Factory.
Getting started
bash# Add the marketplaceclaude plugin marketplace add bayramannakov/claude-reflect# Install the pluginclaude plugin install claude-reflect@claude-reflect-marketplace# IMPORTANT: Restart Claude Code to activate the pluginAfter installation, restart Claude Code. Hooks auto-configure and commands are ready. Prerequisites include Claude Code CLI and Python 3.6+. For the mod installation, use: claude plugin install reflect-mod@claude-reflect-marketplace.
License and pricing
This project is licensed under the MIT license. It is open-source and free to use.
Based on the project's public README and repository metadata.