MemoryAI

Principio fundamental

MemoryAI ofrece memoria persistente prácticamente ilimitada al almacenar grandes cantidades de conocimiento duradero localmente y recuperar solo un subconjunto acotado y altamente relevante para el contexto del LLM.

Los flujos de trabajo tradicionales de IA vuelcan registros de conversación sin procesar (80,000+ tokens) en la ventana de contexto, lo que provoca altos costes de API, degradación de la atención y desviación del prompt. MemoryAI actúa como una capa cognitiva autónoma que intercepta los eventos de conversación, extrae decisiones duraderas y organiza dinámicamente el contexto bajo estrictos presupuestos de tokens:

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

Aspectos destacados

• Cero sobrecarga manual: MemoryAI detecta automáticamente la identidad del proyecto mediante manifiestos de Git/paquetes, recupera el contexto relevante, captura decisiones duraderas y genera traspasos de sesión.

• Portabilidad universal entre clientes: los eventos de conversación normalizados (MemoryAIConversationEvent) conectan sin problemas Claude Code, Cursor, Codex, Gemini CLI, ChatGPT y clientes MCP.

• Núcleo MCP 2026 sin estado y extensión de tareas: totalmente compatible con la especificación MCP 2026, que ofrece ejecución sin estado, identificadores de aplicación explícitos (memoryContextId, taskId, handoffId, snapshotId) y gestión de tareas en segundo plano.

• Divulgación progresiva en 4 niveles: el contexto se construye progresivamente, desde el Nivel 1 (resumen de 150 tokens) y el Nivel 2 (hechos canónicos) hasta el Nivel 3 (evidencia de respaldo) y el Nivel 4 (trazas de conversación).

• Instantáneas de memoria y diferencias históricas: tome instantáneas puntuales del proyecto (memoryai snapshot create) e inspeccione las diferencias históricas (memoryai diff) entre decisiones arquitectónicas.

• Diagnóstico de salud de la memoria del proyecto: puntuación de salud en tiempo real de 0 a 100 que evalúa frescura, confianza, tasa de conflictos, procedencia e integridad de los traspasos (memoryai health).

• Privacidad y escrituras en dos fases: detección y enmascaramiento automáticos de claves privadas RSA, claves de acceso de AWS, tokens JWT, cadenas de conexión y PII antes del almacenamiento permanente.

• Migraciones de embeddings sin tiempo de inactividad: indexación vectorial atómica en tablas sombra con capacidades seguras de reversión (memoryai embeddings migrate).

• Formato portátil .memorypack: exporte, respalde y restaure memorias persistentes con comprobaciones de integridad SHA-256.

Inicio rápido

1. Instalación

# 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. Ejecute el doctor de diagnóstico de 14 puntos

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

3. Uso básico (Recordar y recuperar)

# 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

Arquitectura

                         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)

Memoria basada en eventos

MemoryAI reacciona automáticamente a los eventos del ciclo de vida del IDE y del agente, en lugar de requerir intervención manual:

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

Contexto de divulgación progresiva

Recupere solo la profundidad de información necesaria para el prompt actual:

• Nivel 1 (Resumen): resumen ejecutivo acotado de 150 tokens con los objetivos y los hechos clave.

• Nivel 2 (Canónico): registros de memoria deduplicados y de alta importancia con formato en contenedores seguros <MEMORY_DATA>.

• Nivel 3 (Evidencia): registros canónicos emparejados con la procedencia de la fuente, enlaces a archivos y metadatos de marca de tiempo.

• Nivel 4 (Conversación): traza profunda de segmentos sin procesar bajo demanda explícita.

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

MCP 2026 y extensión de tareas

MemoryAI proporciona un servidor MCP totalmente compatible a través de stdio para Claude Desktop, Claude Code, Cursor, Codex y cualquier cliente MCP.

Herramientas MCP principales (30 herramientas activas):

• memory_auto_context: detección automática del proyecto, evaluación de la intención y recuperación de memoria acotada.

• memory_recall: recuperación híbrida limitada por tokens.

• memory_progressive_recall: divulgación progresiva del contexto en varios niveles.

• memory_remember: captura autónoma de memoria duradera.

• task_create, task_get, task_cancel, task_list: extensión de tareas MCP 2026 no bloqueante para trabajos en segundo plano.

• memory_snapshot_create, memory_snapshot_list, memory_snapshot_compare: gestión del estado en un momento dado.

• memory_diff: comparación de versiones históricas de memoria.

• memory_health: puntuación de salud del proyecto de 0 a 100 con desglose de diagnóstico.

• memory_review_queue: inspección y revisión de memorias en cuarentena.

• memory_handoff_create, memory_handoff_get: continuidad de sesión durante varios días.

• memory_share: uso compartido con ámbito definido y permisos verificados.

• memory_explain, memory_explain_capture: explicaciones de diagnóstico de recuperación y captura.

Instantáneas y versionado

# 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

Salud y diagnóstico

# 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

Arquitectura de seguridad y privacidad

Referencia de CLI

Pruebas y verificación

# 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

Licencia

Licencia MIT. Copyright (c) 2026 MemoryAI Contributors.