MemoryCustodian
MemoryCustodian memberikan agen pengkodean memori proyek yang tahan lama dan repo-native dengan menyimpan konteks kunci sebagai Markdown biasa dan hanya memuat bagian yang relevan dengan tugas melalui manifest untuk overhead prompt minimal di seluruh sesi dan tim.
https://github.com/waittim/MemoryCustodian?ref=producthunt&utm_source=aipure
Informasi Produk
Diperbarui:Jul 30, 2026
Apa itu MemoryCustodian
MemoryCustodian adalah sistem 'memori proyek' ringan untuk agen pengkodean AI yang membantu mereka mempertahankan hal-hal penting di seluruh sesi—keputusan, batasan, pendekatan yang ditolak, dan bentuk proyek saat ini—tanpa mengandalkan riwayat obrolan atau prompt instruksi yang berlebihan. Ini menyimpan konteks yang tahan lama sebagai Markdown yang dapat ditinjau dan dibandingkan di dalam repositori Anda (biasanya di bawah `docs/memory/`) dan menyediakan CLI Python (hanya stdlib) yang cepat, mengutamakan offline, ditambah integrasi agen (misalnya, Codex, Claude Code, keterampilan gaya Gemini). Tujuannya adalah untuk membuat pengetahuan proyek portabel di seluruh agen dan mudah diaudit oleh manusia seperti kode, sambil menjaga konteks runtime tetap kecil dan disengaja.
Fitur Utama MemoryCustodian
MemoryCustodian adalah sistem "memori proyek" offline-first untuk agen pengkodean yang menyimpan konteks yang tahan lama (keputusan, batasan, pendekatan yang ditolak, dan bentuk proyek saat ini) sebagai Markdown biasa di dalam repositori Anda. Alih-alih menempelkan prompt besar atau mengandalkan riwayat obrolan, ia menggunakan alur kerja yang mengutamakan manifes untuk memuat hanya file memori yang relevan dengan tugas ke dalam paket konteks agen, menjaga sesi tetap ringan sambil membuat pengetahuan dapat diperiksa, dapat dibandingkan, portabel di seluruh agen/tim, dan dapat dipelihara melalui CLI Python yang deterministik, hanya stdlib dengan mutasi yang mengutamakan pratinjau yang dijaga (misalnya, ringkas/lupakan/migrasi).
Memori Markdown asli repo: Menyimpan pengetahuan proyek yang tahan lama di bawah `docs/memory/` sebagai Markdown biasa sehingga manusia dapat meninjau, membandingkan, melakukan commit, dan mengembalikan memori seperti kode—tidak diperlukan DB vektor, indeks RAG, atau dependensi cloud.
Pemuatan selektif yang mengutamakan manifes: Agen membaca `manifest.md` lalu `brief.md`, dan memuat hanya file spesifik yang relevan dengan tugas saat ini (perencanaan/implementasi/artefak), meminimalkan pembengkakan prompt sambil mempertahankan konteks penting.
Bootstraps agen tipis di seluruh platform: Menghasilkan file bootstrap kecil (misalnya, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`) yang mengarahkan agen ke manifes daripada menyematkan blok instruksi besar, mendukung agen gaya Codex, Claude Code, Gemini, dan penggunaan shell generik.
CLI deterministik dengan pemeliharaan yang dijaga: Menyediakan perintah `init/status/check/read/add/enable/forget/compact/migrate`; operasi pemeliharaan mengutamakan pratinjau dan mempertahankan struktur, dengan pemeriksaan anggaran dan rencana mutasi yang aman sebelum menerapkan perubahan.
Modul memori yang terlingkup dan ikut serta: Menjaga pengetahuan opsional (misalnya, `rules/`, `profiles/`, `areas/`, `archive/`) keluar dari konteks default sampai diaktifkan secara eksplisit oleh manifes, memungkinkan memori khusus subsistem tanpa mencemari setiap tugas.
Kontrol pelupaan dan pengarsipan yang aman privasi: Mendukung alur pelupaan lunak/keras dan pembersihan dengan batu nisan dan pelindung redaksi, ditambah pengarsipan terkontrol (misalnya, pengarsipan keputusan tertua) yang memerlukan konfirmasi eksplisit untuk menghindari kehilangan semantik yang tidak disengaja.
Kasus Penggunaan MemoryCustodian
Tim perangkat lunak yang memelihara basis kode yang berumur panjang: Tangkap keputusan arsitektur, batasan, dan pendekatan yang ditolak sehingga sesi agen baru (dan insinyur baru) tidak membahas ulang pilihan sebelumnya, mengurangi debugging berulang dan pengerjaan ulang di seluruh sprint.
Lingkungan yang diatur atau offline: Gunakan di pengaturan keuangan, perawatan kesehatan, pertahanan, atau perusahaan yang terisolasi di mana layanan memori cloud tidak diizinkan; CLI yang hanya stdlib dan penyimpanan Markdown lokal mendukung alur kerja yang sepenuhnya offline.
Interoperabilitas multi-agen/perkakas: Standarisasi memori proyek di seluruh host agen yang berbeda (Codex, Claude Code, agen gaya Gemini) sehingga tim dapat beralih alat tanpa kehilangan konteks atau membangun kembali prompt.
Serah terima konsultasi dan agensi: Kirim proyek klien dengan paket memori yang dapat diaudit dan terkandung dalam repo (ringkasan/keputusan/batasan/jangan gunakan) yang mempertahankan alasan dan batasan untuk pemelihara di masa mendatang.
Monorepo kompleks dan kepemilikan subsistem: Gunakan `areas/` dan perutean manifes untuk memuat hanya memori yang relevan dengan domain (frontend, sinkronisasi, infra, dll.), membantu agen bekerja secara efektif tanpa menyeret konteks seluruh organisasi ke setiap tugas.
Kelebihan
Portabel dan dapat diaudit: memori adalah Markdown biasa di dalam repo, mudah ditinjau, dibandingkan, dan dikontrol versinya.
Konteks overhead rendah: pemuatan selektif berbasis manifes menghindari pembengkakan prompt dan menjaga sesi agen tetap efisien.
Offline-first dan dependensi minimal: CLI inti hanya stdlib Python dan dirancang untuk bekerja tanpa layanan jaringan.
Kekurangan
Membutuhkan disiplin kurasi: kerangka `brief.md` yang dihasilkan harus dikurasi dari sumber otoritatif sebelum dapat dipercaya.
Bukan pengambilan semantik otomatis: menghindari embeddings/RAG berdasarkan desain, sehingga relevansi tergantung pada struktur manifes yang baik dan kualitas penulisan manusia/agen.
Operasi pemeliharaan bisa konservatif: perlindungan dan batasan yang mengutamakan pratinjau (misalnya, perlindungan pencocokan luas) dapat menambah langkah alur kerja bagi pengguna yang mengharapkan pembersihan otomatis sepenuhnya.
Cara Menggunakan MemoryCustodian
1) Instal MemoryCustodian (pilih jalur yang sesuai dengan agen/alur kerja Anda): Pilih salah satu metode instalasi:
- Minta agen pengkodean Anda untuk menginstal skill dari repo: https://github.com/waittim/MemoryCustodian
- Codex (marketplace lokal): jalankan `codex plugin marketplace add .` dari checkout, lalu `codex plugin add memory-custodian@memory-custodian-dev`.
- Claude Code (plugin): untuk pengujian lokal jalankan `claude --plugin-dir .`, atau instal ke skill pribadi dengan `./install.sh claude`.
- Agen gaya Gemini: instal dengan `./install.sh gemini` atau `gemini skills link ./skills/memory-custodian`.
- Checkout CLI/sumber: jalankan dari repo melalui `scripts/memory-custodian ...` atau instal yang dapat diedit dengan `python3 -m pip install -e .` untuk mendapatkan perintah `memory-custodian`.
2) Inisialisasi MemoryCustodian dalam sebuah proyek (satu kali per repo): Jalankan inisialisasi sekali untuk setiap proyek target:
- Jika diinstal sebagai skrip konsol: `memory-custodian init --project-root /path/to/project --agent all`
- Dari checkout sumber: `scripts/memory-custodian init --project-root /path/to/project --agent all`
Gunakan `--agent codex`, `--agent claude`, `--agent gemini`, atau `--agent all` untuk menghasilkan file bootstrap tipis yang dibaca agen Anda.
3) Pahami apa yang dibuat inisialisasi (tempat memori berada): Inisialisasi membuat set memori tahan lama default di bawah `docs/memory/`:
- `manifest.md` (mengatur apa yang akan dimuat)
- `brief.md` (bentuk proyek saat ini)
- `decisions.md` (keputusan kunci)
- `constraints.md` (persyaratan keras)
- `do-not-use.md` (jalur yang ditolak / batu nisan)
- `inbox.md` (area pementasan)
File bootstrap platform (misalnya, `AGENTS.md`, `CLAUDE.md`, `GEMINI.md`) tetap tipis dan mengarahkan agen ke `docs/memory/`.
4) Kurasi ringkasan yang dihasilkan sebelum mengandalkannya: Setelah `init`, `brief.md` dimulai sebagai kerangka dengan TODO. Isi dari sumber proyek yang berwenang (README, kode, dokumen) sebelum menganggap memori siap. Gunakan `memory-custodian status --project-root /path/to/project` (atau `scripts/memory-custodian status ...`) untuk melihat apakah ringkasan masih belum dikurasi; `status` dan `check` melaporkan ringkasan yang belum dikurasi.
5) Muat memori yang tepat untuk suatu tugas (pembacaan manifest-first): Alur kerja yang dimaksudkan untuk agen adalah:
1) Baca `docs/memory/manifest.md`.
2) Baca `docs/memory/brief.md`.
3) Muat hanya file yang relevan dengan tugas yang disebutkan oleh manifest.
Untuk inspeksi manual, buat paket konteks dengan:
- `memory-custodian read --project-root /path/to/project --task planning`
- `memory-custodian read --project-root /path/to/project --task implementation`
- `memory-custodian read --project-root /path/to/project --task artifact`
6) Tambahkan memori tahan lama ketika sesuatu harus bertahan dari obrolan saat ini: Catat keputusan/batasan/preferensi/pendekatan yang ditolak menggunakan CLI:
- `memory-custodian add "Kami memilih pemuatan manifest-first." --type decision`
- `memory-custodian add "Pertahankan sinkronisasi coba lagi backoff." --type decision --area sync --reason "Jaga agar percobaan ulang terbatas di seluruh peluncuran."`
Jaga agar entri keputusan tetap singkat (alat ini memberlakukan panduan token dan menolak penulisan yang terlalu panjang kecuali Anda secara eksplisit mengizinkan entri panjang).
7) Aktifkan modul memori opsional hanya ketika menjadi relevan: Modul opsional (misalnya, aturan, profil, area) adalah opt-in dan tidak dimuat kecuali diaktifkan dan diarahkan oleh manifest. Aktifkan sesuai kebutuhan:
- `memory-custodian enable preferences`
- `memory-custodian enable rules/output`
- `memory-custodian enable profile/git`
- `memory-custodian enable area/frontend`
Mengaktifkan tidak pernah menimpa file modul yang ada.
8) Gunakan 'do-not-use' untuk mempertahankan pendekatan yang ditolak dan menghindari regresi: Ketika Anda sengaja menolak suatu pendekatan (misalnya, backend penyimpanan atau arsitektur), catat di `docs/memory/do-not-use.md` (melalui pengeditan atau alur kerja tambah/lupa yang sesuai) agar sesi mendatang tidak mengusulkannya kembali.
9) Periksa kesehatan dan kompatibilitas protokol secara teratur: Jalankan validasi deterministik untuk memastikan struktur, anggaran, dan metadata protokol sudah benar:
- `memory-custodian check --project-root /path/to/project`
Gunakan `memory-custodian status` untuk gambaran umum singkat dan untuk mendeteksi ringkasan yang belum dikurasi.
10) Kompakkan dan pertahankan memori (preview-first, mutasi aman): Gunakan perintah pemeliharaan untuk menjaga memori tetap kecil dan terkini:
- `memory-custodian compact --project-root /path/to/project`
Kompresi dijaga dan mengutamakan pratinjau; terapkan perubahan hanya setelah meninjau rencana. Kompresi kotak masuk bersifat konservatif (misalnya, penghapusan unit-bullet tingkat atas duplikat persis dan pemfilteran batu nisan) dan mengharapkan agen/manusia untuk melakukan promosi semantik ke dalam keputusan/batasan.
11) Lupakan informasi usang dengan aman (preview-first): Hapus atau redaksi topik usang dengan melupakan yang mengutamakan pratinjau:
- Pratinjau: `memory-custodian forget "catatan penyebaran lama" --mode soft --project-root /path/to/project`
- Terapkan setelah peninjauan: `memory-custodian forget "catatan penyebaran lama" --mode soft --apply --project-root /path/to/project`
Pencocokan luas memerlukan konfirmasi eksplisit (misalnya, `--allow-broad-match`). Beberapa kasus memerlukan penulisan ulang manual; alat ini akan menolak penghapusan massal yang tidak aman.
12) Perbaiki atau ganti pengaturan yang ada saat dibutuhkan: Jika file hilang atau metadata perlu diperbarui tanpa menimpa konten yang dikurasi:
- Perbaiki: `memory-custodian init --project-root /path/to/project --repair`
Jika Anda sengaja menginginkan penggantian penuh, gunakan penggantian yang mengutamakan pratinjau dan hanya terapkan jika benar:
- `memory-custodian init --project-root /path/to/project --replace-existing`
- lalu tambahkan `--apply` hanya jika file yang terdaftar harus diganti.
13) Migrasikan versi memori protokol/proyek saat alat diperbarui: Ketika `check` melaporkan metadata protokol lama atau hilang, migrasikan manifest proyek secara offline:
- Pratinjau: `memory-custodian migrate --project-root /path/to/project`
- Terapkan setelah peninjauan: `memory-custodian migrate --apply --project-root /path/to/project`
14) Gunakan pemanggilan yang tepat di Windows vs. checkout sumber: Di Windows, instal perintah konsol dan gunakan `memory-custodian ...`. Dari checkout repo di platform mana pun, Anda dapat menjalankan `scripts/memory-custodian ...` sebagai pembungkus.
FAQ MemoryCustodian
MemoryCustodian adalah alat yang memberikan "memori proyek" yang tahan lama kepada agen pengkodean dengan menyimpan keputusan, batasan, ide yang ditolak, dan konteks proyek sebagai Markdown biasa di dalam repositori Anda, kemudian hanya memuat bagian-bagian yang diperlukan untuk tugas saat ini.
Video MemoryCustodian
Artikel Populer
Atoms: Platform AI Multi-Agen yang Mengubah Ide menjadi Produk Siap Diluncurkan
May 22, 2026
Nano Banana SBTI: Apa Itu, Bagaimana Cara Kerjanya, dan Cara Menggunakannya di Tahun 2026
Apr 15, 2026
Ulasan Atoms — Pembuat Produk AI yang Mendefinisikan Ulang Kreasi Digital di Tahun 2026
Apr 10, 2026
Kilo Claw: Cara Menerapkan dan Menggunakan Agen AI "Lakukan-Untuk-Anda" Sejati (Pembaruan 2026)
Apr 3, 2026
Alat AI Terbaru Serupa dengan MemoryCustodian
Gait
Gait adalah alat kolaborasi yang mengintegrasikan generasi kode yang dibantu AI dengan kontrol versi, memungkinkan tim untuk melacak, memahami, dan membagikan konteks kode yang dihasilkan AI dengan efisien.
invoices.dev
invoices.dev adalah platform penagihan otomatis yang menghasilkan faktur langsung dari komit Git pengembang, dengan kemampuan integrasi untuk layanan GitHub, Slack, Linear, dan Google.
EasyRFP
EasyRFP adalah toolkit komputasi tepi yang didukung AI yang memperlancar respons RFP (Permintaan Proposal) dan memungkinkan fenotip lapangan waktu nyata melalui teknologi pembelajaran mendalam.
Cart.ai
Cart.ai adalah platform layanan bertenaga AI yang menyediakan solusi otomatisasi bisnis yang komprehensif termasuk pengkodean, manajemen hubungan pelanggan, pengeditan video, pengaturan e-commerce, dan pengembangan AI kustom dengan dukungan 24/7.
Alat AI Populer Seperti MemoryCustodian
GitHub Copilot Chat
GitHub Copilot Chat adalah asisten pengkodean bertenaga AI yang menyediakan interaksi bahasa alami, saran kode waktu nyata, dan dukungan kontekstual langsung di dalam IDE yang didukung dan GitHub.com.
CopilotForXcode
CopilotForXcode adalah Ekstensi Editor Sumber Xcode yang mengintegrasikan GitHub Copilot, Codeium, dan ChatGPT untuk memberikan saran kode yang didukung AI, bantuan obrolan, dan fungsionalitas prompt-to-code di dalam Xcode.
BrowserAI
BrowserAI adalah pustaka sumber terbuka yang memungkinkan menjalankan Model Bahasa Besar (LLM) lokal langsung di browser web dengan akselerasi WebGPU, menawarkan kemampuan AI yang berfokus pada privasi tanpa memerlukan infrastruktur server.
OpenAI Codex CLI
OpenAI Codex CLI adalah agen pengkodean sumber terbuka ringan yang berjalan di terminal Anda, memungkinkan pengembang untuk menerjemahkan bahasa alami ke dalam eksekusi kode sambil memberikan penalaran tingkat ChatGPT dengan kemampuan untuk menjalankan kode, memanipulasi file, dan melakukan iterasi di bawah kontrol versi.