@theihtisham/agent-shadow-brain 5.2.0 → 6.0.2

package/README.md

@@ -1,1159 +1,455 @@
 <div align="center">
 
-<img src="banner.svg" alt="Agent Shadow Brain v5.2.0 — Subconscious Singularity Edition" width="100%">
-
-<br/>
+<a href="https://github.com/theihtisham/agent-shadow-brain">
+  <img src="banner-v6.0.2.png" alt="Shadow Brain v6.0.2 — Singularity · 35 new modules · 5 viral features · 10 brain-quality upgrades · One brain, every agent" width="100%">
+</a>
+<a href="https://trendshift.io/repositories/25944" target="_blank"><img src="https://trendshift.io/api/badge/repositories/25944" alt="lsdefine%2FGenericAgent | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+<br/><br/>
+
+<!-- v6.0.2 hero video — auto-plays muted on GitHub README -->
+<video src="https://raw.githubusercontent.com/theihtisham/agent-shadow-brain/main/docs/launch/shadow-brain-v6.0.2-hero.mp4"
+       poster="banner-v6.0.2.png"
+       autoplay
+       muted
+       loop
+       controls
+       playsinline
+       width="100%">
+  Your browser doesn't support inline video.
+  <a href="https://github.com/theihtisham/agent-shadow-brain/releases/tag/v6.0.2">Watch the v6.0.2 hero video on the release page</a>.
+</video>
+
+### 🎬 **2-minute v6.0.2 hero above — auto-plays muted · click 🔊 to unmute · [v6.0.2 release page](https://github.com/theihtisham/agent-shadow-brain/releases/tag/v6.0.2) · [original 2-min explainer](docs/launch/shadow-brain-motion-explainer-narrated.mp4) · [dashboard tour](docs/launch/shadow-brain-dashboard-tour.mp4)**
 
 [![npm version](https://img.shields.io/npm/v/@theihtisham/agent-shadow-brain?color=a855f7&labelColor=1a0a2e&style=for-the-badge&logo=npm)](https://www.npmjs.com/package/@theihtisham/agent-shadow-brain)
 [![npm downloads](https://img.shields.io/npm/dt/@theihtisham/agent-shadow-brain?color=06b6d4&labelColor=1a0a2e&style=for-the-badge)](https://www.npmjs.com/package/@theihtisham/agent-shadow-brain)
-[![npm weekly](https://img.shields.io/npm/dw/@theihtisham/agent-shadow-brain?color=10b981&labelColor=1a0a2e&style=for-the-badge&label=weekly)](https://www.npmjs.com/package/@theihtisham/agent-shadow-brain)
-[![bundle size](https://img.shields.io/bundlephobia/minzip/@theihtisham/agent-shadow-brain?color=f472b6&labelColor=1a0a2e&style=for-the-badge&label=size)](https://bundlephobia.com/package/@theihtisham/agent-shadow-brain)
-[![license](https://img.shields.io/badge/license-MIT-8b5cf6?labelColor=1a0a2e&style=for-the-badge)](https://github.com/theihtisham/agent-shadow-brain/blob/master/LICENSE)
-[![node](https://img.shields.io/badge/node-%3E%3D18-22c55e?labelColor=1a0a2e&style=for-the-badge&logo=node.js)](https://nodejs.org/)
-[![TypeScript](https://img.shields.io/badge/TypeScript-100%25-3178c6?labelColor=1a0a2e&style=for-the-badge&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![GitHub stars](https://img.shields.io/github/stars/theihtisham/agent-shadow-brain?color=f59e0b&labelColor=1a0a2e&style=for-the-badge&logo=github)](https://github.com/theihtisham/agent-shadow-brain/stargazers)
-[![GitHub forks](https://img.shields.io/github/forks/theihtisham/agent-shadow-brain?color=818cf8&labelColor=1a0a2e&style=for-the-badge&logo=github)](https://github.com/theihtisham/agent-shadow-brain/network)
-[![GitHub issues](https://img.shields.io/github/issues/theihtisham/agent-shadow-brain?color=ef4444&labelColor=1a0a2e&style=for-the-badge&logo=github)](https://github.com/theihtisham/agent-shadow-brain/issues)
-[![GitHub last commit](https://img.shields.io/github/last-commit/theihtisham/agent-shadow-brain?color=22d3ee&labelColor=1a0a2e&style=for-the-badge&logo=github)](https://github.com/theihtisham/agent-shadow-brain/commits)
-[![GitHub repo size](https://img.shields.io/github/repo-size/theihtisham/agent-shadow-brain?color=a78bfa&labelColor=1a0a2e&style=for-the-badge)](https://github.com/theihtisham/agent-shadow-brain)
-[![arXiv](https://img.shields.io/badge/arXiv-2504.17033-ef4444?labelColor=1a0a2e&style=for-the-badge&logo=arxiv)](https://arxiv.org/abs/2504.17033)
-[![ICLR 2026](https://img.shields.io/badge/ICLR-2026_TurboQuant-06b6d4?labelColor=1a0a2e&style=for-the-badge)](https://openreview.net/forum?id=TbqSEUXWaO)
-[![Zero Config](https://img.shields.io/badge/zero--config-auto_setup-22c55e?labelColor=1a0a2e&style=for-the-badge&logo=rocket)](#)
-[![MCP](https://img.shields.io/badge/MCP-19_tools-8b5cf6?labelColor=1a0a2e&style=for-the-badge&logo=anthropic)](#)
-[![Dashboard](https://img.shields.io/badge/dashboard-real_time-06b6d4?labelColor=1a0a2e&style=for-the-badge&logo=firefoxbrowser)](#)
-[![LSP](https://img.shields.io/badge/LSP-built_in-f97316?labelColor=1a0a2e&style=for-the-badge&logo=visual-studio-code)](#)
-[![Brain Modules](https://img.shields.io/badge/brain_modules-26-ec4899?labelColor=1a0a2e&style=for-the-badge&logo=brain)](#-architecture)
-[![CLI Commands](https://img.shields.io/badge/CLI-70%2B_commands-eab308?labelColor=1a0a2e&style=for-the-badge&logo=windowsterminal)](#-cli-reference)
-[![AI Agents](https://img.shields.io/badge/agents-10_supported-14b8a6?labelColor=1a0a2e&style=for-the-badge&logo=openai)](#)
-[![Singleton Brain](https://img.shields.io/badge/singleton-global_brain-a855f7?labelColor=1a0a2e&style=for-the-badge&logo=databricks)](#-1-singleton-global-brain)
-[![Subconscious](https://img.shields.io/badge/subconscious-proactive-ec4899?labelColor=1a0a2e&style=for-the-badge&logo=brain)](#-2-subconscious-engine)
-[![L0 Cache](https://img.shields.io/badge/L0_cache-%3C1ms-22d3ee?labelColor=1a0a2e&style=for-the-badge&logo=lightning)](#-4-l0-sub-millisecond-cache)
-[![Auto-Attach](https://img.shields.io/badge/attach--all-one_command-f59e0b?labelColor=1a0a2e&style=for-the-badge&logo=rocket)](#-3-universal-bootstrap-attach-all)
-[![Self Evolving](https://img.shields.io/badge/self--evolving-genetic_AI-d946ef?labelColor=1a0a2e&style=for-the-badge&logo=dna)](#)
-[![Infinite Memory](https://img.shields.io/badge/memory-infinite-facc15?labelColor=1a0a2e&style=for-the-badge&logo=databricks)](#)
-[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-22c55e?labelColor=1a0a2e&style=for-the-badge&logo=git)](https://github.com/theihtisham/agent-shadow-brain/pulls)
-[![Made with Love](https://img.shields.io/badge/made_with-%E2%9D%A4%EF%B8%8F-ef4444?labelColor=1a0a2e&style=for-the-badge)](#)
-[![Follow](https://img.shields.io/github/followers/theihtisham?label=follow&color=a855f7&labelColor=1a0a2e&style=for-the-badge&logo=github)](https://github.com/theihtisham)
+[![license](https://img.shields.io/badge/license-MIT-8b5cf6?labelColor=1a0a2e&style=for-the-badge)](https://github.com/theihtisham/agent-shadow-brain/blob/main/LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-100%25-3178c6?labelColor=1a0a2e&style=for-the-badge&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![node](https://img.shields.io/badge/node-%3E%3D18-22c55e?labelColor=1a0a2e&style=for-the-badge&logo=node.js)](https://nodejs.org/)
+[![Brain Modules](https://img.shields.io/badge/brain_modules-122-ec4899?labelColor=1a0a2e&style=for-the-badge)](#-architecture)
+[![CLI Commands](https://img.shields.io/badge/CLI-120%2B_commands-eab308?labelColor=1a0a2e&style=for-the-badge&logo=windowsterminal)](#-cli-reference)
+[![MCP Tools](https://img.shields.io/badge/MCP-60%2B_tools-8b5cf6?labelColor=1a0a2e&style=for-the-badge&logo=anthropic)](#-mcp-tools)
+[![Tests](https://img.shields.io/badge/tests-148%2F148_passing-10b981?labelColor=1a0a2e&style=for-the-badge&logo=vitest)](#)
+[![Local First](https://img.shields.io/badge/local--first-ollama_default-f97316?labelColor=1a0a2e&style=for-the-badge&logo=ollama)](#)
+[![Free](https://img.shields.io/badge/price-%240_forever-22c55e?labelColor=1a0a2e&style=for-the-badge)](#)
 
 <br/>
 
-### **One Brain. Every Agent. Every Project. Every Session. Forever.**
-
-**Agent Shadow Brain** is the singleton intelligence layer that makes **every AI coding agent** smarter — Claude Code, Cursor, Cline, Codex, GitHub Copilot, Windsurf, Kilo Code, Roo Code, OpenCode, Aider — all sharing the same brain. What one agent learns, every agent knows. What you discover in project A is available in project B. Forever.
-
-> **v5.2.0 — Subconscious Singularity Edition**: One command — `npx @theihtisham/agent-shadow-brain attach-all` — auto-detects every AI agent installed on your machine and wires them to a singleton global brain. Every new session, every agent, every project: Shadow Brain proactively injects the most relevant context **before the agent asks**. Your agents stop forgetting. They stop hallucinating. They start collaborating across tools.
-
-```bash
-# 30-second install. Every agent on your machine becomes smarter.
-npx @theihtisham/agent-shadow-brain attach-all
-```
-
-[**30-Second Install**](#-getting-started-30-seconds) · [**The Singularity**](#-v520--what-makes-it-singular) · [**Live Dashboard**](#-web-dashboard) · [**Algorithms**](#-algorithms--research) · [**70+ CLI Commands**](#-cli-reference) · [**Architecture**](#-architecture) · [**Star on GitHub ⭐**](https://github.com/theihtisham/agent-shadow-brain)
-
-</div>
-
----
-
-## ⚡ Why Shadow Brain Exists
-
-| Without Shadow Brain | With Shadow Brain |
-|---|---|
-| Every new session, your agent starts from zero | Agent gets a 2K-token briefing of relevant context **before it asks** |
-| Cursor learns something — Claude doesn't know | One singleton brain — what one agent learns, all agents know |
-| Discoveries in project A don't help project B | Cross-project memory federation by default |
-| Each AI tool needs its own setup | One command attaches every agent |
-| Agents hallucinate APIs that don't exist | Adversarial defense + multi-agent consensus voting |
-| Your codebase patterns are reinvented daily | Code DNA fingerprinting enforces your style across all agents |
-| 30 minutes of config before anything works | Zero config, auto-detect, instant value |
-
-## 🚀 v5.2.0 — What Makes It Singular
-
-### 🧠 1. Singleton Global Brain
-
-One database (`~/.shadow-brain/global.db`) is the **source of truth** for every project and every agent on your machine. Project-scoped views give each project its own namespace, but the data lives in one place. SQLite WAL mode + write queue handle concurrent multi-agent writes safely. Auto-vacuum at 500MB, auto-prune at 1GB.
-
-```bash
-shadow-brain global stats     # See cross-project, cross-agent stats
-shadow-brain global recall    # Search across every project + every agent
-```
-
-### 💭 2. Subconscious Engine
-
-Every time any agent starts a new session, the Subconscious **proactively injects** a tight briefing of:
-- Recent decisions made in this project (last 24h)
-- Active tasks (TODOs, in-progress items)
-- Similar past work from other projects
-- Cross-agent insights (what Claude learned that Cursor should know)
-- Warnings and known pitfalls
+# 🧠 Shadow Brain v6.0.2 — Singularity
 
-Hard-capped at 2K tokens. Relevance-ranked. The agent doesn't have to ask — the brain surfaces it implicitly. Like human intuition.
+### *The first open-source brain that every AI coding agent on your machine can share.*
 
-```bash
-shadow-brain subconscious inject              # See what your agent gets
-shadow-brain subconscious configure --budget 3000   # Tune the budget
-```
-
-### 🪝 3. Universal Bootstrap (`attach-all`)
-
-One command. Detects every AI agent installed on your machine. Installs the right hook for each one's native mechanism:
+**Claude Code · Cursor · Cline · Codex · Copilot · Windsurf · Kilo · Roo · OpenCode · Aider** — all running on one local brain. What one agent learns, every agent knows. What one sub-agent discovers, every sub-agent inherits.
 
-| Agent | Hook Mechanism |
-|---|---|
-| **Claude Code** | `~/.claude/settings.json` → `hooks.SessionStart` |
-| **Cursor** | `.cursor/rules/shadow-brain.md` + `.cursor/mcp.json` |
-| **Cline** | `~/.vscode/.../cline_mcp_settings.json` |
-| **Windsurf** | `.windsurfrules` + `~/.windsurf/mcp.json` |
-| **Codex** | `~/.codex/config.json` |
-| **Kilo Code** | `~/.kilocode/settings.json` |
-| **OpenCode** | `~/.opencode/settings.json` |
-| **Roo Code** | `~/.roocode/mcp.json` |
-| **Aider** | `~/.aider.conf.yml` `read:` directive |
-| **GitHub Copilot** | `.github/copilot-instructions.md` |
+> **🆕 v6.0.2 "Singularity" — 19 world-first features. Every one of them shareable.**
+>
+> **The 5 viral artifacts** — each renders as a tweet-ready PNG/SVG/MP4:
+> 🎬 **Brain Replay** · 🧬 **Brain DNA** · 🗳️ **Hive Voice** · ⏰ **Time Capsule** · 🔬 **Brain Diff**
+>
+> **The 14 advanced features** — Spotify-Wrapped-meets-AI-codebase:
+> 🎵 **Brain Cinema** (auto 60s SVG-animated video of brain growth) · 🎼 **Brain Sonification** (your codebase as music) · 🏆 **Brain Trophies** (25 achievements + share cards) · 🎁 **Brain Holiday Card** (year-in-review) · 🧭 **Brain Coach** (proactive idle suggestions) · 🗺️ **Brain Quest** (gamified onboarding adventures) · 📓 **Brain Notebook** (Jupyter-style brain explorer) · ⚡ **Brain Reflex** (local-model inline completion) · 🔥 **Brain Roast** (comedy code reviews, 6 personas) · 🔮 **Brain Tarot** (78-card divination from git+brain) · 🎨 **Brain ASCII** (terminal art representations) · 😂 **Brain Memes** (auto-generated dev memes) · 🌌 **Brain 3D** (Three.js rotatable graph viewer) · 💞 **Brain Doppelganger** (find your codebase's twin)
+>
+> **The infrastructure** — real ANN HNSW index · Constitution layer · Confidence Gate · multimodal vision (llava) · LoRA distillation pipeline · SWE-Bench-Lite eval harness · OpenTelemetry-lite tracing · git-trackable Markdown brain export/import.
+>
+> [Full release notes →](docs/launch/RELEASE_NOTES_v6.0.2.md)
 
 ```bash
-shadow-brain attach-all                # Wire every detected agent
-shadow-brain attach-all --dry-run      # See what would be wired
-```
-
-### ⚡ 4. L0 Sub-Millisecond Cache
+# 30 seconds. Every agent + sub-agent on your machine becomes smarter.
+npx @theihtisham/agent-shadow-brain@latest attach-all
 
-In-memory hot tier sits in front of the singleton brain. Hot recalls return in **<1ms**. Byte-budgeted (default 64MB), LRU-evicted, per-namespace. Tracks every access in nanoseconds.
-
-```bash
-shadow-brain global cache    # Hit rate, top keys, ns-latency
+# Or — the 30-second wow tour
+npx @theihtisham/agent-shadow-brain@latest demo
 ```
 
-### 🎯 5. First-Class Adapters for Every Major Agent
-
-Cursor, Windsurf, and Copilot were stub aliases in v5.1.1. In v5.2.0 they each have **dedicated adapters** matching their actual file layouts, conversation parsers, and injection mechanisms.
+**[🎬 Video](https://github.com/theihtisham/agent-shadow-brain/raw/main/docs/launch/shadow-brain-motion-explainer-narrated.mp4) · [📦 npm](https://www.npmjs.com/package/@theihtisham/agent-shadow-brain) · [⭐ Star on GitHub](https://github.com/theihtisham/agent-shadow-brain) · [📚 Docs](https://github.com/theihtisham/agent-shadow-brain/tree/main/docs) · [🐛 Issues](https://github.com/theihtisham/agent-shadow-brain/issues)**
 
----
-
----
-
-## The Problem
-
-You use AI coding agents. They're powerful, but:
-
-| Problem | Impact |
-|---|---|
-| Agents **forget everything** between sessions | Same mistakes, zero learning |
-| Multiple agents **don't communicate** | Claude doesn't know what Cursor learned |
-| Generated code has **hallucinations** | LLMs fabricate APIs that don't exist |
-| No **cross-session memory** | Every conversation starts from zero |
-| No **cross-project learning** | Discoveries in one project don't help others |
-| Setup is **complicated** | 30 minutes of config before anything works |
-| Each tool needs **separate config** | Claude, Cursor, Cline all need different setup |
-
-## The Solution
-
-**Shadow Brain v5.1.1** — zero-config, auto-detecting, infinite-intelligence shadow layer:
-
-```
-┌──────────────┐    auto-detect     ┌──────────────────────────────────────────┐
-│  AI Agents   │ ◀────────────────  │         SHADOW BRAIN v5.1.1              │
-│ Claude Code  │  MCP auto-install  │                                          │
-│ Cursor       │  zero-config       │  ┌─ HYPER-COGNITIVE (v5.1.1 NEW) ────┐  │
-│ Kilo Code    │                    │  │ Built-in LSP Server (stdio+TCP)   │  │
-│ Cline        │    watches         │  │ Custom LLM Fine-Tuning Engine     │  │
-│ OpenCode     │ ──────────────▶   │  │ Smart Cache (hot/warm/cold tiers) │  │
-│ Codex        │  file changes      │  │ Intent Engine (NLP commands)      │  │
-│ Roo Code     │  git commits       │  │ Code DNA (9-gene fingerprinting) │  │
-│ Aider        │  activity          │  │ Temporal Intelligence (velocity)  │  │
-│ Windsurf     │                    │  └────────────────────────────────────┘  │
-└──────────────┘                    │  ┌─ ZERO-CONFIG (v5.0.1) ─────────────┐  │
-         ▲                          │  │ Auto-detect + MCP + Dashboard      │  │
-         │                          │  │ Plugins + Export/Import + Hooks    │  │
-         │                          │  └────────────────────────────────────┘  │
-         │                          │  ┌─ INFINITE MEMORY (v5.0.0) ────────┐  │
-         │                          │  │ 4-tier hierarchical compression    │  │
-         │                          │  │ Context-triggered recall            │  │
-         │                          │  │ Multi-agent consensus + trust       │  │
-         │                          │  │ Collective cross-project learning   │  │
-         │                          │  └────────────────────────────────────┘  │
-         │                          │  ┌─ HYPER-INTELLIGENCE (v4) ──────────┐  │
-         │                          │  │ TurboQuant 6x Compression           │  │
-         │                          │  │ SSSP BMSSP Quantum Routing          │  │
-         │                          │  │ Self-Evolution + CAIP + Swarm       │  │
-         │                          │  │ PageRank + Predictive + Adversarial │  │
-         └──────────────────────────┴──────────────────────────────────────────┘
-```
+</div>
 
 ---
 
-## v5.1.1 — What's New
-
-### 6 Hyper-Cognitive Brain Modules
-
-<table>
-<tr>
-<td width="50%">
-
-### Built-in LSP Server
-
-**Language Server Protocol** — real-time IDE feedback without external tools.
-
-Pure Node.js LSP server supporting stdio and TCP transport modes:
-- **Diagnostics**: pushes brain insights as IDE warnings/errors
-- **Hover**: shows code health info on hover
-- **Code Actions**: quick-fix suggestions from brain analysis
-- **Zero dependency**: no external LSP libraries required
+## ⚡ Install in 30 seconds
 
 ```bash
-shadow-brain lsp --stdio          # stdio mode (for editors)
-shadow-brain lsp --tcp 2087       # TCP mode (for remote)
-```
-
-### Custom LLM Fine-Tuning Engine
-
-**Train on your codebase** — your brain learns YOUR patterns.
+# Method 1 — one command, every agent wired, dashboard launches
+npx @theihtisham/agent-shadow-brain@latest attach-all
 
-Automatic training data generation from code changes, insights, and fixes:
-- **Pair extraction**: before/after code → training pairs
-- **Pattern mining**: recurring fix patterns → fine-tune examples
-- **JSONL export**: ready for OpenAI, Anthropic, or local fine-tuning
-- **Quality scoring**: only high-confidence pairs enter the dataset
+# Method 2 — global install
+npm install -g @theihtisham/agent-shadow-brain
+shadow-brain attach-all
+shadow-brain dash .                 # → http://localhost:7341/
 
-```bash
-shadow-brain fine-tune status             # Training data stats
-shadow-brain fine-tune generate [dir]     # Generate training pairs
-shadow-brain fine-tune export [path]      # Export JSONL dataset
+# Method 3 — in a specific project only
+cd my-project
+npx @theihtisham/agent-shadow-brain attach-all
 ```
 
-</td>
-<td width="50%">
-
-### Smart Cache (Multi-Tier)
+**Zero config. Zero API key required. 100 % local-first.**
 
-**Hot/Warm/Cold** — intelligent caching with predictive prefetch.
+---
 
-Three-tier LRU cache with automatic promotion and demotion:
-- **Hot tier**: 200 entries, fastest access
-- **Warm tier**: 1000 entries, promoted on repeated access
-- **Cold tier**: 5000 entries, compressed storage
-- **Predictive prefetch**: co-access graph predicts what you'll need next
-- **Tag-based invalidation**: invalidate by category
+## 🆕 What's New in v6.0.2 — "Singularity"
 
-```bash
-shadow-brain cache stats          # Hit rate, tier sizes, memory usage
-shadow-brain cache clear          # Clear all tiers
-```
+> **35 new modules + 27 new CLI commands + 7 sample artifacts. Zero new npm deps. tsc-clean.**
 
-### Intent Engine
+### 🌟 The 5 World-First Viral Features
 
-**Natural language → brain actions** — understand what you mean.
+Every one of these renders as a tweet-ready PNG/SVG. *Cursor doesn't have these. Cline doesn't have these. Nobody has these.*
 
-Multi-strategy NLP command understanding:
-- **Keyword matching**: fast path for common commands
-- **Fuzzy matching**: handles typos and variations
-- **Context-aware**: uses current file/project context
-- **Confidence scoring**: routes to best-matching action
+| | Feature | What it does |
+|---|---|---|
+| 🎬 | **[Brain Replay](docs/launch/v6.0.2-samples/brain-replay-sample.svg)** | Scrubbable timeline of every brain event since day-zero. Drag the cursor, rewind to any moment. SVG export. |
+| 🧬 | **[Brain DNA](docs/launch/v6.0.2-samples/brain-dna-sample.svg)** | Spotify-Wrapped-style fingerprint card. 8 personality archetypes (The Architect, The Debugger, …). 1080×1080 share card. |
+| 🗳️ | **Hive Voice** | 3 local models debate-vote on every architecture question. See consensus, dissent, and confidence — live. SVG bar chart. |
+| ⏰ | **Brain Time Capsule** | Freeze + label + resurrect brain snapshots. "Here's what we knew about React in January." Ed25519-signed bundles. |
+| 🔬 | **Brain Diff** | Semantic diff between two brains. Venn-diagram SVG + English narrative. "What did Team A learn that Team B didn't?" |
 
 ```bash
-shadow-brain intent "find security bugs"    # Maps to: analyze + security filter
-shadow-brain intent "show hot files"        # Maps to: temporal + heatmap
+shadow-brain dna card --out my-brain.svg                    # 🧬 generate your DNA card
+shadow-brain replay export --format svg --out timeline.svg  # 🎬 scrubbable timeline
+shadow-brain hive-voice ask "Server Components by default?" # 🗳️ multi-model vote
+shadow-brain capsule freeze --label "pre-redesign"          # ⏰ freeze a snapshot
+shadow-brain brain-diff compare brain-a/ brain-b/           # 🔬 semantic diff
 ```
 
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### Code DNA Fingerprinting
-
-**9-gene analysis** — every file gets a unique genetic profile.
-
-Analyzes code across 9 gene categories to create a structural fingerprint:
-- **Structure genes**: classes, functions, nesting depth
-- **Complexity genes**: cyclomatic complexity, cognitive load
-- **Style genes**: naming conventions, formatting patterns
-- **Dependency genes**: import graph, coupling metrics
-- **Evolution genes**: change frequency, stability score
-- **Similarity matching**: find structurally similar files across projects
+### 🎁 14 More Advanced Features
 
-```bash
-shadow-brain dna analyze [dir]    # Generate DNA profiles
-shadow-brain dna compare f1 f2    # Compare two file fingerprints
-shadow-brain dna similar [file]   # Find similar files
-```
+| | | | |
+|---|---|---|---|
+| 🎵 **Brain Cinema** — auto-procedural 60-sec SVG video | 🎼 **Brain Sonification** — your codebase as music (WAV) | 🏆 **Brain Trophies** — 25 achievements w/ share cards | 🎁 **Brain Holiday Card** — year-in-review SVG |
+| 🧭 **Brain Coach** — 10 proactive idle-suggestion rules | 🗺️ **Brain Quest** — 5 gamified onboarding adventures | 📓 **Brain Notebook** — Jupyter-style brain explorer | ⚡ **Brain Reflex** — local-model inline completion |
+| 🔥 **Brain Roast** — comedy code review (6 personas) | 🔮 **Brain Tarot** — 78-card divination from git+brain | 🎨 **Brain ASCII** — terminal-art brain (6 styles) | 😂 **Brain Memes** — auto-generated dev memes (10 templates) |
+| 🌌 **Brain 3D** — rotatable Three.js graph viewer | 💞 **Brain Doppelganger** — find your codebase's twin | | |
 
-</td>
-<td width="50%">
+### 🧠 10 Brain-Quality Upgrades (the engineering wins)
 
-### Temporal Intelligence
+| Recall quality | Memory arch | Efficiency | Intelligence | Size + Learning |
+|---|---|---|---|---|
+| **Rerank** (BM25 + cosine hybrid) | **Memory Tiers** (episodic/semantic) | **Working Memory** (LRU + predictive prefetch) | **Contradictions** (46 polarity pairs) | **Quantize** (int8 vectors, 4× smaller, 0.000298 mean error) |
+| **Query Expander** (synonyms + abbrev + HyDE) | **Consolidator** (dedup + abstractions) | **Recall Cache** (bloom filter, 65k bits, ~4% FP @ 10k keys) | **Graph Walker** (5 edge types, 3-hop BFS) | **Active Learner** (accept/reject feedback bias) |
 
-**Time-series code evolution** — velocity tracking & bug prediction.
+### ⚙️ Production Infrastructure
 
-Continuous monitoring of code change patterns over time:
-- **Velocity metrics**: daily/weekly/monthly rates with trend detection
-- **File heatmaps**: hotness scoring, churn risk, stability
-- **Bug prediction**: 5-factor probability model per file
-- **Anomaly detection**: burst detection, drought alerts, unusual hours
-- **Peak analysis**: identifies your most productive hours and days
+- **Real ANN vector index** (`embeddings-v2.ts`) — HNSW-style graph, M=8, sub-100ms recall over 10k vectors, sharded persistence (5MB cap), auto-pulls `nomic-embed-text` from Ollama on first run
+- **Constitution layer** — `<project>/.shadow-brain/constitution.md` parser + hot-reload + injection
+- **Confidence Gate** — active output filter, Brier score + ECE stats
+- **Multimodal vision** — Ollama llava / llava-llama3 / bakllava ingestion
+- **Markdown brain export/import** — git-trackable `.shadow-brain.md` round-trip
+- **OpenTelemetry-lite tracing** — OTel-compatible JSONL, daily rotation
+- **LoRA distillation pipeline** (`tools/lora-pipeline/`) — turn your brain into a Qwen2.5-Coder-1.5B adapter
+- **SWE-Bench-Lite harness** (`tools/swe-bench-lite/`) — 10 curated bugs, brain-on vs brain-off, statistical scoring
+- **30-second demo**: `npx @theihtisham/agent-shadow-brain demo`
 
-```bash
-shadow-brain temporal stats       # Velocity, anomalies, predictions
-shadow-brain temporal hot         # Top 10 hottest files
-shadow-brain temporal predict     # Bug risk predictions
-shadow-brain temporal timeline    # Recent event timeline
-```
+### 📊 v6.0.2 by the numbers
 
-</td>
-</tr>
-</table>
+| | |
+|---|---|
+| New brain modules | **35** (25 features + 10 quality stack) |
+| New CLI command groups | **27** |
+| New LOC | **~16,000** (TypeScript) |
+| New npm dependencies | **0** |
+| Sample artifacts shipped | **7** (DNA card, Replay timeline, Cinema, Holiday wrapped, Tarot, Trophy wall, 3D viewer HTML) |
+| Quantization roundtrip error | **0.000298** (16× better than spec) |
+| TypeScript errors | **0** |
+
+**Full release notes:** [docs/launch/RELEASE_NOTES_v6.0.2.md](docs/launch/RELEASE_NOTES_v6.0.2.md)
+**Strategic roadmap (v7+):** [docs/ROADMAP-v7.md](docs/ROADMAP-v7.md)
+**Launch playbook:** [docs/VIRAL-PLAYBOOK.md](docs/VIRAL-PLAYBOOK.md)
 
 ---
 
-## v5.0.1 — What's New
-
-### Zero-Config Auto-Setup
+## 🔥 Why Shadow Brain? (the 60-second pitch)
 
-Install it. That's it. Shadow Brain automatically:
-
-- Detects your project type (frontend, backend, fullstack, mobile, game, systems, data-science)
-- Detects 25+ languages, 15+ frameworks, 5+ build tools, 5+ test frameworks
-- Detects which AI tools are installed (Claude Code, Cursor, Kilo Code, Cline, OpenCode, Codex, Aider, Windsurf)
-- Auto-installs MCP server configuration for every detected AI tool
-- Auto-installs git pre-commit and pre-push hooks
-- Generates an optimal brain config based on project complexity
-
-```bash
-npm install @theihtisham/agent-shadow-brain
-# → Shadow Brain v5.1.1 auto-configured for my-app (fullstack)
-# → AI tools detected: Claude Code, Cursor
-# → Run: shadow-brain start
-```
-
-### MCP Server — Works with EVERY AI Tool
-
-The brain exposes itself as a **Model Context Protocol (MCP) server** with 19 tools that any AI tool can call:
-
-| MCP Tool | What It Does |
+| Without Shadow Brain | With Shadow Brain v6 |
 |---|---|
-| `brain_status` | Get full brain status |
-| `brain_analyze` | Trigger code analysis |
-| `brain_health` | Get health score (A-F) |
-| `brain_insights` | Get recent insights |
-| `brain_fixes` | Get smart fix suggestions |
-| `brain_memory_store` | Store knowledge in hierarchical memory |
-| `brain_memory_search` | Search across all memory tiers |
-| `brain_memory_stats` | Memory compression statistics |
-| `brain_recall` | Context-triggered associative recall |
-| `brain_consensus_propose` | Submit a proposal for agent consensus |
-| `brain_consensus_vote` | Vote on a pending proposal |
-| `brain_collective_propose` | Propose a cross-project rule |
-| `brain_collective_search` | Search collective learning rules |
-| `brain_turbo_search` | Semantic search in compressed memory |
-| `brain_predict` | Predict bug risk for files |
-| `brain_graph_query` | Query knowledge graph |
-| `brain_defense_scan` | Scan for hallucination patterns |
-| `brain_evolve_status` | Get self-evolution status |
-| `brain_dashboard_url` | Get dashboard URL |
-
-Works with **Claude Code**, **Cursor**, **Kilo Code**, **Cline**, **OpenCode**, and any MCP-compatible AI tool.
-
-```bash
-# Start MCP server (auto-started by AI tools)
-shadow-brain mcp
-
-# Cursor compatibility (root path POST + /v1/chat)
-# Claude Code compatibility (JSON-RPC 2.0 over stdio/HTTP)
-```
-
-### Rich Web Dashboard
+| Every new session → agent starts from zero | 2K-token briefing injected **before** the first prompt |
+| Cursor learns X → Claude doesn't know | **One singleton brain** every agent shares |
+| Claude Task spawns sub-agent → sub-agent starts blind | **SABB** injects focused context slivers into every sub-agent |
+| You can't explain *why* the AI made a choice | **Causal Memory Chains** render the full DAG of causes |
+| Two agents touching the same file = merge hell | **Collision Detective** catches it in real time |
+| Agents work, then go idle — wasted compute | **Dream Engine** reflects during idle, runs counterfactuals |
+| No verifiable record of agent decisions | **Ed25519-signed Reputation Ledger** — tamper-proof receipts |
+| Token bills explode across Opus / GPT / Gemini | **Token Economy** routes to cheapest model that passes confidence |
+| Needs its own API key for everything | **Agent-proxy mode** reuses your existing Claude/Cursor/Codex config |
+| Every tool runs hot, every key leaks | **Air-Gap mode** + ChaCha20 encryption at rest |
 
-Real-time browser dashboard at `http://localhost:7341` with WebSocket live updates:
+---
 
-- **Stats Topbar**: 8 live counters — Insights, Fixes, Memory KB, Modules, AI Tools, Evolution Gen, Swarm Convergence, Turbo Compression
-- **Health Score**: A-F grading with dimension breakdown (Security, Quality, Performance, Architecture, Maintainability, Test Coverage)
-- **Memory Tiers**: Visual bars showing Raw (50K), Summary (10K), Pattern (2K), Principle (500) with Turbo compression ratio
-- **Live Insights Stream**: Real-time feed of brain insights with priority badges
-- **Smart Fixes**: Actionable fix suggestions with file/line references
-- **AI Tools Panel**: 8 tools showing connected/detected status
-- **Brain Modules**: 13 modules with active/idle/error indicators
-- **Control Buttons**: Trigger analysis on-demand, refresh data
+## 🌟 22 Novel Modules — None Exist in Any Other Tool
+
+> *This isn't a wrapper around someone else's API. All 22 are first-party research-grade implementations, persisted to disk, with real tests.*
+
+### 🧠 Cognition
+1. **Sub-Agent Brain Bridge (SABB)** — sync brain context into Claude Task / Cursor Composer / CrewAI / LangGraph / AutoGen sub-agents
+2. **Causal Memory Chains** — every decision links to its causes; Graphviz DOT export
+3. **Dream Engine** — idle-time reflection: revisit / counterfactual / consolidation / contradiction / pattern-discovery
+4. **Swarm Debate Protocol** — pro / con / arbiter sub-agents for critical decisions
+5. **Pre-Mortem Assistant** — surfaces past failures from *your* project before you start
+6. **Branch Brains** — git-branch-aware memory context
+
+### 🔍 Transparency & Trust
+7. **Agent Reputation Ledger** — Ed25519-signed receipts, portable accuracy score
+8. **Attention Heatmap** — weighted attribution showing which memories shaped a decision
+9. **Confidence Calibration Monitor** — Brier scores + automatic trust-weighting
+10. **Formal Verification Bridge** — natural-language rules → ESLint / Semgrep / LSP diagnostics
+11. **Agent Collision Detective** — real-time overlap detection with advisory locks
+
+### 💰 Economy & Memory
+12. **Token Economy Engine** — cross-agent spend, savings suggestions, routing advice
+13. **Cost-Aware Sub-Agent Spawner** — auto-route trivial tasks to cheaper models
+14. **Forgetting Curve + Sleep Consolidation** — Ebbinghaus-inspired biological memory
+
+### 🔒 Privacy & Safety
+15. **Air-Gap Mode** — zero outbound network, localhost-only
+16. **E2E Encryption** — ChaCha20-Poly1305 at rest
+17. **Hallucination Quarantine** — isolate suspect memories, auto-expire in 7 days
+
+### ✨ Delight & Network Effects
+18. **Voice Mode** — natural-language intent parser for transcripts
+19. **Brain Garden** — animated visualization of memory as a living constellation
+20. **PR Auto-Review** — GitHub PR comments citing project memories
+21. **Team Brain Sync (WebRTC)** — peer-to-peer shared brain, no server
+22. **Brain Exchange** — export / import curated shareable brain slices
+
+### ⚡ Accelerators
+- **Local-First LLM** — Ollama default; optional Anthropic / OpenAI / OpenRouter / Moonshot / Gemini / DeepSeek / Mistral
+- **Hive Accelerator** — SSSP ([arXiv 2504.17033](https://arxiv.org/abs/2504.17033)) + TurboQuant ([ICLR 2026](https://openreview.net/forum?id=TbqSEUXWaO)) for fast causal traversal + 6× vector compression
 
-```bash
-shadow-brain start .     # Dashboard auto-starts at http://localhost:7341
-shadow-brain dash .      # Dashboard only mode
-```
-
-### Natural Language Queries
+---
 
-Ask your brain questions in plain English:
+## 🖥️ Complete Web Control Dashboard
 
+Start it:
 ```bash
-shadow-brain ask "What security issues exist in the auth module?"
-shadow-brain ask "Which files have the highest bug risk?"
-shadow-brain ask "What patterns have we learned about React hooks?"
+shadow-brain dash .
+# → http://localhost:7341/
 ```
 
-### Brain Export/Import — Team Sync
+**28 tabs. Real-time data. Full control.** Every feature has live monitoring + interactive controls. Preview:
 
-Export your brain state and share it with your team:
+| | | |
+|---|---|---|
+| ![Overview](docs/launch/screenshots/01-overview.png) | ![Live Graph](docs/launch/screenshots/02-graph.png) | ![Agents](docs/launch/screenshots/03-agents.png) |
+| **Overview** — live counters, charts | **Live Graph** — animated signal flow | **Agents** — connect / disconnect per agent |
+| ![Chat](docs/launch/screenshots/04-chat.png) | ![Memory](docs/launch/screenshots/05-memory.png) | ![SABB](docs/launch/screenshots/07-sabb.png) |
+| **Chat with Brain** — RAG with citations | **Memory Browser** — semantic search | **SABB** — sliver generator + quarantine |
+| ![Causal](docs/launch/screenshots/08-causal.png) | ![Dream](docs/launch/screenshots/10-dream.png) | ![Reputation](docs/launch/screenshots/11-reputation.png) |
+| **Causal Chains** — traceable decisions | **Dream Engine** — reflection insights | **Reputation** — Ed25519 leaderboard |
+| ![Tokens](docs/launch/screenshots/19-tokens.png) | ![Models](docs/launch/screenshots/27-models.png) | ![Command](docs/launch/screenshots/29-command-palette.png) |
+| **Token Economy** — $ saved live | **Models & Intelligence** — 8 providers | **⌘K Command Palette** |
 
-```bash
-shadow-brain export                    # Full export with all modules
-shadow-brain export -o ./team-brain    # Custom output directory
-shadow-brain import brain-export.json  # Import + merge
-shadow-brain import brain-export.json --merge --skip swarm,evolution
-```
+**→ [Browse all 29 tab screenshots](docs/launch/screenshots/)**
 
-### Plugin System
+Features: dark + light theme · command palette (⌘K) · keyboard shortcuts · toast notifications · Chart.js analytics · responsive (mobile / tablet / desktop) · real-time WebSocket · stop button that actually stops the process.
 
-Extend Shadow Brain with custom plugins:
+---
 
-```bash
-shadow-brain plugin list               # List installed plugins
-shadow-brain plugin create my-plugin   # Create from template
-shadow-brain plugin stats              # Plugin system statistics
-```
+## 🧩 Works With Every AI Coding Agent
 
-Plugins can hook into `pre-analysis` and `post-analysis` pipelines to add custom insights, filter results, or integrate with external services.
+| Agent | Adapter | Hook target |
+|---|---|---|
+| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | ✅ Native | `~/.claude/settings.json` hooks.SessionStart |
+| [Cursor](https://cursor.sh/) | ✅ Native | `.cursor/rules/shadow-brain.md` + MCP |
+| [Cline](https://github.com/cline/cline) | ✅ Native | VS Code globalStorage MCP |
+| [Codex](https://github.com/openai/codex) | ✅ Native | `~/.codex/config.json` |
+| [GitHub Copilot](https://github.com/features/copilot) | ✅ Native | `.github/copilot-instructions.md` |
+| [Windsurf](https://codeium.com/windsurf) | ✅ Native | `.windsurfrules` + MCP |
+| [Kilo Code](https://kilocode.ai/) | ✅ Native | `~/.kilocode/settings.json` |
+| [Roo Code](https://roocode.com/) | ✅ Native | `~/.roocode/mcp.json` |
+| [OpenCode](https://github.com/opencode-ai/opencode) | ✅ Native | `AGENT.md` |
+| [Aider](https://aider.chat/) | ✅ Native | `.aider.conf.yml` |
 
-### 5 New Commands
+**Custom agent?** Add its config path in the dashboard "Custom Agent Paths" panel — Shadow Brain will auto-read its provider + model + API key.
 
-```bash
-shadow-brain off          # Clean shutdown
-shadow-brain ask "..."    # Natural language query
-shadow-brain export       # Export brain state
-shadow-brain import FILE  # Import brain state
-shadow-brain plugin CMD   # Plugin management
-```
+**Sub-agent frameworks supported by SABB:** Claude Task, Cursor Composer, Cline Sub-step, CrewAI, LangGraph, AutoGen, generic.
 
 ---
 
-## Getting Started — 30 Seconds
+## 🤖 Use Your Own LLM — or Your Agent's Already-Configured One
 
-```bash
-# Install globally
-npm install -g @theihtisham/agent-shadow-brain
+Shadow Brain's **ModelRegistry** supports 8 providers out of the box:
 
-# Or use npx (no install needed)
-npx @theihtisham/agent-shadow-brain start .
-```
+**Ollama (default, local, free)** · **Anthropic Claude** · **OpenAI** · **OpenRouter** · **Moonshot / Kimi** · **Google Gemini** · **DeepSeek** · **Mistral**
 
-That's literally it. Shadow Brain will:
-1. **Auto-detect** your project, languages, frameworks, AI tools (zero config)
-2. **Auto-install** MCP server config for Claude Code, Cursor, Kilo Code, Cline, etc.
-3. **Auto-install** git hooks for pre-commit and pre-push
-4. Watch your project files for changes
-5. Analyze every change with LLM + 22 brain modules
-6. Inject expert insights into your agent's memory
-7. Store all knowledge in hierarchical memory for infinite retention
-8. Activate past memories automatically based on context
-9. Share verified patterns across projects via collective learning
-10. Compress knowledge with TurboQuant for infinite retention
-11. Evolve its own rules via genetic algorithm
-12. Share insights across agents via CAIP
-13. Detect hallucinations with adversarial verification
-14. Run consensus when multiple agents disagree
-15. Serve a rich web dashboard at `localhost:7341`
-
-### Quick Review (No Watch Mode)
+Plus a unique **Agent Proxy** mode: if you already use Claude Code / Cursor / Codex with their own API key, Shadow Brain borrows their intelligence — **zero new API keys, zero cost**.
 
-```bash
-shadow-brain review .                    # One-shot analysis
-shadow-brain review . --show-health      # + health score
-shadow-brain review . --show-fixes       # + fix suggestions
-shadow-brain review . --output json      # JSON for scripting
-```
+Auto-discovery reads every agent config on your machine so you never retype a key.
 
 ---
 
-## Web Dashboard
-
-The v5.1.1 dashboard provides a real-time view into your brain:
+## 📊 Real Numbers
 
-```
-┌──────────────────────────────────────────────────────────────────────────┐
-│  Shadow Brain v5.1.1                                     [Analyze] [↻] │
-├──────────────────────────────────────────────────────────────────────────┤
-│  Insights: 142 │ Fixes: 38 │ Memory: 247KB │ Modules: 22/22 │ ...     │
-├──────────────┬─────────────────────────────────────┬───────────────────┤
-│ Health: 87%  │  Live Insights Stream               │ AI Tools          │
-│ ████████░░   │  ● [HIGH] SQL injection in login.ts │ ● Claude Code ✓  │
-│ Security: A  │  ● [MED] Missing error handling     │ ● Cursor    ✓    │
-│ Quality: B+  │  ● [LOW] Unused import in utils     │ ● Kilo Code ✓    │
-│ Perf:    A-  │  ● [CRIT] Exposed API key           │ ● Cline     —    │
-│ Arch:    B   │                                     │ ● OpenCode  —    │
-│ Maintain: A  ├─────────────────────────────────────┤ ● Codex     —    │
-│ Tests:   C+  │  Smart Fixes                        │ ● Aider     —    │
-│              │  1. Add parameterized query...       │ ● Windsurf  —    │
-├──────────────┤  2. Wrap in try/catch with...       ├───────────────────┤
-│ Memory Tiers │  3. Remove unused import on L42     │ Brain Modules     │
-│ Raw:   8421  │                                     │ ● Hierarchical ✓  │
-│ Summ:  1203  │                                     │ ● TurboMemory  ✓  │
-│ Patt:   187  │                                     │ ● Consensus    ✓  │
-│ Princ:    24 │                                     │ ● Swarm        ✓  │
-│ Turbo: 6.2x  │                                     │ ● Evolution    ✓  │
-│              │                                     │ ● Adversarial  ✓  │
-└──────────────┴─────────────────────────────────────┴───────────────────┘
-```
+| Metric | Value |
+|---|---|
+| Brain modules | **48** |
+| CLI commands | **90+** |
+| MCP tools | **60+** |
+| REST endpoints | **50+** |
+| Tests passing | **148 / 148** |
+| TypeScript errors | **0** |
+| Supported agents | **10** (plus custom) |
+| Supported LLM providers | **8** (plus agent-proxy) |
+| Novel features nobody else has | **22** |
+| License | **MIT** |
+| Cost to run | **$0 forever** (local-first) |
 
 ---
 
-## v5.0.0 Infinite Intelligence Engine
-
-### 4 Breakthrough Modules
-
-<table>
-<tr>
-<td width="50%">
-
-### Infinite Memory Layer
-
-**Hierarchical Memory Compression** — 4-tier pyramid that never forgets.
-
-Knowledge flows through compression tiers as it ages:
-- **Raw** (50K entries) — full detail, hot path
-- **Summary** (10K) — condensed key points
-- **Pattern** (2K) — recurring patterns extracted
-- **Principle** (500) — timeless design rules
-
-Drill-down and drill-up between tiers. Older knowledge compresses, never deletes.
-
-```bash
-shadow-brain memory stats          # 4 tiers | 12,847 entries
-shadow-brain memory store "..."    # Store new knowledge
-shadow-brain memory search "auth"  # Cross-tier semantic search
-```
-
-**Context-Triggered Associative Recall** — memories that activate themselves.
-
-Instead of requiring explicit search queries, this engine monitors your current work context and automatically surfaces relevant past knowledge:
-- File path pattern matching (editing `auth/*.ts` → security memories)
-- Keyword detection (typing "database" → SQL pattern memories)
-- Category association (bug-fix context → past fix patterns)
-- Co-occurrence networks (memories activated together strengthen their link)
-- Learned trigger patterns that improve with use
-
-```bash
-shadow-brain recall . --file src/auth/login.ts --keywords "jwt,session"
-# → Activates 8 memories | Top: "JWT rotation pattern (92%)"
-```
-
-</td>
-<td width="50%">
-
-### Multi-Agent Intelligence Layer
-
-**Consensus Engine** — voting, trust scoring, conflict resolution.
-
-When multiple AI agents observe the same codebase, they may produce conflicting insights. This engine:
-1. Collects proposals from agents
-2. Opens voting windows (agree/disagree/abstain with confidence)
-3. Computes trust-weighted agreement scores
-4. Resolves conflicts via confidence intervals
-5. Tracks long-term agent trust based on proposal accuracy
+## 🚀 30-Second Quickstart
 
 ```bash
-shadow-brain consensus status
-shadow-brain consensus propose "Use bcrypt for all password hashing" security 0.95
-shadow-brain consensus vote <id> agree 0.9 "Industry standard"
-shadow-brain consensus results
-```
+# 1. Install
+npx @theihtisham/agent-shadow-brain@latest attach-all
 
-**Collective Learning** — discoveries flow across all projects.
+# 2. Launch the dashboard
+shadow-brain dash .
+# → open http://localhost:7341/
 
-When you discover a pattern in Project A, it becomes a verified rule available in Project B:
-- Rule proposal with evidence and verification
-- Viral propagation across connected brain instances
-- Accuracy tracking per rule (tested vs. false positive)
-- Category-based organization (security, performance, architecture...)
-- Trust scores for rule sources
+# 3. Seed the brain (optional — populates example data)
+shadow-brain reputation sign --agent claude-code --ver 4.7 --project demo \
+  --decision "use bcrypt cost 12 for all password hashing" \
+  --category security --confidence 0.92
 
-```bash
-shadow-brain collective status
-shadow-brain collective propose "Always validate file upload MIME types" security
-shadow-brain collective search performance
+# 4. Every new AI agent session automatically gets context injected
 ```
 
-</td>
-</tr>
-</table>
+**That's it.** Open any project in Claude Code / Cursor / any supported agent — Shadow Brain is already running under the hood.
 
 ---
 
-## v4.0.0 Hyper-Intelligence Engine
-
-### 8 Breakthrough Modules (included in v5.1.1)
-
-<table>
-<tr>
-<td width="50%">
-
-### Quantum Memory Layer
+## 🧪 The Hive Mind Explainer (2 minutes)
 
-**TurboQuant Infinite Memory** — never forget anything, ever.
-
-Based on Google Research's **TurboQuant** (ICLR 2026):
-- **PolarQuant**: 2 bits per dimension (polar coordinate quantization)
-- **QJL Residual**: 1 bit per dimension (random rotation + sign)
-- **Total**: 3 bits/dim = **6x compression** with <1% accuracy loss
-- **Result**: Infinite retention — old knowledge is compressed, never deleted
-
-```bash
-shadow-brain turbo stats
-shadow-brain turbo search "authentication patterns"
-```
-
-**SSSP Quantum Router** — deterministic shortest-path message routing.
-
-Based on **"Breaking the Sorting Barrier"** (arXiv 2504.17033, Duan et al.):
-- **BMSSP Algorithm**: O(m log<sup>2/3</sup> n) — breaks the sorting barrier
-- **Deterministic**: No randomization, provably correct
-
-```bash
-shadow-brain route status
-shadow-brain route find node-A node-B
-```
-
-</td>
-<td width="50%">
-
-### Self-Evolution Layer
-
-**Genetic Algorithm Self-Evolution** — rules that write themselves.
-
-- **Population**: 50 genetic rule chromosomes
-- **Selection**: Tournament (k=5) — survival of the fittest
-- **Crossover**: Single-point recombination
-- **Mutation**: Gaussian noise (Box-Muller transform, sigma=0.1)
-- **Fitness**: accuracy x coverage x (1 / falsePositiveRate)
-
-```bash
-shadow-brain evolve status
-shadow-brain evolve run
-shadow-brain evolve best-rules security
-```
-
-**Cross-Agent Intelligence Protocol (CAIP)** — agents that talk to each other.
-
-Your Claude Code session learns what your Cursor session discovered:
-- Zero-config broadcast protocol
-- Agent identification + insight tagging
-- Multi-agent consensus building
-
-```bash
-shadow-brain caip status
-shadow-brain caip broadcast "Security pattern detected"
-```
-
-</td>
-</tr>
-<tr>
-<td width="50%">
-
-### Defense & Trust Layer
-
-**Adversarial Hallucination Defense** — trust nothing, verify everything.
-
-- Cross-reference every critical insight against actual code
-- Evidence scoring with confidence thresholds
-- Verdict: `real` | `hallucinated` | `uncertain`
-
-```bash
-shadow-brain defense status
-shadow-brain defense scan "This API endpoint exists at /api/v2/users"
-```
+[![Shadow Brain Hive Mind Explainer — 2 minutes](banner.svg)](https://github.com/theihtisham/agent-shadow-brain/raw/main/docs/launch/shadow-brain-motion-explainer-narrated.mp4)
 
-**Swarm Intelligence** — Ant Colony Optimization for file prioritization.
+**[▶ Click here to watch](https://github.com/theihtisham/agent-shadow-brain/raw/main/docs/launch/shadow-brain-motion-explainer-narrated.mp4)** · Full motion graphics explainer with voice-over walking through every feature, the live dashboard, and the 30-second install.
 
-- Pheromone deposit: +3 for critical, +2 for high, +1 for medium
-- Evaporation: decay over time to avoid staleness
+Local file: `docs/launch/shadow-brain-motion-explainer-narrated.mp4` (2:05 · 1080p · narrated).
 
-```bash
-shadow-brain swarm status
-shadow-brain swarm priorities
-```
-
-</td>
-<td width="50%">
-
-### Analytics & Prediction Layer
-
-**Knowledge Graph + PageRank** — code impact radar.
-
-- Identify high-impact files (change one, break many)
-- Cycle detection in dependency graphs
-- Entity extraction with file/line tracking
-
-```bash
-shadow-brain graph build .
-shadow-brain graph pagerank
-shadow-brain graph cycles
-```
-
-**Predictive Engine** — predict bugs before they happen.
+---
 
-- Bug risk scoring: `low` | `medium` | `high` | `critical`
-- Technical debt forecasting
-- Anomaly detection in change patterns
+## 📖 CLI Reference (top commands)
 
 ```bash
-shadow-brain predict bugs .
-```
-
-</td>
-</tr>
-</table>
+# Attachment + lifecycle
+shadow-brain attach-all          # wire every detected agent
+shadow-brain detach-all          # remove every hook
+shadow-brain audit-hooks         # list what's installed
+shadow-brain dash .              # launch web dashboard at :7341
+shadow-brain mcp                 # start MCP server at :7342
 
----
+# v6 Hive Mind
+shadow-brain hive status         # cross-module status
+shadow-brain subagent sliver --parent claude-code --task "refactor auth"
+shadow-brain causal trace <id>   # render ancestor DAG
+shadow-brain dream run           # trigger idle reflection now
+shadow-brain debate "Redis or Postgres?" --context "10k users"
+shadow-brain premortem "migrate auth to passkeys"
+shadow-brain reputation sign --agent claude-code --ver 4.7 --project X \
+  --decision "..." --category security --confidence 0.92
+shadow-brain reputation badge claude-code --ver 4.7
 
-## Algorithms & Research
+# Memory + analytics
+shadow-brain global recall --keywords "auth"
+shadow-brain tokens report       # cross-agent spend + savings
+shadow-brain forget consolidate  # run sleep cycle
+shadow-brain formal generate "always use parameterized SQL"
+shadow-brain formal export-eslint
 
-Shadow Brain v5.1.1 implements algorithms from **peer-reviewed research**:
+# Privacy + trust
+shadow-brain airgap enable --policy strict
+shadow-brain encrypt file ~/.shadow-brain/global.json --passphrase ...
+shadow-brain quarantine list
 
-| Algorithm | Paper / Origin | Application | Complexity |
-|---|---|---|---|
-| **Hierarchical Compression** | Novel 4-tier system | Infinite memory with drill-down | O(n) per tier |
-| **Associative Recall** | Spreading activation model | Context-triggered memory activation | O(n x k) |
-| **Consensus Protocol** | Byzantine fault tolerance | Multi-agent agreement with trust | O(v x log v) |
-| **TurboQuant** | Google Research, ICLR 2026 | Vector compression (PolarQuant + QJL) | O(n) per vector |
-| **BMSSP (SSSP)** | arXiv 2504.17033, Duan et al. | Neural mesh message routing | O(m log<sup>2/3</sup> n) |
-| **Shannon Entropy** | Claude Shannon, 1948 | Cross-project insight relevance scoring | O(n) |
-| **Bayesian Inference** | Thomas Bayes, 1763 | Confidence updating, meta-learning | O(1) per update |
-| **Cosine Similarity** | Vector space model | Knowledge deduplication | O(d) per pair |
-| **PageRank** | Brin & Page, 1998 | Code entity impact analysis | O(V + E) per iteration |
-| **Tarjan's SCC** | Robert Tarjan, 1972 | Dependency cycle detection | O(V + E) |
-| **Winnowing** | Schleimer et al., 2003 | Code duplicate fingerprinting | O(n) |
-| **Box-Muller** | Box & Muller, 1958 | Gaussian mutation in genetic algorithm | O(1) per sample |
-| **Ant Colony (ACO)** | Dorigo, 1992 | File priority pheromone system | O(n x m) |
-| **Tournament Selection** | Goldberg, 1989 | Genetic rule selection (k=5) | O(k) per selection |
-
-### TurboQuant Pipeline Detail
+# Sharing
+shadow-brain exchange export --name "react-expert-v1" --tags react,auth
+shadow-brain exchange import ~/brain-packs/react-expert-v1.json
 
-```
-Input Vector (64-dim, float64)
-     |
-     v
-+-------------+
-|  PolarQuant  |-- Cartesian -> Polar coordinates
-|  2 bits/dim  |-- Quantize angles to 4 levels (2 bits each)
-+------+-------+   Pack into Uint8Array
-       |
-       v
-+-------------+
-|  QJL Residual|-- Random rotation (Hadamard-like)
-|  1 bit/dim   |-- Sign extraction (1 bit per dim)
-+------+-------+   Pack into Uint8Array
-       |
-       v
-  TurboVector { polar: Uint8Array, qjl: Uint8Array, dim: number, radius: number }
-  = 3 bits/dim total = 6x compression from float64
-  = ZERO FORGETTING -- compressed knowledge stays searchable forever
+# Full list
+shadow-brain --help
 ```
 
 ---
 
-## Features
-
-<table>
-<tr>
-<td width="20%">
-
-### Hyper-Cognitive (v5.1.1)
-- Built-in LSP Server
-- Custom LLM Fine-Tuning
-- Smart Cache (3-tier)
-- Intent Engine (NLP)
-- Code DNA Fingerprinting
-- Temporal Intelligence
-
-</td>
-<td width="20%">
-
-### Zero Config (v5.0.1)
-- Auto-detect project + tools
-- MCP for ALL AI tools
-- Rich web dashboard
-- Natural language queries
-- Plugin system
-- Brain export/import
-- Git hook auto-install
-
-</td>
-<td width="20%">
-
-### Infinite Intelligence (v5)
-- 4-tier hierarchical memory
-- Context-triggered recall
-- Multi-agent consensus
-- Collective cross-project learning
-
-</td>
-<td width="20%">
-
-### Hyper-Intelligence (v4)
-- TurboQuant infinite memory
-- SSSP quantum routing
-- Self-evolving genetic rules
-- Cross-agent protocol (CAIP)
-- Adversarial defense
-- Swarm intelligence (ACO)
-- Knowledge Graph + PageRank
-- Predictive bug forecasting
-
-</td>
-<td width="20%">
-
-### Developer Experience
-- **60+ CLI commands**
-- MCP Server (19 tools)
-- Built-in LSP Server
-- Web dashboard (real-time)
-- Terminal UI (Ink/React)
-- Pre-commit hooks
-- GitHub Actions CI
-- Plugin architecture
-
-</td>
-</tr>
-</table>
+## 🎯 Tweetable Talking Points
 
----
+> *"Shadow Brain is the first open-source brain that works with sub-agents. Claude Task, Cursor Composer, CrewAI, LangGraph, AutoGen — all finally share context. One `npx` command. Zero API keys."*
 
-## Architecture
+> *"Every AI decision Shadow Brain makes is Ed25519-signed. Every cause is traced. Every collision is caught before it happens. Free forever."*
 
-### v5.1.1 Module Map (22 modules)
-
-| Module | File | What It Does | Since |
-|---|---|---|---|
-| **LSP Server** | `brain/lsp-server.ts` | Built-in Language Server Protocol (stdio+TCP) | v5.1.1 |
-| **Fine-Tuning Engine** | `brain/fine-tuning-engine.ts` | Custom LLM training data generation | v5.1.1 |
-| **Smart Cache** | `brain/smart-cache.ts` | Multi-tier caching with predictive prefetch | v5.1.1 |
-| **Intent Engine** | `brain/intent-engine.ts` | Natural language command understanding | v5.1.1 |
-| **Code DNA** | `brain/code-dna.ts` | 9-gene code fingerprinting + similarity | v5.1.1 |
-| **Temporal Intelligence** | `brain/temporal-intelligence.ts` | Velocity tracking, heatmaps, bug prediction | v5.1.1 |
-| **Auto Setup** | `brain/auto-setup.ts` | Zero-config project + tool detection | v5.0.1 |
-| **MCP Server** | `brain/mcp-server.ts` | 19-tool MCP server for all AI tools | v5.0.1 |
-| **Plugin System** | `brain/plugin-system.ts` | Hookable analysis pipeline | v5.0.1 |
-| **Brain Portability** | `brain/brain-portability.ts` | Export/import brain state | v5.0.1 |
-| **Dashboard** | `dashboard/server.ts` | Real-time WebSocket dashboard | v5.0.1 |
-| **Hierarchical Memory** | `brain/hierarchical-memory.ts` | 4-tier infinite memory | v5.0.0 |
-| **Context Recall** | `brain/context-recall.ts` | Associative memory activation | v5.0.0 |
-| **Consensus Engine** | `brain/consensus-engine.ts` | Multi-agent voting + trust | v5.0.0 |
-| **Collective Learning** | `brain/collective-learning.ts` | Cross-project rule sharing | v5.0.0 |
-| **TurboMemory** | `brain/turbo-memory.ts` | 6x compressed infinite memory | v4.0.0 |
-| **SSSP Router** | `brain/sssp-router.ts` | Sub-sorting routing | v4.0.0 |
-| **Self-Evolution** | `brain/self-evolution.ts` | Genetic rule optimization | v4.0.0 |
-| **Cross-Agent** | `brain/cross-agent-protocol.ts` | Multi-agent broadcast | v4.0.0 |
-| **Adversarial** | `brain/adversarial-defense.ts` | Hallucination detection | v4.0.0 |
-| **Swarm** | `brain/swarm-intelligence.ts` | File priority pheromones | v4.0.0 |
-| **Knowledge Graph** | `brain/knowledge-graph.ts` | PageRank impact analysis | v4.0.0 |
-| **Predictive** | `brain/predictive-engine.ts` | Bug risk & debt forecasting | v4.0.0 |
+> *"22 novel features nobody else has. Free. Open source. Local-first. `npx @theihtisham/agent-shadow-brain`."*
 
 ---
 
-## CLI Reference
-
-### Core Commands
-
-| Command | Description |
-|---|---|
-| `shadow-brain start [dir]` | Start real-time watching + dashboard + MCP |
-| `shadow-brain off` | Clean shutdown |
-| `shadow-brain review [dir]` | One-shot code analysis |
-| `shadow-brain health [dir]` | Health score (A-F grading) |
-| `shadow-brain fix [dir]` | Smart fix suggestions |
-| `shadow-brain report [dir]` | HTML/MD/JSON reports |
-| `shadow-brain metrics [dir]` | Code metrics |
-| `shadow-brain scan [dir]` | Vulnerability scanner |
-| `shadow-brain pr [dir]` | Generate PR description |
-| `shadow-brain commit-msg [dir]` | Generate commit message |
-| `shadow-brain ci [dir]` | GitHub Actions workflow |
-| `shadow-brain hook [dir]` | Pre-commit hook |
-| `shadow-brain dash [dir]` | Web dashboard |
-| `shadow-brain mcp` | MCP server mode |
-| `shadow-brain inject <msg>` | Inject into agent memory |
-| `shadow-brain status` | Current configuration |
-| `shadow-brain setup` | Interactive setup wizard |
-| `shadow-brain doctor` | Health check & diagnostics |
-| `shadow-brain ask <question>` | Natural language brain query |
-
-### v5.1.1 Hyper-Cognitive Commands (NEW)
-
-| Command | Description |
-|---|---|
-| `shadow-brain lsp [--stdio\|--tcp PORT]` | Start built-in LSP server |
-| `shadow-brain fine-tune status` | Fine-tuning training data stats |
-| `shadow-brain fine-tune generate [dir]` | Generate training pairs from code |
-| `shadow-brain fine-tune export [path]` | Export JSONL dataset for fine-tuning |
-| `shadow-brain cache stats` | Smart cache hit rate, tier sizes, memory |
-| `shadow-brain cache clear` | Clear all cache tiers |
-| `shadow-brain intent <text>` | Parse natural language intent |
-| `shadow-brain dna analyze [dir]` | Generate Code DNA profiles |
-| `shadow-brain dna compare <f1> <f2>` | Compare two file fingerprints |
-| `shadow-brain dna similar <file>` | Find structurally similar files |
-| `shadow-brain temporal stats` | Velocity, anomalies, predictions |
-| `shadow-brain temporal hot` | Top 10 hottest files by churn |
-| `shadow-brain temporal predict` | Bug risk predictions |
-| `shadow-brain temporal timeline` | Recent event timeline |
-
-### v5.0.1 Commands
-
-| Command | Description |
-|---|---|
-| `shadow-brain off` | Clean shutdown of all brain processes |
-| `shadow-brain ask <question>` | Natural language query to the brain |
-| `shadow-brain export [-o dir]` | Export full brain state to JSON |
-| `shadow-brain import <file> [--merge]` | Import brain state |
-| `shadow-brain plugin list` | List installed plugins |
-| `shadow-brain plugin create <name>` | Create plugin from template |
-| `shadow-brain plugin stats` | Plugin system statistics |
+## 🛠️ For Contributors
 
-### v5.0.0 Infinite Intelligence Commands
+```bash
+git clone https://github.com/theihtisham/agent-shadow-brain.git
+cd agent-shadow-brain
+npm install
+npm run build
+npm test                # 148/148 tests
+npm run dev             # ts-node dev mode
 
-| Command | Description |
-|---|---|
-| `shadow-brain memory stats` | 4-tier hierarchical memory stats |
-| `shadow-brain memory store <text>` | Store knowledge at raw tier |
-| `shadow-brain memory search <query>` | Cross-tier semantic search |
-| `shadow-brain recall . --file <f>` | Context-triggered associative recall |
-| `shadow-brain consensus status` | Multi-agent consensus stats |
-| `shadow-brain consensus propose <text> <cat> <conf>` | Submit proposal for voting |
-| `shadow-brain consensus vote <id> <vote> <conf> <reason>` | Vote on a proposal |
-| `shadow-brain consensus results` | All resolved proposals |
-| `shadow-brain collective status` | Cross-project rule stats |
-| `shadow-brain collective propose <text> <cat>` | Propose a collective rule |
-| `shadow-brain collective search <cat>` | Search collective rules by category |
-| `shadow-brain v5 [dir]` | Run ALL v5.0.0 analyses |
-
-### v4.0.0 Hyper-Intelligence Commands
-
-| Command | Description |
-|---|---|
-| `shadow-brain turbo stats` | TurboQuant infinite memory stats |
-| `shadow-brain turbo search <q>` | Semantic search compressed memory |
-| `shadow-brain route status` | SSSP routing status |
-| `shadow-brain route find <from> <to>` | Shortest path query |
-| `shadow-brain caip status` | Cross-agent protocol status |
-| `shadow-brain caip broadcast <msg>` | Broadcast to all agents |
-| `shadow-brain evolve status` | Genetic algorithm generation stats |
-| `shadow-brain evolve run` | Trigger evolution cycle |
-| `shadow-brain evolve best-rules [cat]` | Top evolved rules by category |
-| `shadow-brain predict bugs [dir]` | Bug risk prediction |
-| `shadow-brain graph build [dir]` | Build knowledge graph + PageRank |
-| `shadow-brain swarm status` | Swarm convergence + priorities |
-| `shadow-brain swarm priorities` | File hotspot ranking |
-| `shadow-brain defense status` | Adversarial defense statistics |
-| `shadow-brain defense scan <text>` | Scan text for hallucination patterns |
-| `shadow-brain v4 [dir]` | Run ALL v4.0.0 analyses |
+# Rebuild the explainer video
+node tools/record-motion-explainer.mjs
 
----
+# Capture fresh dashboard screenshots
+node tools/capture-screenshots.mjs
 
-## Programmatic API
-
-```typescript
-import {
-  Orchestrator,
-  // v5.1.1 — Hyper-Cognitive modules
-  LSPServer,
-  FineTuningEngine,
-  SmartCache,
-  IntentEngine,
-  CodeDNA,
-  TemporalIntelligence,
-  // v5.0.1 — Zero-Config modules
-  AutoSetup,
-  PluginSystem,
-  BrainPortability,
-  // v5.0.0 — Infinite Intelligence modules
-  HierarchicalMemory,
-  ContextRecall,
-  ConsensusEngine,
-  CollectiveLearning,
-  // v4.0.0 — Hyper-Intelligence modules
-  TurboMemory,
-  SSSPRouter,
-  SelfEvolution,
-  CrossAgentProtocol,
-  AdversarialDefense,
-  SwarmIntelligence,
-  KnowledgeGraph,
-  PredictiveEngine,
-  NeuralMesh,
-} from '@theihtisham/agent-shadow-brain';
-
-// v5.1.1 — Built-in LSP server
-const lsp = new LSPServer('./my-project');
-lsp.start({ mode: 'tcp', port: 2087 }); // or { mode: 'stdio' }
-
-// v5.1.1 — Smart Cache
-const cache = new SmartCache({ maxHotEntries: 200, enablePrefetch: true });
-cache.set('analysis:auth', analysisResult, { ttl: 300_000, tags: ['security'] });
-const cached = cache.get('analysis:auth');
-
-// v5.1.1 — Temporal Intelligence
-const temporal = new TemporalIntelligence('./my-project');
-temporal.recordCommit(['src/auth.ts'], 'fix: JWT rotation');
-const velocity = temporal.getVelocity(); // { daily, weekly, trend: 'accelerating' }
-const bugRisks = temporal.predictBugs(10);
-
-// v5.1.1 — Code DNA
-const dna = new CodeDNA('./my-project');
-const profile = await dna.analyze('src/auth.ts');
-const similar = await dna.findSimilar('src/auth.ts', 5);
-
-// v5.0.1 — Zero-config auto-setup
-const setup = new AutoSetup('./my-project');
-const config = await setup.detect();
-// → { projectType: 'fullstack', languages: ['typescript','python'], frameworks: ['next.js'], aiTools: [...] }
-await setup.installMCPForTools(['Claude Code', 'Cursor']);
-await setup.installGitHooks();
-
-// Create the brain
-const brain = new Orchestrator({
-  provider: 'anthropic',
-  projectDir: './my-project',
-  agents: ['claude-code', 'cursor', 'cline'],
-  watchMode: true,
-  autoInject: true,
-  brainPersonality: 'balanced',
-});
-
-// v5.0.1 — Plugin system
-const plugins = new PluginSystem('./my-project');
-await plugins.loadAll();
-await plugins.preAnalysis({ files: ['src/auth.ts'], projectDir: './my-project' });
-
-// v5.0.1 — Brain portability
-const porter = new BrainPortability('./my-project');
-const { filePath, sizeBytes, checksum } = await porter.exportBrain();
-
-// v5.0.0 — Infinite Intelligence
-const hmem = new HierarchicalMemory();
-await hmem.store('JWT rotation pattern: rotate every 24h with refresh tokens', 'security', 0.9);
-const results = hmem.search('jwt');
-
-const recall = new ContextRecall(hmem);
-const activated = recall.recall({
-  currentFile: 'src/auth/login.ts',
-  currentCategory: 'security',
-  recentEdits: ['src/auth/login.ts', 'src/middleware/auth.ts'],
-  projectType: 'node',
-  keywords: ['jwt', 'authentication', 'session'],
-});
-
-const consensus = new ConsensusEngine('my-agent');
-const proposalId = consensus.propose('Use bcrypt cost factor 12', 'security', 0.95);
-
-// Start everything
-await brain.start();
+# Seed the brain with demo data
+node tools/seed-brain.mjs
 ```
 
----
-
-## Health Score System
-
-| Dimension | Weight | Checks |
-|---|---|---|
-| Security | 25% | Vulnerabilities, secrets, exposed keys |
-| Quality | 25% | Code smells, anti-patterns, complexity |
-| Performance | 15% | N+1 queries, memory leaks, blocking ops |
-| Architecture | 15% | Coupling, cohesion, dependencies |
-| Maintainability | 10% | Duplication, file sizes, comments |
-| Test Coverage | 10% | Test presence, assertion quality |
+Issues, PRs, discussions welcome. See [CONTRIBUTING.md](CONTRIBUTING.md).
 
 ---
 
-## Version History
-
-> **Full changelogs, migration guides, and detailed release notes:** [`docs/versions/`](docs/versions/)
->
-> **Compact changelog:** [`CHANGELOG.md`](CHANGELOG.md)
+## 📚 Documentation
 
-| Version | Codename | Date | Highlights |
-|---|---|---|---|
-| **[v5.1.1](docs/versions/v5.1.1.md)** | Hyper-Cognitive | 2026-04-18 | LSP Server, Fine-Tuning Engine, Smart Cache, Intent Engine, Code DNA, Temporal Intelligence |
-| **[v5.0.1](docs/versions/v5.0.1.md)** | Zero-Config | 2026-04-15 | Auto-Setup, MCP Server (19 tools), Dashboard, NLP Queries, Plugin System |
-| **[v5.0.0](docs/versions/v5.0.0.md)** | Infinite Intelligence | 2026-04-12 | Hierarchical Memory, Associative Recall, Multi-Agent Consensus, Collective Learning |
-| **[v4.0.0](docs/versions/v4.0.0.md)** | Hyper-Intelligence | 2026-04-08 | TurboQuant, SSSP Routing, Self-Evolution, CAIP, Adversarial Defense, Swarm, Knowledge Graph |
-| **[v3.0.0](docs/versions/v3.0.0.md)** | Hyper-Intelligence | 2026-04-01 | Cognitive Load Analysis, Security Audit Engine, Influence Map |
-| **[v2.1.0](docs/versions/v2.1.0.md)** | Quantum Neural Mesh | 2026-03-25 | Shannon Entropy, Cosine Similarity, Bayesian Confidence |
-| **[v2.0.0](docs/versions/v2.0.0.md)** | Super-Intelligence | 2026-03-18 | Semantic Analyzer, Dependency Graph, Code Similarity, MCP Server |
-| **[v1.0.0](docs/versions/v1.0.0.md)** | Foundation | 2026-02-28 | 7 Agent Adapters, Health Scoring, Smart Fixes, Vulnerability Scanning |
+- **[CHANGELOG.md](CHANGELOG.md)** — release notes
+- **[docs/versions/v6.0.0.md](docs/versions/v6.0.0.md)** — v6 release details
+- **[docs/launch/HIVEMIND_VIDEO.md](docs/launch/HIVEMIND_VIDEO.md)** — video production pipeline
+- **[docs/launch/screenshots/](docs/launch/screenshots/)** — all 29 dashboard screenshots
+- **[SECURITY.md](SECURITY.md)** — security policy
+- **[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)** — community guidelines
 
 ---
 
-## Supported Agents & Tools
+## 💬 Community
 
-| Agent | Status | MCP Support | Injection Target |
-|---|---|---|---|
-| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | Full Support | Auto-install | `CLAUDE.md`, `.claude/` |
-| [Cursor](https://cursor.sh/) | Full Support | Auto-install | `.cursor/mcp.json` |
-| [Kilo Code](https://kilocode.ai/) | Full Support | Auto-install | `.kilocode/rules.md` |
-| [Cline](https://github.com/cline/cline) | Full Support | Auto-install | `.clinerules` |
-| [OpenCode](https://github.com/opencode-ai/opencode) | Full Support | Yes | `AGENT.md` |
-| [Codex](https://github.com/openai/codex) | Full Support | Yes | `AGENTS.md` |
-| [Roo Code](https://roocode.com/) | Full Support | Yes | `.roo/rules.md` |
-| [Aider](https://aider.chat/) | Full Support | Yes | `.aider.conf.yml` |
-| [Windsurf](https://codeium.com/windsurf) | Detection | Yes | `.windsurfrules` |
-
----
+- **[GitHub Issues](https://github.com/theihtisham/agent-shadow-brain/issues)** — bug reports, feature requests
+- **[GitHub Discussions](https://github.com/theihtisham/agent-shadow-brain/discussions)** — questions, ideas, show-and-tell
+- **[GitHub Releases](https://github.com/theihtisham/agent-shadow-brain/releases)** — download the explainer MP4 + release assets
 
-## Development
-
-```bash
-git clone https://github.com/theihtisham/agent-shadow-brain.git
-cd agent-shadow-brain
-npm install
-npm run build
-npm test
-```
+**If Shadow Brain makes your AI agents smarter, star the repo ⭐**
 
 ---
 
-## Roadmap
-
-- [x] ~~MCP Server, multi-project, team mode~~ (v2.0)
-- [x] ~~Cross-session neural mesh~~ (v2.1)
-- [x] ~~TurboQuant infinite memory~~ (v4.0)
-- [x] ~~SSSP quantum routing~~ (v4.0)
-- [x] ~~Self-evolving rules~~ (v4.0)
-- [x] ~~Cross-agent protocol~~ (v4.0)
-- [x] ~~Adversarial hallucination defense~~ (v4.0)
-- [x] ~~Hierarchical memory compression~~ (v5.0)
-- [x] ~~Context-triggered associative recall~~ (v5.0)
-- [x] ~~Multi-agent consensus protocol~~ (v5.0)
-- [x] ~~Collective cross-project learning~~ (v5.0)
-- [x] ~~Zero-config auto-setup~~ (v5.0.1)
-- [x] ~~MCP server for Cursor + all tools~~ (v5.0.1)
-- [x] ~~Rich web dashboard with real-time WebSocket~~ (v5.0.1)
-- [x] ~~Plugin system + brain export/import~~ (v5.0.1)
-- [x] ~~Custom LLM fine-tuning~~ (v5.1.1)
-- [x] ~~Language server (LSP)~~ (v5.1.1)
-- [x] ~~Web dashboard v3~~ (v5.1.1)
-- [ ] **Visual Studio Code integration** — inline insight overlays
-- [ ] **Multi-model orchestration** — route insights through multiple LLMs
-- [ ] **Real-time collaboration** — team brain with live cursors
+## ⭐ Stargazers Over Time
 
----
-
-## License
-
-MIT License — see [LICENSE](LICENSE) for details.
+[![Star History Chart](https://api.star-history.com/svg?repos=theihtisham/agent-shadow-brain&type=Date)](https://star-history.com/#theihtisham/agent-shadow-brain&Date)
 
 ---
 
-## Author
+## 📜 License
 
-**theihtisham**
+**MIT** — see [LICENSE](LICENSE).
 
-[![GitHub](https://img.shields.io/badge/GitHub-theihtisham-181717?style=flat-square&logo=github)](https://github.com/theihtisham)
-[![npm](https://img.shields.io/badge/npm-@theihtisham-CB3837?style=flat-square&logo=npm)](https://www.npmjs.com/~theihtisham)
+Free to use, modify, fork, commercialize. Local-first by default. Works offline, in air-gapped environments, in privacy-constrained enterprises. No telemetry. No phone-home. No trial expiration.
 
 ---
 
 <div align="center">
 
-### If Shadow Brain makes your AI agents smarter, give it a star
+### Built by [@theihtisham](https://github.com/theihtisham)
 
-[![Star History Chart](https://api.star-history.com/svg?repos=theihtisham/agent-shadow-brain&type=Date)](https://star-history.com/#theihtisham/agent-shadow-brain&Date)
+<a href="https://github.com/theihtisham"><img src="https://img.shields.io/badge/GitHub-theihtisham-181717?style=for-the-badge&logo=github" alt="GitHub"></a>
+<a href="https://www.npmjs.com/~theihtisham"><img src="https://img.shields.io/badge/npm-@theihtisham-CB3837?style=for-the-badge&logo=npm" alt="npm"></a>
+
+### The Hive Mind for every AI coding agent on your machine.
 
-**Built with brains by [theihtisham](https://github.com/theihtisham)**
+**`npx @theihtisham/agent-shadow-brain@latest attach-all`**
 
-**Topics:** `ai` `artificial-intelligence` `llm` `claude-code` `cursor` `cline` `kilo-code` `codex` `roo-code` `aider` `opencode` `windsurf` `code-review` `static-analysis` `developer-tools` `npm-package` `typescript` `ollama` `openai` `anthropic` `code-quality` `security-scanner` `health-score` `smart-fix` `vulnerability-scanner` `pattern-learning` `agent-tools` `ai-agent` `code-metrics` `pre-commit-hook` `github-actions` `developer-productivity` `neural-mesh` `quantum-computing` `shannon-entropy` `bayesian-inference` `mcp-server` `model-context-protocol` `semantic-analysis` `dependency-graph` `turboquant` `sssp-algorithm` `genetic-algorithm` `swarm-intelligence` `pagerank` `knowledge-graph` `hallucination-detection` `cross-agent` `self-evolving` `predictive-engine` `ant-colony` `infinite-memory` `vector-compression` `iclr-2026` `arxiv` `super-intelligence` `hyper-intelligence` `autonomous-agents` `ai-engineering` `agentic-coding` `vibe-coding` `cursor-ai` `zero-config` `auto-setup` `dashboard` `plugin-system` `brain-export` `natural-language` `real-time` `websocket` `team-collaboration` `ci-cd` `open-source` `trending` `hierarchical-memory` `context-recall` `consensus-engine` `collective-learning` `infinite-intelligence` `coding-assistant` `lsp-server` `language-server-protocol` `fine-tuning` `smart-cache` `intent-engine` `code-dna` `temporal-intelligence` `hyper-cognitive`
+<sub>Topics: `ai` · `llm` · `claude-code` · `cursor` · `cline` · `codex` · `copilot` · `hive-mind` · `sub-agent` · `sabb` · `causal-chains` · `dream-engine` · `reputation-ledger` · `swarm-debate` · `pre-mortem` · `branch-brain` · `attention-heatmap` · `token-economy` · `forgetting-curve` · `formal-verification` · `calibration-monitor` · `air-gap` · `e2e-encryption` · `hallucination-quarantine` · `voice-mode` · `brain-garden` · `pr-review` · `team-brain` · `brain-exchange` · `local-first` · `ollama` · `anthropic` · `openai` · `openrouter` · `gemini` · `deepseek` · `moonshot` · `mistral` · `mcp-server` · `model-context-protocol` · `lsp-server` · `cross-agent` · `multi-agent` · `autonomous-agents` · `agentic-ai` · `vibe-coding` · `cursor-ai` · `developer-tools` · `developer-productivity` · `coding-assistant` · `ai-coding` · `code-review` · `static-analysis` · `knowledge-graph` · `semantic-search` · `vector-embeddings` · `prompt-caching` · `json-mode` · `chat-with-memory` · `ed25519` · `chacha20-poly1305` · `sssp` · `turboquant` · `iclr-2026` · `arxiv` · `zero-config` · `typescript` · `open-source` · `free-forever` · `mit-license`</sub>
 
 </div>