Memro — единая долговременная память для всех ИИ-агентов кодинга

· 5 мин чтения
memory ai-agents mcp claude-code context-management
📂 Исходный код на GitHub

Единая долговременная память для всех ИИ-инструментов кодинга: Claude Code, Cursor, Codex, Copilot. Правила сохраняются файлом в репозитории и показываются каждому агенту на каждом промпте, долговременная память делится между инструментами и машинами. MCP-сервер, SDK для Python, JavaScript/TypeScript и Go, облако или самостоятельный запуск через Docker. Лицензия PolyForm Noncommercial: бесплатно для некоммерческого использования.

Memro — единая долговременная память для всех ИИ-агентов кодинга

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