hipocampus — плагин

hipocampus дает агенту файловую память: индекс тем на 3000 токенов грузится в каждую сессию и подсказывает, что обсуждалось раньше

  • 211 ★ репозитория
  • Последний коммит
  • MIT
Плагин

Расширенный доступ

Почему такой уровень

  • Записывает файлы памяти в проект и правит настройки агента при инициализации
  • Содержимое журналов сессий уходит модели для сжатия и поиска, там могут быть секреты и решения по проекту
  • Поиск на базе qmd скачивает модели и занимает около 2 ГБ
Все причины и проверки

kevin-hs-sohn/hipocampus

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add plugins/hipocampus

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Записывает файлы памяти в проект и правит настройки агента при инициализации
  • Содержимое журналов сессий уходит модели для сжатия и поиска, там могут быть секреты и решения по проекту
  • Поиск на базе qmd скачивает модели и занимает около 2 ГБ

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

hipocampus — плагин и набор скиллов памяти для Claude Code, OpenCode, Codex и OpenClaw. Вся память хранится обычными файлами в проекте, никакой инфраструктуры не требуется. Установка идет одной командой, `npx hipocampus init` настраивает платформу и поиск. Память делится на три слоя. Горячий слой всегда загружается в сессию: файл `memory/ROOT.md` с индексом тем на около трех тысяч токенов, а также `SCRATCHPAD.md`, `WORKING.md` и `TASK-QUEUE.md`. У каждой темы указаны тип (project, feedback, user, reference) и возраст, поэтому агент видит, о чем он знает и насколько это свежо. Теплый слой читается по запросу: ежедневные журналы, `knowledge/` и `plans/`. Холодный слой ищется через гибрид BM25 и векторов на базе qmd либо через дерево сжатия от ежедневных записей к недельным, месячным и корневой. Записи сжимаются по порогам: короткие копируются дословно, длинные суммирует модель. Поправки пользователя и сведения о нем сохраняются дословно навсегда, а ссылочные записи после 30 дней без проверки получают пометку. При вопросе агент идет по трем шагам: индекс тем, выбор файлов по заголовкам и поиск по ключевым словам.

Для кого. Тем, кто ведет долгие проекты с Claude Code или OpenCode и устал напоминать агенту решения трехнедельной давности.

Подходит, если

  • Агент перерабатывает платежный поток, а решение о лимитах запросов принималось в другой сессии
  • Проект идет месяцами, и журналы сессий растут быстрее, чем их кто-то перечитает
  • Нужно, чтобы поправки к стилю и подходу сохранялись и не сжимались, пока не отменены
  • Память должна лежать обычными файлами в репозитории, которые видно и можно править руками
  • Хочется один набор памяти для Claude Code, OpenCode, Codex и OpenClaw

Не подходит, если

  • Нужна общая память для команды в облаке: данные лежат файлами одного проекта
  • Диск ограничен: векторный поиск требует около 2 ГБ, хотя режим `--no-vector` его обходит
  • Проект короткий, и хватает файла `CLAUDE.md` с правилами
  • Вы используете агента вне списка платформ: автоматическое определение платформы его не знает

Пример запроса к агенту

Перед правкой платежного модуля загляни в ROOT.md и скажи, какие решения о лимитах запросов и ретраях мы принимали раньше

Ограничения

  • Поддержаны Claude Code, OpenCode и OpenClaw, для Codex есть отдельный скилл. Платформу можно задать флагом `--platform`.
  • Векторный поиск требует около 2 ГБ на диске, режим `--no-vector` оставляет только BM25, а `--no-search` отключает поиск и оставляет дерево сжатия.
  • Длинные записи суммирует модель, поэтому сжатие тратит токены.
  • Результаты теста MemAware принадлежат автору: на трудном уровне метод набирает 8,0 процента, и автор связывает это с моделью, а не с размером индекса.

Как отключить. Плагин снимается через менеджер плагинов Claude Code. Память хранится файлами в проекте (`memory/`, `knowledge/`, `plans/`), эти папки удаляйте вручную, если не нужны. Строки в настройках агента, которые добавил `npx hipocampus init`, уберите руками.

Частые вопросы

Как поставить hipocampus в Claude Code?

Выполните `/plugin marketplace add kevin-hs-sohn/hipocampus` и `/plugin install hipocampus@kevin-hs-sohn/hipocampus`, затем запустите `npx hipocampus init`, чтобы настроить память в проекте.

Чем hipocampus отличается от обычного RAG?

RAG отвечает на запрос, а здесь индекс тем уже лежит в контексте и подсказывает связи, о которых никто не спрашивал. Поиск остается для точных деталей.

Что такое ROOT.md?

Сжатый индекс всей истории: активный контекст за неделю, недавние паттерны, итог по месяцам и перечень тем с типом и возрастом. Он занимает около трех тысяч токенов и загружается автоматически.

Можно ли обойтись без векторного поиска?

Да. Флаг `--no-vector` оставляет только BM25 и экономит около 2 ГБ, а `--no-search` оставляет одно дерево сжатия без поиска.

Какие платформы поддерживаются?

Claude Code, OpenCode и OpenClaw с автоопределением, для Codex отдельный скилл в каталоге платформ. Принудительный выбор делает флаг `--platform`.

Обсуждение

Вопросов и отзывов пока нет.

Плагины

Общая память для Claude Code, Codex и Cursor: решение из одной сессии находят в другом инструменте и на другой машине.

ПлагинРасширенный доступ118Звезды репозитория

Долговременная память агента в локальных Markdown-файлах с графом связей, семантическим поиском и MCP-доступом

MCP-серверРасширенный доступ4,5 тыс.Звезды репозитория
Официальный

Плагин Supermemory для Claude Code: долговременная память между сессиями с автоматическим поиском по подсказке, сохранением диалога и индексом кодовой базы

ПлагинШирокий доступ2,8 тыс.Звезды репозитория

Плагин долгой памяти: запоминает решения, предпочтения и состояние задач между сессиями и подмешивает в запрос только нужное

ПлагинШирокий доступ400Звезды репозитория

Локальная панель для Claude Code, Codex, Pi и OpenCode: изменения памяти ждут вашего решения, а после хода идет аудит

CLIРасширенный доступ178Звезды репозитория

Постоянная память для агентов: заметки хранятся карточками в markdown и находятся в начале следующей сессии.

MCP-серверРасширенный доступ144Звезды репозитория

Коротко о README

README открывается таблицей результатов теста MemAware на 900 вопросах и сравнением с поиском по BM25 и векторам. Затем излагает идею: нельзя искать то, о чем не знаешь, что знаешь. Разделы описывают три слоя памяти, умное сжатие, типы записей и порядок обращения к памяти.

Бейдж для README

Сообщить о проблеме

Foxx AIhipocampus
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.