@vheins/local-memory-mcp 0.13.2 → 0.14.0

package/README.id.md

@@ -0,0 +1,94 @@
+# @vheins/local-memory-mcp
+
+[![npm version](https://img.shields.io/npm/v/@vheins/local-memory-mcp.svg)](https://www.npmjs.com/package/@vheins/local-memory-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/@vheins/local-memory-mcp.svg)](https://www.npmjs.com/package/@vheins/local-memory-mcp)
+[![npm total downloads](https://img.shields.io/npm/dt/@vheins/local-memory-mcp.svg)](https://www.npmjs.com/package/@vheins/local-memory-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+**MCP Local Memory Service** adalah server [Model Context Protocol (MCP)](https://modelcontextprotocol.io) berkinerja tinggi yang menyediakan memori jangka panjang untuk AI Agent (seperti Claude Desktop, Cursor, atau Windsurf).
+
+Dibangun dengan filosofi **Local-First**, layanan ini menyimpan keputusan arsitektur, pola kode, dan fakta kritis secara lokal di mesin Anda menggunakan SQLite dan Pencarian Semantik berbasis AI.
+
+## Fitur Utama
+
+- **Pencarian Semantik (V2):** Temukan memori berdasarkan makna, bukan hanya kata kunci, menggunakan model `all-MiniLM-L6-v2` secara lokal.
+- **Tech-Stack Affinity:** Bagikan pengetahuan antar repositori secara cerdas berdasarkan tag teknologi (misalnya memori Filament di Repo A dapat diakses di Repo B).
+- **Anti-Hallusinasi:** Mencegah Agent berhalusinasi dengan batas kemiripan yang ketat dan deteksi konflik keputusan.
+- **Decay Memori Otomatis:** Mengarsipkan memori usang secara otomatis untuk menjaga konteks tetap bersih dan relevan.
+- **Dashboard Modern:** Visualisasikan memori, statistik penggunaan, dan log audit melalui antarmuka web.
+
+## Penggunaan & Konfigurasi MCP
+
+Tambahkan layanan ini ke AI Agent Anda menggunakan salah satu metode di bawah.
+
+> **Rekomendasi:** Jika MCP Anda sering berjalan, hindari `npx` dan gunakan instalasi global. Ini mengurangi unduhan NPM dan mempercepat startup Agent.
+
+### Quick Start (Zero Setup)
+
+Cocok untuk **pengguna pertama** atau **pengujian cepat**.
+
+```json
+"local-memory": {
+  "command": "npx",
+  "args": ["-y", "@vheins/local-memory-mcp"],
+  "type": "stdio"
+}
+```
+
+### Direkomendasikan untuk Produksi
+
+1. **Install secara global:**
+   ```bash
+   npm install -g @vheins/local-memory-mcp
+   ```
+
+2. **Tambahkan ke konfigurasi:**
+   ```json
+   "local-memory": {
+     "command": "local-memory-mcp",
+     "type": "stdio"
+   }
+   ```
+
+## Dashboard
+
+Jalankan dashboard web untuk visualisasi memori dan task:
+
+```bash
+local-memory-mcp dashboard
+```
+*Jika belum install global:* `npx @vheins/local-memory-mcp dashboard`
+
+Buka `http://localhost:3456` di browser.
+
+### Auto-Start Dashboard di IDE
+
+Dashboard bisa otomatis menyala saat project dibuka di VS Code, Cursor, Windsurf, Zed, atau JetBrains.
+
+📖 **[Panduan auto-start dashboard →](docs/id/auto-start-dashboard.md)**
+
+## Dokumentasi
+
+- [Memulai & Instalasi](docs/id/getting-started.md) — Instalasi dan konfigurasi klien
+- [Panduan Penggunaan Tools](docs/id/tools-reference.md) — Dokumentasi tools lengkap dengan contoh dan alur kerja
+- [Panduan Pemecahan Masalah](docs/id/troubleshooting.md) — Mengatasi masalah umum
+- [Fitur & Cara Kerja](docs/id/features.md) — Semantic search, anti-hallusinasi, decay memori
+- [Logika Hybrid Search](docs/id/hybrid-search.md) — Cara kerja skoring pencarian
+- [Panduan Dashboard](docs/id/dashboard-guide.md) — UI web untuk manajemen memori & task
+- [Referensi Protokol MCP](docs/id/mcp-concepts.md) — Detail teknis protokol
+- [Integrasi dengan Claude Code](docs/id/claude-code-integration.md) — Panduan setup untuk Claude Code CLI
+- [Integrasi dengan Codex (OpenAI)](docs/id/codex-integration.md) — Panduan setup untuk Codex CLI
+- [Integrasi dengan Kiro](docs/id/kiro-integration.md) — Panduan setup untuk Kiro IDE
+- [Auto-Start Dashboard di IDE](docs/id/auto-start-dashboard.md) — tasks.json untuk VS Code, Cursor, Windsurf, Zed, JetBrains
+
+> 🇬🇧 **English version available:** [`README.md`](README.md) & docs in [`docs/en/`](docs/en/)
+
+- [Panduan Kontribusi](CONTRIBUTING.md)
+
+## Penyangkalan
+
+**PERANGKAT LUNAK INI DISEDIAKAN "SEBAGAIMANA ADANYA", TANPA JAMINAN DALAM BENTUK APAPUN**, baik tersurat maupun tersirat, termasuk namun tidak terbatas pada jaminan kepatutan, kesesuaian untuk tujuan tertentu, dan tidak melanggar hak pihak ketiga. Dalam hal apa pun penulis atau pemegang hak cipta tidak bertanggung jawab atas klaim, kerusakan, atau kewajiban lainnya, baik dalam tindakan kontrak, gugatan, atau lainnya, yang timbul dari, di luar, atau sehubungan dengan perangkat lunak ini.
+
+## Lisensi
+
+MIT © Muhammad Rheza Alfin

package/README.md

@@ -98,34 +98,29 @@ npm run build
 
 > The server serves the compiled Svelte build from `dist/dashboard/public/` in production.
 
-### Auto-launch in VS Code
-Add this to your `.vscode/tasks.json` to have the dashboard start automatically:
-```json
-{
-  "version": "2.0.0",
-  "tasks": [
-    {
-      "label": "Launch Memory Dashboard",
-      "type": "shell",
-      "command": "npx -y @vheins/local-memory-mcp dashboard",
-      "isBackground": true,
-      "runOptions": { "runOn": "folderOpen" }
-    }
-  ]
-}
-```
+### Auto-launch Dashboard in IDEs
+
+The dashboard can auto-start when you open a project in VS Code, Cursor, Windsurf, Zed, or JetBrains IDEs.
+
+📖 **[See the auto-start guide →](docs/en/auto-start-dashboard.md)**
 
 ## 📖 Documentation
 
-- [Getting Started & Setup](docs/user/getting-started.md)
-- [How it Works & Features](docs/user/features.md)
-- [Dashboard Guide](docs/user/dashboard-guide.md)
-- [MCP Protocol Reference](docs/user/mcp-concepts.md)
-- [Hybrid Search Logic](docs/user/hybrid-search.md)
+- [Getting Started & Setup](docs/en/getting-started.md) — Installation & client configuration
+- [Tool Reference & Usage Guide](docs/en/tools-reference.md) — Complete tool docs with examples and workflows
+- [Troubleshooting Guide](docs/en/troubleshooting.md) — Fix common issues
+- [Features & How It Works](docs/en/features.md) — Semantic search, anti-hallucination, memory decay
+- [Hybrid Search Logic](docs/en/hybrid-search.md) — How search scoring works
+- [Dashboard Guide](docs/en/dashboard-guide.md) — Web UI for memory & task management
+- [MCP Protocol Reference](docs/en/mcp-concepts.md) — Technical protocol details
+- [Claude Code Integration](docs/en/claude-code-integration.md) — Setup for Claude Code CLI
+- [Codex (OpenAI) Integration](docs/en/codex-integration.md) — Setup for Codex CLI
+- [Kiro Integration](docs/en/kiro-integration.md) — Setup for Kiro IDE
+- [Auto-Start Dashboard in IDEs](docs/en/auto-start-dashboard.md) — tasks.json for VS Code, Cursor, Windsurf, Zed, JetBrains
+
+> 🇮🇩 **Indonesian version available:** [`README.id.md`](README.id.md) & docs in [`docs/id/`](docs/id/)
+
 - [Contribution Guidelines](CONTRIBUTING.md)
-- [Developer: Architecture & Design](.agents/documents/design/architecture/architecture.md)
-- [Developer: Implementation Details](.agents/documents/implementation-details.md)
-- [Developer: Debugging Guide](.agents/documents/debugging-guide.md)
 
 ## ⚠️ Disclaimer