Piia Engram — переносимая память для ИИ-агентов
Piia Engram
Локальная память о вас и ваших проектах: Claude Code, Codex и Cursor читают одни и те же предпочтения и уроки из файлов на диске
- 165 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Агент пишет в локальные файлы памяти и читает их в каждой сессии; чувствительные пункты ждут подтверждения, остальные принимаются автоматически
- Один раз в сутки уходит анонимный счетчик использования, если не отключить его
Установка
- Работает в
Ручная установка
pip install piia-engram && engram setupМастер сам находит клиентов и после подтверждения прописывает MCP.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент пишет в локальные файлы памяти и читает их в каждой сессии; чувствительные пункты ждут подтверждения, остальные принимаются автоматически
- Один раз в сутки уходит анонимный счетчик использования, если не отключить его
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Piia Engram хранит под вашим управлением то, что агенты обычно забывают при смене чата или инструмента: стиль работы, планку качества, усвоенные уроки, принятые решения и контекст проектов. Данные лежат в каталоге ~/.engram/ как JSON и Markdown, облачный аккаунт не нужен. Через MCP по stdio одну и ту же память подключают к Claude Code, Codex, Cursor, Claude Desktop и еще нескольким клиентам. Знания делятся на три вида: уроки, решения и сценарии. Агент записывает новое сам, но чувствительные пункты (учетные данные, команды оболочки, настройки MCP, правила разрешений) ждут вашего подтверждения. Команда `engram preview --html` строит Memory Lens, отчет о том, что получит агент и что скрыто политикой. Режим `ENGRAM_APPROVAL=strict` ставит под проверку каждую запись. По умолчанию загружаются 19 основных инструментов MCP, еще 40 включаются переменной `ENGRAM_TOOLS=all`. Для ChatGPT, Gemini и Kimi мастер выдает карточку личности в Markdown, а для OpenClaw импортирует и экспортирует файлы SOUL.md, MEMORY.md и USER.md.
Для кого. Разработчикам, которые переключаются между Claude Code, Codex и Cursor и устали заново объяснять стандарты кода и прошлые решения.
Подходит, если
- Вы открываете десятый чат за неделю, и каждый раз агент спрашивает про язык, фреймворк и подход к тестам
- Решение по архитектуре принято в Claude Code, а продолжать работу вы будете в Codex
- После обновления инструмента его встроенная память сбросилась, а наработанные правила нужно сохранить
- Хочется заранее увидеть, какой контекст агент получит, до того как он уйдет в запрос
Не подходит, если
- Нужна память о ходе одной задачи: историю сессии и шаги агента лучше хранить в базе агентской памяти вроде Mem0 или Letta. Engram описывает человека, а не задачу
- Вам важна строгая лицензия: код под AGPL-3.0, и встраивать его в закрытый продукт без раскрытия исходников нельзя
- Нужна общая память команды на сервере: хранилище локальное и принадлежит одному пользователю
Пример запроса к агенту
Запомни, что я предпочитаю pytest с покрытием от 90 процентов, и покажи, что Codex увидит из моей памяти в этом проекте.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
ENGRAM_APPROVAL- Значение strict ставит под подтверждение каждую запись.
ENGRAM_TOOLS- Значение all включает 40 дополнительных инструментов.
Ограничения
Python 3.10 или новее. Файлы памяти лежат в открытом виде (JSON и Markdown), шифрование AES-256-GCM полей профиля включается отдельно. Раз в сутки уходит анонимный счетчик использования, отключить его можно командой `engram telemetry off` или переменной `DO_NOT_TRACK=1`; проверка версии на PyPI отключается переменной `ENGRAM_NO_UPDATE_CHECK=1`.
Сессионные записи (чекпойнты и снимки) не проходят проверку и не дают агенту права на действия. «Проверено» значит принято вами или политикой, а не сверено с вашим текущим кодом. Сетевой запрос делает только необязательный инструмент read_web_content. Клиенты Windsurf, Copilot, Cline и ряд других отмечены в README как «ожидается, что работает».
Как отключить. Удалите запись сервера из конфигурации клиента, затем при желании очистите каталог ~/.engram/. Мастер `engram setup` перед каждой правкой делает резервную копию конфигов клиентов.
Частые вопросы
Чем Piia Engram отличается от встроенной памяти Claude Code или Cursor?
Встроенная память привязана к одному инструменту или рабочему пространству, а Engram хранит файлы у вас и отдает их разным клиентам по MCP. Память Claude Code, записанная в одном инструменте, читается в Codex через то же хранилище: в репозитории есть воспроизводимая демонстрация такого переноса.
Как поставить Piia Engram?
Выполните `pip install piia-engram && engram setup`. Мастер находит Claude Code, Cursor, Codex и Claude Desktop, показывает список файлов, которые собирается изменить, и пишет подключение MCP после подтверждения. Затем перезапустите клиент.
Агент может записать в память что угодно?
Пункты с низкой и средней опасностью сохраняются сразу, но журнал ведется, и запись можно откатить. Учетные данные, команды оболочки, настройки MCP и правила разрешений ждут вашего решения. Строгий режим включается командой `ENGRAM_APPROVAL=strict`.
Нужен ли облачный аккаунт?
Нет. Ядро хранилища работает на вашей машине, установка идет через pip, а данные лежат в ~/.engram/. Сетевых запросов инструменты памяти не делают, исключение составляет необязательный read_web_content.
С какими клиентами работает Piia Engram?
Claude Code, Codex, Cursor и Claude Desktop подключаются через MCP по stdio, и проверялись глубже всего. Для Windsurf, Copilot, Cline, Roo Code, Zed и других в README стоит пометка «ожидается, что работает». OpenClaw получает файлы SOUL.md, MEMORY.md и USER.md, а ChatGPT и Gemini берут карточку личности в Markdown.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыEngram от Gentleman Programming
Engram (Gentleman Programming)
Постоянная память для ИИ-агентов в одном бинарнике на Go: MCP-сервер на SQLite с полнотекстовым поиском, который помнит проект между сессиями
Память для ИИ-агентов с тремя типами: факты, события и процедуры, которые учатся на ошибках; облако по ключу или локальная папка
Общий слой долгой памяти: агент ведет заметки в обычных markdown-файлах, а индекс MEMORY.md подгружается в начале каждой сессии.
Engram (getengram.app) — облачная память агента
Engram (getengram.app)
Удаленный MCP-сервер, который хранит переписки с агентом дословно и ищет по ним по смыслу между сессиями
Зашифрованная офлайн-память для ИИ-агентов: общее хранилище на вашем компьютере для Claude Code, Cursor, Codex и других
Локальная память для ИИ-агентов программиста: хуки записывают ход каждой сессии, и Claude Code, Codex или Cursor находят прошлые решения через MCP
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Piia Engram — переносимая память для ИИ-агентов (эта карточка) | нет | не нужна | 165 | |
| agentmemory | да | не нужна | 30 314 | база памяти для задач и сессий агента, а не профиль человека |
| MCP Memory Service | нет | не нужна | 2 117 | общая память по MCP с серверной частью |
Коротко о README
В README Piia Engram подан как слой личности над инструментами, отдельный от базы памяти агента. В нем есть таблица клиентов с уровнями проверки от L0 до L5, правила доверия, политика приватности и воспроизводимый тест переноса памяти между Claude Code и Codex.