@pcircle/memesh 2.9.2 → 2.9.4

package/README.de.md

@@ -1,77 +1,106 @@
 <div align="center">
 
-# 🧠 MeMesh Plugin
+<img src="https://img.shields.io/badge/%F0%9F%A7%A0-MeMesh-blueviolet?style=for-the-badge" alt="MeMesh" />
 
-### Produktivitäts-Plugin für Claude Code
+# MeMesh
 
-Speicher, intelligente Aufgabenanalyse und Workflow-Automatisierung — in einem Plugin.
+### Deine KI-Coding-Sitzungen verdienen ein Gedächtnis.
 
-[![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 gibt Claude Code ein persistentes, durchsuchbares Gedächtnis — damit jede Sitzung auf der vorherigen aufbaut.
 
-[Installation](#installation) • [Verwendung](#verwendung) • [Fehlerbehebung](#fehlerbehebung)
+[![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** • [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
+```
+
+[Loslegen](#loslegen) · [So funktioniert es](#so-funktioniert-es) · [Befehle](#befehle) · [Dokumentation](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** · [Español](README.es.md) · [Tiếng Việt](README.vi.md) · [ภาษาไทย](README.th.md) · [Bahasa Indonesia](README.id.md)
 
 </div>
 
+> **Hinweis**: Dieses Projekt hieß ursprünglich „Claude Code Buddy" und wurde in MeMesh Plugin umbenannt, um mögliche Markenrechtsprobleme zu vermeiden.
+
 ---
 
-## Warum dieses Projekt existiert
+## Das Problem
 
-Ich liebe Claude Code. Es hat verändert, wie ich Software entwickle.
+Du steckst mitten in einem Projekt mit Claude Code. Vor drei Sitzungen hast du wichtige Entscheidungen getroffen — welche Auth-Bibliothek, warum dieses Datenbankschema, welche Muster zu verwenden sind. Aber Claude erinnert sich nicht. Du wiederholst dich. Der Kontext geht verloren. Du verschwendest Zeit.
 
-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.
+**MeMesh löst das.** Es gibt Claude ein persistentes, durchsuchbares Gedächtnis, das mit deinem Projekt wächst.
 
-> **Hinweis**: Dieses Projekt hieß ursprünglich „Claude Code Buddy" und wurde in MeMesh Plugin umbenannt, um mögliche Markenrechtsprobleme zu vermeiden.
+---
+
+## So funktioniert es
+
+<table>
+<tr>
+<td width="50%">
+
+### Vor MeMesh
+```
+Sitzung 1: "Verwende JWT für Auth"
+Sitzung 2: "Warum haben wir JWT gewählt?"
+Sitzung 3: "Moment, welche Auth-Bibliothek nutzen wir?"
+```
+Du wiederholst Entscheidungen. Claude vergisst den Kontext. Der Fortschritt stockt.
+
+</td>
+<td width="50%">
 
-## Was kann es?
+### Nach MeMesh
+```
+Sitzung 1: "Verwende JWT für Auth" → gespeichert
+Sitzung 2: buddy-remember "auth" → sofortiger Abruf
+Sitzung 3: Kontext wird beim Start automatisch geladen
+```
+Jede Sitzung knüpft dort an, wo du aufgehört hast.
 
-MeMesh Plugin macht Claude Code schlauer und produktiver. Es ist nicht nur ein Speicher — es ist ein komplettes Toolkit:
+</td>
+</tr>
+</table>
 
-**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.
+## Was du bekommst
 
-**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
+**Durchsuchbares Projektgedächtnis** — Frage „Was haben wir über Auth entschieden?" und erhalte sofort eine semantisch abgeglichene Antwort. Keine Stichwortsuche — *Bedeutungssuche*, angetrieben durch lokale ONNX-Embeddings.
 
-**Aus Fehlern lernen** — Fehler und Korrekturen aufzeichnen, um eine Wissensbasis aufzubauen und wiederholte Fehler zu vermeiden.
+**Intelligente Aufgabenanalyse** — `buddy-do "Benutzer-Auth hinzufügen"` führt nicht einfach aus. Es zieht relevanten Kontext aus vergangenen Sitzungen, prüft welche Muster du etabliert hast und erstellt einen angereicherten Plan, bevor eine einzige Zeile geschrieben wird.
 
-**Wie unterscheidet sich das vom eingebauten Gedächtnis von Claude?**
+**Proaktiver Abruf** — MeMesh ruft automatisch relevante Erinnerungen ab, wenn du eine Sitzung startest, ein Test fehlschlägt oder ein Fehler auftritt. Kein manuelles Suchen nötig.
 
-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.
+**Workflow-Automatisierung** — Sitzungszusammenfassungen beim Start. Verfolgung von Dateiänderungen. Code-Review-Erinnerungen vor Commits. Alles läuft leise im Hintergrund.
 
-So kann man es sich vorstellen:
-- **CLAUDE.md** = eure Bedienungsanleitung für Claude
-- **MeMesh** = durchsuchbares Notizbuch + intelligenter Assistent, der mit eurem Projekt wächst
+**Aus Fehlern lernen** — Fehler und Korrekturen aufzeichnen, um eine Wissensbasis aufzubauen. Derselbe Fehler passiert nicht zweimal.
 
 ---
 
-## Installation
+## Loslegen
 
-**Ihr braucht**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) und Node.js 20+
+**Voraussetzungen**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) + Node.js 20+
 
 ```bash
 npm install -g @pcircle/memesh
 ```
 
-Claude Code neu starten. Fertig.
+Claude Code neu starten. Das war's.
 
-**Funktioniert es?** — Tippt das in Claude Code ein:
+**Überprüfen** — tippe in Claude Code:
 
 ```
 buddy-help
 ```
 
-Ihr solltet eine Liste von Befehlen sehen.
+Du solltest eine Liste der verfügbaren Befehle sehen.
 
 <details>
-<summary>Aus dem Quellcode installieren (für Mitwirkende)</summary>
+<summary><strong>Aus dem Quellcode installieren</strong> (für Mitwirkende)</summary>
 
 ```bash
 git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
@@ -83,76 +112,88 @@ npm install && npm run build
 
 ---
 
-## Verwendung
-
-MeMesh fügt 3 Befehle zu Claude Code hinzu:
+## Befehle
 
-| Befehl | Funktion |
-|--------|----------|
-| `buddy-do "Aufgabe"` | Aufgabe mit Speicherkontext ausführen |
-| `buddy-remember "Thema"` | Vergangene Entscheidungen und Kontext suchen |
+| Befehl | Was er tut |
+|--------|-----------|
+| `buddy-do "Aufgabe"` | Aufgabe mit vollem Gedächtniskontext ausführen |
+| `buddy-remember "Thema"` | Vergangene Entscheidungen und Kontext durchsuchen |
 | `buddy-help` | Verfügbare Befehle anzeigen |
 
-**Beispiele:**
+**Praxisbeispiele:**
 
 ```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"
+# Sich in einer neuen Codebase orientieren
+buddy-do "explain this codebase"
+
+# Features mit Kontext aus vergangener Arbeit bauen
+buddy-do "add user authentication"
+
+# Nachvollziehen, warum Entscheidungen getroffen wurden
+buddy-remember "API design decisions"
+buddy-remember "why we chose PostgreSQL"
 ```
 
-Alle Daten werden lokal auf eurem Rechner gespeichert. Entscheidungen werden 90 Tage aufbewahrt, Sitzungsnotizen 30 Tage.
+Alle Daten bleiben auf deinem Rechner. Entscheidungen werden 90 Tage aufbewahrt, Sitzungsnotizen 30 Tage.
 
 ---
 
-## Unterstützte Plattformen
+## Wie unterscheidet sich das von CLAUDE.md?
+
+| | CLAUDE.md | MeMesh |
+|---|-----------|--------|
+| **Zweck** | Statische Anweisungen für Claude | Lebendiges Gedächtnis, das mit deinem Projekt wächst |
+| **Suche** | Manuelle Textsuche | Semantische Suche nach Bedeutung |
+| **Aktualisierung** | Du bearbeitest manuell | Erfasst Entscheidungen automatisch während der Arbeit |
+| **Abruf** | Wird immer geladen (kann lang werden) | Zeigt relevanten Kontext bei Bedarf |
+| **Umfang** | Allgemeine Präferenzen | Projektspezifischer Wissensgraph |
+
+**Sie ergänzen sich.** CLAUDE.md sagt Claude, *wie* er arbeiten soll. MeMesh erinnert sich daran, *was* ihr gebaut habt.
+
+---
+
+## Plattformunterstützung
 
 | 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
+| macOS | ✅ |
+| Linux | ✅ |
+| Windows | ✅ (WSL2 empfohlen) |
 
-**Claude Desktop (Cowork)**: Grundbefehle funktionieren, aber Speicherfunktionen benötigen die CLI-Version. Siehe [Cowork-Details](docs/COWORK_SUPPORT.md).
+**Funktioniert mit:** Claude Code CLI · VS Code Extension · Cursor (via MCP) · Jeder MCP-kompatible Editor
 
 ---
 
-## Fehlerbehebung
+## Architektur
 
-**MeMesh erscheint nicht?**
+MeMesh läuft als lokaler MCP-Server neben Claude Code:
 
-```bash
-# Installation prüfen
-npm list -g @pcircle/memesh
+- **Knowledge Graph** — SQLite-basierter Entity-Speicher mit FTS5-Volltextsuche
+- **Vector Embeddings** — ONNX Runtime für semantische Ähnlichkeit (läuft 100% lokal)
+- **Content Dedup** — SHA-256-Hashing überspringt redundante Embedding-Berechnungen
+- **Batch Processing** — Effiziente Massenoperationen für große Wissensbasen
+- **Hook System** — Proaktiver Abruf bei Sitzungsstart, Testfehlern und Fehlern
 
-# Node.js-Version prüfen (20+ benötigt)
-node --version
+Alles läuft lokal. Keine Cloud. Keine API-Aufrufe. Deine Daten verlassen nie deinen Rechner.
 
-# Setup erneut ausführen
-memesh setup
-```
+---
 
-Dann Claude Code vollständig neu starten.
+## Dokumentation
 
-Weitere Hilfe: [Fehlerbehebungsanleitung](docs/TROUBLESHOOTING.md)
+| Dokument | Beschreibung |
+|----------|-------------|
+| [Erste Schritte](docs/GETTING_STARTED.md) | Schritt-für-Schritt-Einrichtungsanleitung |
+| [Benutzerhandbuch](docs/USER_GUIDE.md) | Vollständige Anleitung mit Beispielen |
+| [Befehle](docs/COMMANDS.md) | Komplette Befehlsreferenz |
+| [Architektur](docs/ARCHITECTURE.md) | Technischer Tiefgang |
+| [Mitwirken](CONTRIBUTING.md) | Richtlinien für Beiträge |
+| [Entwicklung](docs/DEVELOPMENT.md) | Entwicklungsumgebung für Mitwirkende |
 
 ---
 
-## Mehr erfahren
+## Mitwirken
 
-- **[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
+Beiträge sind willkommen! Siehe [CONTRIBUTING.md](CONTRIBUTING.md) für den Einstieg.
 
 ---
 
@@ -164,8 +205,8 @@ 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.
+**Gebaut mit Claude Code, für Claude Code.**
 
-[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)
+[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) · [Hilfe erhalten](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
 
 </div>

package/README.es.md

@@ -1,77 +1,106 @@
 <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 productividad para Claude Code
+# MeMesh
 
-Memoria, análisis inteligente de tareas y automatización — todo en un plugin.
+### Tus sesiones de programación con IA merecen memoria.
 
-[![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 le da a Claude Code una memoria persistente y consultable — para que cada sesión se base en la anterior.
 
-[Instalación](#instalación) • [Uso](#uso) • [Solución de problemas](#solución-de-problemas)
+[![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** • [Tiếng Việt](README.vi.md) • [ภาษาไทย](README.th.md) • [Bahasa Indonesia](README.id.md)
+```bash
+npm install -g @pcircle/memesh
+```
+
+[Comenzar](#comenzar) · [Cómo funciona](#cómo-funciona) · [Comandos](#comandos) · [Docs](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** · [Tiếng Việt](README.vi.md) · [ภาษาไทย](README.th.md) · [Bahasa Indonesia](README.id.md)
 
 </div>
 
+> **Nota**: Este proyecto se llamaba originalmente "Claude Code Buddy" y fue renombrado a MeMesh Plugin para evitar posibles problemas de marca registrada.
+
 ---
 
-## Por qué existe este proyecto
+## El problema
 
-Me encanta Claude Code. Ha cambiado cómo construyo software.
+Estás metido de lleno en un proyecto con Claude Code. Tomaste decisiones importantes hace tres sesiones — qué biblioteca de autenticación usar, por qué elegiste ese esquema de base de datos, qué patrones seguir. Pero Claude no recuerda. Te repites. Pierdes contexto. Pierdes tiempo.
 
-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.
+**MeMesh soluciona esto.** Le da a Claude una memoria persistente y consultable que crece con tu proyecto.
 
-> **Nota**: Este proyecto se llamaba originalmente "Claude Code Buddy" y fue renombrado a MeMesh Plugin para evitar posibles problemas de marca registrada.
+---
+
+## Cómo funciona
+
+<table>
+<tr>
+<td width="50%">
+
+### Antes de MeMesh
+```
+Session 1: "Use JWT for auth"
+Session 2: "Why did we pick JWT again?"
+Session 3: "Wait, what auth library are we using?"
+```
+Repites decisiones. Claude olvida el contexto. El progreso se detiene.
+
+</td>
+<td width="50%">
 
-## ¿Qué hace?
+### Después de MeMesh
+```
+Session 1: "Use JWT for auth" → saved
+Session 2: buddy-remember "auth" → instant recall
+Session 3: Context auto-loaded on start
+```
+Cada sesión continúa donde lo dejaste.
 
-MeMesh Plugin hace Claude Code más inteligente y productivo. No es solo memoria — es un kit de herramientas completo:
+</td>
+</tr>
+</table>
 
-**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.
+## Lo que obtienes
 
-**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
+**Memoria de proyecto consultable** — Pregunta "¿qué decidimos sobre la auth?" y obtén una respuesta instantánea con coincidencia semántica. No es búsqueda por palabras clave — es búsqueda por *significado*, impulsada por embeddings ONNX locales.
 
-**Aprender de los errores** — Registra errores y correcciones para construir una base de conocimiento y evitar repetir los mismos errores.
+**Análisis inteligente de tareas** — `buddy-do "add user auth"` no solo ejecuta. Extrae contexto relevante de sesiones anteriores, verifica qué patrones has establecido y construye un plan enriquecido antes de escribir una sola línea.
 
-**¿En qué se diferencia de la memoria integrada de Claude?**
+**Recuperación proactiva** — MeMesh muestra automáticamente memorias relevantes cuando inicias una sesión, cuando falla un test o cuando encuentras un error. Sin búsqueda manual necesaria.
 
-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.
+**Automatización del flujo de trabajo** — Resúmenes de sesión al iniciar. Seguimiento de cambios en archivos. Recordatorios de revisión de código antes de commits. Todo ejecutándose silenciosamente en segundo plano.
 
-Piénsalo así:
-- **CLAUDE.md** = tu manual de instrucciones para Claude
-- **MeMesh** = un cuaderno consultable + asistente inteligente que crece con tu proyecto
+**Aprendizaje de errores** — Registra errores y correcciones para construir una base de conocimiento. El mismo error no ocurre dos veces.
 
 ---
 
-## Instalación
+## Comenzar
 
-**Necesitas**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) y Node.js 20+
+**Requisitos previos**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) + Node.js 20+
 
 ```bash
 npm install -g @pcircle/memesh
 ```
 
-Reinicia Claude Code. Listo.
+Reinicia Claude Code. Eso es todo.
 
-**Verificar que funciona** — escribe esto en Claude Code:
+**Verificar** — escribe en Claude Code:
 
 ```
 buddy-help
 ```
 
-Deberías ver una lista de comandos.
+Deberías ver una lista de comandos disponibles.
 
 <details>
-<summary>Instalar desde el código fuente (para contribuidores)</summary>
+<summary><strong>Instalar desde el código fuente</strong> (contribuidores)</summary>
 
 ```bash
 git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
@@ -83,76 +112,88 @@ npm install && npm run build
 
 ---
 
-## Uso
-
-MeMesh añade 3 comandos a Claude Code:
+## Comandos
 
 | Comando | Qué hace |
 |---------|----------|
-| `buddy-do "tarea"` | Ejecutar una tarea con contexto de memoria |
+| `buddy-do "tarea"` | Ejecutar una tarea con contexto de memoria completo |
 | `buddy-remember "tema"` | Buscar decisiones y contexto anteriores |
 | `buddy-help` | Mostrar comandos disponibles |
 
-**Ejemplos:**
+**Ejemplos reales:**
 
 ```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"
+# Orientarte en un codebase nuevo para ti
+buddy-do "explain this codebase"
+
+# Construir funcionalidades con contexto de trabajo anterior
+buddy-do "add user authentication"
+
+# Recordar por qué se tomaron decisiones
+buddy-remember "API design decisions"
+buddy-remember "why we chose 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.
+Todos los datos permanecen en tu máquina. Las decisiones se conservan 90 días, las notas de sesión 30 días.
+
+---
+
+## ¿En qué se diferencia de CLAUDE.md?
+
+| | CLAUDE.md | MeMesh |
+|---|-----------|--------|
+| **Propósito** | Instrucciones estáticas para Claude | Memoria viva que crece con tu proyecto |
+| **Búsqueda** | Búsqueda manual de texto | Búsqueda semántica por significado |
+| **Actualizaciones** | Las editas manualmente | Captura decisiones automáticamente mientras trabajas |
+| **Recuperación** | Siempre cargado (puede volverse extenso) | Muestra contexto relevante bajo demanda |
+| **Alcance** | Preferencias generales | Grafo de conocimiento específico del proyecto |
+
+**Funcionan juntos.** CLAUDE.md le dice a Claude *cómo* trabajar. MeMesh recuerda *qué* has construido.
 
 ---
 
 ## 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
+|------------|--------|
+| macOS | ✅ |
+| Linux | ✅ |
+| Windows | ✅ (WSL2 recomendado) |
 
-**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).
+**Compatible con:** Claude Code CLI · VS Code Extension · Cursor (vía MCP) · Cualquier editor compatible con MCP
 
 ---
 
-## Solución de problemas
+## Arquitectura
 
-**¿MeMesh no aparece?**
+MeMesh se ejecuta como un servidor MCP local junto a Claude Code:
 
-```bash
-# Verificar instalación
-npm list -g @pcircle/memesh
+- **Grafo de conocimiento** — Almacén de entidades respaldado por SQLite con búsqueda de texto completo FTS5
+- **Embeddings vectoriales** — Runtime ONNX para similitud semántica (se ejecuta 100% localmente)
+- **Deduplicación de contenido** — Hashing SHA-256 omite cálculos de embedding redundantes
+- **Procesamiento por lotes** — Operaciones masivas eficientes para grandes bases de conocimiento
+- **Sistema de hooks** — Recuperación proactiva al iniciar sesión, fallos de tests y errores
 
-# Verificar versión de Node.js (necesita 20+)
-node --version
+Todo se ejecuta localmente. Sin nube. Sin llamadas API. Tus datos nunca salen de tu máquina.
 
-# Volver a ejecutar el setup
-memesh setup
-```
+---
 
-Luego reinicia Claude Code completamente.
+## Documentación
 
-Más ayuda: [Guía de solución de problemas](docs/TROUBLESHOOTING.md)
+| Documento | Descripción |
+|-----------|-------------|
+| [Primeros pasos](docs/GETTING_STARTED.md) | Guía de configuración paso a paso |
+| [Guía de usuario](docs/USER_GUIDE.md) | Guía completa de uso con ejemplos |
+| [Comandos](docs/COMMANDS.md) | Referencia completa de comandos |
+| [Arquitectura](docs/ARCHITECTURE.md) | Análisis técnico en profundidad |
+| [Contribuir](CONTRIBUTING.md) | Directrices para contribuir |
+| [Desarrollo](docs/DEVELOPMENT.md) | Configuración de desarrollo para contribuidores |
 
 ---
 
-## Más información
+## Contribuir
 
-- **[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
+¡Las contribuciones son bienvenidas! Consulta [CONTRIBUTING.md](CONTRIBUTING.md) para comenzar.
 
 ---
 
@@ -164,8 +205,8 @@ 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.
+**Construido con Claude Code, para Claude Code.**
 
-[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)
+[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) · [Obtener ayuda](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
 
 </div>