Память Grok Build между сессиями: как включить и что агент записывает

У терминального агента Grok Build от xAI есть память между сессиями: он может запомнить соглашения проекта, принятые решения и удачные шаги отладки, а в новой сессии подставить их в контекст без напоминаний. По умолчанию функция выключена и имеет статус экспериментальной - включается одной настройкой.

Описание сверено с официальным руководством в репозитории xai-org/grok-build 20 сентября 2026 года. Сам продукт мы не запускали: механику описываем по документации, а не по собственному тесту.

В Telegram-канале - что нового в вайб-кодинге: инструменты, находки, ошибки. Подпишись, чтобы не пропускать новое.

Что даёт память в Grok Build?

Например, в одной сессии ты объяснил агенту, что в проекте отступы в два пробела, миграции базы запускаются отдельной командой, а за оплату отвечает конкретный модуль. В новой сессии эти сведения приходится передавать заново.

С включённой памятью Grok Build может:

• вспоминать соглашения проекта, которые ты объяснял раньше;
• использовать шаги отладки, которые уже сработали;
• переносить архитектурные решения в следующие сессии;
• не переспрашивать то, на что уже есть ответ.

Функция экспериментальная и по умолчанию выключена. Пока ты её не включил, поведение агента не меняется.

Как включить память?

Разово, на один запуск:

GROK_MEMORY=1 grok

Так переменная действует только на этот запуск. Команда export GROK_MEMORY=1 оставит её в текущей оболочке и включит память во всех следующих запусках grok из неё - до конца сеанса терминала или export GROK_MEMORY=0.

Постоянно, через конфиг. В файле ~/.grok/config.toml добавь:

[memory]
enabled = true

Внутри сессии, без перезапуска: открой /memory и нажми t.

Такое переключение действует только на текущую сессию и в конфиг не записывается. Оно позволяет как включить, так и выключить память. Выключение убирает доступ к инструментам памяти, но сами файлы с диска не удаляет; повторное включение заново открывает хранилище. Переключение не отменяет принудительное отключение памяти для всего процесса через GROK_MEMORY=0: с ним /memory недоступна всю сессию.

Если настройки заданы в нескольких местах, действует следующий приоритет:

• GROK_MEMORY=0 принудительно отключает память для всего процесса и имеет высший приоритет.
• Явное enabled = false в конфиге отключает память, даже если управляемая удалённая настройка её включает.
• Включить память можно через GROK_MEMORY=1, enabled = true в конфиге или управляемую удалённую настройку.
• Если ничего не задано, память выключена.

Заметки подставляются на первом ходу сессии. Если ты включил память посреди работы и хочешь, чтобы агент начал с учётом сохранённых сведений о проекте, выполни /new. Проверить, включилась ли память, можно в выводе grok inspect.

Что и куда Grok Build записывает?

Структура каталога ~/.grok/memory/:

К имени проектного каталога добавляется короткий хеш идентификатора репозитория. Для идентификации используется origin remote в форме «организация/репозиторий», а если git-репозитория нет - путь к каталогу. Поэтому клоны и worktree (отдельные рабочие копии веток git) одного репозитория делят одну проектную память: что агент запомнил в одной копии, доступно в другой.

Записи появляются четырьмя путями:

1. Автосводка в конце сессии. Когда сессия завершается, Grok Build сохраняет в дневной журнал короткую служебную сводку: количество сообщений, до пяти первых содержательных реплик, дату и время. Сводка строится из метаданных без вызова модели и без задержки. Совсем короткие сессии пропускаются: меньше трёх содержательных реплик или меньше 50 байт твоего текста - и записи не будет. В сводку не попадают использованные инструменты, пути файлов и команды. Автосводка отключается настройкой session.save_on_end = false.
2. /flush - подробная заметка по запросу. По этой команде модель составляет резюме самого важного из текущей сессии: решения, закономерности, шаги отладки, находки по API. Резюме пишется в датированный журнал и индексируется для будущих сессий. Документация советует делать /flush перед сжатием контекста, в конце удачной отладки и после обнаружения важных закономерностей.
3. /remember - явная просьба запомнить. Пиши /remember всегда открывать ссылки на PR после отправки или скажи агенту «запомни, что...». Перед записью открывается панель проверки: заметка сохраняется только после твоего подтверждения, и в ленте появляется Memory saved to ~/.grok/memory/MEMORY.md. Сведения о проекте попадают в проектный MEMORY.md, общие для всех проектов - в глобальный.
4. /dream - консолидация. Команда собирает разрозненные журналы и заметки по темам и убирает дубли, чтобы сделать поиск точнее. Как и /flush, консолидацию выполняет модель - она читает накопленные записи и переписывает их в темы, поэтому итог стоит периодически просматривать через /memory. Есть и автоматический режим: по умолчанию Grok Build проверяет условия при запуске и раз в час, а консолидацию запускает, когда прошло минимум 24 часа и накопилось минимум 5 сессий. Пороги настраиваются в секции [memory.dream] конфига.

