Pamięć Grok Build między sesjami: ustawienia i ograniczenia

Grok Build, agent xAI działający w terminalu, ma pamięć między sesjami: może zapamiętywać konwencje projektowe, decyzje i skuteczne kroki debugowania, a następnie dodawać je do kontekstu nowej sesji bez przypominania. Ta funkcja jest domyślnie wyłączona i ma status eksperymentalny — można ją włączyć jednym ustawieniem.

Ten opis opiera się na oficjalnym przewodniku z repozytorium xai-org/grok-build, aktualnym na 20 września 2026 r. Autor oryginalnego artykułu nie uruchamiał produktu: mechanizm opisano na podstawie dokumentacji, a nie osobistych testów.

Praktyczne informacje o pracy z Ailoot znajdziesz w dokumentacji.

Co daje pamięć w Grok Build?#

Na przykład podczas jednej sesji wyjaśniasz agentowi, że projekt używa wcięć z dwóch spacji, migracje bazy danych uruchamia się osobnym poleceniem, a konkretny moduł obsługuje płatności. W nowej sesji musisz przekazać te informacje ponownie.

Po włączeniu pamięci Grok Build może:

• przypominać sobie wcześniej wyjaśnione konwencje projektowe;
• korzystać ze sprawdzonych już kroków debugowania;
• przenosić decyzje architektoniczne do kolejnych sesji;
• unikać ponownego pytania o rzeczy, na które już udzielono odpowiedzi.

Funkcja ma status eksperymentalny i jest domyślnie wyłączona. Dopóki jej nie włączysz, zachowanie agenta się nie zmieni.

Jak włączyć pamięć?#

Jednorazowo, na czas jednego uruchomienia:

GROK_MEMORY=1 grok

Zmienna obowiązuje tylko podczas tego uruchomienia. Polecenie export GROK_MEMORY=1 zachowuje ustawienie w bieżącej powłoce i włącza pamięć przy wszystkich kolejnych uruchomieniach grok z tej powłoki — do zakończenia sesji terminala albo wykonania polecenia export GROK_MEMORY=0.

Na stałe, przez konfigurację. Dodaj poniższy wpis do ~/.grok/config.toml:

[memory]
enabled = true

W trakcie sesji, bez ponownego uruchamiania: otwórz /memory i naciśnij t.

To przełączanie dotyczy tylko bieżącej sesji i nie jest zapisywane w konfiguracji. Możesz w ten sposób włączyć lub wyłączyć pamięć. Wyłączenie odbiera dostęp do narzędzi pamięci, ale nie usuwa plików z dysku; ponowne włączenie przywraca dostęp do pamięci. Przełącznik nie może jednak nadpisać wymuszonego wyłączenia pamięci dla całego procesu przez GROK_MEMORY=0: /memory pozostaje niedostępne przez całą sesję.

Jeśli ustawienia są określone w kilku miejscach, obowiązuje następująca kolejność priorytetów:

• GROK_MEMORY=0 wymusza wyłączenie pamięci dla całego procesu i ma najwyższy priorytet.
• Jawne enabled = false w konfiguracji wyłącza pamięć, nawet jeśli zarządzane ustawienie zdalne ją włącza.
• Pamięć można włączyć za pomocą GROK_MEMORY=1, ustawienia enabled = true w konfiguracji lub zarządzanego ustawienia zdalnego.
• Jeśli niczego nie określono, pamięć jest wyłączona.

Notatki są dodawane w pierwszym kroku sesji. Jeśli włączysz pamięć w trakcie pracy i chcesz, by agent zaczął korzystać z zapisanych informacji o projekcie, uruchom /new. Możesz sprawdzić, czy pamięć jest włączona, w wyniku polecenia grok inspect.

Co Grok Build zapisuje i gdzie?#

Struktura katalogu ~/.grok/memory/:

Do nazwy katalogu projektu dodawany jest krótki hash identyfikatora repozytorium. Do identyfikacji używany jest zdalny adres origin w formacie „organization/repository”, a jeśli nie ma repozytorium Git — ścieżka katalogu. Dzięki temu klony i worktree (osobne kopie robocze gałęzi Git) tego samego repozytorium korzystają ze wspólnej pamięci projektu: to, co agent zapamięta w jednej kopii, będzie dostępne w drugiej.

Wpisy powstają na cztery sposoby:

