@pcircle/memesh 2.9.1 → 2.9.3

package/README.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" />
 
-### A productivity plugin for Claude Code
+# MeMesh
 
-Memory, smart task analysis, and workflow automation — all in one plugin.
+### Your AI coding sessions deserve memory.
 
-[![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 gives Claude Code persistent, searchable memory — so every session builds on the last.
 
-[Install](#install) • [Usage](#usage) • [Troubleshooting](#troubleshooting)
+[![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)
 
-[繁體中文](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](README.id.md)
+```bash
+npm install -g @pcircle/memesh
+```
+
+[Get Started](#get-started) · [How It Works](#how-it-works) · [Commands](#commands) · [Docs](docs/USER_GUIDE.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](README.id.md)
 
 </div>
 
+> **Note**: This project was originally called "Claude Code Buddy" and has been renamed to MeMesh Plugin to avoid potential trademark issues.
+
 ---
 
-## Why This Project Exists
+## The Problem
 
-I love Claude Code. It's changed how I build software.
+You're deep into a project with Claude Code. You made important decisions three sessions ago — which auth library, why you chose that database schema, what patterns to follow. But Claude doesn't remember. You repeat yourself. You lose context. You waste time.
 
-This project started because I wanted to help more people — especially those new to coding — get the most out of Claude Code for vibe coding. One thing I noticed: when projects grow, it gets hard to keep track of all the decisions you've made across sessions. So I built a plugin (with Claude Code, of course) that remembers for you.
+**MeMesh fixes this.** It gives Claude a persistent, searchable memory that grows with your project.
 
-> **Note**: This project was originally called "Claude Code Buddy" and has been renamed to MeMesh Plugin to avoid potential trademark issues.
+---
+
+## How It Works
+
+<table>
+<tr>
+<td width="50%">
+
+### Before MeMesh
+```
+Session 1: "Use JWT for auth"
+Session 2: "Why did we pick JWT again?"
+Session 3: "Wait, what auth library are we using?"
+```
+You repeat decisions. Claude forgets context. Progress stalls.
+
+</td>
+<td width="50%">
 
-## What Does It Do?
+### After MeMesh
+```
+Session 1: "Use JWT for auth" → saved
+Session 2: buddy-remember "auth" → instant recall
+Session 3: Context auto-loaded on start
+```
+Every session picks up where you left off.
 
-MeMesh Plugin makes Claude Code smarter and more productive. It's not just memory — it's a full toolkit:
+</td>
+</tr>
+</table>
 
-**Searchable Project Memory** — Automatically saves decisions, patterns, and lessons as you work. Search by meaning, not just keywords. Ask "what did we decide about auth?" and get an instant answer.
+---
 
-**Smart Task Analysis** — When you say `buddy-do "add user auth"`, MeMesh analyzes the task, pulls in relevant context from past work, and gives you an enriched plan before executing.
+## What You Get
 
-**Workflow Automation** — Behind the scenes, MeMesh hooks into Claude Code to:
-- Show you a recap of your last session when you start
-- Track which files you've changed and tested
-- Remind you about code reviews before committing
-- Route tasks to the right model (fast model for search, powerful model for planning)
+**Searchable Project Memory** — Ask "what did we decide about auth?" and get an instant, semantically-matched answer. Not keyword search — *meaning* search, powered by local ONNX embeddings.
 
-**Learn from Mistakes** — Record errors and their fixes so they don't happen again. MeMesh builds a knowledge base of what works and what doesn't.
+**Smart Task Analysis** — `buddy-do "add user auth"` doesn't just execute. It pulls relevant context from past sessions, checks what patterns you've established, and builds an enriched plan before writing a single line.
 
-**How is this different from Claude's built-in memory?**
+**Proactive Recall** — MeMesh automatically surfaces relevant memories when you start a session, hit a test failure, or encounter an error. No manual searching needed.
 
-Claude Code already has auto memory and CLAUDE.md — great for general preferences and instructions. MeMesh adds dedicated **project-level tools** on top: searchable memory you can query by meaning, task analysis that pulls in past context, and automated workflows that make every session more productive.
+**Workflow Automation** — Session recaps on startup. File change tracking. Code review reminders before commits. All running silently in the background.
 
-Think of it this way:
-- **CLAUDE.md** = your instruction manual for Claude
-- **MeMesh** = a searchable notebook + smart assistant that learns as your project grows
+**Mistake Learning** — Record errors and fixes to build a knowledge base. The same mistake doesn't happen twice.
 
 ---
 
-## Install
+## Get Started
 
-**You need**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and Node.js 20+
+**Prerequisites**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) + Node.js 20+
 
 ```bash
 npm install -g @pcircle/memesh
 ```
 
-Restart Claude Code. Done.
+Restart Claude Code. That's it.
 
-**Check it works** — type this in Claude Code:
+**Verify** — type in Claude Code:
 
 ```
 buddy-help
 ```
 
-You should see a list of commands.
+You should see a list of available commands.
 
 <details>
-<summary>Install from source (for contributors)</summary>
+<summary><strong>Install from source</strong> (contributors)</summary>
 
 ```bash
 git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
@@ -83,76 +112,88 @@ npm install && npm run build
 
 ---
 
-## Usage
-
-MeMesh adds 3 commands to Claude Code:
+## Commands
 
 | Command | What it does |
 |---------|-------------|
-| `buddy-do "task"` | Run a task with memory context |
-| `buddy-remember "topic"` | Search for past decisions and context |
+| `buddy-do "task"` | Execute a task with full memory context |
+| `buddy-remember "topic"` | Search past decisions and context |
 | `buddy-help` | Show available commands |
 
-**Examples:**
+**Real examples:**
 
 ```bash
+# Get oriented in a new-to-you codebase
 buddy-do "explain this codebase"
+
+# Build features with context from past work
 buddy-do "add user authentication"
+
+# Recall why decisions were made
 buddy-remember "API design decisions"
 buddy-remember "why we chose PostgreSQL"
 ```
 
-Everything is stored locally on your machine. Decisions are kept for 90 days, session notes for 30 days.
+All data stays on your machine. Decisions kept 90 days, session notes 30 days.
 
 ---
 
-## Where It Runs
+## How is this different from CLAUDE.md?
+
+| | CLAUDE.md | MeMesh |
+|---|-----------|--------|
+| **Purpose** | Static instructions for Claude | Living memory that grows with your project |
+| **Search** | Manual text search | Semantic search by meaning |
+| **Updates** | You edit manually | Auto-captures decisions as you work |
+| **Recall** | Always loaded (can get long) | Surfaces relevant context on demand |
+| **Scope** | General preferences | Project-specific knowledge graph |
+
+**They work together.** CLAUDE.md tells Claude *how* to work. MeMesh remembers *what* you've built.
+
+---
+
+## Platform Support
 
 | Platform | Status |
 |----------|--------|
-| **macOS** | ✅ Works |
-| **Linux** | ✅ Works |
-| **Windows** | ✅ Works (WSL2 recommended) |
-
-**Works with:**
-- Claude Code CLI (terminal)
-- Claude Code VS Code Extension
-- Cursor (via MCP)
-- Other MCP-compatible editors
+| macOS | ✅ |
+| Linux | ✅ |
+| Windows | ✅ (WSL2 recommended) |
 
-**Claude Desktop (Cowork)**: Basic commands work, but memory features need the CLI version. See [Cowork details](docs/COWORK_SUPPORT.md).
+**Works with:** Claude Code CLI · VS Code Extension · Cursor (via MCP) · Any MCP-compatible editor
 
 ---
 
-## Troubleshooting
+## Architecture
 
-**MeMesh not showing up?**
+MeMesh runs as a local MCP server alongside Claude Code:
 
-```bash
-# Check it's installed
-npm list -g @pcircle/memesh
+- **Knowledge Graph** — SQLite-backed entity store with FTS5 full-text search
+- **Vector Embeddings** — ONNX runtime for semantic similarity (runs 100% locally)
+- **Content Dedup** — SHA-256 hashing skips redundant embedding computation
+- **Batch Processing** — Efficient bulk operations for large knowledge bases
+- **Hook System** — Proactive recall on session start, test failures, and errors
 
-# Check Node.js version (needs 20+)
-node --version
+Everything runs locally. No cloud. No API calls. Your data never leaves your machine.
 
-# Re-run setup
-memesh setup
-```
+---
 
-Then restart Claude Code completely.
+## Documentation
 
-More help: [Troubleshooting Guide](docs/TROUBLESHOOTING.md)
+| Doc | Description |
+|-----|-------------|
+| [Getting Started](docs/GETTING_STARTED.md) | Step-by-step setup guide |
+| [User Guide](docs/USER_GUIDE.md) | Full usage guide with examples |
+| [Commands](docs/COMMANDS.md) | Complete command reference |
+| [Architecture](docs/ARCHITECTURE.md) | Technical deep dive |
+| [Contributing](CONTRIBUTING.md) | Contribution guidelines |
+| [Development](docs/DEVELOPMENT.md) | Dev setup for contributors |
 
 ---
 
-## Learn More
+## Contributing
 
-- **[Getting Started](docs/GETTING_STARTED.md)** — Step-by-step setup
-- **[User Guide](docs/USER_GUIDE.md)** — Full usage guide with examples
-- **[Commands](docs/COMMANDS.md)** — All available commands
-- **[Architecture](docs/ARCHITECTURE.md)** — How it works under the hood
-- **[Contributing](CONTRIBUTING.md)** — Want to help? Start here
-- **[Development Guide](docs/DEVELOPMENT.md)** — For contributors
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) to get started.
 
 ---
 
@@ -164,8 +205,8 @@ MIT — See [LICENSE](LICENSE)
 
 <div align="center">
 
-Something not working? [Open an issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — we respond fast.
+**Built with Claude Code, for Claude Code.**
 
-[Report Bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) • [Request Feature](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
+[Report Bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) · [Request Feature](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions) · [Get Help](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
 
 </div>

package/README.th.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" />
 
-### ปลั๊กอินเพิ่มประสิทธิภาพสำหรับ Claude Code
+# MeMesh
 
-หน่วยความจำ การวิเคราะห์งานอัจฉริยะ และระบบอัตโนมัติ — ทั้งหมดในปลั๊กอินเดียว
+### เซสชันเขียนโค้ดกับ AI ของคุณสมควรมีหน่วยความจำ
 
-[![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 มอบหน่วยความจำถาวรที่ค้นหาได้ให้ Claude Code — ทำให้ทุกเซสชันต่อยอดจากเซสชันก่อนหน้า
 
-[ติดตั้ง](#ติดตั้ง) • [วิธีใช้](#วิธีใช้) • [แก้ไขปัญหา](#แก้ไขปัญหา)
+[![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) • **ภาษาไทย** • [Bahasa Indonesia](README.id.md)
+```bash
+npm install -g @pcircle/memesh
+```
+
+[เริ่มต้นใช้งาน](#เริ่มต้นใช้งาน) · [วิธีการทำงาน](#วิธีการทำงาน) · [คำสั่ง](#คำสั่ง) · [เอกสาร](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) · **ภาษาไทย** · [Bahasa Indonesia](README.id.md)
 
 </div>
 
+> **หมายเหตุ**: โปรเจกต์นี้เดิมชื่อ "Claude Code Buddy" และถูกเปลี่ยนชื่อเป็น MeMesh Plugin เพื่อหลีกเลี่ยงปัญหาเครื่องหมายการค้า
+
 ---
 
-## ทำไมถึงสร้างโปรเจกต์นี้
+## ปัญหา
 
-ผมชอบ Claude Code มาก มันเปลี่ยนวิธีที่ผมสร้างซอฟต์แวร์
+คุณกำลังทำงานโปรเจกต์กับ Claude Code อย่างเข้มข้น คุณตัดสินใจเรื่องสำคัญไปเมื่อสามเซสชันก่อน — จะใช้ไลบรารี auth ตัวไหน ทำไมถึงเลือกสคีมาฐานข้อมูลแบบนั้น ควรใช้รูปแบบอะไร แต่ Claude จำไม่ได้ คุณต้องพูดซ้ำ เสียบริบท เสียเวลา
 
-โปรเจกต์นี้เริ่มต้นเพราะผมอยากช่วยให้คนมากขึ้น — โดยเฉพาะคนที่เพิ่งเริ่มเขียนโค้ด — ได้ใช้ประโยชน์จาก Claude Code สำหรับ vibe coding ให้เต็มที่ สิ่งหนึ่งที่ผมสังเกตคือ: เมื่อโปรเจกต์ใหญ่ขึ้น มันยากที่จะติดตามการตัดสินใจทั้งหมดที่ทำไปในแต่ละเซสชัน ผมเลยสร้างปลั๊กอิน (ร่วมกับ Claude Code แน่นอน) ที่จดจำให้คุณ
+**MeMesh แก้ปัญหานี้** โดยมอบหน่วยความจำถาวรที่ค้นหาได้ซึ่งเติบโตไปพร้อมกับโปรเจกต์ของคุณ
 
-> **หมายเหตุ**: โปรเจกต์นี้เดิมชื่อ "Claude Code Buddy" และถูกเปลี่ยนชื่อเป็น MeMesh Plugin เพื่อหลีกเลี่ยงปัญหาเครื่องหมายการค้า
+---
+
+## วิธีการทำงาน
+
+<table>
+<tr>
+<td width="50%">
+
+### ก่อนใช้ MeMesh
+```
+Session 1: "Use JWT for auth"
+Session 2: "Why did we pick JWT again?"
+Session 3: "Wait, what auth library are we using?"
+```
+คุณต้องทวนการตัดสินใจซ้ำ Claude ลืมบริบท ความคืบหน้าหยุดชะงัก
+
+</td>
+<td width="50%">
 
-## มันทำอะไรได้?
+### หลังใช้ MeMesh
+```
+Session 1: "Use JWT for auth" → saved
+Session 2: buddy-remember "auth" → instant recall
+Session 3: Context auto-loaded on start
+```
+ทุกเซสชันเริ่มต่อจากจุดที่คุณหยุดไว้
 
-MeMesh Plugin ทำให้ Claude Code ฉลาดขึ้นและมีประสิทธิภาพมากขึ้น ไม่ใช่แค่หน่วยความจำ — เป็นชุดเครื่องมือครบครัน:
+</td>
+</tr>
+</table>
 
-**หน่วยความจำโปรเจกต์ที่ค้นหาได้** — บันทึกการตัดสินใจ รูปแบบ และบทเรียนที่ได้เรียนรู้โดยอัตโนมัติ ค้นหาด้วยความหมาย ไม่ใช่แค่คีย์เวิร์ด ถามว่า "เราตัดสินใจเรื่อง auth ยังไง?" แล้วได้คำตอบทันที
+---
 
-**วิเคราะห์งานอัจฉริยะ** — เมื่อคุณพิมพ์ `buddy-do "เพิ่มระบบ auth"` MeMesh จะวิเคราะห์งาน ดึงบริบทที่เกี่ยวข้องจากงานที่ผ่านมา และให้แผนที่สมบูรณ์ก่อนลงมือทำ
+## สิ่งที่คุณจะได้รับ
 
-**ระบบอัตโนมัติ** — MeMesh ทำงานเบื้องหลังให้คุณ:
-- แสดงสรุปการทำงานครั้งก่อนเมื่อเริ่มเซสชัน
-- ติดตามไฟล์ที่แก้ไขและทดสอบ
-- เตือนให้รีวิวโค้ดก่อน commit
-- กำหนดเส้นทางงานไปยังโมเดลที่เหมาะสม
+**หน่วยความจำโปรเจกต์ที่ค้นหาได้** — ถามว่า "เราตัดสินใจเรื่อง auth ยังไง?" แล้วได้คำตอบทันทีที่จับคู่ตามความหมาย ไม่ใช่การค้นหาด้วยคีย์เวิร์ด — แต่เป็นการค้นหาด้วย*ความหมาย* ขับเคลื่อนด้วย ONNX embeddings บนเครื่องของคุณ
 
-**เรียนรู้จากข้อผิดพลาด** — บันทึกข้อผิดพลาดและการแก้ไขเพื่อสร้างฐานความรู้และไม่ทำผิดซ้ำ
+**การวิเคราะห์งานอัจฉริยะ** — `buddy-do "add user auth"` ไม่ได้แค่รันคำสั่ง มันดึงบริบทที่เกี่ยวข้องจากเซสชันก่อนหน้า ตรวจสอบรูปแบบที่คุณกำหนดไว้ และสร้างแผนที่สมบูรณ์ก่อนเขียนโค้ดแม้แต่บรรทัดเดียว
 
-**ต่างจากหน่วยความจำในตัวของ Claude ยังไง?**
+**การเรียกคืนเชิงรุก** — MeMesh แสดงความทรงจำที่เกี่ยวข้องโดยอัตโนมัติเมื่อคุณเริ่มเซสชัน เจอเทสต์ล้มเหลว หรือพบข้อผิดพลาด ไม่ต้องค้นหาเอง
 
-Claude Code มี auto memory และ CLAUDE.md อยู่แล้ว — เหมาะสำหรับการตั้งค่าทั่วไป MeMesh เพิ่ม**เครื่องมือเฉพาะโปรเจกต์**: หน่วยความจำที่ค้นหาด้วยความหมาย การวิเคราะห์งานพร้อมบริบทที่ผ่านมา และเวิร์กโฟลว์อัตโนมัติที่ทำให้ทุกเซสชันมีประสิทธิภาพมากขึ้น
+**ระบบอัตโนมัติของเวิร์กโฟลว์** — สรุปเซสชันเมื่อเริ่มงาน ติดตามการเปลี่ยนแปลงไฟล์ เตือนให้รีวิวโค้ดก่อน commit ทั้งหมดทำงานเงียบๆ ในเบื้องหลัง
 
-ลองคิดแบบนี้:
-- **CLAUDE.md** = คู่มือการใช้งานสำหรับ Claude
-- **MeMesh** = สมุดบันทึกที่ค้นหาได้ + ผู้ช่วยอัจฉริยะที่เติบโตไปกับโปรเจกต์ของคุณ
+**เรียนรู้จากข้อผิดพลาด** — บันทึกข้อผิดพลาดและการแก้ไขเพื่อสร้างฐานความรู้ ข้อผิดพลาดเดิมจะไม่เกิดขึ้นซ้ำ
 
 ---
 
-## ติดตั้ง
+## เริ่มต้นใช้งาน
 
-**สิ่งที่ต้องมี**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) และ Node.js 20+
+**สิ่งที่ต้องมี**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) + Node.js 20+
 
 ```bash
 npm install -g @pcircle/memesh
 ```
 
-รีสตาร์ท Claude Code เสร็จแล้ว
+รีสตาร์ท Claude Code เท่านั้นเอง
 
-**ตรวจสอบการติดตั้ง** — พิมพ์ใน Claude Code:
+**ตรวจสอบ** — พิมพ์ใน Claude Code:
 
 ```
 buddy-help
 ```
 
-ถ้าเห็นรายการคำสั่ง แสดงว่าติดตั้งสำเร็จ
+คุณจะเห็นรายการคำสั่งที่ใช้ได้
 
 <details>
-<summary>ติดตั้งจากซอร์สโค้ด (สำหรับผู้ร่วมพัฒนา)</summary>
+<summary><strong>ติดตั้งจากซอร์สโค้ด</strong> (สำหรับผู้ร่วมพัฒนา)</summary>
 
 ```bash
 git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
@@ -83,76 +112,88 @@ npm install && npm run build
 
 ---
 
-## วิธีใช้
-
-MeMesh เพิ่ม 3 คำสั่งใน Claude Code:
+## คำสั่ง
 
 | คำสั่ง | ทำอะไร |
-|--------|--------|
-| `buddy-do "งาน"` | รันงานพร้อมบริบทหน่วยความจำ |
-| `buddy-remember "หัวข้อ"` | ค้นหาการตัดสินใจและบริบทที่ผ่านมา |
+|---------|-------------|
+| `buddy-do "task"` | รันงานพร้อมบริบทหน่วยความจำเต็มรูปแบบ |
+| `buddy-remember "topic"` | ค้นหาการตัดสินใจและบริบทที่ผ่านมา |
 | `buddy-help` | แสดงคำสั่งที่ใช้ได้ |
 
-**ตัวอย่าง:**
+**ตัวอย่างจริง:**
 
 ```bash
-buddy-do "อธิบาย codebase นี้"
-buddy-do "เพิ่มระบบยืนยันตัวตนผู้ใช้"
-buddy-remember "การตัดสินใจออกแบบ API"
-buddy-remember "ทำไมถึงเลือก PostgreSQL"
+# ทำความเข้าใจ codebase ที่ไม่คุ้นเคย
+buddy-do "explain this codebase"
+
+# สร้างฟีเจอร์พร้อมบริบทจากงานที่ผ่านมา
+buddy-do "add user authentication"
+
+# เรียกดูเหตุผลของการตัดสินใจ
+buddy-remember "API design decisions"
+buddy-remember "why we chose PostgreSQL"
 ```
 
-ข้อมูลทั้งหมดเก็บไว้ในเครื่องของคุณ การตัดสินใจเก็บไว้ 90 วัน บันทึกเซสชันเก็บไว้ 30 วัน
+ข้อมูลทั้งหมดอยู่บนเครื่องของคุณ การตัดสินใจเก็บไว้ 90 วัน บันทึกเซสชันเก็บไว้ 30 วัน
+
+---
+
+## MeMesh ต่างจาก CLAUDE.md อย่างไร?
+
+| | CLAUDE.md | MeMesh |
+|---|-----------|--------|
+| **วัตถุประสงค์** | คำสั่งคงที่สำหรับ Claude | หน่วยความจำที่มีชีวิตซึ่งเติบโตไปกับโปรเจกต์ |
+| **การค้นหา** | ค้นหาข้อความด้วยตนเอง | ค้นหาเชิงความหมายตามความหมาย |
+| **การอัปเดต** | คุณแก้ไขเอง | บันทึกการตัดสินใจอัตโนมัติขณะทำงาน |
+| **การเรียกคืน** | โหลดทุกครั้ง (อาจยาวมาก) | แสดงบริบทที่เกี่ยวข้องตามต้องการ |
+| **ขอบเขต** | การตั้งค่าทั่วไป | กราฟความรู้เฉพาะโปรเจกต์ |
+
+**ทั้งสองทำงานร่วมกัน** CLAUDE.md บอก Claude ว่าต้องทำงาน*อย่างไร* MeMesh จำว่าคุณ*สร้างอะไร*ไปบ้าง
 
 ---
 
 ## รองรับแพลตฟอร์ม
 
 | แพลตฟอร์ม | สถานะ |
-|-----------|--------|
-| **macOS** | ✅ ใช้ได้ |
-| **Linux** | ✅ ใช้ได้ |
-| **Windows** | ✅ ใช้ได้ (แนะนำ WSL2) |
-
-**ใช้ร่วมกับ:**
-- Claude Code CLI (เทอร์มินัล)
-- Claude Code VS Code Extension
-- Cursor (ผ่าน MCP)
-- เอดิเตอร์อื่นที่รองรับ MCP
+|----------|--------|
+| macOS | ✅ |
+| Linux | ✅ |
+| Windows | ✅ (แนะนำ WSL2) |
 
-**Claude Desktop (Cowork)**: คำสั่งพื้นฐานใช้ได้ แต่ฟีเจอร์หน่วยความจำต้องใช้เวอร์ชัน CLI ดู[รายละเอียด Cowork](docs/COWORK_SUPPORT.md)
+**ใช้ร่วมกับ:** Claude Code CLI · VS Code Extension · Cursor (ผ่าน MCP) · เอดิเตอร์ใดก็ได้ที่รองรับ MCP
 
 ---
 
-## แก้ไขปัญหา
+## สถาปัตยกรรม
 
-**MeMesh ไม่แสดง?**
+MeMesh ทำงานเป็นเซิร์ฟเวอร์ MCP บนเครื่องควบคู่กับ Claude Code:
 
-```bash
-# ตรวจสอบการติดตั้ง
-npm list -g @pcircle/memesh
+- **Knowledge Graph** — ที่เก็บ entity บน SQLite พร้อมการค้นหาข้อความเต็มรูปแบบ FTS5
+- **Vector Embeddings** — ONNX runtime สำหรับความคล้ายคลึงเชิงความหมาย (ทำงานบนเครื่อง 100%)
+- **Content Dedup** — แฮช SHA-256 ข้ามการคำนวณ embedding ที่ซ้ำซ้อน
+- **Batch Processing** — การดำเนินการจำนวนมากอย่างมีประสิทธิภาพสำหรับฐานความรู้ขนาดใหญ่
+- **Hook System** — เรียกคืนเชิงรุกเมื่อเริ่มเซสชัน เทสต์ล้มเหลว และเกิดข้อผิดพลาด
 
-# ตรวจสอบเวอร์ชัน Node.js (ต้อง 20+)
-node --version
+ทุกอย่างทำงานบนเครื่อง ไม่ใช้คลาวด์ ไม่เรียก API ข้อมูลของคุณไม่ออกจากเครื่องเด็ดขาด
 
-# รันเซ็ตอัพใหม่
-memesh setup
-```
+---
 
-จากนั้นรีสตาร์ท Claude Code ใหม่ทั้งหมด
+## เอกสาร
 
-ข้อมูลเพิ่มเติม: [คู่มือแก้ไขปัญหา](docs/TROUBLESHOOTING.md)
+| เอกสาร | คำอธิบาย |
+|-----|-------------|
+| [เริ่มต้นใช้งาน](docs/GETTING_STARTED.md) | คู่มือการตั้งค่าทีละขั้นตอน |
+| [คู่มือผู้ใช้](docs/USER_GUIDE.md) | คู่มือการใช้งานฉบับเต็มพร้อมตัวอย่าง |
+| [คำสั่ง](docs/COMMANDS.md) | รายการคำสั่งทั้งหมด |
+| [สถาปัตยกรรม](docs/ARCHITECTURE.md) | รายละเอียดเชิงเทคนิคเชิงลึก |
+| [ร่วมพัฒนา](CONTRIBUTING.md) | แนวทางการร่วมพัฒนา |
+| [การพัฒนา](docs/DEVELOPMENT.md) | การตั้งค่าสำหรับผู้ร่วมพัฒนา |
 
 ---
 
-## เรียนรู้เพิ่มเติม
+## ร่วมพัฒนา
 
-- **[เริ่มต้นใช้งาน](docs/GETTING_STARTED.md)** — การตั้งค่าทีละขั้นตอน
-- **[คู่มือผู้ใช้](docs/USER_GUIDE.md)** — คู่มือฉบับเต็มพร้อมตัวอย่าง
-- **[คำสั่ง](docs/COMMANDS.md)** — คำสั่งทั้งหมดที่ใช้ได้
-- **[สถาปัตยกรรม](docs/ARCHITECTURE.md)** — วิธีทำงานเบื้องหลัง
-- **[ร่วมพัฒนา](CONTRIBUTING.md)** — อยากช่วย? เริ่มที่นี่
-- **[คู่มือพัฒนา](docs/DEVELOPMENT.md)** — สำหรับผู้ร่วมพัฒนา
+เรายินดีต้อนรับการร่วมพัฒนา! ดู [CONTRIBUTING.md](CONTRIBUTING.md) เพื่อเริ่มต้น
 
 ---
 
@@ -164,8 +205,8 @@ MIT — ดู [LICENSE](LICENSE)
 
 <div align="center">
 
-มีปัญหา? [เปิด Issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — เราตอบเร็ว
+**สร้างด้วย Claude Code เพื่อ Claude Code**
 
-[รายงานบัก](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) • [ขอฟีเจอร์](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
+[รายงานบัก](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.yml) · [ขอฟีเจอร์](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions) · [ขอความช่วยเหลือ](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new)
 
 </div>