git404hub

what is claude-soul fr?

domdemetz/claude-soul — explained in plain English

Analysis updated 2026-05-18

49TypeScriptAudience · developerComplexity · 2/5Setup · easy

tl;dr

An add-on for Claude Code that builds persistent, evolving memory of how you work by learning from corrections and successes across sessions, all stored locally.

vibe map

mindmap
  root((repo))
    What it does
      Persistent memory
      Cognitive frameworks
      Signal extraction
    Tech stack
      TypeScript
      Node.js
      MCP tools
    Use cases
      Cross session identity
      Adaptive detail level
      Track what worked
    Audience
      Claude Code users
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Give Claude Code a persistent identity and memory that carries over between coding sessions.

VIBE 2

Let Claude Code learn your preferred level of detail and when to push back on decisions.

VIBE 3

Track what approaches worked or failed on a project so future sessions build on that history.

what's the stack?

TypeScriptNode.jsMCP

how it stacks up fr

domdemetz/claude-soulalemtuzlak/kiirablazeup-ai/pi-insights
Stars494949
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderateeasy
Complexity2/52/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires Node.js 18 or newer and an active Claude Code Pro or Max subscription.

in plain english

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.

prompts (copy fr)

prompt 1
Help me install Claude Soul with the --starter flag and explain what it seeds into my identity file.
prompt 2
Show me how to add the soul_context call to my CLAUDE.md so every session loads it automatically.
prompt 3
Explain the difference between a quick, deep, and meta reflection in Claude Soul.
prompt 4
Walk me through how Claude Soul's signal extraction and framework evolution works between sessions.

Frequently asked questions

what is claude-soul fr?

An add-on for Claude Code that builds persistent, evolving memory of how you work by learning from corrections and successes across sessions, all stored locally.

What language is claude-soul written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

How hard is claude-soul to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is claude-soul for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.