Поиск по заметкам работает через SQLite-индекс: по умолчанию полнотекстовый FTS5, а если настроена embedding-модель, добавляется векторный поиск по смыслу.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - инструменты, метод, первый проект

Старт 22–24 сентября  ·  2 000 ₽

Записаться →

Как память попадает в новую сессию?

Для первой подстановки действует порог отбора min_score = 0.9, его можно поменять в секции [memory.initial_injection]. После автоматического сжатия контекста агент снова обращается к памяти, чтобы вернуть сведения, которые могли быть удалены из контекста вместе со старыми репликами.

Спросить агента напрямую тоже можно: «что ты помнишь?» - и он сгруппирует ответ по источникам: глобальные предпочтения, проектные знания, история сессий.

У сессионных записей есть пометки об устаревании. Чем старше запись из журнала сессии, тем настойчивее пометка «проверь актуальность, прежде чем полагаться». Глобальный и проектный MEMORY.md таких пометок не получают: эти сведения рассчитаны на долгое использование, за их актуальностью нужно следить самостоятельно.

Как посмотреть, поправить и удалить заметки?

Команда /memory в сессии открывает окно со всеми файлами памяти, сгруппированными по областям: глобальная, проектная, сессии (в обратном хронологическом порядке). Слева - список файлов, справа - предпросмотр выбранного, только для чтения.

Полезные клавиши внутри обзора:

Через окно удаляются отдельные заметки и файлы сессий; сгенерированные индексы MEMORY.md (глобальный и проектный) через окно не удаляются.

Второй способ - прямая правка. Файлы лежат в ~/.grok/memory/ и открываются любым редактором. Изменения в каталоге отслеживаются: созданные и изменённые файлы переиндексируются, удалённые выпадают из индекса при следующем поиске.

Просьба «забудь про snake_case» срабатывает без гарантии: модель ищет и убирает подходящие записи, но может что-то пропустить. Для гарантированного удаления открой файл (путь удобно скопировать клавишей y в /memory) и удали запись вручную. Полностью очистить память можно из командной строки: grok memory clear для проектной, grok memory clear --global для глобальной, grok memory clear --all для обеих.

Чем память отличается от файла инструкций в репозитории?

Инструкция в репозитории - общая для всех, кто работает с проектом, её видно в коде и в истории изменений. Память пополняется по ходу сессий, хранится на твоей машине и никуда не публикуется сама по себе.

Память не заменяет файл инструкций. Общие правила проекта, которые нужны всей команде и любому агенту, по-прежнему разумно держать в репозитории. Про один файл инструкций для Claude Code, Codex и Cursor у нас есть отдельный гайд: AGENTS.md и CLAUDE.md вместе. Память же сохраняет личный контекст: твои предпочтения, что уже пробовали, к какому решению пришли.

Похожее разделение есть и у Claude: чем память отличается от CLAUDE.md, разбираем в статье память Claude и CLAUDE.md. Выбор между самими инструментами - в обзоре Grok Build или Claude Code.

Ограничения и проверка работы памяти

Учитывай следующие ограничения:

• Экспериментальный статус. Команды, пороги и поведение могут измениться в следующих версиях; сверяйся с руководством по памяти в репозитории, если что-то работает не так.
• Первая подстановка в новой сессии. Включил память - начни работу с /new, чтобы сохранённые заметки подставились на первом ходу.
• Модель решает, что важно. Резюме по /flush создаёт модель, она же выбирает, что попадёт в заметку. Раз в неделю-две открывай /memory и вычитывай, что накопилось; лишнее удаляй.
• Секреты не проси запоминать. Ключи, токены и пароли в долгоживущих заметках не нужны: файлы лежат в открытом виде в ~/.grok/memory/. Если что-то чувствительное всё же записалось - удали правкой файла.
• Проектная память общая для копий репозитория. Если в одном клоне агент запомнил что-то неактуальное для другого, учитывай общий каталог при чистке.

Если память не работает:

1. Убедись в выводе grok inspect, что память включена.
2. Проверь, что GROK_MEMORY=0 или конфиг её не выключают.
3. Для диагностики запусти RUST_LOG=debug GROK_LOG_FILE=/tmp/grok.log grok и посмотри строки про memory в /tmp/grok.log.

Короткий итог

Память Grok Build включается через GROK_MEMORY=1 или [memory] enabled = true в ~/.grok/config.toml. Для первой подстановки заметок после включения начни новую сессию командой /new. Агент пишет заметки в ~/.grok/memory/: сводки сессий без вызова модели, подробные резюме через /flush, явные записи через /remember с твоим подтверждением и упорядоченные темы через /dream. Смотреть и чистить - через /memory и прямую правку файлов. Функция экспериментальная, поэтому пороги и команды сверяй с официальным руководством, а заметки периодически вычитывай.

Полная схема вайб-кодинга за три вечера: ИИ-клон + Второй мозг + Контекст-инжиниринг. Записи эфиров в личном кабинете, доступ 30 дней.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - инструменты, метод, первый проект

Старт 22–24 сентября  ·  2 000 ₽

Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Подписаться в Telegramили на email