Memory Sidecar CLI
Внешняя память для Hermes, Claude Code, Codex и Cursor: архив сессий, слои recall, возврат нужного в контекст без правки агента
- 208 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Установщик в режиме по умолчанию ставит зависимости и регистрирует блок cron
- Сайдкар читает и архивирует сессии агента, а они содержат код и контекст проектов
- Память возвращается в контекст агента автоматически
Установка
- Работает в
Ручная установка
Выполни `git clone https://github.com/mage0535/hermes-memory-installer.git`, задай `AGENT_HOME` для агента и запусти `./install.sh --install-mode 1`, чтобы только проверить зависимости. Покажи пользователю план и после его согласия запусти `./install.sh`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установщик в режиме по умолчанию ставит зависимости и регистрирует блок cron
- Сайдкар читает и архивирует сессии агента, а они содержат код и контекст проектов
- Память возвращается в контекст агента автоматически
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Memory Sidecar работает рядом с агентом и не меняет его ядро. Он читает каталог данных агента (`state.db` и файлы сессий), архивирует сессии, строит долгосрочные знания и возвращает релевантные куски в контекст. Память делится на горячий, теплый и холодный слои плюс куратные заметки, а между ними идет послойный recall. Стек опирается на Hindsight, `gbrain` и PostgreSQL. Установщик `install.sh` читает путь из `AGENT_HOME`, а три режима `--install-mode` доходят от автоматической установки зависимостей до режима только обнаружения. Состояние машиночитаемое: система пишет артефакты здоровья, метрики качества памяти, оценки с трендами и план для `gbrain` в режиме dry-run. Для наблюдения в репозитории лежат конфигурации Prometheus и Grafana.
Для кого. Тем, кто сам разворачивает долгоживущего агента (Hermes Agent, Claude Code или Codex) на своем сервере и хочет наблюдаемую память с метриками вместо одного файла заметок.
Подходит, если
- Работа тянется через много сессий и проектов, и один файл памяти перестал вмещать нужное
- Нужно знать, когда память архивировалась, как часто recall пригодился и что просело
- Агент нельзя менять, а долгосрочная память должна работать рядом с ним
- Для пользователей агента требуется приватный стек без чужих серверов
Не подходит, если
- Агент один и сессий мало: хватит файла `CLAUDE.md` или встроенной памяти
- Нет PostgreSQL 16, Hindsight и `gbrain`, а ставить три сервиса ради памяти не хочется
- Установка на рабочий компьютер без права менять cron и системные пакеты
Пример запроса к агенту
Поставь Memory Sidecar для моего агента и покажи, какие зависимости не хватает, не меняя систему.Ограничения
Нужны Python 3.9 или новее, PostgreSQL 16, запущенные Hindsight и `gbrain` и каталог данных агента со `state.db`. Режим установки по умолчанию `--install-mode 3` сам пытается поставить зависимости: сначала читайте план в режиме `1` или `2`. Репозиторий ориентирован на технических пользователей со своим стеком Hindsight, `gbrain` и PostgreSQL. В README есть блок с версией 3.5.2 и версией 3.5.1, номера в тексте различаются. Последний коммит в репозитории датирован июлем 2026 года.
Как отключить. Остановите задания cron, которые добавил установщик, удалите `$AGENT_HOME/memory-sidecar` и скрипты из `$AGENT_HOME/scripts`. Базы PostgreSQL и сервисы Hindsight и gbrain удаляются отдельно.
Частые вопросы
Как установить Memory Sidecar?
Клонируйте репозиторий, задайте `AGENT_HOME` (например `~/.hermes` или `~/.claude`) и запустите `./install.sh`. Режим без вопросов: `./install.sh --noninteractive --agent-home "$HOME/.my-agent"`.
Что делают режимы установки?
Режим 3 по умолчанию сам ставит зависимости. Режим 2 показывает команды и идет по шагам, режим 1 только проверяет и ничего не меняет.
С какими агентами работает?
Hermes Agent, Claude Code, Codex и локальные агенты в стиле Codex или Cursor с общим каталогом данных. Условие одно: в каталоге есть `state.db` и файлы сессий.
Что нужно запустить заранее?
PostgreSQL 16, Hindsight и `gbrain`, которые достижимы по сети. Без них память не построится.
Уходят ли данные в облако?
В README описана публичная архитектура без путей и ключей конкретного сервера, а в `PRIVACY.md` есть отдельная политика. Проверьте ее: данные сессий обрабатывает ваш стек.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыОбщая локальная память для ИИ-агентов: Claude Code, Codex, Cursor и другие находят в ней договоренности прошлых сессий и записывают новые
Долговременная память агента в папке связанных markdown-заметок, чтобы Claude Code помнил проект между сессиями
Общая память для ИИ-агентов на нескольких машинах: факт, записанный одним агентом, появляется у остальных без сервера посередине
memory.cpp собирает из истории репозитория компактный контекст для агента и убирает устаревшее, секреты и противоречия
Долговременная память для агентов: удаленный MCP-сервер, плагины для Claude Code, Cursor и Codex и API для своих приложений
Двойная память для агентов: граф знаний на вашей машине, поиск по запросу и подсказки до запроса, сквозные между сессиями.
Коротко о README
README объясняет, что это внешняя память рядом с агентом, зачем она сделана и по каким принципам: не трогать ядро агента, использовать стабильные границы данных, сочетать слои recall. Дальше идут требования, быстрый старт и режимы установки.