engram

Русский

English
Українська

Русский

English
Українська

Тема

engramДолговременная память для AI-агентов

Решения, грабли, принципы и заметки о сессиях хранятся в вашем репозитории и доступны Claude Code, Cursor и любому MCP-клиенту.

Быстрый старт
Что такое engram?
GitHub
engram

Помнит причины

Решение записывается вместе с аргументами, отвергнутые варианты тоже. Когда спрашивают, почему не взяли Redis, ответ берётся из записи.

Записи связаны между собой

Типизированные рёбра, такие как supersedes, rejected_because и caused_by, позволяют агенту пройти от решения к проблеме, которая его вызвала.

Сверяет план со старыми ошибками

engram_check сравнивает то, что агент собирается сделать, с записанными граблями и отвергнутыми подходами ещё до написания кода.

Брифинг укладывается в бюджет токенов

Важные записи приходят целиком, следующие урезаются до одной строки, остальное достаётся через recall.

Любой MCP-клиент

Это обычный MCP-сервер. init настраивает Claude Code, Cursor и AGENTS.md, другим клиентам подходит та же запись сервера.

Локально, а делится через git

SQLite с полнотекстовым поиском на вашей машине, без нативных зависимостей. Отсортированный memories.jsonl лежит в git рядом с кодом.

Посмотрите в деле ​

Минута настоящего вывода. Озвучка синтезированная.

От установки до ответа ​

Ниже пример из examples/adr-demo: три ADR о том, где хранить сессии.

$ npx @vefimov/engram init
✔ Created .engram/ in ~/code/shop
✔ Claude Code: .mcp.json, CLAUDE.md, 6 skills
✔ Indexed in 66 ms — 3 ADRs, 1 commits, 0 hotspots, 0 possible pitfalls

$ engram why sessions
↩️ ADR-0001: Cache sessions in Redis (superseded)
  Context: Login latency is dominated by the session lookup in Postgres.
  Decision: Store sessions in Redis with a 30-day TTL.
❌ ADR-0002: Store sessions in MongoDB (rejected)
  Rejected: no transactions spanning sessions and the orders table.
✅ ADR-0003: Keep sessions in Postgres (active)
  Sessions live in Postgres with an hourly cleanup job.
  dec_edkgurku —supersedes→ dec_40bmzazh

Затем перезапустите агента и скажите ему «используй engram». Он получает брифинг в начале каждой задачи, сверяет планы со старыми ошибками, записывает решения по ходу дела и оставляет заметку для следующей сессии.

Released under the MIT License.

© 2026 Valentyn Yefimov