superlocalmemory 2.5.1 → 2.6.5

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://varun369.github.io/SuperLocalMemoryV2/assets/branding/icon-512.png" alt="SuperLocalMemory V2" width="200"/>
+  <img src="https://superlocalmemory.com/assets/branding/icon-512.png" alt="SuperLocalMemory V2" width="200"/>
 </p>
 
 <h1 align="center">SuperLocalMemory V2</h1>
@@ -14,6 +14,10 @@
   <strong>Stop re-explaining your codebase every session. 100% local. Zero setup. Completely free.</strong>
 </p>
 
+<p align="center">
+  <a href="https://superlocalmemory.com"><img src="https://img.shields.io/badge/🌐_Website-superlocalmemory.com-ff6b35?style=for-the-badge" alt="Official Website"/></a>
+</p>
+
 <p align="center">
   <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.8+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python 3.8+"/></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT License"/></a>
@@ -24,10 +28,10 @@
 </p>
 
 <p align="center">
+  <a href="https://superlocalmemory.com"><strong>superlocalmemory.com</strong></a> •
   <a href="#-quick-start">Quick Start</a> •
-  <a href="#-why-superlocalemory">Why This?</a> •
+  <a href="#-why-superlocalmemory">Why This?</a> •
   <a href="#-features">Features</a> •
-  <a href="#-vs-alternatives">vs Alternatives</a> •
   <a href="#-documentation">Docs</a> •
   <a href="https://github.com/varun369/SuperLocalMemoryV2/issues">Issues</a>
 </p>
@@ -40,75 +44,37 @@
 
 ---
 
-## NEW: v2.5 — "Your AI Memory Has a Heartbeat"
+## What's New in v2.6.5
 
