@pcircle/memesh 2.8.10 → 2.9.0

package/README.ja.md

@@ -0,0 +1,171 @@
+<div align="center">
+
+# 🧠 MeMesh Plugin
+
+### Claude Code の生産性プラグイン
+
+メモリ、スマートタスク分析、ワークフロー自動化 — ひとつのプラグインで。
+
+[![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)
+
+[インストール](#インストール) • [使い方](#使い方) • [トラブルシューティング](#トラブルシューティング)
+
+[English](README.md) • [繁體中文](README.zh-TW.md) • [简体中文](README.zh-CN.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>
+
+---
+
+## なぜこのプロジェクトを作ったのか
+
+Claude Code が大好きです。ソフトウェアの作り方が変わりました。
+
+このプロジェクトは、もっと多くの人 — 特にコーディング初心者の方々 — が Claude Code を使った vibe coding をもっと楽しめるようにしたいと思って始めました。プロジェクトが大きくなると、セッションをまたいだ決定事項を追跡するのが難しくなります。そこで（もちろん Claude Code と一緒に）記憶してくれるプラグインを作りました。
+
+> **注**: このプロジェクトは元々「Claude Code Buddy」という名前でしたが、商標問題を避けるため MeMesh Plugin に改名しました。
+
+## 何ができるの？
+
+MeMesh Plugin は Claude Code をよりスマートで生産的にします。メモリだけではなく、フルツールキットです：
+
+**検索可能なプロジェクトメモリ** — 作業中に決定、パターン、教訓を自動保存。意味で検索できます。「認証についてどう決めたっけ？」と聞けば即座に回答。
+
+**スマートタスク分析** — `buddy-do "ユーザー認証を追加"` と言うと、MeMesh がタスクを分析し、過去の作業からコンテキストを引き出し、実行前に充実したプランを提供します。
+
+**ワークフロー自動化** — MeMesh がバックグラウンドで自動的に：
+- セッション開始時に前回の作業サマリーを表示
+- 変更・テストしたファイルを追跡
+- コミット前にコードレビューをリマインド
+- タスクを最適なモデルに振り分け
+
+**ミスから学ぶ** — エラーと修正を記録し、同じ失敗を繰り返さないナレッジベースを構築。
+
+**Claude の内蔵メモリとの違いは？**
+
+Claude Code には auto memory と CLAUDE.md がすでにあります — 一般的な設定や指示には最適です。MeMesh はそれに加えてプロジェクトレベルの**専用ツール**を追加します：意味で検索できるメモリ、過去のコンテキストを活用するタスク分析、毎セッションをより生産的にする自動化ワークフロー。
+
+こう考えてください：
+- **CLAUDE.md** = Claude への取扱説明書
+- **MeMesh** = 検索可能なノートブック + プロジェクトと共に成長するスマートアシスタント
+
+---
+
+## インストール
+
+**必要なもの**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) と Node.js 20+
+
+```bash
+npm install -g @pcircle/memesh
+```
+
+Claude Code を再起動すれば完了です。
+
+**動作確認** — Claude Code で以下を入力：
+
+```
+buddy-help
+```
+
+コマンド一覧が表示されれば成功です。
+
+<details>
+<summary>ソースからインストール（コントリビューター向け）</summary>
+
+```bash
+git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
+cd claude-code-buddy
+npm install && npm run build
+```
+
+</details>
+
+---
+
+## 使い方
+
+MeMesh は Claude Code に 3 つのコマンドを追加します：
+
+| コマンド | 機能 |
+|---------|------|
+| `buddy-do "タスク"` | メモリコンテキスト付きでタスクを実行 |
+| `buddy-remember "トピック"` | 過去の決定やコンテキストを検索 |
+| `buddy-help` | 利用可能なコマンドを表示 |
+
+**例：**
+
+```bash
+buddy-do "このコードベースを説明して"
+buddy-do "ユーザー認証を追加して"
+buddy-remember "API 設計の決定事項"
+buddy-remember "なぜ PostgreSQL を選んだのか"
+```
+
+すべてのデータはローカルマシンに保存されます。決定事項は 90 日間、セッションノートは 30 日間保持されます。
+
+---
+
+## 対応環境
+
+| プラットフォーム | 状態 |
+|----------------|------|
+| **macOS** | ✅ 対応 |
+| **Linux** | ✅ 対応 |
+| **Windows** | ✅ 対応（WSL2 推奨）|
+
+**対応ツール：**
+- Claude Code CLI（ターミナル）
+- Claude Code VS Code 拡張機能
+- Cursor（MCP 経由）
+- その他 MCP 互換エディタ
+
+**Claude Desktop (Cowork)**: 基本コマンドは動作しますが、メモリ機能には CLI 版が必要です。[Cowork 詳細](docs/COWORK_SUPPORT.md)をご覧ください。
+
+---
+
+## トラブルシューティング
+
+**MeMesh が表示されない？**
+
+```bash
+# インストール確認
+npm list -g @pcircle/memesh
+
+# Node.js バージョン確認（20+ が必要）
+node --version
+
+# セットアップ再実行
+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)** — コントリビューター向け
+
+---
+
+## ライセンス
+
+MIT — [LICENSE](LICENSE) を参照
+
+---
+
+<div align="center">
+
+うまくいかない？ [Issue を開く](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — 迅速に対応します。
+
+[バグ報告](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)
+
+</div>

package/README.ko.md

@@ -0,0 +1,171 @@
+<div align="center">
+
+# 🧠 MeMesh Plugin
+
+### Claude Code 생산성 플러그인
+
+메모리, 스마트 작업 분석, 워크플로우 자동화 — 하나의 플러그인으로.
+
+[![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)
+
+[설치](#설치) • [사용법](#사용법) • [문제 해결](#문제-해결)
+
+[English](README.md) • [繁體中文](README.zh-TW.md) • [简体中文](README.zh-CN.md) • [日本語](README.ja.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>
+
+---
+
+## 왜 이 프로젝트를 만들었나
+
+Claude Code를 정말 좋아합니다. 소프트웨어를 만드는 방식이 완전히 바뀌었습니다.
+
+이 프로젝트는 더 많은 사람들 — 특히 코딩을 처음 접하는 분들 — 이 Claude Code로 vibe coding을 더 잘 활용할 수 있도록 돕고 싶어서 시작했습니다. 프로젝트가 커지면 세션을 넘나드는 모든 결정을 추적하기 어려워진다는 걸 깨달았습니다. 그래서 (당연히 Claude Code와 함께) 여러분을 위해 기억해주는 플러그인을 만들었습니다.
+
+> **참고**: 이 프로젝트는 원래 "Claude Code Buddy"라는 이름이었으며, 상표 문제를 피하기 위해 MeMesh Plugin으로 이름을 변경했습니다.
+
+## 무엇을 할 수 있나요?
+
+MeMesh Plugin은 Claude Code를 더 똑똑하고 생산적으로 만듭니다. 단순한 메모리가 아닌 풀 툴킷입니다:
+
+**검색 가능한 프로젝트 메모리** — 작업 중 결정, 패턴, 교훈을 자동 저장. 의미로 검색 가능. "auth에 대해 뭘 결정했지?"라고 물으면 즉시 답변.
+
+**스마트 작업 분석** — `buddy-do "사용자 인증 추가"` 라고 하면, MeMesh가 작업을 분석하고 과거 작업에서 컨텍스트를 가져와 실행 전에 풍부한 계획을 제공합니다.
+
+**워크플로우 자동화** — MeMesh가 백그라운드에서 자동으로:
+- 세션 시작 시 지난 작업 요약 표시
+- 변경/테스트한 파일 추적
+- 커밋 전 코드 리뷰 알림
+- 작업을 최적의 모델로 라우팅
+
+**실수에서 배우기** — 오류와 수정 사항을 기록하여 같은 실수를 반복하지 않는 지식 베이스 구축.
+
+**Claude 내장 메모리와 뭐가 다른가요?**
+
+Claude Code에는 이미 auto memory와 CLAUDE.md가 있습니다 — 일반적인 설정과 지시에 적합합니다. MeMesh는 여기에 프로젝트 수준의 **전용 도구**를 추가합니다: 의미로 검색할 수 있는 메모리, 과거 컨텍스트를 활용하는 작업 분석, 매 세션을 더 생산적으로 만드는 자동화 워크플로우.
+
+이렇게 생각하세요:
+- **CLAUDE.md** = Claude를 위한 사용 설명서
+- **MeMesh** = 검색 가능한 노트북 + 프로젝트와 함께 성장하는 스마트 어시스턴트
+
+---
+
+## 설치
+
+**필요한 것**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code)와 Node.js 20+
+
+```bash
+npm install -g @pcircle/memesh
+```
+
+Claude Code를 재시작하면 끝.
+
+**작동 확인** — Claude Code에서 입력:
+
+```
+buddy-help
+```
+
+명령어 목록이 보이면 성공입니다.
+
+<details>
+<summary>소스에서 설치 (기여자용)</summary>
+
+```bash
+git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
+cd claude-code-buddy
+npm install && npm run build
+```
+
+</details>
+
+---
+
+## 사용법
+
+MeMesh는 Claude Code에 3개의 명령어를 추가합니다:
+
+| 명령어 | 기능 |
+|--------|------|
+| `buddy-do "작업"` | 메모리 컨텍스트와 함께 작업 실행 |
+| `buddy-remember "주제"` | 과거 결정과 컨텍스트 검색 |
+| `buddy-help` | 사용 가능한 명령어 표시 |
+
+**예시:**
+
+```bash
+buddy-do "이 코드베이스 설명해줘"
+buddy-do "사용자 인증 추가해줘"
+buddy-remember "API 설계 결정사항"
+buddy-remember "왜 PostgreSQL을 선택했는지"
+```
+
+모든 데이터는 로컬 머신에 저장됩니다. 결정사항은 90일, 세션 노트는 30일간 보관됩니다.
+
+---
+
+## 지원 환경
+
+| 플랫폼 | 상태 |
+|--------|------|
+| **macOS** | ✅ 지원 |
+| **Linux** | ✅ 지원 |
+| **Windows** | ✅ 지원 (WSL2 권장) |
+
+**함께 사용 가능:**
+- Claude Code CLI (터미널)
+- Claude Code VS Code 확장
+- Cursor (MCP 경유)
+- 기타 MCP 호환 에디터
+
+**Claude Desktop (Cowork)**: 기본 명령어는 작동하지만, 메모리 기능은 CLI 버전이 필요합니다. [Cowork 상세](docs/COWORK_SUPPORT.md)를 참고하세요.
+
+---
+
+## 문제 해결
+
+**MeMesh가 나타나지 않나요?**
+
+```bash
+# 설치 확인
+npm list -g @pcircle/memesh
+
+# Node.js 버전 확인 (20+ 필요)
+node --version
+
+# 설정 다시 실행
+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)** — 기여자용
+
+---
+
+## 라이선스
+
+MIT — [LICENSE](LICENSE) 참조
+
+---
+
+<div align="center">
+
+문제가 있나요? [이슈 열기](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — 빠르게 응답합니다.
+
+[버그 리포트](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)
+
+</div>

package/README.md

@@ -1,64 +1,74 @@
 <div align="center">
 
-# 🧠 MeMesh
+# 🧠 MeMesh Plugin
 
-### Persistent Memory for Claude Code
+### A productivity plugin for Claude Code
 
-Claude forgets everything between sessions. MeMesh fixes that.
+Memory, smart task analysis, and workflow automation — all in one 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-AGPL--3.0-blue.svg)](LICENSE)
-[![MCP](https://img.shields.io/badge/MCP-1.25.3-purple.svg)](https://modelcontextprotocol.io)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io)
 
-[Quick Install](#install) • [Usage](#usage) • [Troubleshooting](#troubleshooting) • [繁體中文](README.zh-TW.md)
+[Install](#install) • [Usage](#usage) • [Troubleshooting](#troubleshooting)
+
+[繁體中文](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>
 
 ---
 
-## The Problem
+## Why This Project Exists
 
-Every new Claude Code session starts from zero:
+I love Claude Code. It's changed how I build software.
 
-```
-You: "Remember our auth setup from yesterday?"
-Claude: "I don't have context from previous sessions..."
-```
+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.
 
-You end up re-explaining the same decisions, architecture, and constraints — over and over.
+> **Note**: This project was originally called "Claude Code Buddy" and has been renamed to MeMesh Plugin to avoid potential trademark issues.
 
-## How MeMesh Helps
+## What Does It Do?
 
-MeMesh gives Claude a persistent memory that survives across sessions:
+MeMesh Plugin makes Claude Code smarter and more productive. It's not just memory — it's a full toolkit:
 
-```bash
-# Monday: You make a decision
-buddy-remember "auth"
-# → JWT auth: access tokens 15min, refresh tokens 7 days
-# → Decided on Jan 15, stored permanently
-```
+**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.
+
+**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)
+
+**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.
+
+**How is this different from Claude's built-in memory?**
 
-Your project decisions, architecture context, and debugging history — all remembered automatically.
+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.
+
+Think of it this way:
+- **CLAUDE.md** = your instruction manual for Claude
+- **MeMesh** = a searchable notebook + smart assistant that learns as your project grows
 
 ---
 
 ## Install
 
-**Prerequisites**: [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) and Node.js >= 20
+**You need**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and Node.js 20+
 
 ```bash
 npm install -g @pcircle/memesh
 ```
 
-Restart Claude Code. That's it.
+Restart Claude Code. Done.
 
-**Verify it works** — in a new Claude Code session, type:
+**Check it works** — type this in Claude Code:
 
 ```
 buddy-help
 ```
 
-If you see a list of available commands, MeMesh is running.
+You should see a list of commands.
 
 <details>
 <summary>Install from source (for contributors)</summary>
@@ -75,13 +85,13 @@ npm install && npm run build
 
 ## Usage
 
-MeMesh provides 3 core commands inside Claude Code:
+MeMesh adds 3 commands to Claude Code:
 
 | Command | What it does |
 |---------|-------------|
-| `buddy-do "task"` | Execute a task and save what was learned |
-| `buddy-remember "topic"` | Recall past decisions and context |
-| `buddy-help` | Show all available commands |
+| `buddy-do "task"` | Run a task with memory context |
+| `buddy-remember "topic"` | Search for past decisions and context |
+| `buddy-help` | Show available commands |
 
 **Examples:**
 
@@ -92,49 +102,63 @@ buddy-remember "API design decisions"
 buddy-remember "why we chose PostgreSQL"
 ```
 
-Memories are stored locally on your machine and persist across sessions (90 days for decisions, 30 days for session context).
+Everything is stored locally on your machine. Decisions are kept for 90 days, session notes for 30 days.
+
+---
+
+## Where It Runs
+
+| 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
+
+**Claude Desktop (Cowork)**: Basic commands work, but memory features need the CLI version. See [Cowork details](docs/COWORK_SUPPORT.md).
 
 ---
 
 ## Troubleshooting
 
-**MeMesh not loading?**
+**MeMesh not showing up?**
 
 ```bash
-# Check installation
+# Check it's installed
 npm list -g @pcircle/memesh
 
-# Check Node.js version (needs >= 20)
+# Check Node.js version (needs 20+)
 node --version
 
-# Repair installation
+# Re-run setup
 memesh setup
 ```
 
 Then restart Claude Code completely.
 
-See the full [Troubleshooting Guide](docs/TROUBLESHOOTING.md) for more.
+More help: [Troubleshooting Guide](docs/TROUBLESHOOTING.md)
 
 ---
 
-## Documentation
+## Learn More
 
-- **[Getting Started](docs/GETTING_STARTED.md)** — First-time setup walkthrough
-- **[User Guide](docs/USER_GUIDE.md)** — Complete usage guide with real-world examples
-- **[Development Guide](docs/DEVELOPMENT.md)** — Contributor guide for local development
-- **[API Reference](https://pcircle-ai.github.io/claude-code-buddy/)** — Auto-generated API documentation
-- **[Commands Reference](docs/COMMANDS.md)** — All commands and tools
-- **[Architecture](docs/ARCHITECTURE.md)** — How MeMesh works internally
+- **[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
 
 ---
 
-## Contributing
-
-Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).
-
 ## License
 
-AGPL-3.0 — See [LICENSE](LICENSE)
+MIT — See [LICENSE](LICENSE)
 
 ---
 
@@ -142,6 +166,6 @@ AGPL-3.0 — See [LICENSE](LICENSE)
 
 Something not working? [Open an issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — we respond fast.
 
-[Report Bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.md) • [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)
 
 </div>