1. Automatyczne podsumowanie na koniec sesji. Po zakończeniu sesji Grok Build zapisuje w dzienniku dziennym krótkie podsumowanie systemowe: liczbę wiadomości, maksymalnie pięć pierwszych merytorycznych wymian oraz datę i godzinę. Podsumowanie powstaje na podstawie metadanych, bez wywołania modelu i bez opóźnienia. Bardzo krótkie sesje są pomijane: wpis nie powstaje, jeśli odbyły się mniej niż trzy merytoryczne wymiany lub Twój tekst miał mniej niż 50 bajtów. Podsumowanie nie zawiera użytych narzędzi, ścieżek plików ani poleceń. Automatyczne podsumowania można wyłączyć ustawieniem session.save_on_end = false.
2. /flush — szczegółowa notatka na żądanie. Za pomocą tego polecenia model podsumowuje najważniejsze punkty bieżącej sesji: decyzje, wzorce, kroki debugowania i ustalenia dotyczące API. Podsumowanie trafia do dziennika z datą i jest indeksowane na potrzeby przyszłych sesji. Dokumentacja zaleca uruchamiać /flush przed kompresją kontekstu, na końcu udanej sesji debugowania oraz po odkryciu ważnych wzorców.
3. /remember — jawna prośba o zapamiętanie czegoś. Wpisz /remember zawsze otwieraj linki do PR po ich wysłaniu albo powiedz agentowi: „pamiętaj, że…”. Przed zapisaniem wpisu otworzy się panel weryfikacji: notatka zostanie zachowana dopiero po potwierdzeniu, a w kanale pojawi się komunikat Memory saved to ~/.grok/memory/MEMORY.md. Informacje o projekcie trafiają do jego pliku MEMORY.md, a informacje wspólne dla wszystkich projektów — do pliku globalnego.
4. /dream — porządkowanie. Polecenie grupuje rozproszone dzienniki i notatki według tematów oraz usuwa duplikaty, by zwiększyć trafność wyszukiwania. Podobnie jak /flush, porządkowanie wykonuje model — odczytuje zgromadzone wpisy i przepisuje je w grupach tematycznych, dlatego warto co jakiś czas sprawdzać wynik za pomocą /memory. Dostępny jest też tryb automatyczny: domyślnie Grok Build sprawdza warunki przy uruchomieniu i raz na godzinę, a porządkowanie rozpoczyna, gdy minęły co najmniej 24 godziny i zgromadziło się co najmniej 5 sesji. Progi można skonfigurować w sekcji [memory.dream] pliku konfiguracyjnego.

Notatki są wyszukiwane przez indeks SQLite: domyślnie używa on wyszukiwania pełnotekstowego FTS5, a jeśli skonfigurowano model osadzeń, dodawane jest semantyczne wyszukiwanie wektorowe.

Jak pamięć trafia do nowej sesji?#

Przy pierwszym wczytywaniu stosowany jest próg wyboru min_score = 0.9, który możesz zmienić w sekcji [memory.initial_injection]. Po automatycznej kompresji kontekstu agent ponownie przeszukuje pamięć, by przywrócić informacje, które mogły zostać usunięte wraz ze starszymi wymianami.

Możesz też bezpośrednio zapytać agenta: „Co pamiętasz?”. Pogrupuje odpowiedź według źródła: preferencje globalne, wiedza o projekcie i historia sesji.

Wpisy sesji mają oznaczenia aktualności. Im starszy wpis w dzienniku sesji, tym wyraźniej jest oznaczony: „Zanim na tym polegniesz, sprawdź, czy to nadal jest aktualne”. Globalne i projektowe pliki MEMORY.md nie otrzymują takich oznaczeń: ich zawartość ma służyć przez dłuższy czas, więc samodzielnie musisz kontrolować jej aktualność.

Jak przeglądać, edytować i usuwać notatki?#

Polecenie /memory w sesji otwiera okno ze wszystkimi plikami pamięci, pogrupowanymi według zakresu: globalne, projektowe i sesje (w odwrotnej kolejności chronologicznej). Po lewej znajduje się lista plików, a po prawej podgląd wybranego pliku tylko do odczytu.

Przydatne klawisze w przeglądzie:

W tym oknie można usuwać pojedyncze notatki i pliki sesji, ale nie wygenerowane indeksy MEMORY.md (globalny i projektowe).

Drugą metodą jest bezpośrednia edycja plików. Znajdują się w ~/.grok/memory/ i można je otworzyć w dowolnym edytorze. Zmiany w katalogu są śledzone: nowe i zmodyfikowane pliki są ponownie indeksowane, a usunięte pliki znikają z indeksu podczas kolejnego wyszukiwania.

