@pcircle/memesh 2.9.1 → 2.9.3

package/README.fr.md

@@ -1,60 +1,89 @@
 <div align="center">
 
-# 🧠 MeMesh Plugin
+<img src="https://img.shields.io/badge/%F0%9F%A7%A0-MeMesh-blueviolet?style=for-the-badge" alt="MeMesh" />
 
-### Plugin de productivité pour Claude Code
+# MeMesh
 
-Mémoire, analyse intelligente des tâches et automatisation — dans un seul plugin.
+### Vos sessions de code avec l'IA méritent une mémoire.
 
-[![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io)
+MeMesh offre à Claude Code une mémoire persistante et consultable — chaque session s'appuie sur la précédente.
 
-[Installation](#installation) • [Utilisation](#utilisation) • [Dépannage](#dépannage)
+[![npm version](https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@pcircle/memesh)
+[![Downloads](https://img.shields.io/npm/dm/@pcircle/memesh?style=flat-square&color=blue)](https://www.npmjs.com/package/@pcircle/memesh)
+[![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square)](https://nodejs.org)
+[![MCP](https://img.shields.io/badge/MCP-compatible-purple?style=flat-square)](https://modelcontextprotocol.io)
 
-[English](README.md) • [繁體中文](README.zh-TW.md) • [简体中文](README.zh-CN.md) • [日本語](README.ja.md) • [한국어](README.ko.md) • **Français** • [Deutsch](README.de.md) • [Español](README.es.md) • [Tiếng Việt](README.vi.md) • [ภาษาไทย](README.th.md) • [Bahasa Indonesia](README.id.md)
+```bash
+npm install -g @pcircle/memesh
+```
+
+[Démarrage](#démarrage) · [Fonctionnement](#fonctionnement) · [Commandes](#commandes) · [Documentation](docs/USER_GUIDE.md)
+
+[English](README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · **Français** · [Deutsch](README.de.md) · [Español](README.es.md) · [Tiếng Việt](README.vi.md) · [ภาษาไทย](README.th.md) · [Bahasa Indonesia](README.id.md)
 
 </div>
 
+> **Note** : Ce projet s'appelait à l'origine « Claude Code Buddy » et a été renommé MeMesh Plugin pour éviter d'éventuels problèmes de marque.
+
 ---
 
-## Pourquoi ce projet existe
+## Le problème
 
-J'adore Claude Code. Il a changé ma façon de créer des logiciels.
+Vous travaillez sur un projet avec Claude Code. Vous avez pris des décisions importantes il y a trois sessions — quelle bibliothèque d'authentification utiliser, pourquoi ce schéma de base de données, quels patterns suivre. Mais Claude ne s'en souvient pas. Vous vous répétez. Vous perdez le contexte. Vous perdez du temps.
 
-Ce projet est né de mon envie d'aider plus de gens — en particulier les débutants en programmation — à tirer le meilleur parti de Claude Code pour le vibe coding. J'ai remarqué que quand les projets grandissent, il devient difficile de suivre toutes les décisions prises entre les sessions. Alors j'ai créé un plugin (avec Claude Code, bien sûr) qui s'en souvient pour vous.
+**MeMesh résout ce problème.** Il offre à Claude une mémoire persistante et consultable qui grandit avec votre projet.
 
-> **Note** : Ce projet s'appelait à l'origine « Claude Code Buddy » et a été renommé MeMesh Plugin pour éviter d'éventuels problèmes de marque.
+---
+
+## Fonctionnement
+
+<table>
+<tr>
+<td width="50%">
+
+### Avant MeMesh
+```
+Session 1 : "Utiliser JWT pour l'auth"
+Session 2 : "Pourquoi on avait choisi JWT déjà ?"
+Session 3 : "Attends, on utilise quelle bibliothèque d'auth ?"
+```
+Vous répétez vos décisions. Claude oublie le contexte. La progression stagne.
+
+</td>
+<td width="50%">
 
-## Qu'est-ce que ça fait ?
+### Après MeMesh
+```
+Session 1 : "Utiliser JWT pour l'auth" → sauvegardé
+Session 2 : buddy-remember "auth" → rappel instantané
+Session 3 : Contexte chargé automatiquement au démarrage
+```
+Chaque session reprend là où vous vous étiez arrêté.
 
-MeMesh Plugin rend Claude Code plus intelligent et productif. Ce n'est pas qu'une mémoire — c'est une boîte à outils complète :
+</td>
+</tr>
+</table>
 
-**Mémoire de projet consultable** — Sauvegarde automatique des décisions, patterns et leçons. Recherche par sens, pas seulement par mots-clés. Demandez « qu'est-ce qu'on avait décidé pour l'auth ? » et obtenez une réponse immédiate.
+---
 
-**Analyse intelligente des tâches** — Quand vous dites `buddy-do "ajouter l'auth"`, MeMesh analyse la tâche, récupère le contexte pertinent du travail passé, et fournit un plan enrichi avant exécution.
+## Ce que vous obtenez
 
-**Automatisation du workflow** — MeMesh travaille en arrière-plan pour :
-- Afficher un récapitulatif de votre dernière session au démarrage
-- Suivre les fichiers modifiés et testés
-- Rappeler la revue de code avant le commit
-- Router les tâches vers le modèle optimal
+**Mémoire de projet consultable** — Demandez "qu'est-ce qu'on avait décidé pour l'auth ?" et obtenez une réponse instantanée par correspondance sémantique. Pas une recherche par mots-clés — une recherche par *sens*, propulsée par des embeddings ONNX locaux.
 
-**Apprendre des erreurs** — Enregistrez les erreurs et leurs corrections pour construire une base de connaissances et éviter de répéter les mêmes erreurs.
+**Analyse intelligente des tâches** — `buddy-do "ajouter l'auth utilisateur"` ne se contente pas d'exécuter. Il récupère le contexte pertinent des sessions passées, vérifie les patterns que vous avez établis, et construit un plan enrichi avant d'écrire la moindre ligne.
 
-**En quoi c'est différent de la mémoire intégrée de Claude ?**
+**Rappel proactif** — MeMesh fait remonter automatiquement les souvenirs pertinents au démarrage d'une session, lors d'un échec de test ou d'une erreur. Aucune recherche manuelle nécessaire.
 
-Claude Code dispose déjà de l'auto memory et de CLAUDE.md — parfaits pour les préférences générales. MeMesh ajoute des **outils dédiés au projet** : mémoire consultable par sens, analyse de tâches avec contexte passé, et workflows automatisés qui rendent chaque session plus productive.
+**Automatisation du workflow** — Récapitulatifs de session au démarrage. Suivi des modifications de fichiers. Rappels de revue de code avant les commits. Le tout fonctionne silencieusement en arrière-plan.
 
-Pensez-y comme ça :
-- **CLAUDE.md** = votre manuel d'instructions pour Claude
-- **MeMesh** = un carnet consultable + un assistant intelligent qui apprend avec votre projet
+**Apprentissage des erreurs** — Enregistrez les erreurs et leurs corrections pour construire une base de connaissances. La même erreur ne se reproduit pas deux fois.
 
 ---
 
-## Installation
+## Démarrage
 
-**Prérequis** : [Claude Code](https://docs.anthropic.com/en/docs/claude-code) et Node.js 20+
+**Prérequis** : [Claude Code](https://docs.anthropic.com/en/docs/claude-code) + Node.js 20+
 
 ```bash
 npm install -g @pcircle/memesh
@@ -62,16 +91,16 @@ npm install -g @pcircle/memesh
 
 Redémarrez Claude Code. C'est tout.
 
-**Vérification** — tapez ceci dans Claude Code :
+**Vérification** — tapez dans Claude Code :
 
 ```
 buddy-help
 ```
 
-Vous devriez voir une liste de commandes.
+Vous devriez voir une liste des commandes disponibles.
 
 <details>
-<summary>Installation depuis les sources (pour les contributeurs)</summary>
+<summary><strong>Installation depuis les sources</strong> (contributeurs)</summary>
 
 ```bash
 git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
@@ -83,26 +112,43 @@ npm install && npm run build
 
 ---
 
-## Utilisation
-
-MeMesh ajoute 3 commandes à Claude Code :
+## Commandes
 
-| Commande | Fonction |
-|----------|----------|
-| `buddy-do "tâche"` | Exécuter une tâche avec le contexte mémoire |
+| Commande | Ce qu'elle fait |
+|----------|----------------|
+| `buddy-do "tâche"` | Exécuter une tâche avec le contexte mémoire complet |
 | `buddy-remember "sujet"` | Rechercher les décisions et le contexte passés |
 | `buddy-help` | Afficher les commandes disponibles |
 
-**Exemples :**
+**Exemples concrets :**
 
 ```bash
-buddy-do "explique ce codebase"
-buddy-do "ajoute l'authentification utilisateur"
-buddy-remember "décisions de conception API"
-buddy-remember "pourquoi on a choisi PostgreSQL"
+# Se repérer dans un nouveau codebase
+buddy-do "explain this codebase"
+
+# Développer des fonctionnalités avec le contexte du travail passé
+buddy-do "add user authentication"
+
+# Retrouver pourquoi des décisions ont été prises
+buddy-remember "API design decisions"
+buddy-remember "why we chose PostgreSQL"
 ```
 
-Toutes les données sont stockées localement sur votre machine. Les décisions sont conservées 90 jours, les notes de session 30 jours.
+Toutes les données restent sur votre machine. Les décisions sont conservées 90 jours, les notes de session 30 jours.
+
+---
+
+## En quoi est-ce différent de CLAUDE.md ?
+
+| | CLAUDE.md | MeMesh |
+|---|-----------|--------|
+| **Objectif** | Instructions statiques pour Claude | Mémoire vivante qui grandit avec votre projet |
+| **Recherche** | Recherche textuelle manuelle | Recherche sémantique par sens |
+| **Mises à jour** | Vous éditez manuellement | Capture automatique des décisions en cours de travail |
+| **Rappel** | Toujours chargé (peut devenir long) | Fait remonter le contexte pertinent à la demande |
+| **Portée** | Préférences générales | Graphe de connaissances spécifique au projet |
+
+**Ils fonctionnent ensemble.** CLAUDE.md indique à Claude *comment* travailler. MeMesh se souvient de *ce que* vous avez construit.
 
 ---
 
@@ -110,49 +156,44 @@ Toutes les données sont stockées localement sur votre machine. Les décisions
 
 | Plateforme | Statut |
 |-----------|--------|
-| **macOS** | ✅ Fonctionne |
-| **Linux** | ✅ Fonctionne |
-| **Windows** | ✅ Fonctionne (WSL2 recommandé) |
-
-**Compatible avec :**
-- Claude Code CLI (terminal)
-- Claude Code VS Code Extension
-- Cursor (via MCP)
-- Autres éditeurs compatibles MCP
+| macOS | ✅ |
+| Linux | ✅ |
+| Windows | ✅ (WSL2 recommandé) |
 
-**Claude Desktop (Cowork)** : Les commandes de base fonctionnent, mais les fonctionnalités mémoire nécessitent la version CLI. Voir [détails Cowork](docs/COWORK_SUPPORT.md).
+**Compatible avec :** Claude Code CLI · VS Code Extension · Cursor (via MCP) · Tout éditeur compatible MCP
 
 ---
 
-## Dépannage
+## Architecture
 
-**MeMesh n'apparaît pas ?**
+MeMesh fonctionne comme un serveur MCP local aux côtés de Claude Code :
 
-```bash
-# Vérifier l'installation
-npm list -g @pcircle/memesh
+- **Graphe de connaissances** — Stockage d'entités basé sur SQLite avec recherche plein texte FTS5
+- **Embeddings vectoriels** — Runtime ONNX pour la similarité sémantique (100 % local)
+- **Déduplication de contenu** — Hachage SHA-256 pour éviter les calculs d'embeddings redondants
+- **Traitement par lots** — Opérations en masse efficaces pour les grandes bases de connaissances
+- **Système de hooks** — Rappel proactif au démarrage de session, en cas d'échec de tests et d'erreurs
 
-# Vérifier la version de Node.js (20+ requis)
-node --version
+Tout fonctionne localement. Pas de cloud. Pas d'appels API. Vos données ne quittent jamais votre machine.
 
-# Relancer la configuration
-memesh setup
-```
+---
 
-Puis redémarrez complètement Claude Code.
+## Documentation
 
-Plus d'aide : [Guide de dépannage](docs/TROUBLESHOOTING.md)
+| Document | Description |
+|----------|-------------|
+| [Démarrage](docs/GETTING_STARTED.md) | Guide d'installation pas à pas |
+| [Guide utilisateur](docs/USER_GUIDE.md) | Guide complet avec exemples |
+| [Commandes](docs/COMMANDS.md) | Référence complète des commandes |
+| [Architecture](docs/ARCHITECTURE.md) | Plongée technique approfondie |
+| [Contribuer](CONTRIBUTING.md) | Guide de contribution |
+| [Développement](docs/DEVELOPMENT.md) | Configuration pour les contributeurs |
 
 ---
 
-## En savoir plus
+## Contribuer
 
-- **[Démarrage](docs/GETTING_STARTED.md)** — Installation pas à pas
-- **[Guide utilisateur](docs/USER_GUIDE.md)** — Guide complet avec exemples
-- **[Commandes](docs/COMMANDS.md)** — Toutes les commandes disponibles
-- **[Architecture](docs/ARCHITECTURE.md)** — Comment ça fonctionne en interne
-- **[Contribuer](CONTRIBUTING.md)** — Envie d'aider ? Commencez ici
-- **[Guide de développement](docs/DEVELOPMENT.md)** — Pour les contributeurs
+Les contributions sont les bienvenues ! Consultez [CONTRIBUTING.md](CONTRIBUTING.md) pour commencer.
 
 ---
 
@@ -164,8 +205,8 @@ MIT — Voir [LICENSE](LICENSE)
 
 <div align="center">
 
-Quelque chose ne fonctionne pas ? [Ouvrir une issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — nous répondons rapidement.
+**Construit avec Claude Code, pour Claude Code.**
 
-[Signaler un bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) • [Demander une fonctionnalité](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
+[Signaler un bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) · [Demander une fonctionnalité](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions) · [Obtenir de l'aide](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
 
 </div>

package/README.id.md

@@ -1,60 +1,89 @@
 <div align="center">
 
-# 🧠 MeMesh Plugin
+<img src="https://img.shields.io/badge/%F0%9F%A7%A0-MeMesh-blueviolet?style=for-the-badge" alt="MeMesh" />
 
-### Plugin produktivitas untuk Claude Code
+# MeMesh
 
-Memori, analisis tugas cerdas, dan otomasi alur kerja — semua dalam satu plugin.
+### Sesi coding AI Anda layak memiliki memori.
 
-[![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-[![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io)
+MeMesh memberikan Claude Code memori yang persisten dan dapat dicari — sehingga setiap sesi melanjutkan dari yang terakhir.
 
-[Instalasi](#instalasi) • [Penggunaan](#penggunaan) • [Pemecahan Masalah](#pemecahan-masalah)
+[![npm version](https://img.shields.io/npm/v/@pcircle/memesh?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@pcircle/memesh)
+[![Downloads](https://img.shields.io/npm/dm/@pcircle/memesh?style=flat-square&color=blue)](https://www.npmjs.com/package/@pcircle/memesh)
+[![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D20-brightgreen?style=flat-square)](https://nodejs.org)
+[![MCP](https://img.shields.io/badge/MCP-compatible-purple?style=flat-square)](https://modelcontextprotocol.io)
 
-[English](README.md) • [繁體中文](README.zh-TW.md) • [简体中文](README.zh-CN.md) • [日本語](README.ja.md) • [한국어](README.ko.md) • [Français](README.fr.md) • [Deutsch](README.de.md) • [Español](README.es.md) • [Tiếng Việt](README.vi.md) • [ภาษาไทย](README.th.md) • **Bahasa Indonesia**
+```bash
+npm install -g @pcircle/memesh
+```
+
+[Mulai Sekarang](#mulai-sekarang) · [Cara Kerja](#cara-kerja) · [Perintah](#perintah) · [Dokumentasi](docs/USER_GUIDE.md)
+
+[English](README.md) · [繁體中文](README.zh-TW.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [Español](README.es.md) · [Tiếng Việt](README.vi.md) · [ภาษาไทย](README.th.md) · **Bahasa Indonesia**
 
 </div>
 
+> **Catatan**: Proyek ini awalnya bernama "Claude Code Buddy" dan telah diganti nama menjadi MeMesh Plugin untuk menghindari masalah merek dagang.
+
 ---
 
-## Mengapa Proyek Ini Ada
+## Masalahnya
 
-Saya sangat suka Claude Code. Cara saya membangun software jadi berubah total.
+Anda sedang mengerjakan proyek dengan Claude Code. Anda membuat keputusan penting tiga sesi yang lalu — pustaka auth mana yang dipilih, mengapa memilih skema database itu, pola apa yang harus diikuti. Tapi Claude tidak ingat. Anda mengulang penjelasan. Anda kehilangan konteks. Anda membuang waktu.
 
-Proyek ini dimulai karena saya ingin membantu lebih banyak orang — terutama yang baru belajar coding — untuk mendapatkan manfaat maksimal dari Claude Code untuk vibe coding. Satu hal yang saya perhatikan: ketika proyek semakin besar, sulit untuk melacak semua keputusan yang dibuat antar sesi. Jadi saya membuat plugin (bersama Claude Code, tentu saja) yang mengingat untuk Anda.
+**MeMesh memperbaiki ini.** MeMesh memberikan Claude memori yang persisten dan dapat dicari yang berkembang bersama proyek Anda.
 
-> **Catatan**: Proyek ini awalnya bernama "Claude Code Buddy" dan telah diganti nama menjadi MeMesh Plugin untuk menghindari masalah merek dagang.
+---
+
+## Cara Kerja
+
+<table>
+<tr>
+<td width="50%">
+
+### Sebelum MeMesh
+```
+Sesi 1: "Gunakan JWT untuk auth"
+Sesi 2: "Kenapa kita pilih JWT tadi?"
+Sesi 3: "Tunggu, pustaka auth apa yang kita pakai?"
+```
+Anda mengulang keputusan. Claude lupa konteks. Progres terhenti.
+
+</td>
+<td width="50%">
 
-## Apa yang Bisa Dilakukan?
+### Setelah MeMesh
+```
+Sesi 1: "Gunakan JWT untuk auth" → tersimpan
+Sesi 2: buddy-remember "auth" → langsung teringat
+Sesi 3: Konteks dimuat otomatis saat mulai
+```
+Setiap sesi melanjutkan dari yang terakhir.
 
-MeMesh Plugin membuat Claude Code lebih cerdas dan produktif. Bukan hanya memori — ini adalah toolkit lengkap:
+</td>
+</tr>
+</table>
 
-**Memori proyek yang bisa dicari** — Otomatis menyimpan keputusan, pola, dan pelajaran. Cari berdasarkan makna, bukan hanya kata kunci. Tanya "apa yang kita putuskan tentang auth?" dan langsung dapat jawaban.
+---
 
-**Analisis tugas cerdas** — Saat Anda ketik `buddy-do "tambahkan auth"`, MeMesh menganalisis tugas, mengambil konteks relevan dari pekerjaan sebelumnya, dan memberikan rencana lengkap sebelum eksekusi.
+## Yang Anda Dapatkan
 
-**Otomasi alur kerja** — MeMesh bekerja otomatis di latar belakang:
-- Menampilkan ringkasan sesi terakhir saat memulai
-- Melacak file yang diubah dan diuji
-- Mengingatkan code review sebelum commit
-- Merutekan tugas ke model yang optimal
+**Memori Proyek yang Dapat Dicari** — Tanya "apa yang kita putuskan tentang auth?" dan dapatkan jawaban instan yang dicocokkan secara semantik. Bukan pencarian kata kunci — pencarian berdasarkan *makna*, didukung oleh embedding ONNX lokal.
 
-**Belajar dari kesalahan** — Catat error dan perbaikannya untuk membangun basis pengetahuan dan menghindari kesalahan berulang.
+**Analisis Tugas Cerdas** — `buddy-do "tambahkan auth pengguna"` tidak langsung mengeksekusi. Ia mengambil konteks relevan dari sesi sebelumnya, memeriksa pola yang sudah Anda tetapkan, dan menyusun rencana yang diperkaya sebelum menulis satu baris kode pun.
 
-**Apa bedanya dengan memori bawaan Claude?**
+**Pemanggilan Proaktif** — MeMesh secara otomatis memunculkan memori yang relevan saat Anda memulai sesi, menghadapi kegagalan pengujian, atau menemui error. Tidak perlu pencarian manual.
 
-Claude Code sudah punya auto memory dan CLAUDE.md — bagus untuk pengaturan umum. MeMesh menambahkan **alat khusus proyek**: memori yang bisa dicari berdasarkan makna, analisis tugas dengan konteks sebelumnya, dan alur kerja otomatis yang membuat setiap sesi lebih produktif.
+**Otomasi Alur Kerja** — Ringkasan sesi saat startup. Pelacakan perubahan file. Pengingat code review sebelum commit. Semuanya berjalan diam-diam di latar belakang.
 
-Bayangkan seperti ini:
-- **CLAUDE.md** = buku panduan Anda untuk Claude
-- **MeMesh** = buku catatan yang bisa dicari + asisten cerdas yang berkembang bersama proyek
+**Belajar dari Kesalahan** — Catat error dan perbaikannya untuk membangun basis pengetahuan. Kesalahan yang sama tidak terjadi dua kali.
 
 ---
 
-## Instalasi
+## Mulai Sekarang
 
-**Yang dibutuhkan**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) dan Node.js 20+
+**Prasyarat**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) + Node.js 20+
 
 ```bash
 npm install -g @pcircle/memesh
@@ -62,16 +91,16 @@ npm install -g @pcircle/memesh
 
 Restart Claude Code. Selesai.
 
-**Cek apakah berhasil** — ketik ini di Claude Code:
+**Verifikasi** — ketik di Claude Code:
 
 ```
 buddy-help
 ```
 
-Anda akan melihat daftar perintah.
+Anda akan melihat daftar perintah yang tersedia.
 
 <details>
-<summary>Instalasi dari source code (untuk kontributor)</summary>
+<summary><strong>Instalasi dari source</strong> (kontributor)</summary>
 
 ```bash
 git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
@@ -83,76 +112,88 @@ npm install && npm run build
 
 ---
 
-## Penggunaan
-
-MeMesh menambahkan 3 perintah ke Claude Code:
+## Perintah
 
 | Perintah | Fungsi |
 |----------|--------|
-| `buddy-do "tugas"` | Jalankan tugas dengan konteks memori |
+| `buddy-do "tugas"` | Jalankan tugas dengan konteks memori penuh |
 | `buddy-remember "topik"` | Cari keputusan dan konteks sebelumnya |
 | `buddy-help` | Tampilkan perintah yang tersedia |
 
-**Contoh:**
+**Contoh nyata:**
 
 ```bash
-buddy-do "jelaskan codebase ini"
-buddy-do "tambahkan autentikasi pengguna"
-buddy-remember "keputusan desain API"
-buddy-remember "kenapa pilih PostgreSQL"
+# Pahami codebase yang baru Anda temui
+buddy-do "explain this codebase"
+
+# Bangun fitur dengan konteks dari pekerjaan sebelumnya
+buddy-do "add user authentication"
+
+# Ingat kembali mengapa keputusan dibuat
+buddy-remember "API design decisions"
+buddy-remember "why we chose PostgreSQL"
 ```
 
-Semua data disimpan secara lokal di komputer Anda. Keputusan disimpan selama 90 hari, catatan sesi selama 30 hari.
+Semua data tetap di mesin Anda. Keputusan disimpan 90 hari, catatan sesi 30 hari.
 
 ---
 
-## Platform yang Didukung
+## Apa Bedanya dengan CLAUDE.md?
+
+| | CLAUDE.md | MeMesh |
+|---|-----------|--------|
+| **Tujuan** | Instruksi statis untuk Claude | Memori hidup yang berkembang bersama proyek |
+| **Pencarian** | Pencarian teks manual | Pencarian semantik berdasarkan makna |
+| **Pembaruan** | Anda edit secara manual | Otomatis menangkap keputusan saat Anda bekerja |
+| **Pemanggilan** | Selalu dimuat (bisa jadi panjang) | Memunculkan konteks relevan sesuai kebutuhan |
+| **Cakupan** | Preferensi umum | Grafik pengetahuan khusus proyek |
+
+**Keduanya bekerja bersama.** CLAUDE.md memberi tahu Claude *cara* bekerja. MeMesh mengingat *apa* yang telah Anda bangun.
+
+---
+
+## Dukungan Platform
 
 | Platform | Status |
 |----------|--------|
-| **macOS** | ✅ Berjalan |
-| **Linux** | ✅ Berjalan |
-| **Windows** | ✅ Berjalan (WSL2 direkomendasikan) |
-
-**Kompatibel dengan:**
-- Claude Code CLI (terminal)
-- Claude Code VS Code Extension
-- Cursor (via MCP)
-- Editor lain yang kompatibel MCP
+| macOS | ✅ |
+| Linux | ✅ |
+| Windows | ✅ (WSL2 direkomendasikan) |
 
-**Claude Desktop (Cowork)**: Perintah dasar berfungsi, tetapi fitur memori membutuhkan versi CLI. Lihat [detail Cowork](docs/COWORK_SUPPORT.md).
+**Kompatibel dengan:** Claude Code CLI · VS Code Extension · Cursor (via MCP) · Editor mana pun yang kompatibel MCP
 
 ---
 
-## Pemecahan Masalah
+## Arsitektur
 
-**MeMesh tidak muncul?**
+MeMesh berjalan sebagai server MCP lokal berdampingan dengan Claude Code:
 
-```bash
-# Periksa instalasi
-npm list -g @pcircle/memesh
+- **Knowledge Graph** — Penyimpanan entitas berbasis SQLite dengan pencarian teks lengkap FTS5
+- **Vector Embeddings** — Runtime ONNX untuk kesamaan semantik (berjalan 100% lokal)
+- **Content Dedup** — Hashing SHA-256 melewati komputasi embedding yang redundan
+- **Batch Processing** — Operasi massal yang efisien untuk basis pengetahuan besar
+- **Hook System** — Pemanggilan proaktif saat memulai sesi, kegagalan pengujian, dan error
 
-# Periksa versi Node.js (butuh 20+)
-node --version
+Semuanya berjalan secara lokal. Tanpa cloud. Tanpa panggilan API. Data Anda tidak pernah meninggalkan mesin Anda.
 
-# Jalankan ulang setup
-memesh setup
-```
+---
 
-Lalu restart Claude Code sepenuhnya.
+## Dokumentasi
 
-Bantuan lainnya: [Panduan Pemecahan Masalah](docs/TROUBLESHOOTING.md)
+| Dokumen | Deskripsi |
+|---------|-----------|
+| [Memulai](docs/GETTING_STARTED.md) | Panduan setup langkah demi langkah |
+| [Panduan Pengguna](docs/USER_GUIDE.md) | Panduan penggunaan lengkap dengan contoh |
+| [Perintah](docs/COMMANDS.md) | Referensi perintah lengkap |
+| [Arsitektur](docs/ARCHITECTURE.md) | Penjelasan teknis mendalam |
+| [Kontribusi](CONTRIBUTING.md) | Panduan kontribusi |
+| [Pengembangan](docs/DEVELOPMENT.md) | Setup pengembangan untuk kontributor |
 
 ---
 
-## Pelajari Lebih Lanjut
+## Kontribusi
 
-- **[Memulai](docs/GETTING_STARTED.md)** — Panduan setup langkah demi langkah
-- **[Panduan Pengguna](docs/USER_GUIDE.md)** — Panduan lengkap dengan contoh
-- **[Perintah](docs/COMMANDS.md)** — Semua perintah yang tersedia
-- **[Arsitektur](docs/ARCHITECTURE.md)** — Cara kerjanya di balik layar
-- **[Kontribusi](CONTRIBUTING.md)** — Mau bantu? Mulai di sini
-- **[Panduan Pengembangan](docs/DEVELOPMENT.md)** — Untuk kontributor
+Kami menyambut kontribusi! Lihat [CONTRIBUTING.md](CONTRIBUTING.md) untuk memulai.
 
 ---
 
@@ -164,8 +205,8 @@ MIT — Lihat [LICENSE](LICENSE)
 
 <div align="center">
 
-Ada masalah? [Buka Issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — kami merespons cepat.
+**Dibangun dengan Claude Code, untuk Claude Code.**
 
-[Laporkan Bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) • [Minta Fitur](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
+[Laporkan Bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) · [Minta Fitur](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions) · [Dapatkan Bantuan](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
 
 </div>