@pcircle/memesh 2.8.7 → 2.8.8

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 (4) hide show
  1. package/README.md +63 -66
  2. package/README.zh-TW.md +65 -68
  3. package/package.json +1 -1
  4. package/plugin.json +1 -1
package/README.md CHANGED
@@ -2,147 +2,144 @@
2
2
 
3
3
  # 🧠 MeMesh
4
4
 
5
- ### **Persistent Memory for Claude Code**
5
+ ### Persistent Memory for Claude Code
6
6
 
7
- **Give Claude long-term memory. Remember decisions, context, and code. Build faster.**
7
+ Claude forgets everything between sessions. MeMesh fixes that.
8
8
 
9
9
  [![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
10
10
  [![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
11
11
  [![MCP](https://img.shields.io/badge/MCP-1.25.3-purple.svg)](https://modelcontextprotocol.io)
12
12
 
13
- [🚀 Quick Install](#-quick-install) • [💬 Commands](#-3-commands-to-rule-them-all) • [📖 Docs](docs/) • [繁體中文](README.zh-TW.md)
13
+ [Quick Install](#install) • [Usage](#usage) • [Troubleshooting](#troubleshooting) • [繁體中文](README.zh-TW.md)
14
14
 
15
15
  </div>
16
16
 
17
17
  ---
18
18
 
19
- ## 🤔 The Problem
19
+ ## The Problem
20
20
 
21
- Every new Claude Code session:
21
+ Every new Claude Code session starts from zero:
22
22
 
23
23
  ```
24
- You: "Remember our auth setup?"
25
- Claude: "I don't have that context..."
26
- You: *explains for the 47th time* 😤
24
+ You: "Remember our auth setup from yesterday?"
25
+ Claude: "I don't have context from previous sessions..."
27
26
  ```
28
27
 
29
- **Claude has amnesia. Your productivity dies.**
28
+ You end up re-explaining the same decisions, architecture, and constraints — over and over.
30
29
 
31
- ---
30
+ ## How MeMesh Helps
32
31
 
33
- ## ✨ The Solution
32
+ MeMesh gives Claude a persistent memory that survives across sessions:
34
33
 
35
34
  ```bash
36
- # Session 1 (Monday)
37
- You: buddy-do "setup JWT auth"
38
- MeMesh: ✅ Done + saved to memory
39
-
40
- # Session 50 (Friday)
41
- You: buddy-remember "auth"
42
- MeMesh: 📚 JWT auth from Jan 15
43
- → Access tokens: 15min
44
- → Refresh tokens: 7 days
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
45
39
  ```
46
40
 
47
- **MeMesh = Claude with working memory.**
41
+ Your project decisions, architecture context, and debugging history — all remembered automatically.
48
42
 
49
43
  ---
50
44
 
51
- ## 🚀 Quick Install
45
+ ## Install
46
+
47
+ **Prerequisites**: [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) and Node.js >= 20
52
48
 
53
49
  ```bash
54
50
  npm install -g @pcircle/memesh
55
51
  ```
56
52
 
57
- Restart Claude Code. **Done.**
53
+ Restart Claude Code. That's it.
54
+
55
+ **Verify it works** — in a new Claude Code session, type:
56
+
57
+ ```
58
+ buddy-help
59
+ ```
60
+
61
+ If you see a list of available commands, MeMesh is running.
58
62
 
59
63
  <details>
60
- <summary>📦 Alternative: Install from source</summary>
64
+ <summary>Install from source (for contributors)</summary>
61
65
 
62
66
  ```bash
63
67
  git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
64
68
  cd claude-code-buddy
65
69
  npm install && npm run build
66
- npm link # or use ./scripts/quick-install.sh
67
70
  ```
68
71
 
69
72
  </details>
70
73
 
71
74
  ---
72
75
 
73
- ## 💬 3 Commands to Rule Them All
76
+ ## Usage
74
77
 
75
- ```bash
76
- buddy-do "any dev task" # Execute + remember
77
- buddy-remember "topic" # Instant recall
78
- buddy-help # When stuck
79
- ```
78
+ MeMesh provides 3 core commands inside Claude Code:
79
+
80
+ | Command | What it does |
81
+ |---------|-------------|
82
+ | `buddy-do "task"` | Execute a task and save what was learned |
83
+ | `buddy-remember "topic"` | Recall past decisions and context |
84
+ | `buddy-help` | Show all available commands |
80
85
 
81
86
  **Examples:**
82
87
 
83
88
  ```bash
84
89
  buddy-do "explain this codebase"
85
90
  buddy-do "add user authentication"
86
- buddy-do "fix the build error"
87
-
88
91
  buddy-remember "API design decisions"
89
92
  buddy-remember "why we chose PostgreSQL"
90
-
91
- buddy-help # Shows all available commands
92
93
  ```
93
94
 
95
+ Memories are stored locally on your machine and persist across sessions (90 days for decisions, 30 days for session context).
96
+
94
97
  ---
95
98
 
96
- ## 🎯 Core Features
99
+ ## Troubleshooting
97
100
 
98
- ### 🧠 **Persistent Memory**
99
- - Remembers project decisions (90 days)
100
- - Recalls session context (30 days)
101
- - Semantic search across all memories
101
+ **MeMesh not loading?**
102
102
 
103
- ### 🔍 **Knowledge Graph**
104
- - Automatically organizes your knowledge
105
- - Links related concepts
106
- - FTS5 + vector search
103
+ ```bash
104
+ # Check installation
105
+ npm list -g @pcircle/memesh
107
106
 
108
- ### ⚡ **Zero Config**
109
- - Auto-tracks project changes
110
- - Auto-tags memories
111
- - Just install and use
107
+ # Check Node.js version (needs >= 20)
108
+ node --version
112
109
 
113
- ---
114
-
115
- ## 📚 Learn More
110
+ # Repair installation
111
+ memesh setup
112
+ ```
116
113
 
117
- **Core Documentation**:
118
- - **[User Guide](docs/USER_GUIDE.md)** - Complete usage guide
119
- - **[Commands Reference](docs/COMMANDS.md)** - All available commands and tools
120
- - **[Getting Started](docs/GETTING_STARTED.md)** - Installation guide
121
- - **[Troubleshooting](docs/TROUBLESHOOTING.md)** - Common issues
114
+ Then restart Claude Code completely.
122
115
 
123
- **Advanced Documentation**:
124
- - **[Architecture](docs/ARCHITECTURE.md)** - System architecture and design
125
- - **[Best Practices](docs/BEST_PRACTICES.md)** - Usage tips and recommendations
126
- - **[API Reference](docs/api/API_REFERENCE.md)** - Complete API documentation
116
+ See the full [Troubleshooting Guide](docs/TROUBLESHOOTING.md) for more.
127
117
 
128
118
  ---
129
119
 
130
- ## 🤝 Contributing
120
+ ## Documentation
131
121
 
132
- We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
122
+ - **[Getting Started](docs/GETTING_STARTED.md)** — First-time setup walkthrough
123
+ - **[User Guide](docs/USER_GUIDE.md)** — Complete usage guide
124
+ - **[Commands Reference](docs/COMMANDS.md)** — All commands and tools
125
+ - **[Architecture](docs/ARCHITECTURE.md)** — How MeMesh works internally
133
126
 
134
127
  ---
135
128
 
136
- ## 📄 License
129
+ ## Contributing
130
+
131
+ Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).
132
+
133
+ ## License
137
134
 
138
- AGPL-3.0 - See [LICENSE](LICENSE)
135
+ AGPL-3.0 — See [LICENSE](LICENSE)
139
136
 
140
137
  ---
141
138
 
142
139
  <div align="center">
143
140
 
144
- **Built by vibe coders, for vibe coders** 🚀
141
+ Something not working? [Open an issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — we respond fast.
145
142
 
146
- [Report Bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues) • [Request Feature](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
143
+ [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)
147
144
 
148
145
  </div>
package/README.zh-TW.md CHANGED
@@ -2,149 +2,146 @@
2
2
 
3
3
  # 🧠 MeMesh
4
4
 
5
- ### **為 Claude Code 添加持久記憶**
5
+ ### Claude Code 的持久記憶
6
6
 
7
- **讓 Claude 記住決策、脈絡、代碼。長期記憶，開發更快。**
7
+ Claude 每次開新 session 都會忘記一切。MeMesh 解決這個問題。
8
8
 
9
9
  [![npm version](https://img.shields.io/npm/v/@pcircle/memesh)](https://www.npmjs.com/package/@pcircle/memesh)
10
10
  [![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](LICENSE)
11
11
  [![MCP](https://img.shields.io/badge/MCP-1.25.3-purple.svg)](https://modelcontextprotocol.io)
12
12
 
13
- [🚀 快速安裝](#-快速安裝) • [💬 指令](#-三個指令統治一切) • [📖 文件](docs/) • [English](README.md)
13
+ [安裝](#安裝) • [使用方式](#使用方式) • [疑難排解](#疑難排解) • [English](README.md)
14
14
 
15
15
  </div>
16
16
 
17
17
  ---
18
18
 
19
- ## 🤔 問題
19
+ ## 問題
20
20
 
21
- 每次開新的 Claude Code session：
21
+ 每次開新的 Claude Code session 都從零開始：
22
22
 
23
23
  ```
24
- 你：「還記得我們的 auth 設定嗎？」
25
- Claude：「我沒有那個 context...」
26
- 你：*第 47 次解釋* 😤
24
+ 你：「還記得我們昨天的 auth 設定嗎？」
25
+ Claude：「我沒有之前 session 的 context...」
27
26
  ```
28
27
 
29
- **Claude 有失憶症。你的生產力崩潰。**
28
+ 你不斷重複解釋同樣的決策、架構和限制。
30
29
 
31
- ---
30
+ ## MeMesh 如何幫助
32
31
 
33
- ## ✨ 解決方案
32
+ MeMesh 讓 Claude 擁有跨 session 的持久記憶：
34
33
 
35
34
  ```bash
36
- # Session 1 (週一)
37
- 你：buddy-do "設定 JWT 認證"
38
- MeMesh: ✅ 完成 + 已存入記憶
39
-
40
- # Session 50 (週五)
41
- 你：buddy-remember "auth"
42
- MeMesh: 📚 1月15日的 JWT 認證
43
- → Access tokens: 15分鐘
44
- → Refresh tokens: 7天
35
+ # 週一：你做了一個決策
36
+ buddy-remember "auth"
37
+ # → JWT 認證：access token 15分鐘，refresh token 7天
38
+ # → 1月15日決定，永久儲存
45
39
  ```
46
40
 
47
- **MeMesh = 有記憶的 Claude。**
41
+ 專案決策、架構脈絡、除錯紀錄 — 全部自動記住。
48
42
 
49
43
  ---
50
44
 
51
- ## 🚀 快速安裝
45
+ ## 安裝
46
+
47
+ **前置需求**：[Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) 和 Node.js >= 20
52
48
 
53
49
  ```bash
54
50
  npm install -g @pcircle/memesh
55
51
  ```
56
52
 
57
- 重啟 Claude Code。**搞定。**
53
+ 重啟 Claude Code，完成。
54
+
55
+ **驗證安裝** — 在新的 Claude Code session 中輸入：
56
+
57
+ ```
58
+ buddy-help
59
+ ```
60
+
61
+ 看到指令列表就代表 MeMesh 正在運作。
58
62
 
59
63
  <details>
60
- <summary>📦 替代方案：從原始碼安裝</summary>
64
+ <summary>從原始碼安裝（給貢獻者）</summary>
61
65
 
62
66
  ```bash
63
67
  git clone https://github.com/PCIRCLE-AI/claude-code-buddy.git
64
68
  cd claude-code-buddy
65
69
  npm install && npm run build
66
- npm link # 或使用 ./scripts/quick-install.sh
67
70
  ```
68
71
 
69
72
  </details>
70
73
 
71
74
  ---
72
75
 
73
- ## 💬 三個指令統治一切
76
+ ## 使用方式
74
77
 
75
- ```bash
76
- buddy-do "任何開發任務" # 執行 + 記憶
77
- buddy-remember "主題" # 即時回想
78
- buddy-help # 卡住時用
79
- ```
78
+ MeMesh 在 Claude Code 中提供 3 個核心指令：
79
+
80
+ | 指令 | 功能 |
81
+ |------|------|
82
+ | `buddy-do "任務"` | 執行任務並記住學到的內容 |
83
+ | `buddy-remember "主題"` | 回想過去的決策和脈絡 |
84
+ | `buddy-help` | 顯示所有可用指令 |
80
85
 
81
86
  **範例：**
82
87
 
83
88
  ```bash
84
89
  buddy-do "解釋這個 codebase"
85
90
  buddy-do "加上使用者認證"
86
- buddy-do "修正 build error"
87
-
88
91
  buddy-remember "API 設計決策"
89
92
  buddy-remember "為什麼選 PostgreSQL"
90
-
91
- buddy-help # 顯示所有可用指令
92
93
  ```
93
94
 
94
- ---
95
-
96
- ## 🎯 核心功能
95
+ 記憶儲存在你的本機，跨 session 持續保存（決策 90 天，session 脈絡 30 天）。
97
96
 
98
- ### 🧠 **持久記憶**
99
- - 記住專案決策（90天）
100
- - 回想 session context（30天）
101
- - 語意搜尋所有記憶
97
+ ---
102
98
 
103
- ### 🔍 **知識圖譜**
104
- - 自動整理你的知識
105
- - 連結相關概念
106
- - FTS5 + 向量搜尋
99
+ ## 疑難排解
107
100
 
108
- ### ⚡ **零配置**
109
- - 自動追蹤專案變更
110
- - 自動標記記憶
111
- - 安裝即用
101
+ **MeMesh 沒有載入？**
112
102
 
113
- ---
103
+ ```bash
104
+ # 檢查安裝
105
+ npm list -g @pcircle/memesh
114
106
 
115
- ## 📚 了解更多
107
+ # 檢查 Node.js 版本（需要 >= 20）
108
+ node --version
116
109
 
117
- > **注意**：詳細文檔目前僅提供英文版本
110
+ # 修復安裝
111
+ memesh setup
112
+ ```
118
113
 
119
- **核心文檔**：
120
- - **[使用指南](docs/USER_GUIDE.md)** - 完整使用教學
121
- - **[指令參考](docs/COMMANDS.md)** - 所有可用指令與工具
122
- - **[快速開始](docs/GETTING_STARTED.md)** - 新手安裝指南
123
- - **[疑難排解](docs/TROUBLESHOOTING.md)** - 常見問題
114
+ 然後完全重啟 Claude Code。
124
115
 
125
- **進階文檔**：
126
- - **[架構說明](docs/ARCHITECTURE.md)** - 系統架構與設計
127
- - **[最佳實踐](docs/BEST_PRACTICES.md)** - 使用建議與技巧
128
- - **[API 參考](docs/api/API_REFERENCE.md)** - 完整 API 文檔
116
+ 完整指南請參閱 [疑難排解文件](docs/TROUBLESHOOTING.md)。
129
117
 
130
118
  ---
131
119
 
132
- ## 🤝 貢獻
120
+ ## 文件
121
+
122
+ > 詳細文件目前僅提供英文版
133
123
 
134
- 歡迎貢獻！請參閱 [CONTRIBUTING.md](CONTRIBUTING.md)
124
+ - **[快速開始](docs/GETTING_STARTED.md)** — 首次安裝指引
125
+ - **[使用指南](docs/USER_GUIDE.md)** — 完整使用教學
126
+ - **[指令參考](docs/COMMANDS.md)** — 所有指令與工具
127
+ - **[架構說明](docs/ARCHITECTURE.md)** — MeMesh 內部運作方式
135
128
 
136
129
  ---
137
130
 
138
- ## 📄 授權
131
+ ## 貢獻
132
+
133
+ 歡迎貢獻！請參閱 [CONTRIBUTING.md](CONTRIBUTING.md)。
134
+
135
+ ## 授權
139
136
 
140
- AGPL-3.0 - 詳見 [LICENSE](LICENSE)
137
+ AGPL-3.0 — 詳見 [LICENSE](LICENSE)
141
138
 
142
139
  ---
143
140
 
144
141
  <div align="center">
145
142
 
146
- **由 vibe coders 打造，為 vibe coders 服務** 🚀
143
+ 遇到問題？[回報 Issue](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new) — 我們會快速回應。
147
144
 
148
- [回報 Bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues) • [功能請求](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
145
+ [回報 Bug](https://github.com/PCIRCLE-AI/claude-code-buddy/issues/new?labels=bug&template=bug_report.md) • [功能請求](https://github.com/PCIRCLE-AI/claude-code-buddy/discussions)
149
146
 
150
147
  </div>
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pcircle/memesh",
3
- "version": "2.8.7",
3
+ "version": "2.8.8",
4
4
  "description": "MeMesh - Your AI memory mesh for Claude Code. Smart routing, persistent memory, and intelligent task management.",
5
5
  "main": "dist/index.js",
6
6
  "type": "module",
package/plugin.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "author": {
5
5
  "name": "PCIRCLE AI"
6
6
  },
7
- "version": "2.8.7",
7
+ "version": "2.8.8",
8
8
  "homepage": "https://github.com/PCIRCLE-AI/claude-code-buddy",
9
9
  "repository": "https://github.com/PCIRCLE-AI/claude-code-buddy",
10
10
  "license": "AGPL-3.0"