MemoraX Code — общий слой памяти для Codex, Claude Code, OpenCode и других агентов

MemoraX Code — плагин памяти для AI-кодинг-агентов. Его идея проста: агент хорошо справляется с текущей задачей, но новая сессия часто начинается с чистого листа — без знания архитектуры, неудачных попыток, правил репозитория и ваших рабочих предпочтений. MemoraX Code даёт Codex, Claude Code, CodeBuddy CLI, WorkBuddy, DeepSeek Harness, OpenCode и Trae общий слой памяти для этого контекста.

Проект написан на TypeScript, распространяется под лицензией MIT и доступен как npm-пакет @memorax/memorax-code. Цель проекта сформулирована честно: задача не в том, чтобы запоминать всё, а в том, чтобы возвращать ровно тот небольшой объём памяти, который релевантен текущей задаче — чтобы агент быстрее добирался до содержательного анализа и проверки.

Что именно запоминается

MemoraX Code разделяет память на четыре типа с чёткими границами:

Personal Memory и Procedure Memory хранятся локально в текущем репозитории, в каталоге .repo_memory/. При записи MemoraX Code сравнивает смысл с уже сохранённым контентом: эквивалентный запрос не меняет ничего, осмысленное уточнение или конфликт обновляет соответствующую запись и удаляет устаревшую формулировку, а полностью устаревшая запись удаляется. Явная просьба «забыть» удаляет только названное предпочтение или шаг процедуры, не трогая остальную память. Разовые инструкции задач не меняют сохранённую память, и агент спрашивает перед записью, если устойчивое намерение неясно.

Установка и настройка

Требуется Node.js 20+ (рекомендуется Node.js 24 LTS) и хотя бы один из поддерживаемых агентов. Установка:

npm install -g @memorax/memorax-code

Установка пакета не запускает интерактивную настройку автоматически — её нужно запустить вручную. Есть два пути:

С аккаунтом MemoraX (рекомендуемый). Создайте аккаунт на platform.memorax.net, затем выполните:

memorax-code setup --existing-account

и введите имя пользователя и API-ключ локально. Конфигурация обычно хранится в ~/.memorax-code/config.toml — файл содержит API-ключ, так что публиковать его нельзя.

Без аккаунта — гостевой режим на 90 дней. Чтобы начать сразу и подключить аккаунт позже:

memorax-code setup

Если позже вы зарегистрируетесь и захотите сохранить гостевую память, сначала получите Mark ID:

memorax-code account --show-mark-id

и используйте его для активации гостевого аккаунта на платформе — после регистрации прикрепить Mark ID к уже созданному аккаунту нельзя.

Настройка автоматически обнаруживает установленные агенты. После неё нужно перезапустить или обновить каждый найденный клиент: где-то достаточно перезапуска (Claude Code, OpenCode), а где-то требуется ручное включение — например, в Codex нужно включить адаптер MemoraX Code через /plugins, а в Trae — активировать зарегистрированные Global Hooks в настройках.

Проверка статуса выполняется из каталога проекта:

memorax-code status
memorax-cli status

Первая команда проверяет локальный Backend и интеграции с клиентами, вторая — конфигурацию памяти и scope рабочего пространства. Ни одна из них не отправляет тестовый запрос в облако — реальная проверка связанности происходит при первом поиске или записи. В Windows PowerShell используется memorax-cli.cmd status.

Как это работает в сессиях

Ключевые возможности продукта:

• Фоновая запись памяти — извлекает переиспользуемые знания из завершённых ходов диалога и пишет их в Coding Memory в фоне, без ручного вызова.
• Непрерывность предпочтений — записывает предпочтения профиля пользователя и подставляет их в будущие задачи по настроенному расписанию.
• Переиспользование процедур — сохраняет повторяемые процедуры задач и напоминает будущим агентам их применять.
• Видимый вклад памяти — если поиск в Coding Memory или доступная Repo/Procedure/Profile Memory существенно повлияли на ответ, агент начинает финальный ответ с короткой заметки об этом на естественном языке.
• Фоновая поддержка Repo Memory — в клиентах с поддержкой headless-режима автоматически структурирует структуру репозитория, точки входа и исторические свидетельства, обновляя их по политике, чтобы сократить повторный поиск и суммаризацию.
• Активное управление памятью — искать и добавлять память можно через встроенный скилл memorax-code или CLI.
• Локальная наблюдаемость — активность, статусы поиска и записи доступны в локальных trace-записях.

В нормальном режиме вручную вызывать скилл не нужно: релевантная память пишется в фоне, а агенты направляются к поиску, когда он полезен. Скилл вызывается как $memorax-code в Codex или /memorax-code в Claude Code и DeepSeek Harness; в OpenCode, CodeBuddy CLI, WorkBuddy и Trae — по имени скилла.

Приватность и контроль

Облачная память требует аккаунта MemoraX: завершение настройки активирует поиск/добавление и автоматическую запись памяти, а вот автоматическое извлечение остаётся выключенным, пока вы его явно не включите.

Локальный захват trace включён по умолчанию. Сохраняемые трейсы в каталоге MEMORAX_CODE_HOME могут содержать промпты, ответы, извлечённую память и локальные пути — в настройках можно переключиться на захват только метаданных или отключить trace для конкретного клиента. Автоматическая запись отправляет в облако выбранные пользовательские инструкции и соответствующий финальный ответ агента из доверенных рабочих пространств (после удаления служебной пометки о вкладе памяти), но не загружает полный клиентский trace-артефакт.

Coding Memory привязана к репозиторию или рабочему пространству: распознанные каталоги чатов по умолчанию в Codex, WorkBuddy и OpenCode делят общий скоуп General под одним ID пользователя. Посмотреть, отредактировать или удалить сохранённые воспоминания можно в любой момент в консоли MemoraX. Облако MemoraX не получает учётные данные провайдеров моделей и локальные токены Backend.

Обновление и удаление

Для глобальной npm-установки обновление выполняется командой:

memorax-code update

Setup также включает фоновые обновления, пока работает управляемый Backend: обновление ненадолго останавливает его и восстанавливает с сохранённым выбором клиентов. После обновления клиент стоит перезапустить, чтобы он подхватил изменённые интеграционные файлы.

Удаление выполняется через жизненный цикл продукта, а не напрямую через npm:

memorax-code uninstall

Команда удаляет управляемые интеграции и глобальный пакет, сохраняя конфигурацию и накопленную память. Полный список сохраняемых данных приведён в SECURITY.md проекта.

Итог

MemoraX Code решает узнаваемую боль: каждый новый чат с агентом начинается с нуля, и половина сессии уходит на повторное исследование того, что вы уже проходили. Проект предлагает четыре раздельных типа памяти, фоновую запись без ручного труда, локальное хранение чувствительных предпочтений и прозрачное облако с возможностью просмотра и удаления всего, что запомнено. Если вы работаете в нескольких агентами сразу (скажем, Codex и Claude Code над одним репозиторием), общий слой памяти между ними — пожалуй, самая интересная часть предложения. Репозиторий: github.com/memorax-ai/memorax-code.