@pcircle/memesh 2.8.11 โ†’ 2.9.1

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 (79) 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 +47 -55
  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 +9 -12
  65. package/plugin.json +2 -2
  66. package/scripts/hooks/README.md +230 -0
  67. package/scripts/hooks/__tests__/hook-test-harness.js +218 -0
  68. package/scripts/hooks/__tests__/hooks.test.js +267 -0
  69. package/scripts/hooks/hook-utils.js +899 -0
  70. package/scripts/hooks/post-commit.js +307 -0
  71. package/scripts/hooks/post-tool-use.js +812 -0
  72. package/scripts/hooks/pre-tool-use.js +462 -0
  73. package/scripts/hooks/session-start.js +544 -0
  74. package/scripts/hooks/stop.js +673 -0
  75. package/scripts/hooks/subagent-stop.js +184 -0
  76. package/scripts/hooks/templates/planning-template.md +46 -0
  77. package/scripts/postinstall-lib.js +8 -4
  78. package/scripts/postinstall-new.js +110 -7
  79. 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>