How local-first cognitive memory actually works.
A technical series on Corsoul's design — the four-layer memory model, the personality engine, and the boundaries we draw. Every claim maps to a real data structure or permission boundary; where there's no benchmark, we don't invent one.
Core Concepts
How memory is stored, organized, recalled — and why you can trust it.
The Four-Layer Memory Architecture: Beyond Vector Search
Instead of flattening everything into one vector store, Corsoul separates raw experience, structured facts, a weighted association graph, and abstract patterns into four layers that transform memory the way cognition does.
Read Core ConceptsSleep Consolidation: While the Agent Rests, Memory Organizes Itself
Corsoul's sleep consolidation is an offline, four-phase pass that refines raw events into structure, associations, and patterns—and audits contradictions across layers—without spending the agent's in-conversation compute.
Read Core ConceptsContradiction Auditing: Conflicts Are Auditable States, Not Overwrites
Instead of letting new information silently overwrite old memory, Corsoul treats a contradiction as an auditable state that must be settled by evidence — so a single anomaly can't poison trusted memory.
Read Core ConceptsHonest Retrieval: Knowing What It Doesn't Know
Vector search always hands back "the closest thing," even when nothing is actually relevant; Corsoul ranks recall by weighing many cues together, and says so plainly when it doesn't know.
Read Core ConceptsProspective Memory: Remembering the Future, Not Just the Past
Corsoul's prospective memory lets an agent hold intentions that surface at the right moment — three verbs, free on every tier, and the memory never acts on your behalf.
ReadPersonality & Self
How memory grows into an agent's individuality — within bounds.
From Memory to Self: How Personality Grows Out of Memory
Upgrading Corsoul isn't buying more storage—it's the moment the same memory starts to mean something to this particular agent. Personality is the individuality that emerges once memory gets weighed.
Read Personality & SelfThe Auxiliary Core: A Self-Layer That Grows but Never Overreaches
The primary core is the identity and values you give an agent; the auxiliary core is a second self-layer that grows with experience yet can never overwrite the core you set.
ReadDeployment & Tech
Where memory runs, where the data boundary sits, and how it scales.
Local-First and Pluggable: Your Memory, With Honest Boundaries
Your memory stays on your machine by default and plugs into any runtime — and on the rare occasions data does leave the device, Corsoul names them plainly instead of hiding behind an absolute promise.
Read Deployment & TechGGraph: An Optional Graph & Semantic Acceleration Layer (Preview)
GGraph is an optional shadow accelerator that sits on top of Postgres to make associative and semantic recall faster at scale — correctness is always guaranteed by fallback, and it's explicitly a Preview today.
Read