Install
$ agentstack add mcp-alenryuichi-openmemory-plus โ scanned ยท โ verified โ works with Claude Code, Cursor, and more.
Security review
โ PassedNo issues found. Passed automated security review. ยท v0.1.0 How review works โ
- โ Prompt-injection patterns
- โ Secret / credential exfiltration
- โ Dangerous shell & filesystem operations
- โ Untrusted network calls
- โ Known-malicious package signatures
What it can access
- โ Network access No
- โ Filesystem access No
- โ Shell / process execution No
- โ Environment & secrets Used
- โ Dynamic code execution No
From automated source analysis of v0.1.0. โUsedโ means the capability is present in the source โ more access means more to trust, not that itโs unsafe.
About
xMemory ๅๅฑ่ฎฐๅฟๆถๆ ยท ๆบ่ฝๅ็ฑป ยท ่ชๅจๆๅ ยท ๅค IDE ๆฏๆ
๐จ๐ณ ไธญๆ | ๐บ๐ธ English
ๅฟซ้ๅผๅง โข ็นๆง โข ๆถๆ โข ๆฏๆ็ IDE โข ๆๆกฃ
๐ฏ ็ฎไป
> ๅๅฆไบๆฏๆฌกๅๆข AI ๅทฅๅ ท้ฝ่ฆ้ๅค่ชๆไป็ป๏ผ > > Cursor ไธ็ฅ้ไฝ ๅจ Claude ้่ฏด่ฟๅๆฌข TypeScript๏ผAugment ไธ่ฎฐๅพไฝ ๆจๅคฉ็ๆๆฏๅณ็ญ... > > OpenMemory Plus ่ฎฉๆๆ AI Agent ๅ ฑไบซๅไธไปฝ่ฎฐๅฟใ
OpenMemory Plus ๆฏไธไธชไธบ AI Agent ่ฎพ่ฎก็็ปไธ่ฎฐๅฟ็ฎก็ๆกๆถ๏ผ้็จ xMemory ๅๅฑ่ฎฐๅฟๆถๆ๏ผ
- L3 Theme โ ไธป้ข่็ฑปๅฑ๏ผ่ชๅจๅฝ็บณ้ซๅฑๆฆๅฟต
- L2 Semantic โ ่ฏญไน่ฎฐๅฟๅฑ๏ผๅบไบ BGE-M3 ๅ้ๆฃ็ดข
- L1 Episode โ ๆ ่่ฎฐๅฟๅฑ๏ผไฟๅญๅฏน่ฏไธไธๆ
- L0 Message โ ๅๅงๆถๆฏๅฑ
# 5 ๅ้ๅฎ่ฃ
๏ผ็ป็ป AI ๅคฑๅฟ็
npx openmemory-plus install
๐ธ ๆๆๅฑ็คบ
่ชๅจ่ฎฐๅฟๆๅๆง่ก
่ฎฐๅฟๆๅ็ปๆ
๐ก ไธบไปไน้่ฆ OpenMemory Plus๏ผ
็็นๅบๆฏ
ไฝ ๆฏๅฆ้ๅฐ่ฟ่ฟไบ้ฎ้ข๏ผ
| ๐ค ็็น | ๐ ๅบๆฏๆ่ฟฐ | |--------|------------| | ๅค CLI ่ฎฐๅฟๅฒ่ฃ | ๅๆถ็จ GeminiใAugmentใClaudeใCursor๏ผๆฏไธช้ฝๆฏ็ฌ็ซ่ฎฐๅฟ๏ผไบไธ็ธ้ | | Agent ๅคฑๅฟ็ | ๆฏๆฌกๆฐๅฏน่ฏ๏ผAgent ้ฝๅฟ่ฎฐไฝ ๆฏ่ฐใ้กน็ฎๅจๅชใไธๆฌกๅไบไปไน | | ้ๅค่ชๆไป็ป | ๅๆข CLI ๅๅ่ฆๅ่ฏ Agent๏ผๆๅๆฌข TypeScriptใ็จ pnpmใๅๅฅฝๅฝๆฐๅผ... | | ้ ็ฝฎ็ข็ๅ | ้จ็ฝฒ URL ๅจ Slack๏ผAPI Key ๅจ็ฌ่ฎฐ๏ผ่ทฏๅพๅจ่ๅญ้ | | ไธไธๆไธขๅคฑ | ๆจๅคฉๅจ Claude ่ฎจ่ฎบ็ๆๆฏๅณ็ญ๏ผไปๅคฉๅจ Augment ๅฎๅ จไธ่ฎฐๅพ |
OpenMemory Plus ๅฆไฝ่งฃๅณ๏ผ
๐ ๅค CLI ็ปไธ่ฎฐๅฟๅฑ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๆฒกๆ OpenMemory Plus โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โ
โ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โ
โ โ Gemini โ โ Augment โ โ Claude โ โ Cursor โ โ
โ โ CLI โ โ Agent โ โ Code โ โ Agent โ โ
โ โโโโโโโโโโโค โโโโโโโโโโโค โโโโโโโโโโโค โโโโโโโโโโโค โ
โ โ ่ฎฐๅฟ A โ โ ่ฎฐๅฟ B โ โ ่ฎฐๅฟ C โ โ ่ฎฐๅฟ D โ โ
โ โ (็ฌ็ซ) โ โ (็ฌ็ซ) โ โ (็ฌ็ซ) โ โ (็ฌ็ซ) โ โ
โ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โ
โ โ ไบไธ็ธ้๏ผๆฏไธช้ฝ่ฆ้ๅคๅ็ฅๅๅฅฝๅไธไธๆ โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ไฝฟ็จ OpenMemory Plus โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โ
โ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โ
โ โ Gemini โ โ Augment โ โ Claude โ โ Cursor โ โ
โ โ CLI โ โ Agent โ โ Code โ โ Agent โ โ
โ โโโโโโฌโโโโโ โโโโโโฌโโโโโ โโโโโโฌโโโโโ โโโโโโฌโโโโโ โ
โ โ โ โ โ โ
โ โโโโโโโโโโโโโโโดโโโโโโโฌโโโโโโโดโโโโโโโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโผโโโโโโโโ โ
โ โ OpenMemory โ โ
โ โ Plus ็ปไธๅฑ โ โ
โ โโโโโโโโโโโโโโโโโค โ
โ โ โข ็จๆทๅๅฅฝ โ โ
โ โ โข ๆๆฏๆ โ โ
โ โ โข ้กน็ฎ้
็ฝฎ โ โ
โ โ โข ๅๅฒๅณ็ญ โ โ
โ โโโโโโโโโโโโโโโโโ โ
โ โ
ไธๅค่ฎฐๅฟ๏ผๅคๅคๅฏ็จใๅๆข CLI ๆ ็ผ่กๆฅ โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ฌ ๅฎ้ ๅฏน่ฏๅฏนๆฏ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ [Gemini CLI] ๆฉไธ โ
โ ็จๆท: ๆๅๆฌข็จ TypeScript ๅ pnpm โ
โ Gemini: ๅฅฝ็๏ผๅทฒ่ฎฐไฝไฝ ็ๅๅฅฝ โ
โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ [Augment] ไธๅ - ๅๆข CLI โ
โ ็จๆท: ๅธฎๆๅๅงๅไธไธชๆฐ้กน็ฎ โ
โ Augment: ๅฅฝ็๏ผๆ นๆฎไฝ ็ๅๅฅฝ๏ผๆ็จ TypeScript + pnpm ๅๅงๅ โ
โ (่ชๅจ่ฏปๅไบ Gemini ๅญๅจ็ๅๅฅฝ) โ
โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ [Claude Code] ๆไธ - ๅๆฌกๅๆข โ
โ ็จๆท: ๆฃๆฅไธไธไปฃ็ ้ฃๆ ผ โ
โ Claude: ๆ็ๅฐไฝ ๅๅฅฝๅฝๆฐๅผ้ฃๆ ผ๏ผๆฃๆฅไธญ... โ
โ (ๆๆ CLI ๅ
ฑไบซๅไธไปฝ่ฎฐๅฟ) โ
โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ฏ ้็จๅบๆฏ
๐ค ้ๅ่ฐ็จ๏ผ
| ็จๆท็ฑปๅ | ไฝฟ็จๅบๆฏ | |----------|----------| | ็ฌ็ซๅผๅ่ | ๅค้กน็ฎๅผๅ๏ผๅธๆ Agent ่ฎฐไฝๆฏไธช้กน็ฎ็้ ็ฝฎๅไธไธๆ | | ๅ จๆ ๅทฅ็จๅธ | ้ข็นๅๆขๅๅ็ซฏ้กน็ฎ๏ผ้่ฆ Agent ่ฎฐไฝๆๆฏๆ ๅๅฅฝ | | AI ๅทฅๅ ท้ๅบฆ็จๆท | ๅๆถไฝฟ็จ CursorใClaudeใAugment๏ผๅธๆ่ฎฐๅฟไบ้ | | ๅข้ Tech Lead | ๅธๆ้กน็ฎ้ ็ฝฎ็ๆฌๅ๏ผๆฐๆๅ Agent ่ชๅจ่ทๅไธไธๆ |
๐ ๅ ธๅ็จไพ
๐ง ็จไพ 1: ้กน็ฎ้ ็ฝฎ็ฎก็
ๅบๆฏ: ไฝ ๆ 5 ไธช้กน็ฎ๏ผๆฏไธช้ฝๆไธๅ็้จ็ฝฒ้ ็ฝฎ
ๆฒกๆ OpenMemory Plus:
- ๆฏๆฌก้ฝ่ฆๅ่ฏ Agent ้กน็ฎ่ทฏๅพ
- ๆฏๆฌก้ฝ่ฆๆไพ้จ็ฝฒ URL
- ๆฏๆฌก้ฝ่ฆ่งฃ้้กน็ฎ็ปๆ
ไฝฟ็จ OpenMemory Plus:
## ้จ็ฝฒ้
็ฝฎ
- Vercel URL: https://my-app.vercel.app
- Project ID: prj_xxx
## ้กน็ฎ่ทฏๅพ
- Root: /Users/me/projects/my-app
- Src: ./src
- Tests: ./tests
Agent ่ชๅจ่ฏปๅ๏ผๆ ้้ๅค่ฏดๆใ
๐จ ็จไพ 2: ่ทจ้กน็ฎๅๅฅฝๅๆญฅ
ๅบๆฏ: ไฝ ๅๆฌข็จ TypeScriptใTailwindใpnpm
ๆฒกๆ OpenMemory Plus:
- ๆฏไธชๆฐ้กน็ฎ้ฝ่ฆๅ่ฏ Agent ไฝ ็ๅๅฅฝ
- ๅๆข IDE ๅๅๅฅฝไธขๅคฑ
ไฝฟ็จ OpenMemory Plus:
openmemory (็จๆท็บง๏ผ่ทจ้กน็ฎๅ
ฑไบซ):
โโโ "็จๆทๅๅฅฝ: ไฝฟ็จ TypeScript ่้ JavaScript"
โโโ "็จๆทๅๅฅฝ: ไฝฟ็จ pnpm ่้ npm"
โโโ "็จๆทๅๅฅฝ: ไฝฟ็จ Tailwind CSS"
โโโ "็จๆทๆ่ฝ: ็ๆ React, Next.js, Node.js"
ไปปไฝ้กน็ฎใไปปไฝ IDE๏ผAgent ้ฝ็ฅ้ไฝ ็ๅๅฅฝใ
๐ ็จไพ 3: ๆๆฏๅณ็ญ่ฟฝ่ธช
ๅบๆฏ: ๅข้่ฎจ่ฎบๅๅณๅฎไฝฟ็จ PostgreSQL ่้ MongoDB
ๆฒกๆ OpenMemory Plus:
- ๅณ็ญ่ฎฐๅฝๅจ Slack/Notion๏ผAgent ไธ็ฅ้
- ไธๆฌก Agent ๅฏ่ฝๅปบ่ฎฎ็จ MongoDB
ไฝฟ็จ OpenMemory Plus:
## ๆๆฏๅณ็ญ
### ๆฐๆฎๅบ้ๅ (2026-02-01)
- **้ๆฉ**: PostgreSQL
- **ๅค้**: MongoDB, MySQL
- **ๅๅ **: ้่ฆๅคๆๆฅ่ฏขๅไบๅกๆฏๆ
Agent ่ฎฐไฝๅณ็ญ๏ผไธไผ้ๅคๅปบ่ฎฎๅทฒๅฆๅณ็ๆนๆกใ
๐ ็จไพ 4: ๅค CLI ่ฎฐๅฟๅ ฑไบซ (ๆ ธๅฟๅบๆฏ)
ๅบๆฏ: ไฝ ๅๆถไฝฟ็จ Gemini CLIใAugmentใClaude CodeใCursor
ๆฒกๆ OpenMemory Plus:
๐ค ๆฏๅคฉ็็่ฆๅพช็ฏ๏ผ
[ๆฉไธ - Gemini CLI]
็จๆท: ๆๅๆฌข TypeScript๏ผ็จ pnpm
Gemini: ๅฅฝ็๏ผ
[ไธญๅ - ๅๆขๅฐ Augment]
็จๆท: ๅธฎๆๅๅปบ็ปไปถ
Augment: ่ฏท้ฎไฝ ็จ JavaScript ่ฟๆฏ TypeScript๏ผ โ ๅ่ฆ่ฏดไธ้
็จๆท: TypeScript...
Augment: ็จ npm ่ฟๆฏ yarn๏ผ โ ๅๅ่ฆ่ฏดไธ้
็จๆท: pnpm... ๐ค
[ไธๅ - ๅๆขๅฐ Claude Code]
Claude: ไฝ ๅฅฝ๏ผ่ฏท้ฎไฝ ็ๆๆฏๆ ๅๅฅฝๆฏ๏ผ โ ๅๅๅ่ฆ่ฏดไธ้
็จๆท: ...... ๐ญ
ไฝฟ็จ OpenMemory Plus:
โ
ไธๆฌกๅ็ฅ๏ผๅคๅค็ๆ๏ผ
[ๆฉไธ - Gemini CLI]
็จๆท: ๆๅๆฌข TypeScript๏ผ็จ pnpm
Gemini: ๅฅฝ็๏ผๅทฒ่ฎฐไฝ๏ผ โ ๅญๅ
ฅ openmemory
[ไธญๅ - ๅๆขๅฐ Augment]
็จๆท: ๅธฎๆๅๅปบ็ปไปถ
Augment: ๅฅฝ็๏ผ็จ TypeScript + pnpm ๅๅปบไธญ... โ ่ชๅจ่ฏปๅ
(ๆ็ฅ้ไฝ ็ๅๅฅฝ ๐)
[ไธๅ - ๅๆขๅฐ Claude Code]
็จๆท: ๆฃๆฅไปฃ็ ้ฃๆ ผ
Claude: ๆ นๆฎไฝ ็ TypeScript ๅๅฅฝๆฃๆฅไธญ... โ ่ชๅจ่ฏปๅ
ๅ็ฐ 3 ๅคๅฏไผๅ โ
[ๆไธ - ๅๆขๅฐ Cursor]
Cursor: ๆ็ๅฐไฝ ไปๅคฉๅจๅ
ถไป CLI ๅๅปบไบๆฐ็ปไปถ๏ผ
้่ฆๆๅธฎไฝ ๅๆต่ฏๅ๏ผ โ ็่ณ็ฅ้ไฝ ไปๅคฉๅไบไปไน
ๅ ฑไบซ็่ฎฐๅฟๅ ๅฎน:
# openmemory (ๆๆ CLI ๅ
ฑไบซ)
็จๆทๅๅฅฝ:
- ่ฏญ่จ: TypeScript
- ๅ
็ฎก็ๅจ: pnpm
- ๆกๆถ: React, Next.js
- ้ฃๆ ผ: ๅฝๆฐๅผ็ผ็จ
็จๆทๆ่ฝ:
- ็ๆ: Node.js, Python
- ๅญฆไน ไธญ: Rust
ไปๆฅไธไธๆ:
- ๅจ Gemini ่ฎพ็ฝฎไบๅๅฅฝ
- ๅจ Augment ๅๅปบไบ Button ็ปไปถ
- ๅจ Claude ไผๅไบไปฃ็ ้ฃๆ ผ
๐ ๅฟซ้ๅผๅง
ไธ้ฎๅฎ่ฃ
npx openmemory-plus install
ๅฎ่ฃ ๅๅฏผไผ่ชๅจๅผๅฏผไฝ ๏ผ
- โ ๆฃๆต็ณป็ปไพ่ต (Docker, Qdrant, Ollama, BGE-M3)
- โ Docker Compose ไธ้ฎ้จ็ฝฒ (ๆจ่) ๆๅ็ๅฎ่ฃ
- โ ้ๆฉ IDE ็ฑปๅ
- โ ๅๅงๅ้กน็ฎ้ ็ฝฎ
- โ ๆพ็คบไธไธๆญฅๆๅผ
๐ณ Docker Compose ไธ้ฎ้จ็ฝฒ (ๆจ่)
ๅช้ๅฎ่ฃ Docker๏ผๅ ถไปไพ่ต่ชๅจๅค็๏ผ
# ๆนๅผ 1: ๅฎ่ฃ
ๆถ่ชๅจๆฃๆตๅนถไฝฟ็จ Docker Compose
npx openmemory-plus install
# ๆนๅผ 2: ๆพๅผไฝฟ็จ Docker Compose ๆจกๅผ
npx openmemory-plus install --compose
# ๆนๅผ 3: ๆๅจ็ฎก็ไพ่ตๆๅก
omp deps init # ๅๅงๅ้
็ฝฎ
omp deps up # ๅฏๅจๆๅก (Qdrant + Ollama + BGE-M3)
omp deps status # ๆฅ็็ถๆ
omp deps down # ๅๆญขๆๅก
ไผๅฟ๏ผ
- ๐ฏ ๅช้ๅฎ่ฃ Docker ไธไธชไพ่ต
- โก ไธ้ฎๅฏๅจๆๆๆๅก
- ๐ฆ BGE-M3 ๆจกๅ่ชๅจไธ่ฝฝ
- ๐พ ๆฐๆฎๆไน ๅ๏ผ้ๅฏไธไธขๅคฑ
ๅบๆฌ็จๆณ
ๅฎ่ฃ ๅฎๆๅ๏ผๅจไฝ ็ AI Agent ๅฏน่ฏไธญไฝฟ็จ๏ผ
/memory # ๆพ็คบ่ฎฐๅฟ็ถๆ + ๅฟซ้่ๅ
/mem search # ๆ็ดข่ฎฐๅฟ
/mem sync # ๅๆญฅๅนถๆฃๆตๅฒ็ช
/mem clean # ๆธ
็่ฟๆถ่ฎฐๅฟ
็ณป็ป่ฆๆฑ
| ไพ่ต | ็ๆฌ | ่ฏดๆ | |------|------|------| | Node.js | >= 18.0.0 | ่ฟ่ก CLI | | Docker | ๆๆฐ็ | ๅฏไธๅฟ ้ไพ่ต (Docker Compose ๆจกๅผ) | | Ollama | ๆๆฐ็ | ่ฟ่ก BGE-M3 ๅตๅ ฅๆจกๅ (ๅ็ๆจกๅผ้่ฆ) |
โจ ็นๆง
ๆ ธๅฟ่ฝๅ
- ๐ง xMemory ๅๅฑๆถๆ โ L3 Theme โ L2 Semantic โ L1 Episode โ L0 Message
- ๐ฏ ๆบ่ฝๅ็ฑป โ ่ชๅจๅคๆญไฟกๆฏๅบๅญๅจๅจ้กน็ฎ่ฟๆฏ็จๆท่ฎฐๅฟ
- ๐ ่ฏญไนๆ็ดข โ ๅบไบ BGE-M3 ็ๅค่ฏญ่จๅ้ๆฃ็ดข + ไธป้ขๅฑ่็ฑป
- โก ไบไปถ้ฉฑๅจๆๅ โ ๅฏน่ฏ็ปๆๆถ่ชๅจ่งฆๅ่ฎฐๅฟๆๅ Skill
- ๐ ๆๆไฟกๆฏ่ฟๆปค โ ่ชๅจ่ฏๅซๅนถ้ปๆญขๅญๅจ API Keyใๅฏ็ ็ญ
- ๐ฏ Top-down ๆฃ็ดข โ ไปไธป้ขๅฑๅผๅง๏ผ่ช้ๅบๅฑๅผๅฐ่ฏญไนๅฑ
๐ค ๅค LLM ๆฏๆ NEW
ๆฏๆๅค็ง LLM Provider ่ฟ่ก่ฎฐๅฟๅ็ฑป๏ผ
| Provider | ๆจกๅ | ็น็น | |----------|------|------| | DeepSeek | deepseek-chat | ๐ฅ ๆจ่๏ผๆงไปทๆฏ้ซ | | MiniMax | abab6.5s-chat | ไธญๆไผๅ | | ZhiPu | glm-4-flash | ๅฝไบงๅคงๆจกๅ | | Qwen | qwen-turbo | ้ฟ้ไบ | | OpenAI | gpt-4o-mini | ๅฝ้ ๆ ๅ | | Ollama | ๆฌๅฐๆจกๅ | ็ฆป็บฟๅฏ็จ |
๐ง ๆบ่ฝ่ฎฐๅฟ็ฎก็
- ๐ ๅค็ปดๅบฆๅ็ฑป โ ไธ็ปดๅบฆๅ็ฑปไฝ็ณป (Scope/Confidence/Temporality)๏ผ็ฒพๅ่ทฏ็ฑๆฏๆก่ฎฐๅฟ
- ๐งน ROT ๆบ่ฝ่ฟๆปค โ ่ชๅจ่ฏๅซๅไฝใ่ฟๆถใ็็ขไฟกๆฏ๏ผไฟๆ่ฎฐๅฟๅบ็ฒพ็ฎ
- โฐ Ebbinghaus ่กฐๅ โ ๅบไบ้ๅฟๆฒ็บฟ็่ฎฐๅฟ็ๅฝๅจๆ็ฎก็๏ผ่ชๅจๆธ ็้ๆง่ฎฐๅฟ
- ๐ ๅฒ็ชๆฃๆต โ ่ชๅจๅ็ฐๅๅฑๆฐๆฎ็็พ๏ผๆบ่ฝๆ็คบ่งฃๅณๆนๆก
- ๐ ๅฅๅบทๅบฆ็ๆง โ ๅ็ปดๅบฆๅ ๆ่ฏๅ๏ผๅฎๆถๆๆก่ฎฐๅฟ็ณป็ป็ถๆ
> ๐ ๆๆฏ่ฏฆๆ : ๅ่ง [่ฎฐๅฟ็ณป็ปๆถๆๆๆกฃ](docs/memory-system.md)
่ฟ้ถๅ่ฝ
- ๐ ้็บง็ญ็ฅ โ MCP ไธๅฏ็จๆถ่ชๅจ้็บงๅฐๆฌๅฐๅญๅจ
- ๐ ่ฎฐๅฟๆดๅ โ ่ฏญไน่็ฑปๅๅนถ็ข็ๅ่ฎฐๅฟ
- ๐ ่ดจ้ๆๆ โ ๅฏ่งๅ้ขๆฟๅฑ็คบ่ฎฐๅฟๅฅๅบท็ถๆ
- ๐ง ๆธ่ฟๅผ้ ็ฝฎ โ ๅทฒๆ้ ็ฝฎๆไปถๆถ่ฟฝๅ ่้่ฆ็
๐๏ธ ๆถๆ
xMemory ๅๅฑ่ฎฐๅฟๆถๆ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ xMemory 4-Layer Architecture โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ L3 Theme (ไธป้ขๅฑ) โ โ
โ โ โโโ ่ชๅจ่็ฑป็ธไผผ่ฏญไน่ฎฐๅฟ โ โ
โ โ โโโ ไธป้ขๅธ้ (attachThreshold: 0.62) โ โ
โ โ โโโ ไธป้ขๅ่ฃ (maxThemeSize: 12) โ โ
โ โ โโโ ไธป้ขๅๅนถ (mergeThreshold: 0.78) โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ L2 Semantic (่ฏญไนๅฑ) - Qdrant ๅ้ๆฐๆฎๅบ โ โ
โ โ โโโ BGE-M3 ๅค่ฏญ่จ Embedding โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ L1 Episode (ๆ
่ๅฑ) - ๅฏน่ฏไธไธๆ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ L0 Message (ๆถๆฏๅฑ) - ๅๅงๅฏน่ฏ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
ๅญๅจๅๅฑ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ OpenMemory Plus โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโค
โ โ
โ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโ โ
โ โ /memory โ โ /mem xxx โ โ ่ชๅจๆๅ โ โ
โ โ (ๅ
ฅๅฃ) โ โ (ๅญๅฝไปค) โ โ (Skill) โ โ
โ โโโโโโโโฌโโโโโโโ โโโโโโโโฌโโโโโโโ โโโโโโโโฌโโโโโโโ โ
โ โโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ Memory Router (ๆบ่ฝๅ็ฑป) โ โ
โ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โ
โ โ โ
โ โโโโโโโโโโโโโโโโโโโโผโโโโโโโโโโโโโโโโโโโ โ
โ โ โ โ
โ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โ
โ โ _omp/memory/ โ โ openmemory โ โ
โ โ (้กน็ฎ็บง) โ โ (็จๆท็บง) โ โ
โ โโโโโโโโโโโโโโโโโโโค โโโโโโโโโโโโโโโโโโโค โ
โ โ โข project.yaml โ โ โข L3 ไธป้ขๅฑ โ โ
โ โ โข decisions.yamlโ โ โข L2 ่ฏญไนๅฑ โ โ
โ โ โข themes/ โ โ โข L1 ๆ
่ๅฑ โ โ
โ โ โข Git ็ๆฌๆงๅถ โ โ โข MCP ๅ่ฎฎ โ โ
โ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โ
โ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
ๅ็ฑป่งๅ
| ไฟกๆฏ็ฑปๅ | ๅญๅจไฝ็ฝฎ | ๅฑ็บง | ็คบไพ | |----------|----------|------|------| | ้กน็ฎ้
็ฝฎ | _omp/memory/*.md | - | ้จ็ฝฒ URLใ็ฏๅขๅ้ใ่ทฏๅพ | | ๆๆฏๅณ็ญ | _omp/memory/techContext.md | - | ๆกๆถ้ๆฉใๆถๆ่ฎพ่ฎก | | ไธป้ข่็ฑป | _omp/memory/themes/ | L3 | ่ชๅจ็ๆ็ไธป้ข็ดขๅผ | | ็จๆทๅๅฅฝ | openmemory (MCP) | L2 | ่ฏญ่จๅๅฅฝใไปฃ็ ้ฃๆ ผ | | ็จๆทๆ่ฝ | openmemory (MCP) | L2 | ็ๆ็ๆๆฏๆ ใ็ป้ช |
xMemory ๆฃ็ดขๆต็จ
ๆฅ่ฏข่พๅ
ฅ โ L3 ไธป้ขๅฑๅน้
โ ๅๆฐ > 0.75? โ ๅฑๅผๅฐ L2 ่ฏญไนๅฑ โ ่ฟๅ็ปๆ
โ โ
KNN ้ปๅฑ
ๆ็ดข ็ดๆฅ่ฟๅไธป้ข
> ๐ก ๆณจๆ: ๅฎ่ฃ
ๅ๏ผ้กน็ฎ็บง่ฎฐๅฟๅญๅจๅจ _omp/memory/ ็ฎๅฝไธ๏ผ่ฏฅ็ฎๅฝไผ่ขซๆทปๅ ๅฐ Git ็ๆฌๆงๅถใ
๐ฅ๏ธ ๆฏๆ็ IDE
Augment โ ๅฎๆดๆฏๆ
Claude Code โ ๅฎๆดๆฏๆ
Cursor โ ๅฎๆดๆฏๆ
Gemini CLI โ ๅฎๆดๆฏๆ
๐ฆ CLI ๅฝไปค
ๅฎ่ฃ ๅฝไปค
# ไบคไบๅผๅฎ่ฃ
(ๆจ่)
npx openmemory-plus install
# ไฝฟ็จ Docker Compose ไธ้ฎ้จ็ฝฒ (ๆจ่)
npx openmemory-plus install --compose
# ้้ปๅฎ่ฃ
npx openmemory-plus install -y
# ๆๅฎ IDE
npx openmemory-plus install --ide augment
# ๆๅฎ LLM Provider (็จไบ่ฎฐๅฟๅ็ฑป)
npx openmemory-plus install --llm deepseek
# ไป
้
็ฝฎ้กน็ฎ๏ผ่ทณ่ฟไพ่ตๆฃๆต
npx openmemory-plus install --skip-deps
# ๆพ็คบ MCP ้
็ฝฎ
npx openmemory-plus install --show-mcp
ๆฏๆ็ LLM Provider
| Provider | ๅฝไปค | ็ฏๅขๅ้ | |----------|------|----------| | DeepSeek | --llm deepseek | DEEPSEEK_API_KEY | | MiniMax | --llm minimax | MINIMAX_API_KEY | | ZhiPu | --llm zhipu | ZHIPU_API_KEY | | Qwen | --llm qwen | DASHSCOPE_API_KEY | | OpenAI | --llm openai | OPENAI_API_KEY | | Ollama | --llm ollama | (ๆฌๅฐ๏ผๆ ้ API Key) |
๐ณ ไพ่ตๆๅก็ฎก็ (Docker Compose)
# ๅๅงๅ Docker Compose ้
็ฝฎ
omp deps init
# ๅฏๅจๆๆไพ่ตๆๅก (Qdrant + Ollama + BGE-M3)
omp deps up
# ๅฏๅจๅๆๅๆๆฐ้ๅ
omp deps up --pull
# ๅๆญขๆๆๆๅก
omp deps down
# ๆฅ็ๆๅก็ถๆ
omp deps status
# ๆฅ็ๆๅกๆฅๅฟ
omp deps logs # ๆๆๆๅก
omp deps logs ollama # ๆๅฎๆๅก
omp deps logs -f # ๆ็ปญ่พๅบ
# ๆๅจไธ่ฝฝ BGE-M3 ๆจกๅ
omp deps pull-model
่ฏๆญๅฝไปค
# ๆฃๆฅ็ณป็ป็ถๆ
npx openmemory-plus status
# ่ฏๆญ้ฎ้ข
npx openmemory-plus doctor
# ่ชๅจไฟฎๅค
npx openmemory-plus doctor --fix
Agent ๅ ็ฝฎๅฝไปค
| ๅฝไปค | ่ฏดๆ | |------|------| | /memory | ๆพ็คบๅฟซ้็ถๆ + ๅญๅฝไปค่ๅ | | /mem status | ่ฏฆ็ป่ฎฐๅฟ็ถๆ | | /mem search {query} | ่ฏญไนๆ็ดข่ฎฐๅฟ (้ป่ฎค L2 ่ฏญไนๅฑ) | | /mem search {query} --level theme | ๐ ไธป้ขๅฑๆ็ดข (L3) | | /mem search {query} --level theme --no-expand | ๐ ไป
ไธป้ขๅฑ๏ผไธๅฑๅผ | | /mem store | ๆๅจๅญๅจ่ฎฐๅฟ | | /mem sync | ๆฃๆตๅนถ่งฃๅณๅฒ็ช | | /mem clean | ๆธ
็ ROT ่ฎฐๅฟ | | /mem decay | ๆถ้ด่กฐๅๅๆ | | /mem graph | ็ฅ่ฏๅพ่ฐฑๅฏ่งๅ | | /mem themes | ๐ ๆฅ็ไธป้ข่็ฑป็ถๆ |
๐ ้กน็ฎ็ปๆ
openmemory-plus/
โโโ cli/ # CLI ๅทฅๅ
ทๆบ็
โ โโโ src/
โ โ โโโ commands/ # install, status, doctor
โ โ โโโ lib/ # ๆ ธๅฟๅบ
โ โโโ templates/ # ๆจกๆฟๆไปถ
โ โโโ shared/ # ๅ
ฑไบซๆจกๆฟ
โ โโโ _omp/ # ๆ ธๅฟ็ฎๅฝๆจกๆฟ
โโโ docs/ # ๆๆกฃ
โ โโโ architecture.md # ๆถๆ่ฎพ่ฎก
โโโ AGENTS.md # AI Agent ้
็ฝฎๅ
ฅๅฃ
โโโ README.md # ๆฌๆไปถ
# ๅฎ่ฃ
ๅๅจไฝ ็้กน็ฎไธญ็ๆ (ไปฅ Augment ไธบไพ):
your-project/
โโโ _omp/ # OpenMemory Plus ๆ ธๅฟ็ฎๅฝ (ๆๆ IDE ๅ
ฑไบซ)
โ โโโ AGENTS.md # ๅฎๆด Agent ่งๅๆไปถ
โ โโโ memory/ # ้กน็ฎ็บง่ฎฐๅฟๅญๅจ
โ โ โโโ projectbrief.md # ้กน็ฎๆฆ่ฟฐ
โ โ โโโ productContext.md # ไบงๅ้ๆฑ
โ โ โโโ techContext.md # ๆๆฏๆ
โ โ โโโ activeContext.md # ๅฝๅไผ่ฏไธไธๆ
โ โ โโโ systemPatterns.md # ๆจกๅผไธ่ง่
โ โ โโโ decisions.yaml # ๆถๆๅณ็ญๆฅๅฟ
โ โ โโโ progress.md # ไปปๅก่ฟๅบฆ
โ โโโ commands/ # Agent ๅฝไปค
โ โ โโโ memory.md # ไธปๅฝไปคๅ
ฅๅฃ
โ โโโ workflows/ # ๅทฅไฝๆต
โ โ โโโ memory/ # ่ฎฐๅฟ็ฎก็ๅทฅไฝๆต (7 ๆญฅ้ชค)
โ โโโ skills/ # Agent Skills
โ โโโ memory-extraction/ # ่ฎฐๅฟๆๅ Skill (่ชๅจ่งฆๅ)
โ
โโโ AGENTS.md # ๅ
ฅๅฃๆไปถ (ๅผ็จ _omp/AGENTS.md)
โโโ .augment/ # IDE ็นๅฎ็ฎๅฝ
โโโ commands/ # ๅฝไปคๅ
ฅๅฃ (้พๆฅๅฐ _omp)
โโโ skills/ # Skills (้พๆฅๅฐ _omp)
๐ง ๆๆฏๆ
| ็ปไปถ | ๆๆฏ | ่ฏดๆ | |------|------|------| | CLI | TypeScript + Commander | ๅฝไปค่กๅทฅๅ ท | | ๅ้ๆฐๆฎๅบ | Qdrant | ๅญๅจ็จๆท่ฎฐๅฟๅ้ | | Embedding | BGE-M3 (via Ollama) | ๅค่ฏญ่จๆๆฌๅตๅ ฅ | | ๅ่ฎฎ | MCP (Model Context Protocol)
โฆ
Source & license
This open-source MCP server is cataloged on AgentStack and links to its original source โ we do not rehost the code.
- Author: Alenryuichi
- Source: Alenryuichi/openmemory-plus
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet โ be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.