MemoryAI

Kernprinzip

MemoryAI bietet praktisch unbegrenzten persistenten Speicher, indem es große Mengen dauerhaften Wissens lokal speichert und nur eine begrenzte, hochrelevante Teilmenge für den LLM-Kontext abruft.

Traditionelle KI-Workflows werfen rohe Konversationsprotokolle (80.000+ Tokens) in das Kontextfenster, was hohe API-Kosten, Aufmerksamkeitsverluste und Prompt-Drift verursacht. MemoryAI fungiert als autonome kognitive Schicht, die Konversationsereignisse abfängt, dauerhafte Entscheidungen extrahiert und den Kontext dynamisch unter strengen Token-Budgets schichtet:

User Request / IDE Event
          ↓
  Event Normalizer (session.*, task.*, file.*, decision.*)
          ↓
  Policy Evaluator (ignore, observe, capture, review, immediate)
          ↓
  Memory Orchestrator (Two-Phase Writes & Privacy Redaction)
          ↓
  SQLite Engine (FTS5 BM25 + Dense Vectors + Version Ledger)
          ↓
  Hybrid Retrieval & Multi-Factor Reranking
          ↓
  Progressive Disclosure Context (Level 1 → Level 2 → Level 3 → Level 4)
          ↓
  Strict Token Budget (300 / 500 / 1,000 / 2,000 tokens)
          ↓
       LLM

Related MCP server: ContextKeep

Wichtigste Highlights

• Null manueller Aufwand: MemoryAI erkennt die Projektidentität automatisch über Git-/Paketmanifeste, ruft relevanten Kontext ab, erfasst dauerhafte Entscheidungen und generiert Session-Übergaben.

• Universelle Cross-Client-Portabilität: Normalisierte Konversationsereignisse (MemoryAIConversationEvent) verbinden nahtlos Claude Code, Cursor, Codex, Gemini CLI, ChatGPT und MCP-Clients.

• MCP 2026 – zustandsloser Kern & Tasks-Erweiterung: Vollständig kompatibel mit der MCP-2026-Spezifikation mit zustandsloser Ausführung, expliziten Anwendungs-Handles (memoryContextId, taskId, handoffId, snapshotId) und Hintergrund-Task-Verwaltung.

• 4-stufige Progressive Offenlegung: Der Kontext baut sich progressiv auf – von Stufe 1 (150-Token-Zusammenfassung) und Stufe 2 (kanonische Fakten) über Stufe 3 (Belege) bis zu Stufe 4 (Konversationsspuren).

• Memory-Snapshots & historische Diffs: Erstellen Sie Point-in-Time-Projektsnapshots (memoryai snapshot create) und prüfen Sie historische Diffs (memoryai diff) über Architekturentscheidungen hinweg.

• Project-Memory-Health-Diagnose: Echtzeit-Health-Score von 0–100, der Aktualität, Konfidenz, Konfliktrate, Herkunft und Übergabevollständigkeit bewertet (memoryai health).

• Datenschutz & zweiphasiges Schreiben: Automatische Erkennung und Schwärzung von RSA-Privatekeys, AWS-Zugriffsschlüsseln, JWT-Tokens, Verbindungszeichenfolgen und personenbezogenen Daten (PII) vor der dauerhaften Speicherung.

• Zero-Downtime-Embedding-Migrationen: Atomare Schattentabellen-Vektorindizierung mit sicheren Rollback-Funktionen (memoryai embeddings migrate).

• Portables .memorypack-Format: Export, Sicherung und Wiederherstellung persistenter Memories mit SHA-256-Integritätsprüfungen.

Schnellstart

1. Installation

# Clone the repository
git clone https://github.com/memoryai/memoryai.git
cd memoryai

# Install dependencies and build monorepo packages
npm install
npm run build

2. Führen Sie den 14-Punkte-Diagnose-Doctor aus

# Verify database, vector indexes, encryption, SSRF protection, and MCP tools
node cli/dist/bin.js doctor

3. Grundlegende Verwendung (Speichern & Abrufen)

# Store a durable architectural decision
node cli/dist/bin.js remember "Architectural decision: Standardized on Fastify v4 and SQLite with WAL mode" --type decision --importance 0.95

# Recall bounded context with a 500 token budget
node cli/dist/bin.js recall "Fastify and SQLite database decisions" --max-tokens 500

Architektur

                         MemoryAI Platform
                                │
       ┌────────────────────────┼────────────────────────┐
       ▼                        ▼                        ▼
   AI Clients             MCP 2026 Layer           Local SDK & CLI
 (Claude, Cursor,       (Stateless HTTP/Stdio,    (Node, Shell, API)
  Gemini, Codex, GPT)     Explicit Handles)
       │                        │                        │
       └────────────────────────┼────────────────────────┘
                                ▼
                         Event Normalizer
               (session.*, task.*, file.*, memory.*)
                                │
                                ▼
                       Event Policy Engine
            (ignore, observe, capture, review, immediate)
                                │
                                ▼
                       Memory Orchestrator
       ┌────────────────────────┼────────────────────────┐
       ▼                        ▼                        ▼
