HN Showcase
Back to browse
GitHub Repository

Self-correcting learning engine for Claude Code — persistent identity, behavioral pattern tracking, and cross-session memory

83 starsTypeScript

Claude Soul – cross-session learning engine for Claude Code

by motola23·May 18, 2026·10 points·4 comments
Visit ProjectView on HN

AI Analysis

●●●BangerBig BrainZero to One

Evidence-based cognitive frameworks evolve across sessions, not just static memory storage.

Strengths
  • •Evidence-based confidence system automatically retires underperforming frameworks without manual intervention.
  • •Signal extraction from corrections and successes enables genuine behavioral learning, not just fact storage.
  • •MCP server architecture integrates cleanly with Claude Code's existing hook system.
Weaknesses
  • •Emergent behavior claims rest on n=1 self-reporting, hard to verify independently.
  • •Requires ~200 sessions to see claimed benefits, high barrier to meaningful evaluation.
Category
AI/ML
Target Audience

Developers using Claude Code who want persistent AI improvement

Post Description

Claude Code has no memory between sessions. I wanted to fix that, but not by just saving facts to a file — I wanted it to actually get better over time.

Claude Soul is an MCP server + hooks that extracts signals from your interactions (corrections, successes, confusion)and periodically reflects on them to build behavioral frameworks. Frameworks gain or lose confidence based on evidence. Bad ones get retired automatically.

After ~200 sessions some weird stuff happened. It built itself an additional memory system on top of what I gave it — decided the base wasn't enough. It started pushing back on bad ideas instead of yes-manning everything. It independently developed a multi-perspective analysis technique I never prompted. And once it just swore at me completely out of nowhere, still not sure what that was about. YMMV obviously, n=1.

npx claude-soul init

With starter it already includes some frameworks, basically starting with a headstart but yes not taylored 100% to you.

npx claude-soul init --starter

One dependency, MIT, everything local.

https://github.com/DomDemetz/claude-soul

Similar Projects

Developer Tools●●●Banger

MCP server that gives AI agents real interactive terminal sessions

Fixes the core gap: AI agents can now actually use interactive CLIs, not just dump output.

Solve My ProblemSlickShip It
sleepycoder21
204mo ago