Engram от Gentleman Programming
Engram (Gentleman Programming)
Постоянная память для ИИ-агентов в одном бинарнике на Go: MCP-сервер на SQLite с полнотекстовым поиском, который помнит проект между сессиями
- 7 553 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Плагин Claude Code ставит хуки сессий, которые выполняют скрипты и вызывают curl на вашей машине
- Записи памяти могут содержать куски кода и решения по проекту, и при включении Engram Cloud они реплицируются на сервер
Установка
- Работает в
Ручная установка
brew install gentleman-programming/tap/engramСтавит последнюю стабильную версию. Способы для Windows, Linux и сборки из исходников есть в документации установки.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Плагин Claude Code ставит хуки сессий, которые выполняют скрипты и вызывают curl на вашей машине
- Записи памяти могут содержать куски кода и решения по проекту, и при включении Engram Cloud они реплицируются на сервер
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Engram сохраняет то, что агент узнал за сессию, и подставляет это в следующие. Весь проект — один бинарник на Go: данные лежат в SQLite с индексом FTS5 в файле ~/.engram/engram.db, а наружу он выходит через консольные команды, локальный HTTP API, MCP по stdio и терминальный интерфейс engram tui. Агенту доступны инструменты MCP для сохранения записей, поиска, хронологии, учета сессий, проверки и диагностики. Если записи противоречат друг другу, Engram помечает конфликт, чтобы агент сам сравнил их. Память привязана к проекту: сначала берется явно указанный проект, затем переменная ENGRAM_PROJECT, затем проект определяется по текущему каталогу. Команда engram setup пишет нужную конфигурацию для 14 агентов, включая Claude Code, Codex, Cursor, Gemini CLI, OpenCode и Windsurf. Для Claude Code есть еще плагин через маркетплейс с хуками сессий и восстановлением после сжатия контекста. Память остается на компьютере, а переносить ее между машинами можно через Git Sync или необязательное облако Engram Cloud.
Для кого. Для разработчиков, которые каждую сессию заново объясняют агенту устройство проекта и хотят держать эту память у себя на диске, а не в чужом сервисе.
Подходит, если
- Агент в Claude Code каждый раз забывает принятые решения, и вы хотите, чтобы он сохранял их через MCP-инструменты и находил поиском
- Вы работаете с несколькими агентами, например с Codex и Cursor, и хотите общую память на одном локальном файле SQLite
- После сжатия контекста агент теряет нить, а плагин Claude Code с восстановлением после compaction возвращает ее
- Память нужна по каждому репозиторию отдельно, и определение проекта по каталогу или по ENGRAM_PROJECT это обеспечивает
- Команда делится накопленными записями через Git Sync или проверяет их в терминальном интерфейсе `engram tui`
Не подходит, если
- Нужен граф связей и семантический поиск по векторам: Engram строит полнотекстовый индекс FTS5
- Вам достаточно файла CLAUDE.md или AGENTS.md с несколькими правилами проекта, без отдельного хранилища
- Ваш агент без MCP и без записи в списке поддержки, а ручная настройка вам не подходит
- Для плагина Claude Code на машине нет jq и curl, и ставить их нельзя: тогда доступен только запасной вариант с MCP без хуков
Пример запроса к агенту
Сохрани в память Engram решение, что для этого проекта мы используем SQLite вместо Postgres, и напомни мне о нем при следующей работе с базойMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
ENGRAM_PROJECT- Название проекта, к которому привязана память, если его нельзя определить по каталогу
Ограничения
- Сначала ставится бинарник engram, например через Homebrew командой `brew install gentleman-programming/tap/engram`. Способы для Windows, Linux и сборки из исходников описаны в документации установки.
- Плагин Claude Code из маркетплейса ставит только хуки, скрипты и скилл Memory Protocol. Сервер MCP регистрирует команда `engram setup claude-code`.
- Хукам плагина нужны jq и curl в PATH. Старые версии Claude Code могут отвергнуть манифест плагина, помогает `claude update`.
- Для мутирующих инструментов Codex нужна совместимая версия запущенного ядра, иначе их придется обновить.
- Облако Engram Cloud необязательно и привязано к проекту. Лицензия MIT, ключей и платных аккаунтов для локальной работы не требуется.
Как отключить. Уберите регистрацию MCP в клиенте, например `claude mcp remove engram`, и удалите плагин командой `claude plugin uninstall engram`. Записи останутся в ~/.engram/engram.db, поэтому удалите эту папку, если память больше не нужна.
Частые вопросы
Как поставить Engram в Claude Code?
Установите бинарник через `brew install gentleman-programming/tap/engram` и выполните `engram setup claude-code`. Команда обновляет плагин из маркетплейса и регистрирует MCP-сервер, затем перезапустите Claude Code. Плагину нужны jq и curl.
Где Engram хранит записи памяти?
Локально в SQLite-файле ~/.engram/engram.db с индексом FTS5. Локальная база считается основной. Git Sync выгружает из нее переносимые сжатые фрагменты, а Engram Cloud необязателен.
С какими агентами работает Engram?
Для 14 агентов есть команда engram setup: Claude Code, Pi, OpenCode, Gemini CLI, Codex, Antigravity CLI, Windsurf, Qwen Code, Kiro, Cursor, VS Code (Copilot), Kilo Code, Kimi Code и CommandCode. Любой другой агент с MCP подключается вручную.
Чем Engram отличается от Claude-Mem?
Engram — отдельный бинарник на Go, он работает с четырнадцатью агентами через MCP и общую базу SQLite. Claude-Mem поставляется плагином для Claude Code и сохраняет наблюдения из его сессий.
Как проверить, что Engram установлен правильно?
Команда `engram doctor` выполняет диагностику только на чтение. Содержимое памяти удобно смотреть через `engram tui`: клавиши j и k перемещают по списку, / запускает поиск, Enter открывает запись.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальная память для ИИ-агентов программиста: хуки записывают ход каждой сессии, и Claude Code, Codex или Cursor находят прошлые решения через MCP
Долговременная память для агентов: удаленный MCP-сервер, плагины для Claude Code, Cursor и Codex и API для своих приложений
Общая локальная память для ИИ-агентов: Claude Code, Codex, Cursor и другие находят в ней договоренности прошлых сессий и записывают новые
Локальная память для агентов: хранит переписку и файлы проекта дословно и находит нужное семантическим поиском через MCP
Самостоятельно размещаемая долговременная память для агентов: семантический поиск, граф знаний и автоконсолидация через MCP и REST API
Долговременная память для ИИ-агентов: файлы Markdown как источник истины, индекс SQLite как кэш, общая у Claude Code, Codex и других
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Engram от Gentleman Programming (эта запись) | нет | не нужна | 7 553 | |
| Claude-Mem | нет | 102 612 | плагин для Claude Code с наблюдениями сессий, а Engram — общий бинарник для четырнадцати агентов | |
| Mem0 | нет | 67 710 | слой памяти с плагинами и SDK, хранилище и API задаются отдельно | |
| Basic Memory | нет | не нужна | 4 334 | хранит память в Markdown-файлах с графом связей, а Engram держит ее в одном файле SQLite |
Из блога
Коротко о README
Страница начинается с шапки: слоган про постоянную память, список из 14 поддерживаемых агентов и схема работы от агента через MCP до SQLite. Затем идут блоки о привязке памяти к проекту, локальном хранении с Git Sync и облаком, терминальном интерфейсе и дополнительных компонентах. Раздел начала работы дает установку через Homebrew и таблицу команд настройки по агентам. В конце описана проверка совместимости хранилища командой `engram compatibility`, которая только читает метаданные.