# Memori Grok Build lintas sesi: pengaturan dan batasan
> Cara mengaktifkan memori, tempat catatan disimpan, dan cara kerja /flush, /remember, /dream, dan /memory. Prioritas pengaturan, pemeriksaan, dan penghapusan entri.
Source: https://ailoot.ai/blog/id/grok-build-memory/
Canonical: https://ailoot.ai/blog/id/grok-build-memory/
Language: id
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-111
Revision: sha256-a22379b05b8ea591cccc216888ef7bde2119d80cc5555c5c11b3d43b83dfe231
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](https://ailoot.ai/docs/).
## Apa manfaat memori di Grok Build?
Poin utama
Tanpa memori, sesi Grok Build yang baru tidak menerima informasi dari sesi sebelumnya: baik konvensi yang Anda jelaskan maupun keputusan yang Anda buat, kecuali jika dicatat dalam berkas instruksi repositori. Jika memori diaktifkan, agen mencari catatan yang tersimpan dan otomatis menambahkan catatan yang relevan ke konteks sesi baru. Catatan disimpan sebagai berkas Markdown biasa yang dapat Anda baca dan edit.
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?
Poin utama
Untuk satu kali proses, tetapkan variabel lingkungan `GROK_MEMORY=1`. Agar tetap aktif, tambahkan bagian `[memory]` dengan `enabled = true` ke `~/.grok/config.toml`. Agar catatan tersimpan ditambahkan saat mulai bekerja, mulai sesi baru dengan `/new` setelah mengaktifkan memori.
**Sekali saja, untuk satu proses:**
```bash
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`:
```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?
Poin utama
Catatan disimpan di `~/.grok/memory/` sebagai berkas Markdown: satu `MEMORY.md` global untuk semua proyek, satu `MEMORY.md` terpisah untuk setiap proyek, dan log sesi. Ringkasan otomatis di akhir sesi ditulis tanpa panggilan model, catatan terperinci dibuat dengan `/flush` dan `/remember`, sedangkan `/dream` mengelompokkan entri yang tersebar berdasarkan topik.
Struktur direktori `~/.grok/memory/`:
| Lokasi | Cakupan | Isi |
|----|----|----|
| `~/.grok/memory/MEMORY.md` | Global | Fakta dan preferensi untuk semua proyek Anda |
| `~/.grok/memory/` + direktori proyek dengan hash + `/MEMORY.md` | Proyek | Konvensi dan konteks untuk repositori tertentu |
| `~/.grok/memory/` + direktori proyek dengan hash + `/sessions/` | Sesi | Ringkasan dan log sesi individual |
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?
Poin utama
Pada giliran pertama sesi, Grok Build mencari entri memori yang terkait dengan proyek dan otomatis menambahkannya ke konteks—Anda tidak perlu mengingatkannya. Pencarian dijalankan lagi setelah pemadatan konteks otomatis. Entri sesi yang lebih lama ditandai untuk pemeriksaan kebaruan.
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?
Poin utama
Perintah `/memory` membuka ikhtisar semua berkas memori beserta pratinjaunya. Anda dapat mengedit berkas dengan editor teks apa pun—perubahan akan digunakan dalam pencarian berikutnya. Permintaan “lupakan ...” tidak menjamin penghapusan; untuk menghapus entri tertentu secara andal, edit berkasnya.
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:
| Tombol | Tindakan |
|----|----|
| `↑`/`↓` atau `j`/`k` | Berpindah dalam daftar |
| `/` | Memfilter daftar |
| `y` | Menyalin jalur ke berkas yang dipilih |
| `x` | Menghapus catatan yang dipilih (tekan lagi untuk mengonfirmasi) |
| `t` | Mengaktifkan atau menonaktifkan memori |
| `Esc` | Menutup jendela |
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?
Poin utama
Anda menulis berkas instruksi seperti CLAUDE.md atau AGENTS.md dan meletakkannya di repositori—berkas ini dibagikan kepada tim melalui Git. Agen Grok Build mengelola catatan memori dan menyimpannya di `~/.grok/memory/`, di luar repositori: catatan tersebut bersifat pribadi dan tidak dibagikan melalui Git.
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](https://ailoot.ai/blog/id/agents-md-claude-md-one-instruction-file/). 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](https://ailoot.ai/blog/id/claude-memory-claude-md-auto-memory/). Untuk perbandingan alatnya sendiri, lihat [Grok Build atau Claude Code](https://ailoot.ai/blog/id/grok-build-vs-claude-code/).
## Batasan dan cara memeriksa apakah memori berfungsi
Poin utama
Fitur ini eksperimental: perintah dan pengaturannya dapat berubah. Agar catatan ditambahkan pada giliran pertama setelah memori diaktifkan, mulai sesi baru dengan `/new`. Beberapa entri dibuat oleh model, jadi tinjau catatan secara berkala dan minta agen untuk tidak mengingat rahasia.
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.
### Sumber
- Grok Build, panduan resmi “Cross-Session Memory” (panduan pengguna, bab 13):
- Grok Build, repositori xAI di GitHub:
[Kunjungi Ailoot](https://ailoot.ai/).
## Pertanyaan tentang Memori Grok Build lintas sesi: pengaturan dan batasan
### Mengapa catatan tersimpan tidak muncul setelah memori diaktifkan?
Catatan tersimpan ditambahkan pada giliran pertama sesi baru. Mulai sesi baru setelah mengaktifkan memori dan periksa keadaan yang dilaporkan dengan grok inspect; proses yang dimulai dengan GROK_MEMORY=0 tidak dapat mengaktifkannya melalui tombol sesi.
### Apakah mematikan memori menghapus filenya?
Tidak. Menonaktifkan memori menghapus akses ke alatnya tetapi membiarkan catatan Markdown pada disk. Periksa atau edit catatan tersimpan secara terpisah jika perlu menghapus entri.
## Ailoot · Perusahaan dan portofolio proyeknya
Ailoot bertumpu pada pengalaman operasional yang teruji, basis pelanggan yang besar, layanan yang stabil, dan pemantauan KPI berkelanjutan.
Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan.
Ailoot memanfaatkan pengalaman operasional ini untuk akses API ke fitur AI dalam produk pelanggan, agen, aplikasi, dan otomatisasi.