ai-memory Hermes Agent: Tak Perlu Ulang Cerita

Apa yang dimaksud ai-memory Hermes Agent?

Dalam dokumentasi resmi, fitur ini disebut Persistent Memory, bukan nama perintah terpisah “ai-memory”. Ia menyimpan catatan terkurasi agar preferensi, lingkungan kerja, dan pelajaran penting dapat dibawa ke sesi berikutnya. Ada dua penyimpanan bawaan: MEMORY.md untuk catatan agen dan USER.md untuk profil pengguna. Keduanya berada di ~/.hermes/memories/, lalu dimuat sebagai snapshot ketika sesi baru dimulai.

Fitur tersebut berbeda dari riwayat percakapan penuh. Snapshot tidak berubah di tengah sesi; setelah menyimpan sesuatu, mulai sesi baru dengan /new atau jalankan CLI lagi agar catatan terbaru terbaca. Pada gateway, percakapan yang terus berjalan juga perlu batas sesi yang disengaja.

Mengaktifkan dan memeriksa status

Pastikan profilnya sama

Dokumentasi resmi mencantumkan memory.memory_enabled: true dan memory.user_profile_enabled: true sebagai default. Cek nilai nyata pada instalasi sahabat, karena konfigurasi profil dapat berbeda:

hermes config get memory.memory_enabled

hermes config get memory.user_profile_enabled

Jika salah satunya mati, aktifkan dengan kunci konfigurasi yang sama:

hermes config set memory.memory_enabled true

hermes config set memory.user_profile_enabled true

Periksa hasilnya lagi. Jangan menebak nama opsi lain; bila versi sahabat menolak kunci ini, cocokkan dengan dokumentasi versi terpasang. Untuk memastikan penulisan benar-benar terjadi, lihat isi file secara lokal:

cat ~/.hermes/memories/MEMORY.md

cat ~/.hermes/memories/USER.md

Pada profil selain default, jalurnya berada di direktori profil terkait, bukan otomatis di lokasi dasar. Gunakan profil yang sama saat memeriksa dan saat mengobrol.

Mengecek, merapikan, dan menghapus memori

Gunakan aksi yang tepat

Hermes tidak menyediakan aksi read pada tool memory; isi otomatis masuk ke konteks awal. Untuk perubahan, minta agen memakai aksi resmi add, patch, atau remove, dengan target memory untuk catatan agen dan user untuk profil. Contoh aman: “Simpan bahwa saya memilih jawaban ringkas” atau “hapus preferensi lama tentang editor”. patch mengganti bagian yang cocok, sedangkan remove menghapus entri berdasarkan potongan teks unik. Hindari meminta penggantian menyeluruh; dokumentasi menyebut aksi replace tidak tersedia.

Batas bawaan adalah 2.200 karakter untuk MEMORY.md dan 1.375 untuk USER.md; memori tidak melakukan pemadatan otomatis. Jadi gabungkan fakta yang berdekatan, buang proyek selesai, dan pertahankan hanya informasi yang berguna. Jika persetujuan ingin diwajibkan, setel memory.write_approval: true, lalu tinjau /memory pending; terapkan dengan /memory approve <id> atau buang memakai /memory reject <id>. Ini membantu mencegah asumsi keliru masuk permanen.

Privasi dan batas fitur

Jangan masukkan kata sandi, token, kunci API, data pribadi sensitif, atau rahasia proyek. Baca file sebelum dan sesudah perubahan, hapus catatan usang, dan ingat bahwa memori adalah data persisten lokal. Ia bukan backup-restore konfigurasi, bukan jadwal otomatis, dan bukan skill/plugin. Untuk membedakan salinan konfigurasi dari memori, baca panduan backup-restore konfigurasi Hermes Agent; tautan itu membahas pemulihan berkas, bukan konteks percakapan.

Sahabat, uji dengan fakta tidak sensitif, mulai sesi baru, lalu verifikasi responsnya. Jika perintah atau opsi pada rilis sahabat berbeda, jangan memaksa perubahan.