Memori Grok Build lintas sesi: pengaturan dan batasan

Grok Build, agen terminal xAI, memiliki memori lintas sesi: agen dapat mengingat konvensi proyek, keputusan, dan langkah debugging yang berhasil, lalu menambahkannya ke konteks sesi baru tanpa perlu diingatkan. Fitur ini nonaktif secara default dan masih eksperimental—fitur ini dapat diaktifkan dengan satu pengaturan.

Deskripsi ini didasarkan pada panduan resmi di repositori xai-org/grok-build per 20 September 2026. Penulis artikel asli tidak menjalankan produknya: mekanismenya dijelaskan berdasarkan dokumentasi, bukan pengujian pribadi.

Informasi praktis tentang penggunaan Ailoot tersedia di dokumentasi.

Apa manfaat memori di Grok Build?#

Misalnya, dalam satu sesi Anda menjelaskan kepada agen bahwa proyek menggunakan indentasi dua spasi, migrasi basis data dijalankan dengan perintah terpisah, dan modul tertentu menangani pembayaran. Dalam sesi baru, Anda harus memberikan informasi ini lagi.

Dengan memori diaktifkan, Grok Build dapat:

• mengingat konvensi proyek yang pernah Anda jelaskan;
• menggunakan langkah debugging yang sudah berhasil;
• membawa keputusan arsitektur ke sesi berikutnya;
• menghindari pertanyaan ulang tentang hal yang sudah dijawab.

Fitur ini masih eksperimental dan nonaktif secara default. Sebelum Anda mengaktifkannya, perilaku agen tidak berubah.

Bagaimana cara mengaktifkan memori?#

Sekali saja, untuk satu proses:

GROK_MEMORY=1 grok

Variabel ini hanya berlaku untuk proses tersebut. Perintah export GROK_MEMORY=1 mempertahankan pengaturan di shell saat ini dan mengaktifkan memori untuk semua proses grok berikutnya dari shell itu—sampai sesi terminal berakhir atau Anda menjalankan export GROK_MEMORY=0.

Permanen, melalui konfigurasi. Tambahkan ini ke ~/.grok/config.toml:

[memory]
enabled = true

Di dalam sesi, tanpa memulai ulang: buka /memory dan tekan t.

Pengalih ini hanya berlaku untuk sesi saat ini dan tidak ditulis ke konfigurasi. Pengalih ini dapat digunakan untuk mengaktifkan atau menonaktifkan memori. Menonaktifkannya mencabut akses ke alat memori, tetapi tidak menghapus berkas dari disk; mengaktifkannya lagi akan membuka kembali penyimpanan. Pengalih ini tidak dapat mengesampingkan penonaktifan paksa memori untuk seluruh proses melalui GROK_MEMORY=0: /memory tetap tidak tersedia selama seluruh sesi.

Jika pengaturan ditentukan di beberapa tempat, urutan prioritasnya sebagai berikut:

• GROK_MEMORY=0 secara paksa menonaktifkan memori untuk seluruh proses dan memiliki prioritas tertinggi.
• enabled = false yang secara eksplisit ditetapkan di konfigurasi menonaktifkan memori, sekalipun pengaturan jarak jauh terkelola mengaktifkannya.
• Memori dapat diaktifkan dengan GROK_MEMORY=1, enabled = true di konfigurasi, atau pengaturan jarak jauh terkelola.
• Jika tidak ada pengaturan, memori nonaktif.

Catatan ditambahkan pada giliran pertama sesi. Jika Anda mengaktifkan memori di tengah pekerjaan dan ingin agen mulai menggunakan informasi proyek yang tersimpan, jalankan /new. Anda dapat memeriksa apakah memori aktif di keluaran grok inspect.

Apa yang dicatat Grok Build, dan di mana?#

Struktur direktori ~/.grok/memory/:

Hash singkat dari pengenal repositori ditambahkan ke nama direktori proyek. Remote origin dalam format “organisasi/repositori” digunakan untuk identifikasi, atau jalur direktori jika tidak ada repositori Git. Jadi, klona dan worktree (salinan kerja terpisah dari cabang Git) untuk repositori yang sama berbagi satu memori proyek: hal yang diingat agen di satu salinan tersedia di salinan lainnya.

Entri dibuat dengan empat cara:

