claude-mem — долговременная память для AI-кодинг-агентов между сессиями

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

Плагин постоянной памяти для AI-кодинг-агентов (Claude Code, OpenCode, Grok Bot, OpenClaw). 5 жизненных хуков + worker-сервис на Bun, SQLite с FTS5 и Chroma для гибридного поиска, MCP-инструменты с трёхслойным workflow (search → timeline → get_observations) и экономией токенов до 10x. Теперь называется Grok Mem, пакет остаётся claude-mem. Apache 2.0.

claude-mem — долговременная память для AI-кодинг-агентов между сессиями

claude-mem — плагин постоянной памяти для AI-кодинг-агентов. Он запоминает, что бот сделал, какие решения были приняты и что делать дальше, и возвращает эти заметки в следующей сессии. Проект теперь называется Grok Mem (grok-mem.ai), но npm-пакет остался claude-mem.

Память работает рядом с собственной памятью агента и не заменяет её. Устанавливается в Claude Code, OpenCode, Grok Bot, Antigravity CLI и на шлюзы OpenClaw.

Быстрый старт

Для Claude Code — через плагин-маркетплейс:

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

Для Grok Bot (пакет по-прежнему называется claude-mem):

npx claude-mem install --ide grok-bot

Для OpenCode:

npx claude-mem install --ide opencode

Для OpenClaw-шлюзов — одной командой:

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

Установщик сначала настраивает всё, затем предлагает войти в аккаунт claude-mem через браузер (magic-link по e-mail, карта не нужна). Вход открывает observer: память, работающую вне тарифа, бесплатно первые 30 дней. После окончания триала память автоматически возвращается на ваш Anthropic-план, если не подписаться. Вход можно пропустить флагом --provider, переменной CLAUDE_MEM_ONLINE_OPTIN=false или запуском в CI.

Важно: npm install -g claude-mem ставит только SDK/библиотеку — без хуков и worker-сервиса. Всегда устанавливайте через npx claude-mem install.

Как это работает

Компоненты:

  1. 5 жизненных хуков — SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 hook-скриптов).
  2. Smart Install — кэширующий проверщик зависимостей (pre-hook, не жизненный цикл).
  3. Worker-сервис — локальный HTTP API с веб-просмотрщиком и поиском, управляется Bun.
  4. SQLite — хранение сессий, наблюдений и сводок (FTS5-поиск).
  5. mem-search Skill — естественно-языковые запросы с прогрессивным раскрытием.
  6. Chroma Vector Database — гибридный семантический + ключевой поиск.

MCP-инструменты поиска

Поиск по памяти построен как токен-эффективный трёхслойный workflow:

  1. search — компактный индекс результатов с ID (~50–100 токенов за результат).
  2. timeline — хронологический контекст вокруг интересных результатов.
  3. get_observations — полные детали только для отфильтрованных ID (~500–1 000 токенов за результат).
// Шаг 1: ищем индекс
search(query="authentication bug", type="bugfix", limit=10)

// Шаг 2: смотрим контекст вокруг #123, #456
timeline(id=123)

// Шаг 3: тянем полные детали
get_observations(ids=[123, 456])

Фильтрация до загрузки деталей даёт ~10× экономию токенов на поиске по памяти.

Ключевые возможности

  • Persistent Memory — контекст переживает сессии.
  • Progressive Disclosure — слоистое извлечение памяти с видимой стоимостью в токенах.
  • Skill-Based Search — запрос истории проекта навыком mem-search.
  • Web Viewer UI — живой поток памяти по URL worker'а, печатается при старте.
  • Claude Desktop Skill — поиск памяти из диалогов Claude Desktop.
  • Privacy Control — теги <private> исключают чувствительное содержимое из хранения.
  • Context Configuration — тонкая настройка того, какой контекст инжектится.
  • Automatic Operation — ручное вмешательство не требуется.
  • Citations — ссылки на прошлые наблюдения по ID через worker API.

Конфигурация

Настройки хранятся в ~/.claude-mem/settings.json (создаётся с дефолтами при первом запуске): AI-модель, порт worker'а, каталог данных, уровень логов и параметры инжекции контекста.

Режим и язык задаются через CLAUDE_MEM_MODE — он управляет и поведением (code, chill, investigation), и языком наблюдений:

{
  "CLAUDE_MEM_MODE": "code--zh"
}

Доступные режимы: code (английский по умолчанию), code--zh (упрощённый китайский, встроен), code--ja (японский). Языковые режимы следуют паттерну code--[lang] (ISO 639-1). После смены режима нужен перезапуск Claude Code. Список всех режимов: ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/.

Системные требования

  • Node.js: 20.0.0 и выше
  • Claude Code: последняя версия с поддержкой плагинов
  • Bun: рантайм и менеджер процессов (ставится автоматически)
  • uv: Python-пакет-менеджер для векторного поиска (ставится автоматически)
  • SQLite 3: встроен для постоянного хранения

Веб-просмотрщик доступен по URL, который печатается при старте worker'а; там же можно смотреть все наблюдения с цитатами по ID.

Ветки релизов

Стабильные релизы выходят из main и публикуются в npm. core-dev и community-edge — ветки для ранних фиксов надёжности и интеграций сообщества, запускаются из исходников.

Лицензия

Apache License 2.0. Автор выбрал её, потому что durable-память агентов должна легко встраиваться в инструменты разработчика, локальных агентов, MCP-серверы, enterprise-системы, робототехнику и продакшен-harness'ы. Каталог ragtime/ тоже лицензирован под Apache 2.0.

Ссылки

Источник: https://github.com/thedotmack/claude-mem

Похожие материалы