TrueMemory MCP
Локальная память для агента: хуки сами записывают факты из разговоров, а MCP-сервер возвращает их в новых сессиях из файла SQLite
- 384 ★ репозитория
- Последний коммит
- AGPL-3.0
Широкий доступ
Почему такой уровень
- Хуки автоматически сохраняют содержимое ваших разговоров с агентом, в том числе личные данные, если вы их упоминали, в локальный файл на диске
- Установщик скачивается и запускается как скрипт оболочки, а анонимная телеметрия включена по умолчанию
Установка
- Работает в
Ручная установка
curl -LsSf https://raw.githubusercontent.com/buildingjoshbetter/TrueMemory/main/install.sh | shУстановщик для Claude Code, Cursor, Codex CLI и Gemini CLI. Скачивает около 1,5 ГБ моделей, действует без sudo. На Windows есть install.ps1 в PowerShell.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Хуки автоматически сохраняют содержимое ваших разговоров с агентом, в том числе личные данные, если вы их упоминали, в локальный файл на диске
- Установщик скачивается и запускается как скрипт оболочки, а анонимная телеметрия включена по умолчанию
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
TrueMemory дает Claude Code, Cursor, Codex CLI, Gemini CLI и Claude Desktop память между сеансами. Хуки жизненного цикла сами выбирают из разговоров важное: предпочтения, факты, решения и поправки, а в следующем сеансе подставляют нужные записи. Вручную сохранять и искать ничего не надо. Все лежит в одном файле SQLite `~/.truememory/memories.db` на вашем компьютере. Память не просто копит записи. При смене решения она разрешает противоречия, обновляет устаревшие факты и объединяет похожие. Отдельная пометка directive превращает запись в постоянное указание вроде «всегда подписывай коммиты». Такие указания подгружаются в начало каждого сеанса, до записей, найденных поиском. MCP-сервер открывает 11 инструментов: `truememory_store` сохраняет запись, `truememory_search` и `truememory_search_deep` ищут (второй глубже и медленнее), `truememory_get` и `truememory_forget` читают и удаляют запись по номеру, `truememory_directives` показывает постоянные указания. Поиск идет в шесть слоев с переранжированием моделью. Есть три уровня: Edge работает на любом процессоре, Base использует более точные модели локально, Pro добавляет расширение запроса через языковую модель по вашему ключу.
Для кого. Для тех, кто каждый день работает в Claude Code или Cursor и устал повторять агенту стек, договоренности и поправки в начале новой сессии.
Подходит, если
- Агент каждую сессию начинает с нуля и снова спрашивает, на каком фреймворке построен проект
- Нужно закрепить постоянное указание, например подписывать коммиты, и чтобы оно подгружалось само
- Вы поменяли решение, и старый факт в памяти должен обновиться и не остаться рядом с новым
- Требуется память, которая работает без облака и без ключей и хранится в одном файле на диске
- Нужно подключить одну и ту же память к Claude Code, Cursor, Codex CLI и Gemini CLI
Не подходит, если
- Разговоры содержат данные клиентов или секреты: хуки сохраняют содержимое бесед автоматически, и при таких данных запись лучше не включать
- Нужна общая командная память в облаке: TrueMemory локальная, единый файл лежит на вашей машине
- Нужна коммерческая интеграция в продукт: лицензия AGPL-3.0 позволяет бесплатное личное и исследовательское использование, а для коммерческого нужна отдельная лицензия
- Компьютер слабый или места мало: установщик скачивает около 1,5 ГБ моделей, а режимы Base и Pro просят от 4 ГБ оперативной памяти
Пример запроса к агенту
Запомни, что мы используем FastAPI и Pydantic v2, а миддлвар авторизации лежит в src/auth. И с этого момента всегда подписывай коммиты GPG.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
TRUEMEMORY_TELEMETRY- Значение off отключает анонимную телеметрию, по умолчанию она включена
TRUEMEMORY_DIRECTIVE_LIMIT- Предел постоянных указаний в начале сеанса, по умолчанию 50
Ограничения
Установщик скачивает около 1,5 ГБ моделей и создает изолированное окружение Python 3.12 через uv, системный Python не затрагивается. Режимы Base и Pro рассчитаны на 4 ГБ оперативной памяти и больше, режим Edge работает на любом процессоре. Для Pro нужен ключ языковой модели: он отправляет текст поисковых запросов, но не сами воспоминания.
Анонимная телеметрия включена по умолчанию: считает вызовы инструментов, число сеансов и сведения о платформе, а содержимое памяти, запросы, пути и ключи не отслеживает. Отключить ее можно переменной `TRUEMEMORY_TELEMETRY=off`. Количество постоянных указаний, подгружаемых в начале сеанса, ограничено 50, лимит меняется переменной `TRUEMEMORY_DIRECTIVE_LIMIT`. Один записанный факт не превышает 50 тысяч символов.
Лицензия AGPL-3.0: бесплатно для личного и исследовательского использования, для коммерческого нужна отдельная лицензия. В README приведены результаты на трех тестовых наборах, их можно воспроизвести скриптами из папки benchmarks, но это замеры самого автора.
Как отключить. Закройте агента, удалите запись TrueMemory из конфигурации MCP и хуки, которые добавил установщик. Чтобы убрать данные, удалите папку `~/.truememory/`. Для библиотеки Python выполните `pip uninstall truememory`.
Частые вопросы
Как установить TrueMemory для Claude Code?
Выполните установочную команду `curl -LsSf https://raw.githubusercontent.com/buildingjoshbetter/TrueMemory/main/install.sh | sh`, полностью закройте агента, откройте снова и напишите «Set up TrueMemory», затем выберите уровень. Root-права не нужны, установка занимает 3–5 минут.
Где хранятся воспоминания и уходят ли они в облако?
Все лежит в файле `~/.truememory/memories.db`. Уровни Edge и Base не делают внешних вызовов. Pro отправляет языковой модели только текст поискового запроса для расширения, сами воспоминания не передаются.
Чем различаются уровни Edge, Base и Pro?
Edge использует легкую модель эмбеддингов около 8 МБ и работает на любом процессоре. Base берет более точную модель около 600 МБ и требует от 4 ГБ памяти. Pro добавляет расширение запроса через языковую модель, ему нужен ключ API. Уровень меняют фразой «switch to Pro» или «switch to Base».
Как отключить телеметрию?
Выполните `export TRUEMEMORY_TELEMETRY=off`. По умолчанию собираются анонимные данные о вызовах инструментов, числе сеансов и платформе, а содержимое памяти, запросы, пути и ключи не собираются.
Как закрепить постоянное указание вроде «всегда подписывай коммиты»?
Сохраните запись с флагом directive, а чтобы увидеть список таких указаний, вызовите `truememory_directives`. Устаревшие или противоречивые указания удаляет `truememory_forget`. В начало каждого сеанса подставляется до 50 указаний.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыДолговременная память для агентов: удаленный MCP-сервер, плагины для Claude Code, Cursor и Codex и API для своих приложений
Долговременная память для Claude Code, Cursor и Codex: агент сохраняет решения и находит их в следующих сессиях
Постоянная память агента на графе связей: решения и ошибки переживают сессию, без векторной базы и платных вызовов API
Общая локальная память для ИИ-агентов: Claude Code, Codex, Cursor и другие находят в ней договоренности прошлых сессий и записывают новые
Память для агентов по MCP: пять инструментов, локальный файл SQLite и слои, как в человеческой памяти, без аккаунта
Membase хранит одну общую память для ИИ-агентов, и Claude Code, Cursor и Codex читают ее через MCP, SDK или команду membase
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| TrueMemory (эта карточка) | нет | не нужна | 384 | |
| Claude-Mem | нет | 113 534 | плагин с постоянной памятью, который вводит в контекст наблюдения из сессий агента | |
| Hindsight | да | API-ключ | 58 839 | система долгой памяти, где агент сам сохраняет опыт и факты и потом извлекает их |
| AgentRecall | нет | не нужна | 373 | локальная память агента на журнале поправок |
Коротко о README
README объясняет идею на примере агента, который каждую сессию начинает с амнезии, и сравнивает систему с другими решениями памяти по результатам на трех тестовых наборах. Дальше идут установка командой для разных систем, описание уровней, таблица методов библиотеки Python, список документации и ответы на частые вопросы. Сведения о статье автора и переводах README вынесены в конец.