Prośba „zapomnij o snake_case” nie daje gwarancji: model wyszukuje pasujące wpisy i je usuwa, ale może część pominąć. Aby mieć pewność, otwórz plik (ścieżkę możesz łatwo skopiować, naciskając y w /memory) i ręcznie usuń wpis. Możesz też całkowicie wyczyścić pamięć z wiersza poleceń: grok memory clear dla pamięci projektu, grok memory clear --global dla pamięci globalnej oraz grok memory clear --all dla obu.

Czym pamięć różni się od pliku z instrukcjami repozytorium?#

Instrukcje repozytorium są współdzielone przez wszystkich pracujących nad projektem i widoczne w kodzie oraz historii zmian. Pamięć rośnie w trakcie sesji, jest przechowywana na Twoim komputerze i nie jest samodzielnie publikowana.

Pamięć nie zastępuje pliku z instrukcjami. Ogólne zasady projektu potrzebne całemu zespołowi i każdemu agentowi nadal warto umieścić w repozytorium. Osobny przewodnik wyjaśnia, jak korzystać z jednego pliku instrukcji dla Claude Code, Codex i Cursor: AGENTS.md i CLAUDE.md razem. Pamięć zachowuje kontekst osobisty: Twoje preferencje, wcześniejsze próby i podjęte decyzje.

Claude stosuje podobne rozróżnienie: w artykule Pamięć Claude i CLAUDE.md wyjaśniamy, czym pamięć różni się od CLAUDE.md. Porównanie samych narzędzi znajdziesz w artykule Grok Build czy Claude Code.

Ograniczenia i sprawdzanie, czy pamięć działa#

Pamiętaj o następujących ograniczeniach:

• Status eksperymentalny. Polecenia, progi i zachowanie mogą się zmienić w przyszłych wersjach; jeśli coś nie działa zgodnie z oczekiwaniami, sprawdź przewodnik po pamięci w repozytorium.
• Pierwsze wczytanie w nowej sesji. Po włączeniu pamięci rozpocznij pracę od /new, aby zapisane notatki zostały dodane w pierwszym kroku.
• Model decyduje, co jest istotne. Model tworzy podsumowanie /flush i wybiera, co trafi do notatki. Co tydzień lub dwa otwieraj /memory, przeglądaj zgromadzone treści i usuwaj niepotrzebne.
• Nie proś o zapamiętywanie sekretów. Klucze, tokeny i hasła nie powinny trafiać do notatek przechowywanych przez dłuższy czas: pliki w ~/.grok/memory/ są zapisywane jako zwykły tekst. Jeśli zapisano coś poufnego, usuń to, edytując plik.
• Pamięć projektu jest współdzielona między kopiami repozytorium. Jeśli agent zapamięta coś w jednym klonie, a w innym będzie to nieaktualne, uwzględnij współdzielony katalog podczas porządkowania.

Jeśli pamięć nie działa:

1. Sprawdź wynik grok inspect, aby potwierdzić, że pamięć jest włączona.
2. Sprawdź, czy GROK_MEMORY=0 albo konfiguracja jej nie wyłącza.
3. W celach diagnostycznych uruchom RUST_LOG=debug GROK_LOG_FILE=/tmp/grok.log grok i sprawdź wiersze dotyczące pamięci w /tmp/grok.log.

Krótkie podsumowanie#

Pamięć Grok Build można włączyć za pomocą GROK_MEMORY=1 albo ustawienia [memory] enabled = true w ~/.grok/config.toml. Aby po włączeniu wczytać notatki po raz pierwszy, rozpocznij nową sesję poleceniem /new. Agent zapisuje notatki w ~/.grok/memory/: podsumowania sesji bez wywołania modelu, szczegółowe podsumowania za pomocą /flush, jawne wpisy za pomocą /remember po Twoim potwierdzeniu oraz uporządkowane tematy za pomocą /dream. Notatki można przeglądać i porządkować przez /memory oraz bezpośrednią edycję plików. Funkcja ma status eksperymentalny, dlatego sprawdzaj progi i polecenia w oficjalnym przewodniku oraz regularnie przeglądaj notatki.

Do systematycznej pracy przydatne jest połączenie klon AI + Drugi Mózg + Inżynieria Kontekstu.

Otwórz Ailoot.