MemoryAI

Основной принцип

MemoryAI обеспечивает практически неограниченную долговременную память, сохраняя большие объёмы долговременных знаний локально и извлекая в контекст LLM только ограниченное, высокорелевантное подмножество.

Традиционные ИИ-процессы сбрасывают необработанные журналы разговоров (80 000+ токенов) в окно контекста, что приводит к высоким затратам на API, деградации внимания и дрейфу промптов. MemoryAI работает как автономный когнитивный слой, который перехватывает события разговора, извлекает долговременные решения и динамически наслаивает контекст в рамках строгих лимитов токенов:

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

Ключевые особенности

• Нулевая ручная работа: MemoryAI автоматически определяет идентичность проекта по манифестам Git/пакетов, извлекает релевантный контекст, фиксирует долговременные решения и формирует передачу сеансов.

• Универсальная переносимость между клиентами: Нормализованные события разговора (MemoryAIConversationEvent) бесшовно связывают Claude Code, Cursor, Codex, Gemini CLI, ChatGPT и MCP-клиентов.

• Ядро MCP 2026 без состояния и расширение Tasks: Полная совместимость со спецификацией MCP 2026, включая выполнение без состояния, явные дескрипторы приложения (memoryContextId, taskId, handoffId, snapshotId) и управление фоновыми задачами.

• 4-уровневое прогрессивное раскрытие: Контекст строится постепенно — от уровня 1 (сводка на 150 токенов) и уровня 2 (канонические факты) до уровня 3 (подтверждающие доказательства) и уровня 4 (следы разговора).

• Снимки памяти и исторические различия: Создавайте снимки проекта на конкретный момент времени (memoryai snapshot create) и просматривайте исторические различия (memoryai diff) в архитектурных решениях.

• Диагностика здоровья памяти проекта: Оценка здоровья в реальном времени от 0 до 100, учитывающая актуальность, уверенность, частоту конфликтов, происхождение и полноту передачи контекста (memoryai health).

• Конфиденциальность и двухфазная запись: Автоматическое обнаружение и маскирование приватных ключей RSA, ключей доступа AWS, JWT-токенов, строк подключения и персональных данных (PII) перед постоянным хранением.

• Миграция эмбеддингов без простоев: Атомарное векторное индексирование в теневых таблицах с возможностью безопасного отката (memoryai embeddings migrate).

• Переносимый формат .memorypack: Экспорт, резервное копирование и восстановление долговременных воспоминаний с проверкой целостности SHA-256.

Быстрый старт

1. Установка

# 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. Запуск диагностики из 14 пунктов

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

3. Базовое использование (Remember и Recall)

# 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

Архитектура

                         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)

Событийно-ориентированная память

MemoryAI автоматически реагирует на события жизненного цикла IDE и агентов, не требуя ручного вмешательства:

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

Контекст прогрессивного раскрытия

Извлекайте только ту глубину информации, которая требуется для текущего промпта:

• Уровень 1 (Сводка): Краткая сводка целей и ключевых фактов объёмом до 150 токенов.

• Уровень 2 (Канонический): Дедуплицированные записи памяти высокой важности, оформленные в безопасных контейнерах <MEMORY_DATA>.

• Уровень 3 (Доказательства): Канонические записи вместе с происхождением источника, ссылками на файлы и метаданными времени.

• Уровень 4 (Разговор): Глубокая трассировка необработанных сегментов по явному запросу.

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

MCP 2026 и расширение Tasks

MemoryAI предоставляет полностью совместимый MCP-сервер через stdio для Claude Desktop, Claude Code, Cursor, Codex и любого MCP-клиента.

Основные инструменты MCP (30 активных инструментов):

• memory_auto_context: Автоматическое определение проекта, оценка намерений и ограниченное извлечение из памяти.

• memory_recall: Гибридное извлечение с ограничением по токенам.

• memory_progressive_recall: Многоуровневое прогрессивное раскрытие контекста.

• memory_remember: Автономный захват долговременных воспоминаний.

• task_create, task_get, task_cancel, task_list: Неблокирующее расширение Tasks стандарта MCP 2026 для фоновых задач.

• memory_snapshot_create, memory_snapshot_list, memory_snapshot_compare: Управление состоянием на конкретный момент времени.

• memory_diff: Сравнение исторических версий записи памяти.

• memory_health: Оценка здоровья проекта от 0 до 100.

• memory_review_queue: Проверка воспоминаний, помещённых в карантин.

• memory_handoff_create, memory_handoff_get: Непрерывность сеансов на протяжении нескольких дней.

• memory_share: Предоставление доступа с ограниченной областью и проверкой разрешений.

• memory_explain, memory_explain_capture: Диагностические пояснения для извлечения и захвата.

Снимки и версионирование

# 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

Здоровье и диагностика

# 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

Архитектура безопасности и конфиденциальности

Справочник по CLI

Тестирование и проверка

# 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

Лицензия

Лицензия MIT. Copyright (c) 2026 MemoryAI Contributors.