Improving Claude Code Sessions with claude-self-improve

claude-self-improve is a command-line tool created to address repetitive errors in Claude Code sessions by automating the analysis and updating of memory files. This tool was developed due to the tedious nature of manually curating MEMORY.md files to improve AI-driven coding sessions.

The process involves three main steps:

• The tool reads session facets, specifically the JSON performance data Claude Code already generates.
• This data is sent to headless Claude (also referred to as Sonnet), where it extracts patterns indicating friction and successes, as well as lessons learned.
• Upon analysis, it updates MEMORY.md autonomously, making sure the subsequent sessions are incrementally smarter.

After evaluating 52 sessions, the tool reported a 42% friction rate and identified common anti-patterns. For instance, 'wrong initial diagnosis' accounted for 41% of the friction events. The system also suggested four memory updates and three CLAUDE.md improvements without the need for manual review.

# Example command
bash claude-self-improve.sh

Running the tool costs approximately $0.07 to $0.20 per session. The code repository is available on GitHub, providing access to the script and allowing other developers to implement similar improvements.