DomDemetz/claude-soul

Overview

A self-correcting learning engine for Claude Code that provides persistent identity, behavioral pattern tracking, and cross-session memory. It tracks user interactions across sessions to build a consistent interaction history and adapt its responses over time. Built in TypeScript, it integrates directly with Claude Code to maintain context without manual reconfiguration.

Best for

Best for
Developers using Claude Code who want a consistent, adaptive coding assistant experience

Use cases

• Maintaining consistent assistant identity across multiple coding sessions
• Tracking and adapting to user's preferred coding patterns
• Reducing repetitive instructions by remembering past interactions

How to use

Install

npx claude-soul init --starter

Tools exposed

• soul_context
• soul_activate
• soul_framework
• soul_signal
• soul_reflect
• soul_self_evaluate
• soul_read
• soul_write
• soul_status
• memory_save
• memory_search
• memory_journal
• memory_recent
• memory_stats

Tested with

Claude Code

Notes

A self-correcting learning engine for Claude Code that provides persistent identity, behavioral pattern tracking, and cross-session memory. It tracks user interactions across sessions to build a consistent interaction history and adapt its responses over time. Built in TypeScript, it integrates directly with Claude Code to maintain context without manual reconfiguration.

83 stars on GitHub. Last updated 2026-05-29. Licensed MIT.

Use cases

• Maintaining consistent assistant identity across multiple coding sessions
• Tracking and adapting to user’s preferred coding patterns
• Reducing repetitive instructions by remembering past interactions

Pros

• Enables persistent context without manual reconfiguration
• Self-correcting mechanism improves response relevance over time
• Lightweight TypeScript implementation integrates easily with Claude Code

Cons

• Dependency on Claude Code limits applicability to other tools
• Small open-source project with limited community support (83 stars)
• Requires careful management of stored memory data for privacy

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.