1. Ringkasan otomatis di akhir sesi. Saat sesi berakhir, Grok Build menyimpan ringkasan layanan singkat ke log harian: jumlah pesan, hingga lima pertukaran substantif pertama, serta tanggal dan waktu. Ringkasan dibuat dari metadata tanpa panggilan model atau jeda. Sesi yang sangat singkat dilewati: jika jumlah pertukaran substantif kurang dari tiga atau teks Anda kurang dari 50 byte, entri tidak dibuat. Ringkasan tidak mencakup alat yang digunakan, jalur berkas, atau perintah. Ringkasan otomatis dapat dinonaktifkan dengan pengaturan session.save_on_end = false.
2. /flush—catatan terperinci atas permintaan. Dengan perintah ini, model merangkum poin terpenting dari sesi saat ini: keputusan, pola, langkah debugging, dan temuan API. Ringkasan ditulis ke log bertanggal dan diindeks untuk sesi berikutnya. Dokumentasi menyarankan menjalankan /flush sebelum pemadatan konteks, di akhir sesi debugging yang berhasil, dan setelah menemukan pola penting.
3. /remember—permintaan eksplisit untuk mengingat sesuatu. Ketik /remember always open PR links after sending atau beri tahu agen, “ingat bahwa...” Panel peninjauan terbuka sebelum entri ditulis: catatan hanya disimpan setelah Anda mengonfirmasi, dan Memory saved to ~/.grok/memory/MEMORY.md muncul di feed. Informasi proyek dimasukkan ke MEMORY.md proyek; informasi yang berlaku untuk semua proyek dimasukkan ke berkas global.
4. /dream—konsolidasi. Perintah ini mengelompokkan log dan catatan yang tersebar berdasarkan topik serta menghapus duplikat agar pencarian lebih akurat. Seperti /flush, konsolidasi dilakukan oleh model—model membaca entri yang terkumpul dan menulis ulangnya berdasarkan topik, jadi Anda sebaiknya meninjau hasilnya secara berkala dengan /memory. Tersedia pula mode otomatis: secara default, Grok Build memeriksa kondisinya saat mulai dan sekali setiap jam, lalu memulai konsolidasi jika setidaknya 24 jam telah berlalu dan sedikitnya 5 sesi telah terkumpul. Ambang batas dapat dikonfigurasi di bagian [memory.dream] pada konfigurasi.

Catatan dicari melalui indeks SQLite: secara default, indeks menggunakan pencarian teks penuh FTS5; jika model embedding dikonfigurasi, pencarian vektor semantik juga ditambahkan.

Bagaimana memori masuk ke sesi baru?#

Penyisipan awal menggunakan ambang pemilihan min_score = 0.9, yang dapat Anda ubah di bagian [memory.initial_injection]. Setelah pemadatan konteks otomatis, agen mencari memori lagi untuk memulihkan informasi yang mungkin telah dihapus dari konteks bersama pertukaran yang lebih lama.

Anda juga dapat langsung bertanya kepada agen, “Apa yang kamu ingat?” Agen akan mengelompokkan jawabannya berdasarkan sumber: preferensi global, pengetahuan proyek, dan riwayat sesi.

Entri sesi memiliki penanda kebaruan. Semakin lama usia entri log sesi, semakin tegas penandanya: “Periksa apakah ini masih berlaku sebelum mengandalkannya.” Berkas global dan MEMORY.md proyek tidak menerima penanda seperti ini: isinya dimaksudkan untuk penggunaan jangka panjang, jadi Anda perlu memantau sendiri keakuratannya.

Bagaimana cara melihat, mengedit, dan menghapus catatan?#

Perintah /memory di dalam sesi membuka jendela berisi semua berkas memori, yang dikelompokkan berdasarkan cakupan: global, proyek, dan sesi (dalam urutan kronologis terbalik). Daftar berkas ada di sebelah kiri, dan pratinjau hanya-baca untuk berkas yang dipilih ada di sebelah kanan.

Tombol yang berguna di ikhtisar:

Jendela ini dapat menghapus catatan dan berkas sesi satu per satu; jendela ini tidak dapat menghapus indeks MEMORY.md yang dihasilkan (global dan proyek).

