🌐 Ini adalah terjemahan otomatis. Koreksi dari komunitas sangat dipersilakan!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk
Sistem kompresi memori persisten yang dibangun untuk Claude Code.
Mulai Cepat • Cara Kerja • Alat Pencarian • Dokumentasi • Konfigurasi • Pemecahan Masalah • Lisensi
Claude-Mem secara mulus mempertahankan konteks di seluruh sesi dengan secara otomatis menangkap observasi penggunaan alat, menghasilkan ringkasan semantik, dan membuatnya tersedia untuk sesi mendatang. Ini memungkinkan Claude untuk mempertahankan kontinuitas pengetahuan tentang proyek bahkan setelah sesi berakhir atau tersambung kembali.
Mulai sesi Claude Code baru di terminal dan masukkan perintah berikut:
> /plugin marketplace add thedotmack/claude-mem > /plugin install claude-mem
Restart Claude Code. Konteks dari sesi sebelumnya akan secara otomatis muncul di sesi baru.
Fitur Utama:
- 🧠 Memori Persisten - Konteks bertahan di seluruh sesi
- 📊 Progressive Disclosure - Pengambilan memori berlapis dengan visibilitas biaya token
- 🔍 Pencarian Berbasis Skill - Query riwayat proyek Anda dengan mem-search skill
- 🖥️ Web Viewer UI - Stream memori real-time di http://localhost:37777
- 💻 Claude Desktop Skill - Cari memori dari percakapan Claude Desktop
- 🔒 Kontrol Privasi - Gunakan tag
<private>untuk mengecualikan konten sensitif dari penyimpanan - ⚙️ Konfigurasi Konteks - Kontrol yang detail atas konteks apa yang diinjeksikan
- 🤖 Operasi Otomatis - Tidak memerlukan intervensi manual
- 🔗 Kutipan - Referensi observasi masa lalu dengan ID (akses melalui http://localhost:37777/api/observation/{id} atau lihat semua di web viewer di http://localhost:37777)
- 🧪 Beta Channel - Coba fitur eksperimental seperti Endless Mode melalui peralihan versi
📚 Lihat Dokumentasi Lengkap - Jelajahi di situs web resmi
- Panduan Instalasi - Mulai cepat & instalasi lanjutan
- Panduan Penggunaan - Bagaimana Claude-Mem bekerja secara otomatis
- Alat Pencarian - Query riwayat proyek Anda dengan bahasa alami
- Fitur Beta - Coba fitur eksperimental seperti Endless Mode
- Context Engineering - Prinsip optimisasi konteks agen AI
- Progressive Disclosure - Filosofi di balik strategi priming konteks Claude-Mem
- Ringkasan - Komponen sistem & aliran data
- Evolusi Arsitektur - Perjalanan dari v3 ke v5
- Arsitektur Hooks - Bagaimana Claude-Mem menggunakan lifecycle hooks
- Referensi Hooks - 7 skrip hook dijelaskan
- Worker Service - HTTP API & manajemen Bun
- Database - Skema SQLite & pencarian FTS5
- Arsitektur Pencarian - Pencarian hybrid dengan database vektor Chroma
- Konfigurasi - Variabel environment & pengaturan
- Pengembangan - Membangun, testing, kontribusi
- Pemecahan Masalah - Masalah umum & solusi
Komponen Inti:
- 5 Lifecycle Hooks - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 skrip hook)
- Smart Install - Pemeriksa dependensi yang di-cache (skrip pre-hook, bukan lifecycle hook)
- Worker Service - HTTP API di port 37777 dengan web viewer UI dan 10 endpoint pencarian, dikelola oleh Bun
- SQLite Database - Menyimpan sesi, observasi, ringkasan
- mem-search Skill - Query bahasa alami dengan progressive disclosure
- Chroma Vector Database - Pencarian hybrid semantik + keyword untuk pengambilan konteks yang cerdas
Lihat Ringkasan Arsitektur untuk detail.
Claude-Mem menyediakan pencarian cerdas melalui mem-search skill yang secara otomatis dipanggil saat Anda bertanya tentang pekerjaan masa lalu:
Cara Kerja:
- Tanya saja secara alami: "Apa yang kita lakukan sesi terakhir?" atau "Apakah kita sudah memperbaiki bug ini sebelumnya?"
- Claude secara otomatis memanggil mem-search skill untuk menemukan konteks yang relevan
Operasi Pencarian yang Tersedia:
- Search Observations - Pencarian teks lengkap di seluruh observasi
- Search Sessions - Pencarian teks lengkap di seluruh ringkasan sesi
- Search Prompts - Cari permintaan pengguna mentah
- By Concept - Temukan berdasarkan tag konsep (discovery, problem-solution, pattern, dll.)
- By File - Temukan observasi yang mereferensikan file tertentu
- By Type - Temukan berdasarkan tipe (decision, bugfix, feature, refactor, discovery, change)
- Recent Context - Dapatkan konteks sesi terbaru untuk sebuah proyek
- Timeline - Dapatkan timeline terpadu dari konteks di sekitar titik waktu tertentu
- Timeline by Query - Cari observasi dan dapatkan konteks timeline di sekitar kecocokan terbaik
- API Help - Dapatkan dokumentasi API pencarian
Contoh Query Bahasa Alami:
"What bugs did we fix last session?" "How did we implement authentication?" "What changes were made to worker-service.ts?" "Show me recent work on this project" "What was happening when we added the viewer UI?"
Lihat Panduan Alat Pencarian untuk contoh detail.
Claude-Mem menawarkan beta channel dengan fitur eksperimental seperti Endless Mode (arsitektur memori biomimetik untuk sesi yang diperpanjang). Beralih antara versi stabil dan beta dari web viewer UI di http://localhost:37777 → Settings.
Lihat Dokumentasi Fitur Beta untuk detail tentang Endless Mode dan cara mencobanya.
- Node.js: 18.0.0 atau lebih tinggi
- Claude Code: Versi terbaru dengan dukungan plugin
- Bun: JavaScript runtime dan process manager (otomatis diinstal jika tidak ada)
- uv: Python package manager untuk pencarian vektor (otomatis diinstal jika tidak ada)
- SQLite 3: Untuk penyimpanan persisten (terbundel)
Pengaturan dikelola di ~/.claude-mem/settings.json (otomatis dibuat dengan default saat pertama kali dijalankan). Konfigurasi model AI, port worker, direktori data, level log, dan pengaturan injeksi konteks.
Lihat Panduan Konfigurasi untuk semua pengaturan dan contoh yang tersedia.
Lihat Panduan Pengembangan untuk instruksi build, testing, dan alur kerja kontribusi.
Jika mengalami masalah, jelaskan masalah ke Claude dan troubleshoot skill akan secara otomatis mendiagnosis dan memberikan perbaikan.
Lihat Panduan Pemecahan Masalah untuk masalah umum dan solusi.
Buat laporan bug yang komprehensif dengan generator otomatis:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
Kontribusi sangat dipersilakan! Silakan:
- Fork repositori
- Buat branch fitur
- Buat perubahan Anda dengan tes
- Perbarui dokumentasi
- Kirim Pull Request
Lihat Panduan Pengembangan untuk alur kerja kontribusi.
Proyek ini dilisensikan di bawah GNU Affero General Public License v3.0 (AGPL-3.0).
Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved.
Lihat file LICENSE untuk detail lengkap.
Apa Artinya:
- Anda dapat menggunakan, memodifikasi, dan mendistribusikan perangkat lunak ini dengan bebas
- Jika Anda memodifikasi dan men-deploy di server jaringan, Anda harus membuat kode sumber Anda tersedia
- Karya turunan juga harus dilisensikan di bawah AGPL-3.0
- TIDAK ADA JAMINAN untuk perangkat lunak ini
Catatan tentang Ragtime: Direktori ragtime/ dilisensikan secara terpisah di bawah PolyForm Noncommercial License 1.0.0. Lihat ragtime/LICENSE untuk detail.
- Dokumentasi: docs/
- Issues: GitHub Issues
- Repositori: github.com/thedotmack/claude-mem
- Penulis: Alex Newman (@thedotmack)
Built with Claude Agent SDK | Powered by Claude Code | Made with TypeScript
