Hindsight сам пишет вики о вашем репозитории. Нужна ли Claude Code такая память?

4 520 звёзд за сутки. Столько 28 сентября 2026 собрал на GitHub репозиторий vectorize-io/hindsight, почти вдвое больше, чем Paperclip, оркестратор агентов, который стоит в том же списке первым. Hindsight это память для агентов, и её авторы с первой строки README спорят с привычной идеей памяти: большинство систем учат агента вспоминать разговоры, а они хотят, чтобы агент учился.

Для тех, кто работает в Claude Code, это звучит знакомо. Сессия закончилась, контекст ушёл, и назавтра модель снова не знает, почему в проекте округляют только итог счёта, а не каждую строку. Одну версию решения мы уже разбирали: claude-mem записывает, что происходило в сессии, и подкладывает нужное в следующую. Hindsight пробует запомнить другое: не что вы делали, а почему так решили.

Что такое Hindsight и чем память отличается от истории чата

Внутри Hindsight четыре вида памяти. Факты о мире («в проекте Next.js 15»). Опыт самого агента («я перенёс округление в finalize()»). Наблюдения: убеждения, которые система сводит фоном из многих фактов, с дословными цитатами-доказательствами и счётчиком подтверждений. И ментальные модели: готовые ответы на вопросы, которые вы задали банку один раз.

Самое интересное в наблюдениях то, что новое не затирает старое. Когда приходит свежий факт, наблюдение уточняется: укрепляется, ослабевает или дополняется. В демо из документации это выглядит так: вместо «когда-то кто-то писал про округление» агент получает «округляем один раз, до чётного, в InvoiceTotal.finalize(), три источника».

Ментальные модели в последних версиях выросли в страницы знаний. Это живые документы, которые банк пишет о себе: карта компонентов, соглашения, ключевые решения, текущие инициативы. Они лежат папками, как вики, по ним есть поиск, их можно выгрузить на диск обычным markdown. Чтение такой страницы это запрос к базе без поиска и без вызова LLM, поэтому агент стартует с готовой страницы, а не собирает контекст заново.

Retain, recall, reflect: как устроена память агента

Вся работа сводится к трём вызовам. retain принимает текст, и LLM вытаскивает из него факты, даты, сущности и связи. recall ищет четырьмя способами параллельно: по смыслу через векторы, по точным словам через BM25, по графу связей между сущностями и по времени. Результаты сливаются и переранжируются отдельной моделью, а потом обрезаются под лимит токенов. reflect не ищет, а рассуждает над банком: «какие риски у этого проекта», «почему одни письма клиентам работают, а другие нет».

docker run -p 8888:8888 -p 9999:9999 \
  -e HINDSIGHT_API_LLM_API_KEY=$OPENAI_API_KEY \
  ghcr.io/vectorize-io/hindsight:latest
# API на :8888, интерфейс на :9999, MCP на /mcp/{bank_id}/
client.retain(bank_id="shop", content="Итог счёта округляем до чётного")
client.recall(bank_id="shop", query="Как мы округляем?")
client.reflect(bank_id="shop", query="Что важно знать о деньгах в проекте?")

Модель для извлечения фактов можно взять почти любую: README называет больше 25 провайдеров, включая локальные Ollama и LM Studio. Есть и вариант без API-ключа: провайдер claude-code работает через вашу подписку Pro или Max.

Как подключить Hindsight к Claude Code и Codex

Здесь первая ловушка. Во многих инструкциях до сих пор стоит claude plugin install hindsight-memory. Этот плагин работает, но больше не развивается: его заменил пакет @vectorize-io/hindsight-coding-agents, один на все агенты.

npx @vectorize-io/hindsight-coding-agents install claude-code --server daemon
# или сразу всё, что найдёт на машине:
npx @vectorize-io/hindsight-coding-agents install all
# перенести прошлые сессии этого репозитория:
npx @vectorize-io/hindsight-coding-agents install claude-code --import-conversations

Для Claude Code установщик добавляет три хука в ~/.claude/settings.json, регистрирует MCP и ставит скилл, который объясняет агенту, как с этой памятью работать. Дальше всё идёт само. На старте сессии банк проекта наполняется историей git, на первом промпте в контекст попадает короткий вывод reflect по вашей задаче, после каждого ответа сессия уходит в банк. Как устроена память проекта в самом Claude Code, без плагинов, мы разбираем на курсе про постоянную память под каждый проект.

Главная находка этого пакета в том, что банк один на репозиторий и общий для всех агентов. То, что вы утром объяснили Claude Code, вечером знает Codex в том же проекте. Если у вас уже несколько агентов на одной кодовой базе, это снимает часть той боли, из-за которой ставят оркестраторы: каждый новый агент начинает с нуля.

94,6% на LongMemEval: что стоит за цифрой

На странице бенчмарков Hindsight называет себя первым на Agent Memory Benchmark по всем наборам. Цифры оттуда:

Первое, чего в выдаче не видно: Agent Memory Benchmark построила сама команда Hindsight, и в мартовском манифесте она прямо это пишет. В том же манифесте про LongMemEval сказано, что бенчмарки этого поколения «now mostly measure whether your LLM can read»: при окне в миллион токенов они проверяют скорее умение модели читать, чем память. Заголовочная цифра взята как раз оттуда.

Второе: чем больше объём памяти, тем ниже результат. На десяти миллионах токенов это 64,1%, больше трети ответов неверны. Для сравнения, декабрьская научная статья команды давала 91,4% на LongMemEval, то есть с декабря система выросла. Плюс README сообщает, что результаты воспроизвели исследователи Virginia Tech и The Washington Post, а цифры конкурентов в таблице заявлены самими вендорами.

Мы не считаем это поводом не пробовать. Команда сама объяснила, почему старые тесты устарели, и выложила открытый новый, где видны и сильные, и слабые места. Но «94,6%» в пересказах стоит читать как результат на коротких историях.

Hindsight или claude-mem

Инструменты похожи только снаружи.

Наше мнение, с которым можно спорить: если вы один работаете в Claude Code над одним-двумя проектами, claude-mem или память, настроенная руками в CLAUDE.md, дадут почти то же при меньших затратах. Hindsight окупается там, где агентов несколько или память нужна ещё и ассистенту поддержки, который должен помнить каждого клиента. Мы ошибаемся, если страницы знаний на ваших репозиториях окажутся точнее, чем CLAUDE.md, который вы ведёте сами: тогда он выигрывает и у одиночки.

Что включается само, если ничего не трогать

Пакет для кодовых агентов рассчитан на установку без настройки, и умолчания у него щедрые. Установщик спрашивает, где хранить память, и вариант по умолчанию это облако Hindsight Cloud: соглашаясь не глядя, вы отправляете сессии и историю git на внешний сервер. Память по умолчанию включается во всех проектах на машине. А в новом репозитории плагин сам запускает Claude haiku в фоне на обзор кода с лимитом $2 и повторяет обзор каждые 20 коммитов.

Всё это отключается и настраивается, просто решать лучше до первой сессии, а не после. В облаке хранение каждой записи бесплатно первые 30 дней, а операции оплачиваются по токенам: $10 за миллион на запись и $0,75 на поиск, reflect $0,05 за вызов. Свой сервер бесплатен, платите только за модель извлечения.

Версии и цены на 28 сентября 2026: Hindsight v0.10.1, 38 179 звёзд. С 7 августа по 21 сентября вышло пять релизов, поэтому проверяйте актуальные умолчания в документации.