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