Memro — единая долговременная память для всех ИИ-агентов кодинга
📂 Исходный код на GitHubЕдиная долговременная память для всех ИИ-инструментов кодинга: Claude Code, Cursor, Codex, Copilot. Правила сохраняются файлом в репозитории и показываются каждому агенту на каждом промпте, долговременная память делится между инструментами и машинами. MCP-сервер, SDK для Python, JavaScript/TypeScript и Go, облако или самостоятельный запуск через Docker. Лицензия PolyForm Noncommercial: бесплатно для некоммерческого использования.
Memro — это единая долговременная память для всех ИИ-инструментов кодинга. Claude Code, Cursor, Codex, GitHub Copilot и любой MCP-клиент читают и пишут в одно общее хранилище. Решения, предпочтения и контекст проекта сохраняются между сессиями. Скажи правило одному агенту — его увидят все остальные.
Проект собран в одном репозитории: сервер на Go, MCP-сервер, CLI и официальные SDK для Python, JavaScript/TypeScript и Go. Работать можно через облако Memro Cloud или на своей инфраструктуре через Docker.
Правила, которые агенты не пропустят
Главная возможность Memro — правила. Вы говорите агенту «никогда не используй Intl в коде корзины» или «всегда запускай тесты перед коммитом». Фразы с «никогда», «всегда» и «отныне» Memro ловит прямо в промпте. Правило сохраняется в файл .memro/rules.md вашими же словами.
Дальше происходит три вещи:
- Правило видно в
git diff. Его можно поправить руками и передать команде через коммит. - Каждый агент видит правило на каждом промпте. Поиск ничего не может пропустить.
- Назовите запрещённую вещь в бэктиках — и при правке или команде, которая её использует, агент получит предупреждение с текстом правила. Работает в Claude Code и Codex. Только предупреждение, блокировки нет.
Эффект авторы измерили на бенчмарке. Правило спрятано среди 3000 фактов. Агенты, которым правило показывали описанным выше способом, избегали ловушки 150 раз из 150. Файл с заметками, который агенту приказали прочитать, дал 139 из 150. Только поиск — 58 из 150. Методика описана в журнале бенчмарка.
Память и координация
Правила — часть большой системы. С аккаунтом агенты делят долговременную память между инструментами и машинами. Cursor вспомнит решение, которое вы приняли вчера в Claude Code на другом компьютере.
Агенты также могут захватывать файлы. Тогда два агента не отредактируют один файл одновременно.
Memro подтягивает контекст и из внешних сервисов: Slack, GitHub, Linear, Notion и ещё более 40 источников. Полный список коннекторов — на сайте.
Быстрый старт
Самый короткий путь — облако. Две команды:
npx memro-cli connect # device login and connect installed agent tools
npx memro-cli status # check connection status
Потом проверка. Скажите агенту: «запомни, что наша основная база — PostgreSQL 16 с pgvector». Перезапустите сессию и спросите: «какую базу данных мы используем?». Ответ придёт из памяти Memro.
Для Claude Code есть плагин:
/plugin install memro --marketplace memrohq/memro
Он добавляет MCP-сервер и поднимает память проекта в начале каждой сессии. Подробнее — в каталоге интеграции.
Аккаунт не обязателен. Команда npx memro-cli init раскладывает правила в .memro/rules.md и ставит хуки в каждый агентский инструмент на машине — память будет локальной.
Правилами удобно управлять командой npx memro-cli rules: список, правка, удаление. Если что-то не подключилось, npx memro-cli doctor покажет, какой конфиг каждый инструмент использует на самом деле, и проверит ключ.
Самостоятельный запуск
Весь сервер можно поднять у себя. Понадобятся Docker Compose и ключ OPENAI_API_KEY для гибридного поиска:
git clone https://github.com/memrohq/memro && cd memro
cp .env.example .env
docker compose up -d
curl http://localhost:8081/health
После запуска: API на порту 8081, дашборд на 5173, PostgreSQL на 55432. Порт 55432 выбран специально — чтобы не конфликтовать с локальным Postgres на стандартном 5432. Дашборд рисует граф памяти: воспоминания связаны с людьми, компаниями и разговорами. Варианты развёртывания и конфигурация описаны в руководстве по самостоятельному хостингу.
Два замечания по безопасности. Токен METRICS_TOKEN длиной не меньше 32 символов защищает два адреса API: /metrics и /stats/cache. Без него сервер пишет предупреждение в лог. Подписи опубликованных образов контейнеров можно проверить через Cosign без ключей.
Архитектура
Стек простой и стандартный. HTTP API написан на Go, данные лежат в PostgreSQL 16 с расширением pgvector.
Поиск объединяет два метода: поиск по векторам ловит смысл, полнотекстовый поиск ловит ключевые слова. Результаты сливаются методом Reciprocal Rank Fusion (RRF).
Агенты проходят аутентификацию двумя способами: парами ключей Ed25519, которые генерируются прямо на машине, или обычными Bearer-токенами. Закрытые ключи не покидают хост.
SDK
Для кода вне агентов есть три SDK. Пример на Python:
from memro import Agent
agent = Agent.create() # local sovereign Ed25519 identity
mem = agent.remember("The billing service was rewritten in Go", type="semantic")
results = agent.recall("billing service language")
print(results[0].content)
Установка: pip install memro, npm install @memro/sdk или go get github.com/memrohq/memro/sdk/go@v0.1.0. Готовые примеры для Claude Code, Cursor и Codex лежат в каталоге examples, работа через MCP описана в руководстве MCP.
Типы памяти и продвинутые возможности
Каждое воспоминание имеет тип:
semantic— факты, например «сервис биллинга переписан на Go»;episodic— события и разговоры;procedural— инструкции и пошаговые рецепты;profile— правила поведения агента.
Типы описаны в документации концепций. Поверх этого есть три приёма:
- Поиск с учётом времени. Свежие воспоминания весят больше, видно, как знания менялись со временем.
- Разбор противоречий. Функция
resolve_conflict()помечает устаревший факт как заменённый. - Графы рассуждений. Видно происхождение воспоминания: причинные связи и зависимости между записями.
Проверка на бенчмарках
Авторы публикуют методику и результаты. Основной бенчмарк — LongMemEval: 500 вопросов на память между сессиями и обновление знаний. Отдельный набор тестов проверяет ошибки на границах: противоречивые факты, устаревшие данные, посторонние записи.
Лицензия
Лицензия — PolyForm Noncommercial 1.0.0. Для учёбы, исследований и хобби-проектов бесплатно, включая самостоятельный хостинг. Коммерческое использование требует подписки Memro Cloud или отдельной коммерческой лицензии.
Источник: https://github.com/memrohq/memro