engrim — плагин
Локальная память проекта для кодинг-агентов: решения и текущее состояние переживают смену модели и очистку чата
- 301 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Хуки выполняются при каждом запуске и запросе, а `engrim setup` правит конфиги агентов и файл `~/.claude/CLAUDE.md`
- В базу попадают решения и детали проекта, поэтому файл базы стоит держать вне общих папок
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/engrimОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Хуки выполняются при каждом запуске и запросе, а `engrim setup` правит конфиги агентов и файл `~/.claude/CLAUDE.md`
- В базу попадают решения и детали проекта, поэтому файл базы стоит держать вне общих папок
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
engrim хранит решения, ограничения и текущее состояние проекта в локальной базе SQLite и возвращает агенту короткую выжимку вместо пересылки всей переписки. При старте сессии и на каждый запрос хуки подставляют пакет памяти около 4000 знаков. Записи бывают шести типов: decision, fact, feedback, state, user и reference. Агент пишет их сам через инструмент `engrim_add`, вы можете добавлять их командой `engrim add`. Поиск гибридный: лексический bm25 плюс векторное сходство на статических эмбеддингах model2vec. Инструменты `engrim_recall`, `engrim_context` и `engrim_review` ищут записи, отдают пакет памяти и проверяют, остались ли в логе незафиксированные решения, прежде чем вы очистите чат командой `/clear`. Одна база обслуживает семь агентов, от Claude Code и Cursor до Codex CLI и Google Antigravity, и у каждой записи есть пометка агента, который ее сделал.
Для кого. Для разработчиков, которые ведут один репозиторий в нескольких агентах и не хотят после каждой очистки чата заново объяснять принятые решения.
Подходит, если
- Сессия раздулась, вы собираетесь выполнить `/clear` и хотите сохранить решения и следующий шаг
- Один проект по очереди ведут Claude Code, Cursor и Codex, и им нужна общая память
- Решения нужно хранить вместе с причинами, например почему вы перешли с MongoDB на PostgreSQL
- Данные должны остаться на машине: ни облачной синхронизации, ни ключа API, ни телеметрии
- После переноса настроек на другую машину нужно убедиться, что хуки и MCP на месте
Не подходит, если
- Память нужна всей команде: база лежит в домашней папке одного пользователя, хотя чужую базу можно влить командой `engrim merge`
- Никто не готов фиксировать решения: качество памяти зависит от того, что агент или вы записали
- Агент без хуков и MCP, например веб-чат: подключать engrim не к чему
- Нужен индекс всего кода проекта: engrim ищет по записям памяти и кодовую базу не индексирует
Пример запроса к агенту
Запиши решение: переходим на PostgreSQL ради транзакций, а следующим шагом закрепи перенос миграций. Потом я очищу чат, и ты продолжишь с этого места.Ограничения
Нужен Python 3.10 или новее. Агент читает хуки при старте, поэтому после `engrim setup` откройте новую сессию. В Codex хуки надо проверить и одобрить командой `/hooks` до первого запуска, а MCP-сервер подключается отдельным флагом `--codex-mcp`. GitHub Copilot CLI не публикует формат файла событий как стабильный контракт, и при несовместимых записях engrim выдает предупреждение. Цифры экономии контекста на сайте проекта автор получил на одном своем проекте, независимой проверки нет. Подключение к PyPI нужно при установке, дальше инструмент работает без сети.
Как отключить. Для Codex есть `engrim uninstall --codex`: он убирает только хуки engrim, блок инструкций и запись mcp_servers.engrim. Плагин Claude Code отключите или удалите через /plugin, остальные записи в конфигах агентов удалите вручную. Файл `~/.engrim/memory.db` остается на диске, удалите его, если память больше не нужна.
Частые вопросы
Как поставить engrim в Claude Code?
Через плагин: `/plugin marketplace add timgordontg/engrim`, затем `/plugin install engrim@engrim`. Плагин сам ставится при первом запуске и не требует ключа API. Второй путь: `pip install engrim` и `engrim setup --claude`, он пропишет хуки в `~/.claude/settings.json`.
Что происходит с контекстом после /clear?
Новая сессия стартует из базы памяти: в начале пакета стоит запись с тегом resume-pointer под заголовком «RESUME HERE». Команда `engrim retire` закрывает такую запись, когда работа сделана.
Где engrim хранит данные и уходят ли они в сеть?
Данные лежат в файле SQLite `~/.engrim/memory.db` с правами 0600 на POSIX-системах. Телеметрии и облачной синхронизации в проекте нет.
Как подключить engrim к Cursor или Windsurf?
Для Cursor выполните `engrim setup --cursor`: команда добавит сервер в `~/.cursor/mcp.json` с запуском `engrim serve --mcp`. Для Windsurf вставьте такой же блок вручную в `~/.codeium/windsurf/mcp_config.json`.
Как проверить, что хуки не сломались после переезда на другой компьютер?
Запустите `engrim doctor`, а с флагом `--fix` он починит устаревшие пути к бинарнику. У команд хуков есть и запасной вызов через PATH, поэтому сессия не падает молча.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныEngram от Gentleman Programming
Engram (Gentleman Programming)
Постоянная память для ИИ-агентов в одном бинарнике на Go: MCP-сервер на SQLite с полнотекстовым поиском, который помнит проект между сессиями
Общая семантическая память для агентов: разговоры сохраняются в markdown и находятся поиском в Claude Code, Codex и других агентах
Общая локальная память для ИИ-агентов: Claude Code, Codex, Cursor и другие находят в ней договоренности прошлых сессий и записывают новые
Долговременная память агента в папке связанных markdown-заметок, чтобы Claude Code помнил проект между сессиями
Общая облачная память для агентов команды: сохраняет трассы сессий и превращает повторяющиеся приемы в скиллы
Локальная память для ИИ-агентов программиста: хуки записывают ход каждой сессии, и Claude Code, Codex или Cursor находят прошлые решения через MCP
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| engrim (эта запись) | нет | 301 | ||
| Claude-Mem | нет | 104 106 | плагин, который сохраняет наблюдения сессий и подставляет контекст | |
| projectmem | да | не нужна | 870 | MCP-сервер памяти, который хранит проблемы, попытки и фиксы |
Коротко о README
Центральная идея проекта — режим continue-as-clear: перед очисткой чата вы закрепляете ближайшую задачу, и новая сессия начинает с нее. Для GitHub Agentic Workflows в каталоге examples есть пример памяти между запусками через артефакты и `engrim merge`.