@pcircle/memesh 2.8.11 → 2.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/LICENSE +21 -661
  2. package/README.de.md +171 -0
  3. package/README.es.md +171 -0
  4. package/README.fr.md +171 -0
  5. package/README.id.md +171 -0
  6. package/README.ja.md +171 -0
  7. package/README.ko.md +171 -0
  8. package/README.md +73 -100
  9. package/README.th.md +171 -0
  10. package/README.vi.md +171 -0
  11. package/README.zh-CN.md +171 -0
  12. package/README.zh-TW.md +71 -98
  13. package/dist/knowledge-graph/index.d.ts +22 -1
  14. package/dist/knowledge-graph/index.d.ts.map +1 -1
  15. package/dist/knowledge-graph/index.js +144 -3
  16. package/dist/knowledge-graph/index.js.map +1 -1
  17. package/dist/mcp/ServerInitializer.d.ts.map +1 -1
  18. package/dist/mcp/ServerInitializer.js +1 -1
  19. package/dist/mcp/ServerInitializer.js.map +1 -1
  20. package/dist/mcp/ToolDefinitions.d.ts.map +1 -1
  21. package/dist/mcp/ToolDefinitions.js +100 -4
  22. package/dist/mcp/ToolDefinitions.js.map +1 -1
  23. package/dist/mcp/ToolRouter.d.ts.map +1 -1
  24. package/dist/mcp/ToolRouter.js +4 -4
  25. package/dist/mcp/ToolRouter.js.map +1 -1
  26. package/dist/mcp/daemon/StdioProxyClient.d.ts.map +1 -1
  27. package/dist/mcp/daemon/StdioProxyClient.js +9 -1
  28. package/dist/mcp/daemon/StdioProxyClient.js.map +1 -1
  29. package/dist/mcp/handlers/BuddyHandlers.d.ts +3 -1
  30. package/dist/mcp/handlers/BuddyHandlers.d.ts.map +1 -1
  31. package/dist/mcp/handlers/BuddyHandlers.js +6 -5
  32. package/dist/mcp/handlers/BuddyHandlers.js.map +1 -1
  33. package/dist/mcp/handlers/ToolHandlers.d.ts.map +1 -1
  34. package/dist/mcp/handlers/ToolHandlers.js +1 -2
  35. package/dist/mcp/handlers/ToolHandlers.js.map +1 -1
  36. package/dist/mcp/resources/quick-reference.md +1 -1
  37. package/dist/mcp/schemas/OutputSchemas.d.ts +116 -53
  38. package/dist/mcp/schemas/OutputSchemas.d.ts.map +1 -1
  39. package/dist/mcp/schemas/OutputSchemas.js +64 -26
  40. package/dist/mcp/schemas/OutputSchemas.js.map +1 -1
  41. package/dist/mcp/server-bootstrap.js +89 -9
  42. package/dist/mcp/server-bootstrap.js.map +1 -1
  43. package/dist/mcp/tools/buddy-do.d.ts +2 -1
  44. package/dist/mcp/tools/buddy-do.d.ts.map +1 -1
  45. package/dist/mcp/tools/buddy-do.js +91 -4
  46. package/dist/mcp/tools/buddy-do.js.map +1 -1
  47. package/dist/mcp/tools/buddy-remember.d.ts +0 -5
  48. package/dist/mcp/tools/buddy-remember.d.ts.map +1 -1
  49. package/dist/mcp/tools/buddy-remember.js.map +1 -1
  50. package/dist/mcp/tools/memesh-agent-register.d.ts +20 -0
  51. package/dist/mcp/tools/memesh-agent-register.d.ts.map +1 -0
  52. package/dist/mcp/tools/memesh-agent-register.js +80 -0
  53. package/dist/mcp/tools/memesh-agent-register.js.map +1 -0
  54. package/dist/mcp/tools/memesh-cloud-sync.js +27 -8
  55. package/dist/mcp/tools/memesh-cloud-sync.js.map +1 -1
  56. package/dist/mcp/tools/memesh-metrics.d.ts +13 -0
  57. package/dist/mcp/tools/memesh-metrics.d.ts.map +1 -0
  58. package/dist/mcp/tools/memesh-metrics.js +193 -0
  59. package/dist/mcp/tools/memesh-metrics.js.map +1 -0
  60. package/dist/memory/UnifiedMemoryStore.d.ts +1 -1
  61. package/dist/memory/UnifiedMemoryStore.d.ts.map +1 -1
  62. package/dist/memory/UnifiedMemoryStore.js +4 -3
  63. package/dist/memory/UnifiedMemoryStore.js.map +1 -1
  64. package/package.json +8 -12
  65. package/plugin.json +2 -2
  66. package/scripts/postinstall-new.js +95 -0
  67. package/scripts/skills/comprehensive-code-review/SKILL.md +276 -0
