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 /deploy command 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/bayramannakovclaude-reflect.svg)](https://yunodb.com/tools/bayramannakovclaude-reflect?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/bayramannakovclaude-reflect?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/bayramannakovclaude-reflect.svg" alt="Featured on YunoDB" height="20"></a>