-> **SuperLocalMemory is no longer passive storage — it's a real-time coordination layer.**
+**Interactive Knowledge Graph** — Your memories, visually connected. Powered by [Cytoscape.js](https://js.cytoscape.org/) (the same library behind Obsidian's graph plugins):
 
-| What's New | Why It Matters |
-|------------|----------------|
-| **Real-Time Event Stream** | See every memory operation live in the dashboard — no refresh needed. SSE-powered, cross-process. |
-| **No More "Database Locked"** | WAL mode + serialized write queue. 50 concurrent agents writing? Zero errors. |
-| **Agent Tracking** | Know exactly which AI tool wrote what. Claude, Cursor, Windsurf, CLI — all tracked automatically. |
-| **Trust Scoring** | Bayesian trust signals detect spam, quick-deletes, and cross-agent validation. Silent in v2.5, enforced in v2.6. |
-| **Memory Provenance** | Every memory records who created it, via which protocol, with full derivation lineage. |
-| **Production-Grade Code** | 28 API endpoints across 8 modular route files. 13 modular JS files. 63 pytest tests. |
+- 🔍 **Zoom, pan, explore** — Mouse wheel to zoom, drag to pan, smooth navigation
+- 👆 **Click nodes** — Opens memory preview with "View Full Memory", "Expand Neighbors", "Filter to Cluster"
+- 🎨 **6 layout algorithms** — Force-directed (physics-based), circular, grid, hierarchical, concentric, breadthfirst
+- 🔗 **Smart filtering** — Click cluster cards or entity badges → graph instantly updates
+- ⚡ **Performance** — 3-tier rendering strategy handles 10,000+ nodes smoothly
 
-**Upgrade:** `npm install -g superlocalmemory@latest`
+Launch the dashboard: `python3 ~/.claude-memory/ui_server.py` → `http://localhost:8765/graph.html`
 
-**Dashboard:** `python3 ~/.claude-memory/ui_server.py` then open `http://localhost:8765`
-
-[Interactive Architecture Diagram](https://varun369.github.io/SuperLocalMemoryV2/architecture.html) | [Architecture Doc](docs/ARCHITECTURE-V2.5.md) | [Full Changelog](CHANGELOG.md)
+**[[Complete Interactive Graph Guide →|Using-Interactive-Graph]]**
 
 ---
 
-## NEW: Framework Integrations (v2.5.1)
-
-Use SuperLocalMemory as a memory backend in your LangChain and LlamaIndex applications — 100% local, zero cloud.
-
-### LangChain
+## What's New in v2.6
 
-```bash
-pip install langchain-superlocalmemory
-```
+SuperLocalMemory is now **production-hardened** with security, performance, and scale improvements:
 
-```python
-from langchain_superlocalmemory import SuperLocalMemoryChatMessageHistory
-from langchain_core.runnables.history import RunnableWithMessageHistory
-
-history = SuperLocalMemoryChatMessageHistory(session_id="my-session")
-# Messages persist across sessions, stored locally in ~/.claude-memory/memory.db
-```
+- **Trust Enforcement** — Bayesian scoring actively protects your memory. Agents with trust below 0.3 are blocked from write/delete operations.
+- **Profile Isolation** — Memory profiles fully sandboxed. Zero cross-profile data leakage.
+- **Rate Limiting** — Protects against memory flooding from misbehaving agents.
+- **HNSW-Accelerated Graphs** — Knowledge graph edge building uses HNSW index for faster construction at scale.
+- **Hybrid Search Engine** — Combined semantic + FTS5 + graph retrieval for maximum accuracy.
 
-### LlamaIndex
-
-```bash
-pip install llama-index-storage-chat-store-superlocalmemory
-```
+**v2.5 highlights (included):** Real-time event stream, WAL-mode concurrent writes, agent tracking, memory provenance, 28 API endpoints.
 
-```python
-from llama_index.storage.chat_store.superlocalmemory import SuperLocalMemoryChatStore
-from llama_index.core.memory import ChatMemoryBuffer
-
-chat_store = SuperLocalMemoryChatStore()
-memory = ChatMemoryBuffer.from_defaults(chat_store=chat_store, chat_store_key="user-1")
-```
-
-[LangChain Guide](https://github.com/varun369/SuperLocalMemoryV2/wiki/LangChain-Integration) | [LlamaIndex Guide](https://github.com/varun369/SuperLocalMemoryV2/wiki/LlamaIndex-Integration)
-
----
-
-## Install in One Command
-
-```bash
-npm install -g superlocalmemory
-```
-
-Or clone manually:
-```bash
-git clone https://github.com/varun369/SuperLocalMemoryV2.git && cd SuperLocalMemoryV2 && ./install.sh
-```
+**Upgrade:** `npm install -g superlocalmemory@latest`
 
-Both methods auto-detect and configure **16+ IDEs and AI tools** — Cursor, VS Code/Copilot, Codex, Claude, Windsurf, Gemini CLI, JetBrains, and more.
+[Interactive Architecture Diagram](https://superlocalmemory.com/architecture.html) | [Architecture Doc](docs/ARCHITECTURE-V2.5.md) | [Full Changelog](CHANGELOG.md)
 
 ---
 
@@ -128,6 +94,8 @@ You: *sighs and explains everything again*
 - Previous decisions
 - Debugging history
 
+---
+
 ## The Solution
 
 ```bash
@@ -148,26 +116,21 @@ superlocalmemoryv2:recall "auth bug"
 
 ## 🚀 Quick Start
 
-### npm (Recommended — All Platforms)
+### Install (One Command)
+
 ```bash
 npm install -g superlocalmemory
 ```
 
-### Mac/Linux (Manual)
+Or clone manually:
 ```bash
-git clone https://github.com/varun369/SuperLocalMemoryV2.git
-cd SuperLocalMemoryV2
-./install.sh
+git clone https://github.com/varun369/SuperLocalMemoryV2.git && cd SuperLocalMemoryV2 && ./install.sh
 ```
 
-### Windows (PowerShell)
-```powershell
-git clone https://github.com/varun369/SuperLocalMemoryV2.git
-cd SuperLocalMemoryV2
-.\install.ps1
-```
+Both methods auto-detect and configure **17+ IDEs and AI tools** — Cursor, VS Code/Copilot, Codex, Claude, Windsurf, Gemini CLI, JetBrains, and more.
 
 ### Verify Installation
+
 ```bash
 superlocalmemoryv2:status
 # ✓ Database: OK (0 memories)
@@ -177,168 +140,97 @@ superlocalmemoryv2:status
 
 **That's it.** No Docker. No API keys. No cloud accounts. No configuration.
 
-### Updating to Latest Version
-
-**npm users:**
-```bash
-# Update to latest version
-npm update -g superlocalmemory
-
-# Or force latest
-npm install -g superlocalmemory@latest
-
-# Install specific version
-npm install -g superlocalmemory@latest
-```
-
-**Manual install users:**
-```bash
-cd SuperLocalMemoryV2
-git pull origin main
-./install.sh  # Mac/Linux
-# or
-.\install.ps1  # Windows
-```
-
-**Your data is safe:** Updates preserve your database and all memories.
-
-### Start the Visualization Dashboard
+### Launch Dashboard
 
 ```bash
-# Launch the interactive web UI
+# Start the interactive web UI
 python3 ~/.claude-memory/ui_server.py
 
 # Opens at http://localhost:8765
-# Features: Timeline view, search explorer, graph visualization
+# Features: Timeline, search, interactive graph, statistics
 ```
 
 ---
 
-## 🎨 Visualization Dashboard
-
-**NEW in v2.2.0:** Interactive web-based dashboard for exploring your memories visually.
-
-### Features
-
-| Feature | Description |
-|---------|-------------|
-| **📈 Timeline View** | See your memories chronologically with importance indicators |
-| **🔍 Search Explorer** | Real-time semantic search with score visualization |
-| **🕸️ Graph Visualization** | Interactive knowledge graph with clusters and relationships |
-| **📊 Statistics Dashboard** | Memory trends, tag clouds, pattern insights |
-| **🎯 Advanced Filters** | Filter by tags, importance, date range, clusters |
-
-### Quick Tour
+## 💡 Why SuperLocalMemory?
 
-```bash
-# 1. Start dashboard
-python ~/.claude-memory/ui_server.py
+### For Developers Who Use AI Daily
 
-# 2. Navigate to http://localhost:8765
+| Scenario | Without Memory | With SuperLocalMemory |
+|----------|---------------|----------------------|
+| New Claude session | Re-explain entire project | `recall "project context"` → instant context |
+| Debugging | "We tried X last week..." starts over | Knowledge graph shows related past fixes |
+| Code preferences | "I prefer React..." every time | Pattern learning knows your style |
+| Multi-project | Context constantly bleeds | Separate profiles per project |
 
-# 3. Explore your memories:
-#    - Timeline: See memories over time
-#    - Search: Find with semantic scoring
-#    - Graph: Visualize relationships
-#    - Stats: Analyze patterns
-```
+### Built on 2026 Research
 
-**[[Complete Dashboard Guide →|Visualization-Dashboard]]**
+Not another simple key-value store. SuperLocalMemory implements **cutting-edge memory architecture**:
 
----
+- **PageIndex** (Meta AI) → Hierarchical memory organization
+- **GraphRAG** (Microsoft) → Knowledge graph with auto-clustering
+- **xMemory** (Stanford) → Identity pattern learning
+- **A-RAG** → Multi-level retrieval with context awareness
 
-### New in v2.4.1: Hierarchical Clustering, Community Summaries & Auto-Backup
+**The only open-source implementation combining all four approaches.**
 
-| Feature | Description |
-|---------|-------------|
-| **Hierarchical Leiden** | Recursive community detection — clusters within clusters up to 3 levels. "Python" → "FastAPI" → "Auth patterns" |
-| **Community Summaries** | TF-IDF structured reports per cluster: key topics, projects, categories at a glance |
-| **MACLA Confidence** | Bayesian Beta-Binomial scoring (arXiv:2512.18950) — calibrated confidence, not raw frequency |
-| **Auto-Backup** | Configurable SQLite backups with retention policies, one-click restore from dashboard |
-| **Profile UI** | Create, switch, delete profiles from the web dashboard — full isolation per context |
-| **Profile Isolation** | All API endpoints (graph, clusters, patterns, timeline) scoped to active profile |
+[See research citations →](https://github.com/varun369/SuperLocalMemoryV2/wiki/Research-Foundations)
 
 ---
 
-## 🔍 Advanced Search
-
-SuperLocalMemory V2.2.0 implements **hybrid search** combining multiple strategies for maximum accuracy.
-
-### Search Strategies
-
-| Strategy | Method | Best For | Speed |
-|----------|--------|----------|-------|
-| **Semantic Search** | TF-IDF vectors + cosine similarity | Conceptual queries ("authentication patterns") | 45ms |
-| **Full-Text Search** | SQLite FTS5 with ranking | Exact phrases ("JWT tokens expire") | 30ms |
-| **Graph-Enhanced** | Knowledge graph traversal | Related concepts ("show auth-related") | 60ms |
-| **Hybrid Mode** | All three combined | General queries | 80ms |
-
-### Search Examples
-
-```bash
-# Semantic: finds conceptually similar
-slm recall "security best practices"
-# Matches: "JWT implementation", "OAuth flow", "CSRF protection"
+## ✨ Features
 
-# Exact: finds literal text
-slm recall "PostgreSQL 15"
-# Matches: exactly "PostgreSQL 15"
+### Multi-Layer Memory Architecture
 
-# Graph: finds related via clusters
-slm recall "authentication" --use-graph
-# Matches: JWT, OAuth, sessions (via "Auth & Security" cluster)
+**[View Interactive Architecture Diagram](https://superlocalmemory.com/architecture.html)** — Click any layer for details, research references, and file paths.
 
-# Hybrid: best of all worlds (default)
-slm recall "API design patterns"
-# Combines semantic + exact + graph for optimal results
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Layer 9: VISUALIZATION (v2.2+)                             │
+│  Interactive dashboard: timeline, graph explorer, analytics │
+├─────────────────────────────────────────────────────────────┤
+│  Layer 8: HYBRID SEARCH (v2.2+)                             │
+│  Combines: Semantic + FTS5 + Graph traversal                │
+├─────────────────────────────────────────────────────────────┤
+│  Layer 7: UNIVERSAL ACCESS                                  │
+│  MCP + Skills + CLI (works everywhere)                      │
+│  17+ IDEs with single database                              │
+├─────────────────────────────────────────────────────────────┤
+│  Layer 6: MCP INTEGRATION                                   │
+│  Model Context Protocol: 6 tools, 4 resources, 2 prompts    │
+│  Auto-configured for Cursor, Windsurf, Claude               │
+├─────────────────────────────────────────────────────────────┤
+│  Layer 5: SKILLS LAYER                                      │
+│  6 universal slash-commands for AI assistants               │
+│  Compatible with Claude Code, Continue, Cody                │
+├─────────────────────────────────────────────────────────────┤
+│  Layer 4: PATTERN LEARNING + MACLA                          │
+│  Bayesian confidence scoring (arXiv:2512.18950)             │
+│  "You prefer React over Vue" (73% confidence)               │
+├─────────────────────────────────────────────────────────────┤
+│  Layer 3: KNOWLEDGE GRAPH + HIERARCHICAL CLUSTERING         │
+│  Recursive Leiden algorithm: "Python" → "FastAPI" → "Auth" │
+│  Community summaries with TF-IDF structured reports         │
+├─────────────────────────────────────────────────────────────┤
+│  Layer 2: HIERARCHICAL INDEX                                │
+│  Tree structure for fast navigation                         │
+│  O(log n) lookups instead of O(n) scans                     │
+├─────────────────────────────────────────────────────────────┤
+│  Layer 1: RAW STORAGE                                       │
+│  SQLite + Full-text search + TF-IDF vectors                 │
+│  Compression: 60-96% space savings                          │
+└─────────────────────────────────────────────────────────────┘
 ```
 
-### Search Performance by Dataset Size
-
-| Memories | Semantic | FTS5 | Graph | Hybrid |
-|----------|----------|------|-------|--------|
-| 100 | 35ms | 25ms | 50ms | 65ms |
-| 500 | 45ms | 30ms | 60ms | 80ms |
-| 1,000 | 55ms | 35ms | 70ms | 95ms |
-| 5,000 | 85ms | 50ms | 110ms | 150ms |
-
-**All search strategies remain sub-second even with 5,000+ memories.**
-
----
-
-## ⚡ Performance
-
-### Benchmarks (v2.2.0)
-
-| Operation | Time | Comparison | Notes |
-|-----------|------|------------|-------|
-| **Add Memory** | < 10ms | - | Instant indexing |
-| **Search (Hybrid)** | 80ms | 3.3x faster than v1 | 500 memories |
-| **Graph Build** | < 2s | - | 100 memories |
-| **Pattern Learning** | < 2s | - | Incremental |
-| **Dashboard Load** | < 500ms | - | 1,000 memories |
-| **Timeline Render** | < 300ms | - | All memories |
-
-### Storage Efficiency
-
-| Tier | Description | Compression | Savings |
-|------|-------------|-------------|---------|
-| **Tier 1** | Active memories (0-30 days) | None | - |
-| **Tier 2** | Warm memories (30-90 days) | 60% | Progressive summarization |
-| **Tier 3** | Cold storage (90+ days) | 96% | JSON archival |
-
-**Example:** 1,000 memories with mixed ages = ~15MB (vs 380MB uncompressed)
-
-### Scalability
-
-| Dataset Size | Search Time | Graph Build | RAM Usage |
-|--------------|-------------|-------------|-----------|
-| 100 memories | 35ms | 0.5s | < 30MB |
-| 500 memories | 45ms | 2s | < 50MB |
-| 1,000 memories | 55ms | 5s | < 80MB |
-| 5,000 memories | 85ms | 30s | < 150MB |
+### Key Capabilities
 
-**Tested up to 10,000 memories** with linear scaling and no degradation.
+- **[Knowledge Graphs](https://github.com/varun369/SuperLocalMemoryV2/wiki/Knowledge-Graph)** — Automatic relationship discovery. Interactive visualization with zoom, pan, click.
+- **[Pattern Learning](https://github.com/varun369/SuperLocalMemoryV2/wiki/Pattern-Learning)** — Learns your coding preferences and style automatically.
+- **[Multi-Profile Support](https://github.com/varun369/SuperLocalMemoryV2/wiki/Using-Memory-Profiles)** — Isolated contexts for work, personal, clients. Zero context bleeding.
+- **[Hybrid Search](https://github.com/varun369/SuperLocalMemoryV2/wiki/Advanced-Search)** — Semantic + FTS5 + Graph retrieval combined for maximum accuracy.
+- **[Visualization Dashboard](https://github.com/varun369/SuperLocalMemoryV2/wiki/Visualization-Dashboard)** — Web UI for timeline, search, graph exploration, analytics.
+- **[Framework Integrations](docs/FRAMEWORK-INTEGRATIONS.md)** — Use with LangChain and LlamaIndex applications.
+- **[Real-Time Events](https://github.com/varun369/SuperLocalMemoryV2/wiki/Real-Time-Event-System)** — Live notifications via SSE/WebSocket/Webhooks when memories change.
 
 ---
 
@@ -361,79 +253,29 @@ slm recall "API design patterns"
 | **Gemini CLI** | ✅ MCP + Skills | Native MCP + skills |
 | **JetBrains IDEs** | ✅ MCP | Via AI Assistant settings |
 | **Zed Editor** | ✅ MCP | Native MCP tools |
-| **OpenCode** | ✅ MCP | Native MCP tools |
-| **Perplexity** | ✅ MCP | Native MCP tools |
-| **Antigravity** | ✅ MCP + Skills | Native MCP tools |
-| **ChatGPT** | ✅ MCP Connector | `search()` + `fetch()` via HTTP tunnel |
 | **Aider** | ✅ Smart Wrapper | `aider-smart` with context |
 | **Any Terminal** | ✅ Universal CLI | `slm remember "content"` |
 
 ### Three Ways to Access
 
-1. **MCP (Model Context Protocol)** - Auto-configured for Cursor, Windsurf, Claude Desktop
+1. **MCP (Model Context Protocol)** — Auto-configured for Cursor, Windsurf, Claude Desktop
    - AI assistants get natural access to your memory
    - No manual commands needed
    - "Remember that we use FastAPI" just works
 
-2. **Skills & Commands** - For Claude Code, Continue.dev, Cody
+2. **Skills & Commands** — For Claude Code, Continue.dev, Cody
    - `/superlocalmemoryv2:remember` in Claude Code
    - `/slm-remember` in Continue.dev and Cody
    - Familiar slash command interface
 
-3. **Universal CLI** - Works in any terminal or script
+3. **Universal CLI** — Works in any terminal or script
    - `slm remember "content"` - Simple, clean syntax
    - `slm recall "query"` - Search from anywhere
    - `aider-smart` - Aider with auto-context injection
 
 **All three methods use the SAME local database.** No data duplication, no conflicts.
 
-### Auto-Detection
-
-Installation automatically detects and configures:
-- Existing IDEs (Cursor, Windsurf, VS Code)
-- Installed tools (Aider, Continue, Cody)
-- Shell environment (bash, zsh)
-
-**Zero manual configuration required.** It just works.
-
-### Manual Setup for Other Apps
-
-Want to use SuperLocalMemory in ChatGPT, Perplexity, Zed, or other MCP-compatible tools?
-
-**📘 Complete setup guide:** [docs/MCP-MANUAL-SETUP.md](docs/MCP-MANUAL-SETUP.md)
-
-Covers:
-- ChatGPT Desktop - Add via Settings → MCP
-- Perplexity - Configure via app settings
-- Zed Editor - JSON configuration
-- Cody - VS Code/JetBrains setup
-- Custom MCP clients - Python/HTTP integration
-
-All tools connect to the **same local database** - no data duplication.
-
----
-
-## 💡 Why SuperLocalMemory?
-
-### For Developers Who Use AI Daily
-
-| Scenario | Without Memory | With SuperLocalMemory |
-|----------|---------------|----------------------|
-| New Claude session | Re-explain entire project | `recall "project context"` → instant context |
-| Debugging | "We tried X last week..." starts over | Knowledge graph shows related past fixes |
-| Code preferences | "I prefer React..." every time | Pattern learning knows your style |
-| Multi-project | Context constantly bleeds | Separate profiles per project |
-
-### Built on 2026 Research
-
-Not another simple key-value store. SuperLocalMemory implements **cutting-edge memory architecture**:
-
-- **PageIndex** (Meta AI) → Hierarchical memory organization
-- **GraphRAG** (Microsoft) → Knowledge graph with auto-clustering
-- **xMemory** (Stanford) → Identity pattern learning
-- **A-RAG** → Multi-level retrieval with context awareness
-
-**The only open-source implementation combining all four approaches.**
+[Complete setup guide for all tools →](docs/MCP-MANUAL-SETUP.md)
 
 ---
 
@@ -450,27 +292,23 @@ Not another simple key-value store. SuperLocalMemory implements **cutting-edge m
 | **Letta/MemGPT** | Self-hosted (complex) | TBD | Requires significant setup |
 | **SuperLocalMemory V2** | **Unlimited** | **$0 forever** | **Nothing.** |
 
-### Feature Comparison (What Actually Matters)
+### What Actually Matters
 
 | Feature | Mem0 | Zep | Khoj | Letta | **SuperLocalMemory V2** |
 |---------|------|-----|------|-------|------------------------|
 | **Works in Cursor** | Cloud Only | ❌ | ❌ | ❌ | ✅ **Local** |
 | **Works in Windsurf** | Cloud Only | ❌ | ❌ | ❌ | ✅ **Local** |
 | **Works in VS Code** | 3rd Party | ❌ | Partial | ❌ | ✅ **Native** |
-| **Works in Claude** | ❌ | ❌ | ❌ | ❌ | ✅ |
-| **Works with Aider** | ❌ | ❌ | ❌ | ❌ | ✅ |
 | **Universal CLI** | ❌ | ❌ | ❌ | ❌ | ✅ |
-| **7-Layer Universal Architecture** | ❌ | ❌ | ❌ | ❌ | ✅ |
+| **Multi-Layer Architecture** | ❌ | ❌ | ❌ | ❌ | ✅ |
 | **Pattern Learning** | ❌ | ❌ | ❌ | ❌ | ✅ |
-| **Multi-Profile Support** | ❌ | ❌ | ❌ | Partial | ✅ |
 | **Knowledge Graphs** | ✅ | ✅ | ❌ | ❌ | ✅ |
 | **100% Local** | ❌ | ❌ | Partial | Partial | ✅ |
 | **Zero Setup** | ❌ | ❌ | ❌ | ❌ | ✅ |
-| **Progressive Compression** | ❌ | ❌ | ❌ | ❌ | ✅ |
 | **Completely Free** | Limited | Limited | Partial | ✅ | ✅ |
 
 **SuperLocalMemory V2 is the ONLY solution that:**
-- ✅ Works across 16+ IDEs and CLI tools
+- ✅ Works across 17+ IDEs and CLI tools
 - ✅ Remains 100% local (no cloud dependencies)
 - ✅ Completely free with unlimited memories
 
@@ -478,122 +316,44 @@ Not another simple key-value store. SuperLocalMemory implements **cutting-edge m
 
 ---
 
-## ✨ Features
+## ⚡ Measured Performance
 
-### Multi-Layer Memory Architecture
+All numbers measured on real hardware (Apple M4 Pro, 24GB RAM). No estimates — real benchmarks.
 
-**[View Interactive Architecture Diagram](https://varun369.github.io/SuperLocalMemoryV2/architecture.html)** — Click any layer for details, research references, and file paths.
+### Search Speed
 
-```
-┌─────────────────────────────────────────────────────────────┐
-│  Layer 9: VISUALIZATION (NEW v2.2.0)                        │
-│  Interactive dashboard: timeline, search, graph explorer    │
-│  Real-time analytics and visual insights                    │
-├─────────────────────────────────────────────────────────────┤
-│  Layer 8: HYBRID SEARCH (NEW v2.2.0)                        │
-│  Combines: Semantic + FTS5 + Graph traversal                │
-│  80ms response time with maximum accuracy                   │
-├─────────────────────────────────────────────────────────────┤
-│  Layer 7: UNIVERSAL ACCESS                                  │
-│  MCP + Skills + CLI (works everywhere)                      │
-│  16+ IDEs with single database                              │
-├─────────────────────────────────────────────────────────────┤
-│  Layer 6: MCP INTEGRATION                                   │
-│  Model Context Protocol: 6 tools, 4 resources, 2 prompts    │
-│  Auto-configured for Cursor, Windsurf, Claude               │
-├─────────────────────────────────────────────────────────────┤
-│  Layer 5: SKILLS LAYER                                      │
-│  6 universal slash-commands for AI assistants               │
-│  Compatible with Claude Code, Continue, Cody                │
-├─────────────────────────────────────────────────────────────┤
-│  Layer 4: PATTERN LEARNING + MACLA (v2.4.0)                  │
-│  Bayesian Beta-Binomial confidence (arXiv:2512.18950)       │
-│  "You prefer React over Vue" (73% confidence)               │
-├─────────────────────────────────────────────────────────────┤
-│  Layer 3: KNOWLEDGE GRAPH + HIERARCHICAL LEIDEN (v2.4.1)    │
-│  Recursive clustering: "Python" → "FastAPI" → "Auth"        │
-│  Community summaries + TF-IDF structured reports            │
-├─────────────────────────────────────────────────────────────┤
-│  Layer 2: HIERARCHICAL INDEX                                │
-│  Tree structure for fast navigation                         │
-│  O(log n) lookups instead of O(n) scans                     │
-├─────────────────────────────────────────────────────────────┤
-│  Layer 1: RAW STORAGE                                       │
-│  SQLite + Full-text search + TF-IDF vectors                 │
-│  Compression: 60-96% space savings                          │
-└─────────────────────────────────────────────────────────────┘
-```
-
-### Knowledge Graph (It's Magic)
-
-```bash
-# Build the graph from your memories
-python ~/.claude-memory/graph_engine.py build
-
-# Output:
-# ✓ Processed 47 memories
-# ✓ Created 12 clusters:
-#   - "Authentication & Tokens" (8 memories)
-#   - "Performance Optimization" (6 memories)
-#   - "React Components" (11 memories)
-#   - "Database Queries" (5 memories)
-#   ...
-```
-
-**The graph automatically discovers relationships.** Ask "what relates to auth?" and get JWT, session management, token refresh—even if you never tagged them together.
-
-### Pattern Learning (It Knows You)
-
-```bash
-# Learn patterns from your memories
-python ~/.claude-memory/pattern_learner.py update
-
-# Get your coding identity
-python ~/.claude-memory/pattern_learner.py context 0.5
-
-# Output:
-# Your Coding Identity:
-# - Framework preference: React (73% confidence)
-# - Style: Performance over readability (58% confidence)
-# - Testing: Jest + React Testing Library (65% confidence)
-# - API style: REST over GraphQL (81% confidence)
-```
+| Database Size | Median Latency | P95 Latency |
+|---------------|----------------|-------------|
+| 100 memories | **10.6ms** | 14.9ms |
+| 500 memories | **65.2ms** | 101.7ms |
+| 1,000 memories | **124.3ms** | 190.1ms |
 
-**Your AI assistant can now match your preferences automatically.**
+For typical personal use (under 500 memories), search results return faster than you blink.
 
-**MACLA Confidence Scoring (v2.4.0):** Confidence uses a Bayesian Beta-Binomial posterior (Forouzandeh et al., [arXiv:2512.18950](https://arxiv.org/abs/2512.18950)). Pattern-specific priors, log-scaled competition, recency bonus. Range: 0.0–0.95 (hard cap prevents overconfidence).
+### Concurrent Writes — Zero Errors
 
-### Multi-Profile Support
+| Scenario | Writes/sec | Errors |
+|----------|------------|--------|
+| 1 AI tool writing | **204/sec** | 0 |
+| 2 AI tools simultaneously | **220/sec** | 0 |
+| 5 AI tools simultaneously | **130/sec** | 0 |
 
-```bash
-# Work profile
-superlocalmemoryv2:profile create work --description "Day job"
-superlocalmemoryv2:profile switch work
+WAL mode + serialized write queue = zero "database is locked" errors, ever.
 
-# Personal projects
-superlocalmemoryv2:profile create personal
-superlocalmemoryv2:profile switch personal
+### Storage
 
-# Client projects (completely isolated)
-superlocalmemoryv2:profile create client-acme
-```
+10,000 memories = **13.6 MB** on disk (~1.9 KB per memory). Your entire AI memory history takes less space than a photo.
 
-**Each profile has isolated memories, graphs, and patterns.** No context bleeding.
+### Graph Construction
 
----
+| Memories | Build Time |
+|----------|-----------|
+| 100 | 0.28s |
+| 1,000 | 10.6s |
 
-## 📖 Documentation
+Leiden clustering discovers 6-7 natural topic communities automatically.
 
-| Guide | Description |
-|-------|-------------|
-| [Quick Start](https://github.com/varun369/SuperLocalMemoryV2/wiki/Quick-Start-Tutorial) | Get running in 5 minutes |
-| [Installation](https://github.com/varun369/SuperLocalMemoryV2/wiki/Installation) | Detailed setup instructions |
-| [Visualization Dashboard](https://github.com/varun369/SuperLocalMemoryV2/wiki/Visualization-Dashboard) | Interactive web UI guide (NEW v2.2.0) |
-| [CLI Reference](docs/CLI-COMMANDS-REFERENCE.md) | All commands explained |
-| [Knowledge Graph](docs/GRAPH-ENGINE.md) | How clustering works |
-| [Pattern Learning](docs/PATTERN-LEARNING.md) | Identity extraction |
-| [Profiles Guide](docs/PROFILES-GUIDE.md) | Multi-context management |
-| [API Reference](docs/API-REFERENCE.md) | Python API documentation |
+[Full benchmark details →](https://github.com/varun369/SuperLocalMemoryV2/wiki/Performance-Benchmarks)
 
 ---
 
@@ -612,45 +372,33 @@ superlocalmemoryv2:profile create <name>                 # New profile
 superlocalmemoryv2:profile switch <name>                 # Switch context
 
 # Knowledge Graph
-python ~/.claude-memory/graph_engine.py build            # Build graph (+ hierarchical + summaries)
+python ~/.claude-memory/graph_engine.py build            # Build graph
 python ~/.claude-memory/graph_engine.py stats            # View clusters
-python ~/.claude-memory/graph_engine.py related --id 5   # Find related
-python ~/.claude-memory/graph_engine.py hierarchical     # Sub-cluster large communities
-python ~/.claude-memory/graph_engine.py summaries        # Generate cluster summaries
 
 # Pattern Learning
 python ~/.claude-memory/pattern_learner.py update        # Learn patterns
 python ~/.claude-memory/pattern_learner.py context 0.5   # Get identity
 
-# Auto-Backup (v2.4.0)
-python ~/.claude-memory/auto_backup.py backup            # Manual backup
-python ~/.claude-memory/auto_backup.py list              # List backups
-python ~/.claude-memory/auto_backup.py status            # Backup status
-
-# Reset (Use with caution!)
-superlocalmemoryv2:reset soft                            # Clear memories
-superlocalmemoryv2:reset hard --confirm                  # Nuclear option
+# Visualization Dashboard
+python ~/.claude-memory/ui_server.py                     # Launch web UI
 ```
 
----
-
-## 📊 Performance
+[Complete CLI reference →](docs/CLI-COMMANDS-REFERENCE.md)
 
-**SEO:** Performance benchmarks, memory system speed, search latency, visualization dashboard performance
+---
 
-| Metric | Result | Notes |
-|--------|--------|-------|
-| **Hybrid search** | **80ms** | Semantic + FTS5 + Graph combined |
-| **Semantic search** | **45ms** | 3.3x faster than v1 |
-| **FTS5 search** | **30ms** | Exact phrase matching |
-| **Graph build (100 memories)** | **< 2 seconds** | Leiden clustering |
-| **Pattern learning** | **< 2 seconds** | Incremental updates |
-| **Dashboard load** | **< 500ms** | 1,000 memories |
-| **Timeline render** | **< 300ms** | All memories visualized |
-| **Storage compression** | **60-96% reduction** | Progressive tiering |
-| **Memory overhead** | **< 50MB RAM** | Lightweight |
+## 📖 Documentation
 
-**Tested up to 10,000 memories** with sub-second search times and linear scaling.
+| Guide | Description |
+|-------|-------------|
+| [Quick Start](https://github.com/varun369/SuperLocalMemoryV2/wiki/Quick-Start-Tutorial) | Get running in 5 minutes |
+| [Installation](https://github.com/varun369/SuperLocalMemoryV2/wiki/Installation) | Detailed setup instructions |
+| [Visualization Dashboard](https://github.com/varun369/SuperLocalMemoryV2/wiki/Visualization-Dashboard) | Interactive web UI guide |
+| [Interactive Graph](https://github.com/varun369/SuperLocalMemoryV2/wiki/Using-Interactive-Graph) | Graph exploration guide (NEW v2.6.5) |
+| [Framework Integrations](docs/FRAMEWORK-INTEGRATIONS.md) | LangChain & LlamaIndex setup |
+| [Knowledge Graph](docs/GRAPH-ENGINE.md) | How clustering works |
+| [Pattern Learning](docs/PATTERN-LEARNING.md) | Identity extraction |
+| [API Reference](docs/API-REFERENCE.md) | Python API documentation |
 
 ---
 
@@ -660,9 +408,8 @@ We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 **Areas for contribution:**
 - Additional pattern categories
-- Graph visualization UI
-- Integration with more AI assistants
 - Performance optimizations
+- Integration with more AI assistants
 - Documentation improvements
 
 ---