-
-
Notifications
You must be signed in to change notification settings - Fork 24
Architecture V2.5
Version: 2.5.0 | Date: February 12, 2026 | Author: Varun Pratap Bhardwaj
SuperLocalMemory transforms from passive storage (filing cabinet) to active coordination layer (nervous system). Every memory write, update, delete, or recall now triggers real-time events visible across all connected tools.
Claude or Cursor writes a memory β it is saved silently. No other tool knows it happened.
Every write instantly propagates: the dashboard updates live, the connected agent is registered, and provenance is recorded β all automatically.
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β ACCESS LAYER β
β MCP Server β CLI β REST API β Skills β Python Import β
ββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββββββββββββ
β
ββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββ
β MEMORY STORE β
β Concurrent read/write with zero "database locked" errors β
β Real-time event broadcasting on every operation β
β Provenance and agent tracking on every memory β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
ββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββ
β STORAGE LAYER β
β SQLite (single file: ~/.claude-memory/memory.db) β
β Full-text search, knowledge graph, identity patterns, β
β event log, agent registry, trust signals β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β
ββββββββββββββββββββββββ΄βββββββββββββββββββββββββββββββββββββββ
β DASHBOARD LAYER β
β Web dashboard with real-time updates β
β Tabs: Graph, Memories, Clusters, Patterns, β
β Timeline, Live Events, Agents, Settings β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
For technical details, see our published research: https://zenodo.org/records/18709670
| Capability | What It Does |
|---|---|
| Concurrent Write Safety | Multiple AI tools write simultaneously β zero conflicts, zero errors |
| Real-Time Events | Dashboard and connected tools see every write/recall/delete instantly |
| Agent Tracking | Know which tools are connected, what they've written, and when |
| Provenance | Every memory records which tool created it and via which protocol |
| Trust Scoring | Background monitoring of agent behavior patterns (silent collection) |
| Event | Trigger |
|---|---|
memory.created |
New memory written |
memory.updated |
Existing memory modified |
memory.deleted |
Memory removed |
memory.recalled |
Memory retrieved by an agent |
graph.updated |
Knowledge graph rebuilt |
pattern.learned |
New pattern detected |
agent.connected |
New agent connects |
agent.disconnected |
Agent disconnects |
Events are streamed live to the dashboard and available via API polling.
All agents start at full trust. The system silently collects behavioral signals over time. Trust is asymmetric β trust is harder to gain than to lose, which makes the system robust against manipulation.
Positive signals: High-importance writes, memories recalled by other agents, consistent behavior patterns.
Negative signals: Quick deletes (memory deleted shortly after creation), high-volume write bursts, contradictory content.
v2.5: Silent collection only. v2.6: Trust-weighted recall ranking + enforcement mode.
The dashboard exposes 25+ REST endpoints covering: memory CRUD, search, graph data, clusters, stats, timeline, profiles, export/import, backup, real-time event streaming, WebSocket updates, agent list, and trust overview.
SuperLocalMemory v2.5 β Created by Varun Pratap Bhardwaj. Elastic License 2.0.