Memory Brain &           Memory Job & Tasks       Progressive Context
Two-Phase Write Engine   (Async Long-Running)     (Level 1 - 4 Layers)
       │                        │                        │
       ▼                        ▼                        ▼
Privacy Classifier &     Integrity Checker &      Semantic Cache &
Selective Encryption     Health Monitor (0-100)   Model Router
       │                        │                        │
       └────────────────────────┼────────────────────────┘
                                ▼
                      SQLite Storage Engine
     (Memories, Vectors, Versions, Snapshots, Tasks, Events, Sync Queue)

Ereignisgesteuertes Memory

MemoryAI reagiert automatisch auf IDE- und Agenten-Lebenszyklusereignisse, ohne dass manuelle Eingriffe erforderlich sind:

# Emit an event to the MemoryAI pipeline
node cli/dist/bin.js remember "Project migrated to Angular 21 with standalone components" --type decision

Progressive Offenlegung des Kontexts

Rufen Sie nur die Informationstiefe ab, die für den aktuellen Prompt erforderlich ist:

• Stufe 1 (Zusammenfassung): Begrenzte 150-Token-Executive-Summary der Ziele und Schlüsselfakten.

• Stufe 2 (Kanonisch): Deduplizierte, hochwichtige Memory-Datensätze, formatiert in sicheren <MEMORY_DATA>-Containern.

• Stufe 3 (Belege): Kanonische Datensätze mit Quellenherkunft, Dateilinks und Zeitstempel-Metadaten.

• Stufe 4 (Konversation): Tiefer Roh-Segment-Trace auf ausdrückliche Anforderung.

# Recall Level 1 summary context
node cli/dist/bin.js recall "OAuth architecture" --max-tokens 300

MCP 2026 & Tasks-Erweiterung

MemoryAI stellt einen vollständig konformen MCP-Server über stdio für Claude Desktop, Claude Code, Cursor, Codex und jeden MCP-Client bereit.

Kern-MCP-Tools (30 aktive Tools):

• memory_auto_context: Automatische Projekterkennung, Absichtsbewertung und begrenzter Memory-Abruf.

• memory_recall: Token-begrenzter hybrider Abruf.

• memory_progressive_recall: Mehrstufige progressive Kontext-Offenlegung.

• memory_remember: Autonome Erfassung dauerhafter Memories.

• task_create, task_get, task_cancel, task_list: Nicht blockierende MCP-2026-Tasks-Erweiterung für Hintergrundaufträge.

• memory_snapshot_create, memory_snapshot_list, memory_snapshot_compare: Point-in-Time-Zustandsverwaltung.

• memory_diff: Vergleich historischer Memory-Versionen.

• memory_health: Project-Health-Score von 0–100 mit diagnostischer Aufschlüsselung.

• memory_review_queue: Inspektion und Überprüfung unter Quarantäne gestellter Memories.

• memory_handoff_create, memory_handoff_get: Session-Kontinuität über mehrere Tage.

• memory_share: Bereichsgebundene Freigabe mit Berechtigungsprüfung.

• memory_explain, memory_explain_capture: Diagnose-Erklärungen für Abruf und Erfassung.

Snapshots & Versionierung

# Create a point-in-time milestone snapshot
node cli/dist/bin.js snapshot create v1.0.0-release "Production release snapshot"

# List project snapshots
node cli/dist/bin.js snapshot list

# Compare two project snapshots
node cli/dist/bin.js snapshot compare snap_abc123 snap_def456

# View historical diff of a memory record
node cli/dist/bin.js diff mem_123 1 2

Health & Diagnose

# Check 0-100 Project Memory Health score and diagnostic breakdown
node cli/dist/bin.js health

# Scan for orphaned vectors, broken provenance, or duplicate hashes
node cli/dist/bin.js verify

# Run automated conservative self-healing repair
node cli/dist/bin.js repair

# Calculate token economics and cloud API cost savings
node cli/dist/bin.js cost

# Run sandbox memory policy simulation
node cli/dist/bin.js simulate balanced

# Disaster recovery mode
node cli/dist/bin.js recovery

Sicherheits- & Datenschutzarchitektur

CLI-Referenz

Tests & Verifizierung

# Run all 89 unit, integration, memory, retrieval, MCP, concurrency, and performance tests
npm test

# Run all 22 OWASP API Top 10 and Privacy Security tests
npm run test:security

# Run combined full test suite
npm run test:all

Lizenz

MIT-Lizenz. Copyright (c) 2026 MemoryAI-Mitwirkende.