What is claude-soul?

Claude Soul is an add-on for Claude Code, Anthropic's AI coding assistant, that gives it a kind of persistent memory and an evolving thinking style across sessions. By default, Claude Code starts fresh each time you open it, with no recollection of previous conversations, your preferences, or what worked and what did not. Claude Soul is built to change that, and it goes beyond simply storing notes. The idea is that instead of just remembering facts, such as that a user prefers concise answers, it develops what the project calls cognitive frameworks: patterns of reasoning and behavior that emerge from your actual usage. When you correct a mistake, when something works particularly well, or when you express confusion, the system extracts those signals automatically at the end of each session. Periodically, it runs a reflection process that tests those signals against existing frameworks, updates their confidence, retires frameworks that proved unhelpful, and discovers new ones that fit how you actually work. Over time the claim is that Claude becomes more calibrated to you specifically. It learns when to push back rather than just agree, how much detail you want for a given kind of question, and when to flag uncertainty rather than guess. The project describes three tiers of reflection, using progressively larger models, that run at different signal thresholds as the system matures. Everything runs locally on your machine, using Claude Code's official extension system of MCP tools and hooks, and nothing is sent to a cloud service. It is installed via a command-line tool and requires Node.js and an active Claude Code Pro or Max subscription. The project is written in TypeScript.