@pcircle/memesh 2.8.10 → 2.9.0

package/README.de.md

@@ -0,0 +1,171 @@
+<div align="center">
+
+# 🧠 MeMesh Plugin
+
+### Produktivitäts-Plugin für Claude Code
+
+Speicher, intelligente Aufgabenanalyse und Workflow-Automatisierung — in einem Plugin.
+
+[![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)
+
+[Installation](#installation) • [Verwendung](#verwendung) • [Fehlerbehebung](#fehlerbehebung)
+
+[English](README.md) • [繁體中文](README.zh-TW.md) • [简体中文](README.zh-CN.md) • [日本語](README.ja.md) • [한국어](README.ko.md) • [Français](README.fr.md) • **Deutsch** • [Español](README.es.md) • [Tiếng Việt](README.vi.md) • [ภาษาไทย](README.th.md) • [Bahasa Indonesia](README.id.md)
+
+</div>
+
+---
+
+## Warum dieses Projekt existiert
+
+Ich liebe Claude Code. Es hat verändert, wie ich Software entwickle.
+
+Dieses Projekt entstand, weil ich mehr Menschen helfen wollte — besonders Programmier-Einsteigern — das Beste aus Claude Code fürs Vibe Coding herauszuholen. Mir ist aufgefallen: Wenn Projekte wachsen, wird es schwer, alle Entscheidungen über Sitzungen hinweg nachzuverfolgen. Also habe ich ein Plugin gebaut (mit Claude Code natürlich), das sich für euch erinnert.
+
+> **Hinweis**: Dieses Projekt hieß ursprünglich „Claude Code Buddy" und wurde in MeMesh Plugin umbenannt, um mögliche Markenrechtsprobleme zu vermeiden.
+
+## Was kann es?
+
+MeMesh Plugin macht Claude Code schlauer und produktiver. Es ist nicht nur ein Speicher — es ist ein komplettes Toolkit:
+
+**Durchsuchbarer Projektspeicher** — Entscheidungen, Muster und Lektionen werden automatisch gespeichert. Suche nach Bedeutung, nicht nur Schlüsselwörtern. Fragt „Warum haben wir PostgreSQL gewählt?" und bekommt sofort Antworten.
+
+**Intelligente Aufgabenanalyse** — Bei `buddy-do "Authentifizierung hinzufügen"` analysiert MeMesh die Aufgabe, zieht relevanten Kontext aus vergangener Arbeit und liefert einen angereicherten Plan vor der Ausführung.
+
+**Workflow-Automatisierung** — MeMesh arbeitet im Hintergrund automatisch:
+- Zeigt beim Sitzungsstart eine Zusammenfassung der letzten Arbeit
+- Verfolgt geänderte und getestete Dateien
+- Erinnert vor dem Commit an Code-Review
+- Routet Aufgaben zum optimalen Modell
+
+**Aus Fehlern lernen** — Fehler und Korrekturen aufzeichnen, um eine Wissensbasis aufzubauen und wiederholte Fehler zu vermeiden.
+
+**Wie unterscheidet sich das vom eingebauten Gedächtnis von Claude?**
+
+Claude Code hat bereits Auto Memory und CLAUDE.md — super für allgemeine Einstellungen. MeMesh fügt projektbezogene **dedizierte Tools** hinzu: bedeutungsbasiert durchsuchbarer Speicher, Aufgabenanalyse mit vergangenem Kontext und automatisierte Workflows, die jede Sitzung produktiver machen.
+
+So kann man es sich vorstellen:
+- **CLAUDE.md** = eure Bedienungsanleitung für Claude
+- **MeMesh** = durchsuchbares Notizbuch + intelligenter Assistent, der mit eurem Projekt wächst
+
+---
+
+## Installation
+
+**Ihr braucht**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) und Node.js 20+
+
+```bash
+npm install -g @pcircle/memesh
+```
+
+Claude Code neu starten. Fertig.
+
+**Funktioniert es?** — Tippt das in Claude Code ein:
+
+```
+buddy-help
+```
+
+Ihr solltet eine Liste von Befehlen sehen.
+
+<details>
+<summary>Aus dem Quellcode installieren (für Mitwirkende)</summary>
+
+```bash
+git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
+cd claude-code-buddy
+npm install && npm run build
+```
+
+</details>
+
+---
+
+## Verwendung
+
+MeMesh fügt 3 Befehle zu Claude Code hinzu:
+
+| Befehl | Funktion |
+|--------|----------|
+| `buddy-do "Aufgabe"` | Aufgabe mit Speicherkontext ausführen |
+| `buddy-remember "Thema"` | Vergangene Entscheidungen und Kontext suchen |
+| `buddy-help` | Verfügbare Befehle anzeigen |
+
+**Beispiele:**
+
+```bash
+buddy-do "erkläre diese Codebase"
+buddy-do "füge Benutzerauthentifizierung hinzu"
+buddy-remember "API-Design-Entscheidungen"
+buddy-remember "warum haben wir PostgreSQL gewählt"
+```
+
+Alle Daten werden lokal auf eurem Rechner gespeichert. Entscheidungen werden 90 Tage aufbewahrt, Sitzungsnotizen 30 Tage.
+
+---
+
+## Unterstützte Plattformen
+
+| Plattform | Status |
+|-----------|--------|
+| **macOS** | ✅ Funktioniert |
+| **Linux** | ✅ Funktioniert |
+| **Windows** | ✅ Funktioniert (WSL2 empfohlen) |
+
+**Kompatibel mit:**
+- Claude Code CLI (Terminal)
+- Claude Code VS Code Extension
+- Cursor (über MCP)
+- Andere MCP-kompatible Editoren
+
+**Claude Desktop (Cowork)**: Grundbefehle funktionieren, aber Speicherfunktionen benötigen die CLI-Version. Siehe [Cowork-Details](docs/COWORK_SUPPORT.md).
+
+---
+
+## Fehlerbehebung
+
+**MeMesh erscheint nicht?**
+
+```bash
+# Installation prüfen
+npm list -g @pcircle/memesh
+
+# Node.js-Version prüfen (20+ benötigt)
+node --version
+
+# Setup erneut ausführen
+memesh setup
+```
+
+Dann Claude Code vollständig neu starten.
+
+Weitere Hilfe: [Fehlerbehebungsanleitung](docs/TROUBLESHOOTING.md)
+
+---
+
+## Mehr erfahren
+
+- **[Erste Schritte](docs/GETTING_STARTED.md)** — Schritt-für-Schritt-Einrichtung
+- **[Benutzerhandbuch](docs/USER_GUIDE.md)** — Vollständige Anleitung mit Beispielen
+- **[Befehle](docs/COMMANDS.md)** — Alle verfügbaren Befehle
+- **[Architektur](docs/ARCHITECTURE.md)** — Wie es unter der Haube funktioniert
+- **[Mitwirken](CONTRIBUTING.md)** — Helfen? Hier starten
+- **[Entwicklungsanleitung](docs/DEVELOPMENT.md)** — Für Mitwirkende
+
+---
+
+## Lizenz
+
+MIT — Siehe [LICENSE](LICENSE)
+
+---
+
+<div align="center">
+
+Etwas funktioniert nicht? [Issue eröffnen](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — wir antworten schnell.
+
+[Bug melden](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) • [Feature anfragen](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
+
+</div>

package/README.es.md

@@ -0,0 +1,171 @@
+<div align="center">
+
+# 🧠 MeMesh Plugin
+
+### Plugin de productividad para Claude Code
+
+Memoria, análisis inteligente de tareas y automatización — todo en un plugin.
+
+[![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)
+
+[Instalación](#instalación) • [Uso](#uso) • [Solución de problemas](#solución-de-problemas)
+
+[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** • [Tiếng Việt](README.vi.md) • [ภาษาไทย](README.th.md) • [Bahasa Indonesia](README.id.md)
+
+</div>
+
+---
+
+## Por qué existe este proyecto
+
+Me encanta Claude Code. Ha cambiado cómo construyo software.
+
+Este proyecto nació porque quería ayudar a más personas — especialmente a quienes están empezando a programar — a sacar el máximo provecho de Claude Code para vibe coding. Algo que noté: cuando los proyectos crecen, se vuelve difícil llevar un registro de todas las decisiones tomadas entre sesiones. Así que construí un plugin (con Claude Code, por supuesto) que recuerda por ti.
+
+> **Nota**: Este proyecto se llamaba originalmente "Claude Code Buddy" y fue renombrado a MeMesh Plugin para evitar posibles problemas de marca registrada.
+
+## ¿Qué hace?
+
+MeMesh Plugin hace Claude Code más inteligente y productivo. No es solo memoria — es un kit de herramientas completo:
+
+**Memoria de proyecto consultable** — Guarda automáticamente decisiones, patrones y lecciones. Busca por significado, no solo por palabras clave. Pregunta "¿qué decidimos sobre la auth?" y obtén respuesta inmediata.
+
+**Análisis inteligente de tareas** — Cuando dices `buddy-do "añadir auth"`, MeMesh analiza la tarea, trae contexto relevante del trabajo pasado y proporciona un plan enriquecido antes de ejecutar.
+
+**Automatización del flujo de trabajo** — MeMesh trabaja en segundo plano para:
+- Mostrar un resumen de tu última sesión al iniciar
+- Rastrear archivos modificados y probados
+- Recordar la revisión de código antes del commit
+- Enrutar tareas al modelo óptimo
+
+**Aprender de los errores** — Registra errores y correcciones para construir una base de conocimiento y evitar repetir los mismos errores.
+
+**¿En qué se diferencia de la memoria integrada de Claude?**
+
+Claude Code ya tiene auto memory y CLAUDE.md — genial para preferencias generales. MeMesh añade **herramientas dedicadas al proyecto**: memoria consultable por significado, análisis de tareas con contexto pasado y flujos de trabajo automatizados que hacen cada sesión más productiva.
+
+Piénsalo así:
+- **CLAUDE.md** = tu manual de instrucciones para Claude
+- **MeMesh** = un cuaderno consultable + asistente inteligente que crece con tu proyecto
+
+---
+
+## Instalación
+
+**Necesitas**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) y Node.js 20+
+
+```bash
+npm install -g @pcircle/memesh
+```
+
+Reinicia Claude Code. Listo.
+
+**Verificar que funciona** — escribe esto en Claude Code:
+
+```
+buddy-help
+```
+
+Deberías ver una lista de comandos.
+
+<details>
+<summary>Instalar desde el código fuente (para contribuidores)</summary>
+
+```bash
+git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
+cd claude-code-buddy
+npm install && npm run build
+```
+
+</details>
+
+---
+
+## Uso
+
+MeMesh añade 3 comandos a Claude Code:
+
+| Comando | Qué hace |
+|---------|----------|
+| `buddy-do "tarea"` | Ejecutar una tarea con contexto de memoria |
+| `buddy-remember "tema"` | Buscar decisiones y contexto anteriores |
+| `buddy-help` | Mostrar comandos disponibles |
+
+**Ejemplos:**
+
+```bash
+buddy-do "explica este codebase"
+buddy-do "añade autenticación de usuario"
+buddy-remember "decisiones de diseño de API"
+buddy-remember "por qué elegimos PostgreSQL"
+```
+
+Todos los datos se almacenan localmente en tu máquina. Las decisiones se guardan 90 días, las notas de sesión 30 días.
+
+---
+
+## Plataformas soportadas
+
+| Plataforma | Estado |
+|-----------|--------|
+| **macOS** | ✅ Funciona |
+| **Linux** | ✅ Funciona |
+| **Windows** | ✅ Funciona (WSL2 recomendado) |
+
+**Compatible con:**
+- Claude Code CLI (terminal)
+- Claude Code VS Code Extension
+- Cursor (vía MCP)
+- Otros editores compatibles con MCP
+
+**Claude Desktop (Cowork)**: Los comandos básicos funcionan, pero las funciones de memoria necesitan la versión CLI. Ver [detalles de Cowork](docs/COWORK_SUPPORT.md).
+
+---
+
+## Solución de problemas
+
+**¿MeMesh no aparece?**
+
+```bash
+# Verificar instalación
+npm list -g @pcircle/memesh
+
+# Verificar versión de Node.js (necesita 20+)
+node --version
+
+# Volver a ejecutar el setup
+memesh setup
+```
+
+Luego reinicia Claude Code completamente.
+
+Más ayuda: [Guía de solución de problemas](docs/TROUBLESHOOTING.md)
+
+---
+
+## Más información
+
+- **[Primeros pasos](docs/GETTING_STARTED.md)** — Configuración paso a paso
+- **[Guía de usuario](docs/USER_GUIDE.md)** — Guía completa con ejemplos
+- **[Comandos](docs/COMMANDS.md)** — Todos los comandos disponibles
+- **[Arquitectura](docs/ARCHITECTURE.md)** — Cómo funciona internamente
+- **[Contribuir](CONTRIBUTING.md)** — ¿Quieres ayudar? Empieza aquí
+- **[Guía de desarrollo](docs/DEVELOPMENT.md)** — Para contribuidores
+
+---
+
+## Licencia
+
+MIT — Ver [LICENSE](LICENSE)
+
+---
+
+<div align="center">
+
+¿Algo no funciona? [Abre un issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — respondemos rápido.
+
+[Reportar bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) • [Solicitar función](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
+
+</div>

package/README.fr.md

@@ -0,0 +1,171 @@
+<div align="center">
+
+# 🧠 MeMesh Plugin
+
+### Plugin de productivité pour Claude Code
+
+Mémoire, analyse intelligente des tâches et automatisation — dans un seul plugin.
+
+[![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)
+
+[Installation](#installation) • [Utilisation](#utilisation) • [Dépannage](#dépannage)
+
+[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>
+
+---
+
+## Pourquoi ce projet existe
+
+J'adore Claude Code. Il a changé ma façon de créer des logiciels.
+
+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.
+
+> **Note** : Ce projet s'appelait à l'origine « Claude Code Buddy » et a été renommé MeMesh Plugin pour éviter d'éventuels problèmes de marque.
+
+## Qu'est-ce que ça fait ?
+
+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 :
+
+**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.
+
+**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
+
+**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.
+
+**En quoi c'est différent de la mémoire intégrée de Claude ?**
+
+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.
+
+Pensez-y comme ça :
+- **CLAUDE.md** = votre manuel d'instructions pour Claude
+- **MeMesh** = un carnet consultable + un assistant intelligent qui apprend avec votre projet
+
+---
+
+## Installation
+
+**Prérequis** : [Claude Code](https://docs.anthropic.com/en/docs/claude-code) et Node.js 20+
+
+```bash
+npm install -g @pcircle/memesh
+```
+
+Redémarrez Claude Code. C'est tout.
+
+**Vérification** — tapez ceci dans Claude Code :
+
+```
+buddy-help
+```
+
+Vous devriez voir une liste de commandes.
+
+<details>
+<summary>Installation depuis les sources (pour les contributeurs)</summary>
+
+```bash
+git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
+cd claude-code-buddy
+npm install && npm run build
+```
+
+</details>
+
+---
+
+## Utilisation
+
+MeMesh ajoute 3 commandes à Claude Code :
+
+| Commande | Fonction |
+|----------|----------|
+| `buddy-do "tâche"` | Exécuter une tâche avec le contexte mémoire |
+| `buddy-remember "sujet"` | Rechercher les décisions et le contexte passés |
+| `buddy-help` | Afficher les commandes disponibles |
+
+**Exemples :**
+
+```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"
+```
+
+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.
+
+---
+
+## Plateformes supportées
+
+| 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
+
+**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).
+
+---
+
+## Dépannage
+
+**MeMesh n'apparaît pas ?**
+
+```bash
+# Vérifier l'installation
+npm list -g @pcircle/memesh
+
+# Vérifier la version de Node.js (20+ requis)
+node --version
+
+# Relancer la configuration
+memesh setup
+```
+
+Puis redémarrez complètement Claude Code.
+
+Plus d'aide : [Guide de dépannage](docs/TROUBLESHOOTING.md)
+
+---
+
+## En savoir plus
+
+- **[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
+
+---
+
+## Licence
+
+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.
+
+[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)
+
+</div>

package/README.id.md

@@ -0,0 +1,171 @@
+<div align="center">
+
+# 🧠 MeMesh Plugin
+
+### Plugin produktivitas untuk Claude Code
+
+Memori, analisis tugas cerdas, dan otomasi alur kerja — semua dalam satu plugin.
+
+[![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)
+
+[Instalasi](#instalasi) • [Penggunaan](#penggunaan) • [Pemecahan Masalah](#pemecahan-masalah)
+
+[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>
+
+---
+
+## Mengapa Proyek Ini Ada
+
+Saya sangat suka Claude Code. Cara saya membangun software jadi berubah total.
+
+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.
+
+> **Catatan**: Proyek ini awalnya bernama "Claude Code Buddy" dan telah diganti nama menjadi MeMesh Plugin untuk menghindari masalah merek dagang.
+
+## Apa yang Bisa Dilakukan?
+
+MeMesh Plugin membuat Claude Code lebih cerdas dan produktif. Bukan hanya memori — ini adalah toolkit lengkap:
+
+**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.
+
+**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
+
+**Belajar dari kesalahan** — Catat error dan perbaikannya untuk membangun basis pengetahuan dan menghindari kesalahan berulang.
+
+**Apa bedanya dengan memori bawaan Claude?**
+
+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.
+
+Bayangkan seperti ini:
+- **CLAUDE.md** = buku panduan Anda untuk Claude
+- **MeMesh** = buku catatan yang bisa dicari + asisten cerdas yang berkembang bersama proyek
+
+---
+
+## Instalasi
+
+**Yang dibutuhkan**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) dan Node.js 20+
+
+```bash
+npm install -g @pcircle/memesh
+```
+
+Restart Claude Code. Selesai.
+
+**Cek apakah berhasil** — ketik ini di Claude Code:
+
+```
+buddy-help
+```
+
+Anda akan melihat daftar perintah.
+
+<details>
+<summary>Instalasi dari source code (untuk kontributor)</summary>
+
+```bash
+git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
+cd claude-code-buddy
+npm install && npm run build
+```
+
+</details>
+
+---
+
+## Penggunaan
+
+MeMesh menambahkan 3 perintah ke Claude Code:
+
+| Perintah | Fungsi |
+|----------|--------|
+| `buddy-do "tugas"` | Jalankan tugas dengan konteks memori |
+| `buddy-remember "topik"` | Cari keputusan dan konteks sebelumnya |
+| `buddy-help` | Tampilkan perintah yang tersedia |
+
+**Contoh:**
+
+```bash
+buddy-do "jelaskan codebase ini"
+buddy-do "tambahkan autentikasi pengguna"
+buddy-remember "keputusan desain API"
+buddy-remember "kenapa pilih PostgreSQL"
+```
+
+Semua data disimpan secara lokal di komputer Anda. Keputusan disimpan selama 90 hari, catatan sesi selama 30 hari.
+
+---
+
+## Platform yang Didukung
+
+| 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
+
+**Claude Desktop (Cowork)**: Perintah dasar berfungsi, tetapi fitur memori membutuhkan versi CLI. Lihat [detail Cowork](docs/COWORK_SUPPORT.md).
+
+---
+
+## Pemecahan Masalah
+
+**MeMesh tidak muncul?**
+
+```bash
+# Periksa instalasi
+npm list -g @pcircle/memesh
+
+# Periksa versi Node.js (butuh 20+)
+node --version
+
+# Jalankan ulang setup
+memesh setup
+```
+
+Lalu restart Claude Code sepenuhnya.
+
+Bantuan lainnya: [Panduan Pemecahan Masalah](docs/TROUBLESHOOTING.md)
+
+---
+
+## Pelajari Lebih Lanjut
+
+- **[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
+
+---
+
+## Lisensi
+
+MIT — Lihat [LICENSE](LICENSE)
+
+---
+
+<div align="center">
+
+Ada masalah? [Buka Issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — kami merespons cepat.
+
+[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)
+
+</div>