🧠 MNEMOSYNTH — AI Memory for VS Code

Persistent, verified, hallucination-resistant memory for AI coding assistants. 3D knowledge graph · Dream consolidation · Contradiction detection · A2A protocol · Causal chains · Sentiment analysis · Telemetry

✨ What's New in v0.2.0

🤝 A2A Protocol Panel — Agent-to-Agent memory sharing dashboard
🔗 Causal Chains Panel — Decision → Reason → Outcome DAG visualizer
📊 Telemetry Dashboard — OpenTelemetry metrics & traced operations
🔌 Framework Adapters — CrewAI, LangChain, AutoGen, PydanticAI, OpenAI Agents
💜 Sentiment Analysis — Emotion scoring with visual meters
🛡️ Immune System — Prompt injection quarantine status

🚀 Quick Start

1. Install the Extension

code --install-extension Vasudev-Jaiswal.mnemosynth

Or search "MNEMOSYNTH" in the VS Code Extensions panel.

2. Install the Python Package

pip install mnemosynth
# or with ML + all features:
pip install "mnemosynth[ml,adapters,production]"

3. Start Using

Click the 🧠 brain icon in the Activity Bar → Quick Actions panel is ready.

📦 Features

Memory Management

Feature	Description	Shortcut
Add Memory	Store any text as a memory	Sidebar button
Search Memory	Semantic search across all memories	`Ctrl+Shift+M`
Remember Selection	Store highlighted code/text	`Ctrl+Shift+R`
Auto-Remember	Automatically capture file saves & `@memory` tags	Toggle in sidebar

Visualization

Feature	Description	Shortcut
3D Knowledge Graph	Force-directed graph with 3 themes (Cosmic/Neon/Minimal)	`Ctrl+Shift+G`
Timeline View	Chronological memory timeline	Sidebar button
Stats Dashboard	Memory type distribution + status breakdown	Sidebar button
Contradiction Panel	View & resolve conflicting memories	Sidebar button

Phase 4-7 Features (New in v0.2.0)

Feature	Description	Shortcut
A2A Protocol	Agent registration, memory sharing, heartbeats	`Ctrl+Shift+A`
Causal Chains	Decision → Reason → Outcome DAG browser	Sidebar button
Telemetry Dashboard	OpenTelemetry metrics, p99 latencies, counters	`Ctrl+Shift+T`
Framework Adapters	CrewAI, LangChain, AutoGen, PydanticAI, OpenAI	Sidebar button
Sentiment Analysis	Emotion scoring with positive/neutral/negative meters	Sidebar button
Immune System	Prompt injection detection & quarantine status	Sidebar button

IDE Integrations

Feature	Description
Hover Provider	Shows relevant memories inline when hovering
Code Lens	"🧠 Search memories" above classes/functions
Right-Click Menu	"Remember This" + "Search Memory" in context menu
Status Bar	Live memory count in bottom status bar

🎨 3D Graph Themes

Three premium dark themes for the Knowledge Graph:

🌌 Cosmic — Deep purple with nebula particle effects
⚡ Neon — Cyberpunk glow with electric blue particles
🔲 Minimal — Clean monochrome grid

All nodes are color-coded by memory type (🔵 Episodic, 🟢 Semantic, 🟠 Procedural), with node size reflecting confidence score.

⚙️ Configuration

Setting	Default	Description
`mnemosynth.pythonPath`	`python3`	Python interpreter path
`mnemosynth.dataDir`	`~/.mnemosynth`	Custom data directory
`mnemosynth.autoStart`	`true`	Auto-start MCP server
`mnemosynth.statusBar`	`true`	Show status bar item
`mnemosynth.graphTheme`	`cosmic`	3D graph theme
`mnemosynth.autoRemember`	`false`	Auto-remember on save
`mnemosynth.codeLens`	`true`	Show CodeLens links
`mnemosynth.hoverMemories`	`true`	Show hover memory tooltips

🏗️ Architecture

VS Code Extension (TypeScript)
       │
       ├── Sidebar: Memory Tree + Quick Actions + Stats
       ├── Webview Panels: Graph, Timeline, Contradictions
       ├── Webview Panels: A2A, Causal Chains, Telemetry (NEW)
       ├── IDE: Hover Provider, CodeLens, Auto-Remember
       │
       └── MCP Client ──→ mnemosynth Python Backend
                              │
                              ├── Three-Tier Memory (Episodic/Semantic/Procedural)
                              ├── Anti-Hallucination Engine
                              ├── Sentiment & Emotion Scoring
                              ├── Causal Chain Engine
                              ├── A2A Protocol
                              ├── OpenTelemetry Tracing
                              └── Production DB Backends

📋 All 23 Commands

Command	Title
`mnemosynth.searchMemory`	Search Memory
`mnemosynth.rememberThis`	Remember This
`mnemosynth.runDream`	Run Dream Mode
`mnemosynth.showStats`	Show Stats
`mnemosynth.openGraph`	Open Memory Graph
`mnemosynth.refreshMemories`	Refresh
`mnemosynth.deleteMemory`	Delete Memory
`mnemosynth.inspectProvenance`	Inspect Provenance
`mnemosynth.setup`	Setup & Install
`mnemosynth.openTimeline`	Open Timeline
`mnemosynth.showContradictions`	Show Contradictions
`mnemosynth.exportMemories`	Export Memories
`mnemosynth.importMemories`	Import Memories
`mnemosynth.healthCheck`	Health Check
`mnemosynth.toggleAutoRemember`	Toggle Auto-Remember
`mnemosynth.toggleCodeLens`	Toggle Code Lens
`mnemosynth.setPythonPath`	Set Python Path
`mnemosynth.addMemory`	Add Memory
`mnemosynth.openA2A`	Open A2A Protocol
`mnemosynth.openCausalChains`	Open Causal Chains
`mnemosynth.openTelemetry`	Open Telemetry Dashboard
`mnemosynth.showAdapters`	Show Framework Adapters
`mnemosynth.showSentiment`	Show Sentiment Analysis

🔗 Links

Resource	Link
PyPI Package	pypi.org/project/mnemosynth
VS Code Marketplace	marketplace.visualstudio.com
GitHub Repository	github.com/vasudevjaiswal/mnemosynth
Documentation	mnemosynth.tech

🧪 Development

cd mnemosynth-extension
npm install
npm run compile
# Press F5 in VS Code to launch Extension Development Host

📄 License

Named after Mnemosyne — the Greek goddess of memory and mother of the nine Muses.