Cara kedua adalah mengedit berkas secara langsung. Berkas tersebut berada di ~/.grok/memory/ dan dapat dibuka dengan editor apa pun. Perubahan di direktori dilacak: berkas yang dibuat dan diubah diindeks ulang, sedangkan berkas yang dihapus dikeluarkan dari indeks pada pencarian berikutnya.

Permintaan “lupakan snake_case” tidak menjamin hasil: model mencari dan menghapus entri yang cocok, tetapi beberapa entri mungkin terlewat. Untuk memastikan penghapusan, buka berkasnya (Anda dapat menyalin jalurnya dengan mudah menggunakan y di /memory) dan hapus entri tersebut secara manual. Anda dapat menghapus seluruh memori dari baris perintah: grok memory clear untuk memori proyek, grok memory clear --global untuk memori global, dan grok memory clear --all untuk keduanya.

Apa perbedaan memori dengan berkas instruksi repositori?#

Instruksi repositori dibagikan kepada semua orang yang mengerjakan proyek dan terlihat dalam kode serta riwayat perubahan. Memori bertambah selama sesi berlangsung, disimpan di mesin Anda, dan tidak diterbitkan dengan sendirinya.

Memori tidak menggantikan berkas instruksi. Aturan proyek umum yang diperlukan seluruh tim dan agen tetap sesuai disimpan di repositori. Kami memiliki panduan terpisah tentang penggunaan satu berkas instruksi untuk Claude Code, Codex, dan Cursor: AGENTS.md dan CLAUDE.md bersama-sama. Memori mempertahankan konteks pribadi: preferensi Anda, hal yang sudah dicoba, dan keputusan yang dicapai.

Claude menggunakan pembedaan serupa: kami menjelaskan perbedaan memori dengan CLAUDE.md dalam artikel Memori Claude dan CLAUDE.md. Untuk perbandingan alatnya sendiri, lihat Grok Build atau Claude Code.

Batasan dan cara memeriksa apakah memori berfungsi#

Perhatikan batasan berikut:

• Status eksperimental. Perintah, ambang batas, dan perilaku dapat berubah pada versi mendatang; periksa panduan memori repositori jika ada yang tidak berfungsi seperti yang diharapkan.
• Penyisipan awal di sesi baru. Setelah mengaktifkan memori, mulai bekerja dengan /new agar catatan tersimpan ditambahkan pada giliran pertama.
• Model menentukan hal yang penting. Model membuat ringkasan /flush dan memilih isi catatan. Setiap satu atau dua minggu, buka /memory dan tinjau catatan yang terkumpul; hapus apa pun yang tidak diperlukan.
• Jangan minta agen mengingat rahasia. Kunci, token, dan kata sandi tidak boleh disimpan dalam catatan jangka panjang: berkas di ~/.grok/memory/ disimpan sebagai teks biasa. Jika informasi sensitif tercatat, hapus dengan mengedit berkasnya.
• Memori proyek dibagikan di antara salinan repositori. Jika agen mengingat sesuatu di satu klona yang sudah kedaluwarsa untuk klona lain, pertimbangkan direktori bersama saat membersihkan catatan.

Jika memori tidak berfungsi:

1. Periksa keluaran grok inspect untuk memastikan bahwa memori aktif.
2. Pastikan GROK_MEMORY=0 atau konfigurasi tidak menonaktifkannya.
3. Untuk diagnostik, jalankan RUST_LOG=debug GROK_LOG_FILE=/tmp/grok.log grok dan periksa baris tentang memori di /tmp/grok.log.

Ringkasan singkat#

Memori Grok Build diaktifkan dengan GROK_MEMORY=1 atau [memory] enabled = true di ~/.grok/config.toml. Agar catatan ditambahkan pertama kali setelah diaktifkan, mulai sesi baru dengan /new. Agen menulis catatan ke ~/.grok/memory/: ringkasan sesi tanpa panggilan model, ringkasan terperinci dengan /flush, entri eksplisit dengan /remember setelah Anda mengonfirmasi, dan topik yang ditata dengan /dream. Lihat dan bersihkan catatan melalui /memory dan pengeditan berkas secara langsung. Fitur ini masih eksperimental, jadi periksa ambang batas dan perintah di panduan resmi serta tinjau catatan secara berkala.

Kunjungi Ailoot.