memory.cpp CLI
memory.cpp собирает из истории репозитория компактный контекст для агента и убирает устаревшее, секреты и противоречия
- 679 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Читает историю репозитория, трассы и тесты и собирает из них текст, который уходит в промпт агента
- Хранилище записывает факты агента в SQLite, брандмауэр записи ловит только известные шаблоны опасных записей
Установка
- Работает в
Ручная установка
cargo install --path crates/memory-cliУстановка из клона репозитория. Есть также `./scripts/install.sh` и `./scripts/install.ps1`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Читает историю репозитория, трассы и тесты и собирает из них текст, который уходит в промпт агента
- Хранилище записывает факты агента в SQLite, брандмауэр записи ловит только известные шаблоны опасных записей
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
memory.cpp — локальный компилятор контекста, который работает до обращения к модели. Он превращает историю репозитория, решения, исправления, следы выполнения, тесты и правила в пакет блоков с источником, свежестью, чувствительностью и стоимостью в токенах. Стабильный префикс отделяется от изменчивого суффикса и хешируется blake3, поэтому повторные запросы попадают в кэш провайдера. Команды `memory remember` и `memory recall` ведут хранилище в SQLite внутри `.memory.cpp/`. `memory compile "задача" --provider anthropic --budget 1500` собирает пакет под провайдера, `memory cache-manifest` показывает кэшируемые участки, `memory lock` пишет воспроизводимый файл блокировки с журналом. Негативная память запоминает устаревшие документы и неудачные правки как исключения, доказательства свежести привязывают факты к файлам, коммитам и тестам. Брандмауэр записи отсекает опасные записи до сохранения, секреты скрываются. Для агентов есть `memory pack --for claude|codex|gemini|cursor|continue|mcp`, команда `memory mcp install --client claude` и сервер MCP, по умолчанию доступный только на чтение. Облака, учетных записей и телеметрии нет, пока вы сами не включите коннектор.
Для кого. Разработчикам, чьи агенты на длинных задачах тратят токены на повторное чтение репозитория и подтягивают устаревшие решения.
Подходит, если
- Агент на длинной задаче каждый ход заново читает одни и те же файлы и результаты тестов
- Старые ADR и неудачные исправления попадают в промпт и приводят к неверным правкам
- Нужно доказать, что получила модель: журнал и файл блокировки фиксируют состав пакета
- Стабильный префикс должен давать попадания в кэш провайдера Anthropic, OpenAI или Gemini
- Правила проекта и инварианты надо проверять в CI командой `memory ci-check`
Не подходит, если
- Нужна память для общего ассистента или облачное хранилище между устройствами: хранилище локальное, внутри репозитория
- Нужно сжать кэш ключей и значений у провайдера: проект уменьшает давление на него промптом, а сам кэш не сжимает
- Вам хватает ручного файла правил `CLAUDE.md` для небольшого проекта
Пример запроса к агенту
Собери командой memory compile контекст для задачи исправить экспорт счетов с бюджетом 1500 токенов и покажи, что исключено как устаревшееОграничения
Проект собирается из исходников на Rust командой `cargo build -p memory-cli` или ставится скриптами `./scripts/install.sh` и `./scripts/install.ps1`. Цифры экономии получены на встроенном синтетическом корпусе CAMC-Bench и на реальных репозиториях могут отличаться. Оценки нагрузки на KV-кэш названы оценками, пока их не измерили на конкретной среде выполнения. Готового пакета в реестрах в README нет. Сервер MCP открывает ресурсы только на чтение, запись в хранилище идет командами CLI. Последний коммит сделан 2 ноября 2026 года.
Как отключить. Удалите папку `.memory.cpp/` в репозитории и бинарный файл `memory`, установленный скриптом или `cargo install`. Подключение MCP снимите в настройках агента, где его добавила команда `memory mcp install`.
Частые вопросы
Как поставить memory.cpp?
Склонируйте репозиторий и выполните `./scripts/install.sh` (на Windows `./scripts/install.ps1`) или `cargo install --path crates/memory-cli`. Для сборки на месте служит `cargo build -p memory-cli`.
Как подключить memory.cpp к Claude Code?
Выполните `memory mcp install --client claude`. Сервер MCP отдает ресурсы только на чтение, поэтому агент не изменит хранилище напрямую.
Чем memory.cpp отличается от Mem0 или векторной базы?
Вместо выбора top-k похожих фрагментов он компилирует пакет: исключает устаревшее, проверяет свежесть, раскладывает стабильный префикс и фиксирует состав в журнале.
Сжимает ли memory.cpp KV-кэш модели?
Нет. Он убирает лишние, устаревшие и повторяющиеся токены из промпта, а цифры задержки и кэша остаются оценками, пока их не измерят.
Отправляет ли memory.cpp данные в облако?
Нет. Хранилище лежит в SQLite внутри `.memory.cpp/`, без аккаунтов, телеметрии и сетевых вызовов, пока вы не включите коннектор.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыЛокальная память для агентов с очередью проверки: SQLite, журнал аудита, учет токенов, общая для Claude Code, Codex, Cursor
Локальная память для агента: хуки сами записывают факты из разговоров, а MCP-сервер возвращает их в новых сессиях из файла SQLite
Общая локальная память для ИИ-агентов: Claude Code, Codex, Cursor и другие находят в ней договоренности прошлых сессий и записывают новые
Постоянная память агента на графе связей: решения и ошибки переживают сессию, без векторной базы и платных вызовов API
Долговременная память для Claude Code, Cursor и Codex: агент сохраняет решения и находит их в следующих сессиях
MCP-сервер долговременной памяти для ИИ-агентов: факты стареют по кривой забывания, связанные записи сжимаются в сводку
Коротко о README
README подает memory.cpp как компилятор контекста: он решает, что идет в стабильный префикс, что в свежий суффикс и что исключить. После быстрого старта на 60 секунд описана таблица проблем длинных задач агентов, устройство компилятора с промежуточным представлением и журналом, бенчмарк CAMC-Bench и таблица команд по областям. Затем сравнение с продуктами памяти, раздел о приватности и порядок проверки изменений.