package/README.ja.md ADDED
@@ -0,0 +1,171 @@
1
+ <div align="center">
2
+
3
+ # 🧠 MeMesh Plugin
4
+
5
+ ### Claude Code の生産性プラグイン
6
+
7
+ メモリ、スマートタスク分析、ワークフロー自動化 — ひとつのプラグインで。
8
+
9
+ [![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
10
+ [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
11
+ [![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io)
12
+
13
+ [インストール](#インストール) • [使い方](#使い方) • [トラブルシューティング](#トラブルシューティング)
14
+
15
+ [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)
16
+
17
+ </div>
18
+
19
+ ---
20
+
21
+ ## なぜこのプロジェクトを作ったのか
22
+
23
+ Claude Code が大好きです。ソフトウェアの作り方が変わりました。
24
+
25
+ このプロジェクトは、もっと多くの人 — 特にコーディング初心者の方々 — が Claude Code を使った vibe coding をもっと楽しめるようにしたいと思って始めました。プロジェクトが大きくなると、セッションをまたいだ決定事項を追跡するのが難しくなります。そこで(もちろん Claude Code と一緒に)記憶してくれるプラグインを作りました。
26
+
27
+ > **注**: このプロジェクトは元々「Claude Code Buddy」という名前でしたが、商標問題を避けるため MeMesh Plugin に改名しました。
28
+
29
+ ## 何ができるの?
30
+
31
+ MeMesh Plugin は Claude Code をよりスマートで生産的にします。メモリだけではなく、フルツールキットです:
32
+
33
+ **検索可能なプロジェクトメモリ** — 作業中に決定、パターン、教訓を自動保存。意味で検索できます。「認証についてどう決めたっけ?」と聞けば即座に回答。
34
+
35
+ **スマートタスク分析** — `buddy-do "ユーザー認証を追加"` と言うと、MeMesh がタスクを分析し、過去の作業からコンテキストを引き出し、実行前に充実したプランを提供します。
36
+
37
+ **ワークフロー自動化** — MeMesh がバックグラウンドで自動的に:
38
+ - セッション開始時に前回の作業サマリーを表示
39
+ - 変更・テストしたファイルを追跡
40
+ - コミット前にコードレビューをリマインド
41
+ - タスクを最適なモデルに振り分け
42
+
43
+ **ミスから学ぶ** — エラーと修正を記録し、同じ失敗を繰り返さないナレッジベースを構築。
44
+
45
+ **Claude の内蔵メモリとの違いは?**
46
+
47
+ Claude Code には auto memory と CLAUDE.md がすでにあります — 一般的な設定や指示には最適です。MeMesh はそれに加えてプロジェクトレベルの**専用ツール**を追加します:意味で検索できるメモリ、過去のコンテキストを活用するタスク分析、毎セッションをより生産的にする自動化ワークフロー。
48
+
49
+ こう考えてください:
50
+ - **CLAUDE.md** = Claude への取扱説明書
51
+ - **MeMesh** = 検索可能なノートブック + プロジェクトと共に成長するスマートアシスタント
52
+
53
+ ---
54
+
55
+ ## インストール
56
+
57
+ **必要なもの**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) と Node.js 20+
58
+
59
+ ```bash
60
+ npm install -g @pcircle/memesh
61
+ ```
62
+
63
+ Claude Code を再起動すれば完了です。
64
+
65
+ **動作確認** — Claude Code で以下を入力:
66
+
67
+ ```
68
+ buddy-help
69
+ ```
70
+
71
+ コマンド一覧が表示されれば成功です。
72
+
73
+ <details>
74
+ <summary>ソースからインストール(コントリビューター向け)</summary>
75
+
76
+ ```bash
77
+ git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
78
+ cd claude-code-buddy
79
+ npm install && npm run build
80
+ ```
81
+
82
+ </details>
83
+
84
+ ---
85
+
86
+ ## 使い方
87
+
88
+ MeMesh は Claude Code に 3 つのコマンドを追加します:
89
+
90
+ | コマンド | 機能 |
91
+ |---------|------|
92
+ | `buddy-do "タスク"` | メモリコンテキスト付きでタスクを実行 |
93
+ | `buddy-remember "トピック"` | 過去の決定やコンテキストを検索 |
94
+ | `buddy-help` | 利用可能なコマンドを表示 |
95
+
96
+ **例:**
97
+
98
+ ```bash
99
+ buddy-do "このコードベースを説明して"
100
+ buddy-do "ユーザー認証を追加して"
101
+ buddy-remember "API 設計の決定事項"
102
+ buddy-remember "なぜ PostgreSQL を選んだのか"
103
+ ```
104
+
105
+ すべてのデータはローカルマシンに保存されます。決定事項は 90 日間、セッションノートは 30 日間保持されます。
106
+
107
+ ---
108
+
109
+ ## 対応環境
110
+
111
+ | プラットフォーム | 状態 |
112
+ |----------------|------|
113
+ | **macOS** | ✅ 対応 |
114
+ | **Linux** | ✅ 対応 |
115
+ | **Windows** | ✅ 対応(WSL2 推奨)|
116
+
117
+ **対応ツール:**
118
+ - Claude Code CLI(ターミナル)
119
+ - Claude Code VS Code 拡張機能
120
+ - Cursor(MCP 経由)
121
+ - その他 MCP 互換エディタ
122
+
123
+ **Claude Desktop (Cowork)**: 基本コマンドは動作しますが、メモリ機能には CLI 版が必要です。[Cowork 詳細](docs/COWORK_SUPPORT.md)をご覧ください。
124
+
125
+ ---
126
+
127
+ ## トラブルシューティング
128
+
129
+ **MeMesh が表示されない?**
130
+
131
+ ```bash
132
+ # インストール確認
133
+ npm list -g @pcircle/memesh
134
+
135
+ # Node.js バージョン確認(20+ が必要)
136
+ node --version
137
+
138
+ # セットアップ再実行
139
+ memesh setup
140
+ ```
141
+
142
+ その後、Claude Code を完全に再起動してください。
143
+
144
+ 詳細:[トラブルシューティングガイド](docs/TROUBLESHOOTING.md)
145
+
146
+ ---
147
+
148
+ ## もっと詳しく
149
+
150
+ - **[はじめに](docs/GETTING_STARTED.md)** — ステップバイステップのセットアップ
151
+ - **[ユーザーガイド](docs/USER_GUIDE.md)** — 例付きの完全ガイド
152
+ - **[コマンド](docs/COMMANDS.md)** — すべてのコマンド
153
+ - **[アーキテクチャ](docs/ARCHITECTURE.md)** — 内部の仕組み
154
+ - **[コントリビュート](CONTRIBUTING.md)** — 手伝いたい方はこちら
155
+ - **[開発ガイド](docs/DEVELOPMENT.md)** — コントリビューター向け
156
+
157
+ ---
158
+
159
+ ## ライセンス
160
+
161
+ MIT — [LICENSE](LICENSE) を参照
162
+
163
+ ---
164
+
165
+ <div align="center">
166
+
167
+ うまくいかない? [Issue を開く](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — 迅速に対応します。
168
+
169
+ [バグ報告](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)
170
+
171
+ </div>
package/README.ko.md ADDED
@@ -0,0 +1,171 @@
1
+ <div align="center">
2
+
3
+ # 🧠 MeMesh Plugin
4
+
5
+ ### Claude Code 생산성 플러그인
6
+
7
+ 메모리, 스마트 작업 분석, 워크플로우 자동화 — 하나의 플러그인으로.
8
+
9
+ [![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
10
+ [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
11
+ [![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io)
12
+
13
+ [설치](#설치) • [사용법](#사용법) • [문제 해결](#문제-해결)
14
+
15
+ [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)
16
+
17
+ </div>
18
+
19
+ ---
20
+
21
+ ## 왜 이 프로젝트를 만들었나
22
+
23
+ Claude Code를 정말 좋아합니다. 소프트웨어를 만드는 방식이 완전히 바뀌었습니다.
24
+
25
+ 이 프로젝트는 더 많은 사람들 — 특히 코딩을 처음 접하는 분들 — 이 Claude Code로 vibe coding을 더 잘 활용할 수 있도록 돕고 싶어서 시작했습니다. 프로젝트가 커지면 세션을 넘나드는 모든 결정을 추적하기 어려워진다는 걸 깨달았습니다. 그래서 (당연히 Claude Code와 함께) 여러분을 위해 기억해주는 플러그인을 만들었습니다.
26
+
27
+ > **참고**: 이 프로젝트는 원래 "Claude Code Buddy"라는 이름이었으며, 상표 문제를 피하기 위해 MeMesh Plugin으로 이름을 변경했습니다.
28
+
29
+ ## 무엇을 할 수 있나요?
30
+
31
+ MeMesh Plugin은 Claude Code를 더 똑똑하고 생산적으로 만듭니다. 단순한 메모리가 아닌 풀 툴킷입니다:
32
+
33
+ **검색 가능한 프로젝트 메모리** — 작업 중 결정, 패턴, 교훈을 자동 저장. 의미로 검색 가능. "auth에 대해 뭘 결정했지?"라고 물으면 즉시 답변.
34
+
35
+ **스마트 작업 분석** — `buddy-do "사용자 인증 추가"` 라고 하면, MeMesh가 작업을 분석하고 과거 작업에서 컨텍스트를 가져와 실행 전에 풍부한 계획을 제공합니다.
36
+
37
+ **워크플로우 자동화** — MeMesh가 백그라운드에서 자동으로:
38
+ - 세션 시작 시 지난 작업 요약 표시
39
+ - 변경/테스트한 파일 추적
40
+ - 커밋 전 코드 리뷰 알림
41
+ - 작업을 최적의 모델로 라우팅
42
+
43
+ **실수에서 배우기** — 오류와 수정 사항을 기록하여 같은 실수를 반복하지 않는 지식 베이스 구축.
44
+
45
+ **Claude 내장 메모리와 뭐가 다른가요?**
46
+
47
+ Claude Code에는 이미 auto memory와 CLAUDE.md가 있습니다 — 일반적인 설정과 지시에 적합합니다. MeMesh는 여기에 프로젝트 수준의 **전용 도구**를 추가합니다: 의미로 검색할 수 있는 메모리, 과거 컨텍스트를 활용하는 작업 분석, 매 세션을 더 생산적으로 만드는 자동화 워크플로우.
48
+
49
+ 이렇게 생각하세요:
50
+ - **CLAUDE.md** = Claude를 위한 사용 설명서
51
+ - **MeMesh** = 검색 가능한 노트북 + 프로젝트와 함께 성장하는 스마트 어시스턴트
52
+
53
+ ---
54
+
55
+ ## 설치
56
+
57
+ **필요한 것**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code)와 Node.js 20+
58
+
59
+ ```bash
60
+ npm install -g @pcircle/memesh
61
+ ```
62
+
63
+ Claude Code를 재시작하면 끝.
64
+
65
+ **작동 확인** — Claude Code에서 입력:
66
+
67
+ ```
68
+ buddy-help
69
+ ```
70
+
71
+ 명령어 목록이 보이면 성공입니다.
72
+
73
+ <details>
74
+ <summary>소스에서 설치 (기여자용)</summary>
75
+
76
+ ```bash
77
+ git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
78
+ cd claude-code-buddy
79
+ npm install && npm run build
80
+ ```
81
+
82
+ </details>
83
+
84
+ ---
85
+
86
+ ## 사용법
87
+
88
+ MeMesh는 Claude Code에 3개의 명령어를 추가합니다:
89
+
90
+ | 명령어 | 기능 |
91
+ |--------|------|
92
+ | `buddy-do "작업"` | 메모리 컨텍스트와 함께 작업 실행 |
93
+ | `buddy-remember "주제"` | 과거 결정과 컨텍스트 검색 |
94
+ | `buddy-help` | 사용 가능한 명령어 표시 |
95
+
96
+ **예시:**
97
+
98
+ ```bash
99
+ buddy-do "이 코드베이스 설명해줘"
100
+ buddy-do "사용자 인증 추가해줘"
101
+ buddy-remember "API 설계 결정사항"
102
+ buddy-remember "왜 PostgreSQL을 선택했는지"
103
+ ```
104
+
105
+ 모든 데이터는 로컬 머신에 저장됩니다. 결정사항은 90일, 세션 노트는 30일간 보관됩니다.
106
+
107
+ ---
108
+
109
+ ## 지원 환경
110
+
111
+ | 플랫폼 | 상태 |
112
+ |--------|------|
113
+ | **macOS** | ✅ 지원 |
114
+ | **Linux** | ✅ 지원 |
115
+ | **Windows** | ✅ 지원 (WSL2 권장) |
116
+
117
+ **함께 사용 가능:**
118
+ - Claude Code CLI (터미널)
119
+ - Claude Code VS Code 확장
120
+ - Cursor (MCP 경유)
121
+ - 기타 MCP 호환 에디터
122
+
123
+ **Claude Desktop (Cowork)**: 기본 명령어는 작동하지만, 메모리 기능은 CLI 버전이 필요합니다. [Cowork 상세](docs/COWORK_SUPPORT.md)를 참고하세요.
124
+
125
+ ---
126
+
127
+ ## 문제 해결
128
+
129
+ **MeMesh가 나타나지 않나요?**
130
+
131
+ ```bash
132
+ # 설치 확인
133
+ npm list -g @pcircle/memesh
134
+
135
+ # Node.js 버전 확인 (20+ 필요)
136
+ node --version
137
+
138
+ # 설정 다시 실행
139
+ memesh setup
140
+ ```
141
+
142
+ 그런 다음 Claude Code를 완전히 재시작하세요.
143
+
144
+ 추가 도움: [문제 해결 가이드](docs/TROUBLESHOOTING.md)
145
+
146
+ ---
147
+
148
+ ## 더 알아보기
149
+
150
+ - **[시작하기](docs/GETTING_STARTED.md)** — 단계별 설정
151
+ - **[사용자 가이드](docs/USER_GUIDE.md)** — 예제 포함 전체 가이드
152
+ - **[명령어](docs/COMMANDS.md)** — 모든 사용 가능한 명령어
153
+ - **[아키텍처](docs/ARCHITECTURE.md)** — 내부 작동 원리
154
+ - **[기여하기](CONTRIBUTING.md)** — 도와주고 싶다면? 여기서 시작
155
+ - **[개발 가이드](docs/DEVELOPMENT.md)** — 기여자용
156
+
157
+ ---
158
+
159
+ ## 라이선스
160
+
161
+ MIT — [LICENSE](LICENSE) 참조
162
+
163
+ ---
164
+
165
+ <div align="center">
166
+
167
+ 문제가 있나요? [이슈 열기](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — 빠르게 응답합니다.
168
+
169
+ [버그 리포트](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)
170
+
171
+ </div>
package/README.md CHANGED
@@ -1,64 +1,74 @@
1
1
  <div align="center">
2
2
 
3
- # 🧠 MeMesh
3
+ # 🧠 MeMesh Plugin
4
4
 
5
- ### Persistent Memory for Claude Code
5
+ ### A productivity plugin for Claude Code
6
6
 
7
- Claude forgets everything between sessions. MeMesh fixes that.
7
+ Memory, smart task analysis, and workflow automation — all in one plugin.
8
8
 
9
9
  [![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
10
- [![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
11
- [![MCP](https://img.shields.io/badge/MCP-1.25.3-purple.svg)](https://modelcontextprotocol.io)
10
+ [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
11
+ [![MCP](https://img.shields.io/badge/MCP-compatible-purple.svg)](https://modelcontextprotocol.io)
12
12
 
13
- [Quick Install](#install) • [Usage](#usage) • [Troubleshooting](#troubleshooting) • [繁體中文](README.zh-TW.md)
13
+ [Install](#install) • [Usage](#usage) • [Troubleshooting](#troubleshooting)
14
+
15
+ [繁體中文](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)
14
16
 
15
17
  </div>
16
18
 
17
19
  ---
18
20
 
19
- ## The Problem
21
+ ## Why This Project Exists
20
22
 
21
- Every new Claude Code session starts from zero:
23
+ I love Claude Code. It's changed how I build software.
22
24
 
23
- ```
24
- You: "Remember our auth setup from yesterday?"
25
- Claude: "I don't have context from previous sessions..."
26
- ```
25
+ 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.
27
26
 
28
- You end up re-explaining the same decisions, architecture, and constraints over and over.
27
+ > **Note**: This project was originally called "Claude Code Buddy" and has been renamed to MeMesh Plugin to avoid potential trademark issues.
29
28
 
30
- ## How MeMesh Helps
29
+ ## What Does It Do?
31
30
 
32
- MeMesh gives Claude a persistent memory that survives across sessions:
31
+ MeMesh Plugin makes Claude Code smarter and more productive. It's not just memory it's a full toolkit:
33
32
 
34
- ```bash
35
- # Monday: You make a decision
36
- buddy-remember "auth"
37
- # → JWT auth: access tokens 15min, refresh tokens 7 days
38
- # Decided on Jan 15, stored permanently
39
- ```
33
+ **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.
34
+
35
+ **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.
36
+
37
+ **Workflow Automation** Behind the scenes, MeMesh hooks into Claude Code to:
38
+ - Show you a recap of your last session when you start
39
+ - Track which files you've changed and tested
40
+ - Remind you about code reviews before committing
41
+ - Route tasks to the right model (fast model for search, powerful model for planning)
42
+
43
+ **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.
44
+
45
+ **How is this different from Claude's built-in memory?**
40
46
 
41
- Your project decisions, architecture context, and debugging history all remembered automatically.
47
+ 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.
48
+
49
+ Think of it this way:
50
+ - **CLAUDE.md** = your instruction manual for Claude
51
+ - **MeMesh** = a searchable notebook + smart assistant that learns as your project grows
42
52
 
43
53
  ---
44
54
 
45
55
  ## Install
46
56
 
47
- **Prerequisites**: [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) and Node.js >= 20
57
+ **You need**: [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and Node.js 20+
48
58
 
49
59
  ```bash
50
60
  npm install -g @pcircle/memesh
51
61
  ```
52
62
 
53
- Restart Claude Code. That's it.
63
+ Restart Claude Code. Done.
54
64
 
55
- **Verify it works** — in a new Claude Code session, type:
65
+ **Check it works** — type this in Claude Code:
56
66
 
57
67
  ```
58
68
  buddy-help
59
69
  ```
60
70
 
61
- If you see a list of available commands, MeMesh is running.
71
+ You should see a list of commands.
62
72
 
63
73
  <details>
64
74
  <summary>Install from source (for contributors)</summary>
@@ -73,66 +83,15 @@ npm install && npm run build
73
83
 
74
84
  ---
75
85
 
76
- ## Compatibility
77
-
78
- ### Supported Platforms
79
-
80
- | Platform | Status | Notes |
81
- |----------|--------|-------|
82
- | **macOS** | ✅ Fully tested | Primary development platform |
83
- | **Linux** | ✅ Fully tested | All distributions supported |
84
- | **Windows** | ✅ Compatible | WSL2 recommended for best experience |
85
-
86
- ### Requirements
87
-
88
- - **Claude Code**: Latest version recommended ([install guide](https://docs.anthropic.com/en/docs/claude-code))
89
- - **Node.js**: >= 20.0.0 ([download](https://nodejs.org/))
90
- - **npm**: >= 9.0.0 (included with Node.js)
91
-
92
- ### Claude Code Integration
93
-
94
- MeMesh works seamlessly with:
95
- - ✅ **Claude Code CLI** (terminal) - **Full functionality**
96
- - ✅ **Claude Code VS Code Extension** - **Full functionality**
97
- - ✅ **Cursor** (via MCP) - **Full functionality**
98
- - ⚠️ **Claude Desktop (Cowork)** - **Partial support** (see below)
99
- - ✅ **Other MCP-compatible editors**
100
-
101
- #### Claude Desktop Cowork Compatibility
102
-
103
- **Current Status**: Cloud-only mode with limited functionality
104
-
105
- | Feature | Status | Notes |
106
- |---------|--------|-------|
107
- | MCP Server | ✅ Works | Starts successfully in cloud-only mode |
108
- | Basic Commands | ✅ Works | buddy-help, list-skills, etc. |
109
- | Memory Tools | ❌ Disabled | recall-memory, create-entities, buddy-do, buddy-remember |
110
- | Cloud Sync | ✅ Works | When MEMESH_API_KEY is configured |
111
- | Local Knowledge Graph | ❌ Unavailable | better-sqlite3 cannot compile in Cowork sandbox |
112
-
113
- **Why Limited**: Cowork sandbox has read-only filesystem and blocks native module compilation (better-sqlite3, onnxruntime-node, sqlite-vec).
114
-
115
- **Future**: Full support planned through cloud-first memory architecture. See [docs/COWORK_SUPPORT.md](docs/COWORK_SUPPORT.md) for details.
116
-
117
- **Recommendation**: Use **CLI version** for full functionality until cloud-first memory is implemented.
118
-
119
- ### Known Limitations
120
-
121
- - Windows native terminal may have display issues (use WSL2)
122
- - Minimum 4GB RAM recommended for large knowledge graphs
123
- - Vector search requires ~100MB disk space for embedding models
124
-
125
- ---
126
-
127
86
  ## Usage
128
87
 
129
- MeMesh provides 3 core commands inside Claude Code:
88
+ MeMesh adds 3 commands to Claude Code:
130
89
 
131
90
  | Command | What it does |
132
91
  |---------|-------------|
133
- | `buddy-do "task"` | Execute a task and save what was learned |
134
- | `buddy-remember "topic"` | Recall past decisions and context |
135
- | `buddy-help` | Show all available commands |
92
+ | `buddy-do "task"` | Run a task with memory context |
93
+ | `buddy-remember "topic"` | Search for past decisions and context |
94
+ | `buddy-help` | Show available commands |
136
95
 
137
96
  **Examples:**
138
97
 
@@ -143,49 +102,63 @@ buddy-remember "API design decisions"
143
102
  buddy-remember "why we chose PostgreSQL"
144
103
  ```
145
104
 
146
- Memories are stored locally on your machine and persist across sessions (90 days for decisions, 30 days for session context).
105
+ Everything is stored locally on your machine. Decisions are kept for 90 days, session notes for 30 days.
106
+
107
+ ---
108
+
109
+ ## Where It Runs
110
+
111
+ | Platform | Status |
112
+ |----------|--------|
113
+ | **macOS** | ✅ Works |
114
+ | **Linux** | ✅ Works |
115
+ | **Windows** | ✅ Works (WSL2 recommended) |
116
+
117
+ **Works with:**
118
+ - Claude Code CLI (terminal)
119
+ - Claude Code VS Code Extension
120
+ - Cursor (via MCP)
121
+ - Other MCP-compatible editors
122
+
123
+ **Claude Desktop (Cowork)**: Basic commands work, but memory features need the CLI version. See [Cowork details](docs/COWORK_SUPPORT.md).
147
124
 
148
125
  ---
149
126
 
150
127
  ## Troubleshooting
151
128
 
152
- **MeMesh not loading?**
129
+ **MeMesh not showing up?**
153
130
 
154
131
  ```bash
155
- # Check installation
132
+ # Check it's installed
156
133
  npm list -g @pcircle/memesh
157
134
 
158
- # Check Node.js version (needs >= 20)
135
+ # Check Node.js version (needs 20+)
159
136
  node --version
160
137
 
161
- # Repair installation
138
+ # Re-run setup
162
139
  memesh setup
163
140
  ```
164
141
 
165
142
  Then restart Claude Code completely.
166
143
 
167
- See the full [Troubleshooting Guide](docs/TROUBLESHOOTING.md) for more.
144
+ More help: [Troubleshooting Guide](docs/TROUBLESHOOTING.md)
168
145
 
169
146
  ---
170
147
 
171
- ## Documentation
148
+ ## Learn More
172
149
 
173
- - **[Getting Started](docs/GETTING_STARTED.md)** — First-time setup walkthrough
174
- - **[User Guide](docs/USER_GUIDE.md)** — Complete usage guide with real-world examples
175
- - **[Development Guide](docs/DEVELOPMENT.md)** — Contributor guide for local development
176
- - **[API Reference](https://pcircle-ai.github.io/claude-code-buddy/)** — Auto-generated API documentation
177
- - **[Commands Reference](docs/COMMANDS.md)** — All commands and tools
178
- - **[Architecture](docs/ARCHITECTURE.md)** — How MeMesh works internally
150
+ - **[Getting Started](docs/GETTING_STARTED.md)** — Step-by-step setup
151
+ - **[User Guide](docs/USER_GUIDE.md)** — Full usage guide with examples
152
+ - **[Commands](docs/COMMANDS.md)** — All available commands
153
+ - **[Architecture](docs/ARCHITECTURE.md)** — How it works under the hood
154
+ - **[Contributing](CONTRIBUTING.md)** — Want to help? Start here
155
+ - **[Development Guide](docs/DEVELOPMENT.md)** — For contributors
179
156
 
180
157
  ---
181
158
 
182
- ## Contributing
183
-
184
- Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).
185
-
186
159
  ## License
187
160
 
188
- AGPL-3.0 — See [LICENSE](LICENSE)
161
+ MIT — See [LICENSE](LICENSE)
189
162
 
190
163
  ---
191
164
 
@@ -193,6 +166,6 @@ AGPL-3.0 — See [LICENSE](LICENSE)
193
166
 
194
167
  Something not working? [Open an issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — we respond fast.
195
168
 
196
- [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)
169
+ [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)
197
170
 
198
171
  </div>