@pcircle/memesh 4.6.1 → 4.7.1

package/.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
       "name": "memesh",
       "source": "./",
       "description": "MeMesh — agentic memory for coding agents. Captured from the agent's real work via hooks, recalled when it acts. One SQLite file, zero cloud required.",
-      "version": "4.6.1",
+      "version": "4.7.1",
       "author": {
         "name": "PCIRCLE AI"
       },

package/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "PCIRCLE AI"
   },
-  "version": "4.6.1",
+  "version": "4.7.1",
   "homepage": "https://github.com/PCIRCLE-AI/memesh",
   "repository": "https://github.com/PCIRCLE-AI/memesh",
   "license": "MIT",

package/README.de.md

@@ -16,7 +16,7 @@
 
 ---
 
-**MeMesh** — Open-Source-**agentischer Speicher** für Claude Code & MCP-Coding-Agenten: erfasst aus der echten Arbeit des Agenten, injiziert in dem Moment, in dem er handelt, ehrlich gehalten, wenn er sich selbst widerspricht. Eine SQLite-Datei. Keine Cloud.
+**MeMesh** — Open-Source-**agentischer Speicher** für einzelne KI-Coding-Agenten: kompatibel mit Claude Code, Codex, Gemini, Cursor und anderen MCP-Clients. Erfasst aus der echten Arbeit des Agenten, injiziert in dem Moment, in dem er handelt, ehrlich gehalten, wenn er sich selbst widerspricht. Eine SQLite-Datei. Keine Cloud.
 
 ## Installation
 
@@ -65,7 +65,7 @@ flowchart TB
     subgraph clients["Where you use memesh from"]
       direction LR
       CC["Claude Code<br/>(chat + agent)"]:::client
-      TERM["Terminal / other<br/>MCP clients<br/>(Cursor, Cline...)"]:::client
+      TERM["Terminal / other<br/>MCP clients<br/>(Codex, Gemini, Cursor...)"]:::client
     end
 
     subgraph paths["Two install paths"]
@@ -152,7 +152,7 @@ memesh setup --check         # Prüfung auf Maschinenebene: liest die Host-Confi
 
 Die Hooks existieren neben Ihren bestehenden Custom-Hooks unter `~/.claude/hooks/` — `install-hooks` schreibt additiv und überschreibt nie Ihre Einträge. Zum Entfernen: `memesh uninstall-hooks`.
 
-### Dieselben Memories aus Codex CLI und Gemini CLI
+### Dieselben Memories aus Codex CLI, Gemini CLI, Cursor und anderen MCP-Clients
 
 `memesh-mcp` ist ein gewöhnlicher stdio-MCP-Server — jeder MCP-fähige Host kann ihn nutzen, nicht nur Claude Code. Mit installierter Option B (`memesh-mcp` im `PATH`) einmal pro Host registrieren:
 
@@ -164,7 +164,18 @@ codex mcp add memesh -- memesh-mcp
 gemini mcp add -s user memesh memesh-mcp
 ```
 
-Jeder Host liest und schreibt dieselbe `~/.memesh/knowledge-graph.db` — eine in Claude Code gespeicherte Memory ist aus Codex oder Gemini abrufbar, und umgekehrt. Prüfen:
+Für Cursor fügen Sie denselben stdio-Server in `~/.cursor/mcp.json` (global)
+oder in `.cursor/mcp.json` (projektspezifisch) ein:
+
+```json
+{
+  "mcpServers": {
+    "memesh": { "command": "memesh-mcp" }
+  }
+}
+```
+
+Jeder Host liest und schreibt dieselbe `~/.memesh/knowledge-graph.db` — eine in einem Agenten gespeicherte Memory ist aus Codex, Gemini, Cursor oder einem anderen MCP-Client abrufbar. Prüfen:
 
 ```bash
 codex mcp list       # memesh sollte als enabled gelistet sein
@@ -264,8 +275,8 @@ Denselben Block erhält Claude Code automatisch beim Session-Start, und jeder an
 |---------------|---------------------|
 | **Claude Code verwenden** | Projektentscheidungen, dateispezifische Erkenntnisse und vergangene Fehler während der Arbeit automatisch abrufen |
 | **Power-User von Coding-Agenten** | Eine lokale Speicherschicht über MCP-kompatible Tools verteilen |
-| **ein Team mit KI-Coding-Workflows experimentiert** | Projektwissen ohne gehostete Infrastruktur aus- und importieren |
-| **Agent-Entwickler** | Lokalen Speicher via MCP, HTTP oder CLI hinzufügen |
+| **Codex, Gemini, Cursor, Claude Code oder einen anderen MCP-Client einzeln nutzt** | Eine lokale Speicherschicht über Agenten und Sessions hinweg verwenden |
+| **einen Agenten integrieren** | Lokalen Speicher via MCP, HTTP oder CLI hinzufügen |
 
 ---
 
@@ -406,8 +417,8 @@ Wenn npm eine installierte Version als veraltet kennzeichnet (typischerweise ein
 
 **🕸️ Wissensgraph-Konnektivität** — `memesh kg backfill-relations --all-rules` verknüpft verwaiste Entitäten über Tag-Kookurrenz, Projekt-Clustering, Sitzungskontext und Namensähnlichkeit — ohne LLM.
 
-**📦 Team-Freigabe** — `memesh export > team-knowledge.json` → mit Team teilen → `memesh import team-knowledge.json`
-Importierte Bundles bleiben durchsuchbar, aber MeMesh injiziert importierte Memories nicht automatisch in Claude Hooks, bis Sie sie überprüfen oder lokal neu speichern.
+**📦 Persönliches Backup und Migration** — `memesh export > memesh-backup.json` → auf einen anderen Rechner kopieren → `memesh import memesh-backup.json`
+Importierte Bundles bleiben durchsuchbar, aber MeMesh injiziert importierte Memories nicht automatisch in den Host-Kontext, bis Sie sie überprüfen oder lokal neu speichern.
 
 ---
 
@@ -416,8 +427,8 @@ Importierte Bundles bleiben durchsuchbar, aber MeMesh injiziert importierte Memo
 > "MeMesh hat sich daran erinnert, dass wir vor drei Wochen PKCE gegenüber Implicit Flow gewählt haben. Als ich Claude erneut nach Auth fragte, wusste es bereits Bescheid — keine Wiederholungen nötig."
 > — **Einzelentwickler, baut eine SaaS**
 
-> "Wir exportieren unseren Team-Memory jeden Freitag und importieren ihn Montag. Jedes Claude des Teams startet die Woche mit dem Wissen aus der Vorwoche."
-> — **3er-Startup mit gemeinsamer Wissensbasis**
+> "Eine in Claude Code gespeicherte Entscheidung war am nächsten Tag aus Codex abrufbar. Dieselbe lokale Memory folgt meiner Arbeit statt einem einzelnen Agenten."
+> — **Einzelentwickler mit mehreren Coding-Agenten**
 
 > "Das Dashboard zeigte mir, dass 90 % meiner Memories automatisch generierte Session-Logs waren. Ich begann, `remember` bewusst für Architekturentscheidungen zu nutzen. Ein Spielwechsel."
 > — **Entwickler, der das Analytics-Panel entdeckte**
@@ -471,7 +482,7 @@ Wechselst du zu einer anderen Dimension (z. B. 768 → 1536), wird **nichts gel
 | `remember` | Wissen mit Beobachtungen, Relationen und Tags speichern |
 | `recall` | FTS5 + sqlite-vec Suche mit Multi-Faktor-Bewertung (Relevanz, Aktualität, Häufigkeit, Konfidenz, Abruf-Auswirkung) — kein LLM auf dem Hot Path |
 | `forget` | Soft-Archivierung (löscht nie) oder entfernt spezifische Beobachtungen |
-| `export` | Memories als JSON zwischen Projekten oder Teamkollegen teilen |
+| `export` | Memories als JSON sichern, migrieren oder zwischen kompatiblen Agenten übertragen |
 | `import` | Memories mit Merge-Strategien importieren (Skip / Overwrite / Append) |
 | `learn` | Strukturierte Lektionen aus Fehlern erfassen (Fehler, Grundursache, Behebung, Prävention) |
 | `task_state` | Arbeitsstand lesen oder festhalten — Ziel, nächster Schritt, Blocker, gerade Erledigtes |

package/README.md

@@ -16,7 +16,7 @@
 
 ---
 
-**MeMesh** — open-source **agentic memory** for Claude Code & MCP coding agents: captured from the agent's real work, injected at the moment it acts, kept honest when it contradicts itself. One SQLite file. No cloud.
+**MeMesh** — open-source **agentic memory** for individual AI coding agents: compatible with Claude Code, Codex, Gemini, Cursor, and other MCP clients. Captured from the agent's real work, injected at the moment it acts, kept honest when it contradicts itself. One SQLite file. No cloud.
 
 ## Install
 
@@ -67,7 +67,7 @@ flowchart TB
     subgraph clients["Where you use memesh from"]
       direction LR
       CC["Claude Code<br/>(chat + agent)"]:::client
-      TERM["Terminal / other<br/>MCP clients<br/>(Cursor, Cline...)"]:::client
+      TERM["Terminal / other<br/>MCP clients<br/>(Codex, Gemini, Cursor...)"]:::client
     end
 
     subgraph paths["Two install paths"]
@@ -162,7 +162,7 @@ memesh setup --check         # machine-level verification: reads the hosts' own
 
 The hooks coexist with any custom hooks you already have under `~/.claude/hooks/` — `install-hooks` writes additive entries and never overwrites yours. To remove later: `memesh uninstall-hooks`.
 
-### Same memory from Codex CLI and Gemini CLI
+### Same memory from Codex CLI, Gemini CLI, Cursor, and other MCP clients
 
 `memesh-mcp` is a plain stdio MCP server, so any MCP-capable host can talk to it — not just Claude Code. With Option B installed (`memesh-mcp` on your `PATH`), register it once per host:
 
@@ -174,7 +174,18 @@ codex mcp add memesh -- memesh-mcp
 gemini mcp add -s user memesh memesh-mcp
 ```
 
-Every host reads and writes the same `~/.memesh/knowledge-graph.db`, so a memory stored from a Claude Code session is recallable from Codex or Gemini, and the other way around. Verify from either host by asking it to call the `recall` tool, or from a terminal:
+For Cursor, add the same stdio server to `~/.cursor/mcp.json` (global) or
+`.cursor/mcp.json` (project-local):
+
+```json
+{
+  "mcpServers": {
+    "memesh": { "command": "memesh-mcp" }
+  }
+}
+```
+
+Every host reads and writes the same `~/.memesh/knowledge-graph.db`, so a memory stored from one agent is recallable from Codex, Gemini, Cursor, or another MCP client. Verify from the host by asking it to call the `recall` tool, or from a terminal:
 
 ```bash
 codex mcp list       # memesh should be listed as enabled
@@ -276,8 +287,8 @@ This same block is what Claude Code receives automatically at session start, and
 |---------------|---------------------|
 | **A developer using Claude Code** | Auto-recall project decisions, file-specific lessons, and past failures as you work |
 | **A coding-agent power user** | Share one local memory layer across MCP-compatible tools |
-| **A team experimenting with AI coding workflows** | Export/import project knowledge without introducing hosted infrastructure |
-| **An agent developer** | Add local memory through MCP, HTTP, or the CLI |
+| **An individual using Codex, Gemini, Cursor, Claude Code, or another MCP client** | Use one local memory layer across agents and sessions |
+| **A developer integrating an agent** | Add local memory through MCP, HTTP, or the CLI |
 
 ---
 
@@ -419,8 +430,8 @@ When npm flags an installed version as deprecated (typically a security advisory
 
 **🕸️ Knowledge Graph Connectivity** — `memesh kg backfill-relations --all-rules` links orphan entities using tag co-occurrence, project clustering, session context, and name similarity — no LLM required.
 
-**📦 Team Sharing** — `memesh export > team-knowledge.json` → share with your team → `memesh import team-knowledge.json`
-Imported bundles stay searchable, but MeMesh does not auto-inject imported memories into Claude hooks until you review or re-store them locally.
+**📦 Personal backup and migration** — `memesh export > memesh-backup.json` → copy it to another machine → `memesh import memesh-backup.json`
+Imported bundles stay searchable, but MeMesh does not auto-inject imported memories into host context until you review or re-store them locally.
 
 ---
 
@@ -429,8 +440,8 @@ Imported bundles stay searchable, but MeMesh does not auto-inject imported memor
 > "MeMesh remembered that we chose PKCE over implicit flow three weeks ago. When I asked Claude about auth again, it already knew — no re-explaining needed."
 > — **Solo developer, building a SaaS**
 
-> "We export our team's memory every Friday and import it Monday. Everyone's Claude starts the week knowing what the team learned last week."
-> — **3-person startup, shared knowledge base**
+> "I stored a decision from Claude Code and recalled it from Codex the next day. The same local memory followed my work instead of one agent."
+> — **Solo developer using multiple coding agents**
 
 > "The dashboard showed me that 90% of my memories were auto-generated session logs. I started using `remember` deliberately for architecture decisions. Game changer."
 > — **Developer who discovered the analytics panel**
@@ -538,7 +549,7 @@ If you switch to an embedder with a different dimension (e.g. 768 → 1536), **n
 | `remember` | Store knowledge with observations, relations, and tags |
 | `recall` | FTS5 + sqlite-vec search with multi-factor scoring (relevance, recency, frequency, confidence, recall impact) — no LLM in the hot path |
 | `forget` | Soft-archive (never deletes) or remove specific observations |
-| `export` | Share memories as JSON between projects or team members |
+| `export` | Back up, migrate, or move memories as JSON between compatible agents |
 | `import` | Import memories with merge strategies (skip / overwrite / append) |
 | `learn` | Record structured lessons from mistakes (error, root cause, fix, prevention) |
 | `task_state` | Read or record where the work stands — goal, next step, blocker, what was just finished |

package/README.zh-TW.md

@@ -16,7 +16,7 @@
 
 ---
 
-**MeMesh** — 給 Claude Code 和 MCP 程式開發代理的開源**代理式記憶**：從代理的實際工作中擷取，在它行動的當下注入，記憶自相矛盾時保持誠實。一個 SQLite 檔案。不需要雲端。
+**MeMesh** — 給個人 AI 程式開發代理的開源**代理式記憶**：相容於 Claude Code、Codex、Gemini、Cursor 與其他 MCP 用戶端。從代理的實際工作中擷取，在它行動的當下注入，記憶自相矛盾時保持誠實。一個 SQLite 檔案。不需要雲端。
 
 ## 安裝
 
@@ -65,7 +65,7 @@ flowchart TB
     subgraph clients["Where you use memesh from"]
       direction LR
       CC["Claude Code<br/>(chat + agent)"]:::client
-      TERM["Terminal / other<br/>MCP clients<br/>(Cursor, Cline...)"]:::client
+      TERM["Terminal / other<br/>MCP clients<br/>(Codex, Gemini, Cursor...)"]:::client
     end
 
     subgraph paths["Two install paths"]
@@ -158,7 +158,7 @@ memesh setup --check         # 機器層級驗證：讀各主機自己的設定
 
 這些 hooks 會跟你既有的 `~/.claude/hooks/` 自訂 hooks 共存 — `install-hooks` 用追加方式寫入，從不覆寫你的東西。要移除：`memesh uninstall-hooks`。
 
-### 從 Codex CLI 和 Gemini CLI 用同一份記憶
+### 從 Codex CLI、Gemini CLI、Cursor 與其他 MCP 用戶端使用同一份記憶
 
 `memesh-mcp` 是標準的 stdio MCP server，任何支援 MCP 的主機都能用 — 不限 Claude Code。裝好選項 B（`memesh-mcp` 在 `PATH` 上）之後，每個主機註冊一次：
 
@@ -170,7 +170,17 @@ codex mcp add memesh -- memesh-mcp
 gemini mcp add -s user memesh memesh-mcp
 ```
 
-每個主機讀寫的都是同一個 `~/.memesh/knowledge-graph.db`，所以在 Claude Code session 存的記憶，Codex 和 Gemini 都回憶得到，反之亦然。驗證：
+Cursor 請將同一個 stdio server 加入 `~/.cursor/mcp.json`（全域），或專案內的 `.cursor/mcp.json`：
+
+```json
+{
+  "mcpServers": {
+    "memesh": { "command": "memesh-mcp" }
+  }
+}
+```
+
+每個主機讀寫的都是同一個 `~/.memesh/knowledge-graph.db`，所以在任何代理儲存的記憶，Codex、Gemini、Cursor 和其他 MCP 用戶端都能回憶得到。請從主機要求它呼叫 `recall` 工具驗證：
 
 ```bash
 codex mcp list       # memesh 應顯示為 enabled
@@ -272,8 +282,8 @@ Claude Code 在 session 開始時自動收到的就是同一個區塊，其他 M
 |---------------|---------------------|
 | **使用 Claude Code 的開發者** | 在工作時自動回憶專案決策、檔案特定的經驗教訓和過去的失敗 |
 | **程式開發代理進階使用者** | 在多個 MCP 相容工具間共享一層在地記憶 |
-| **嘗試 AI 程式開發工作流的團隊** | 匯出／匯入專案知識，無需引入託管基礎設施 |
-| **代理開發者** | 透過 MCP、HTTP 或 CLI 添加在地記憶 |
+| **使用 Codex、Gemini、Cursor、Claude Code 或其他 MCP 用戶端的個人** | 在不同代理與 session 之間使用同一層在地記憶 |
+| **整合 AI 代理的開發者** | 透過 MCP、HTTP 或 CLI 添加在地記憶 |
 
 ---
 
@@ -415,8 +425,8 @@ MeMesh 的檢索引擎**只用 FTS5**（熱路徑上不使用 LLM、不使用嵌
 
 **🕸️ 知識圖連通性** — `memesh kg backfill-relations --all-rules` 使用標籤共現、專案叢集、會話上下文和名稱相似度連結孤立實體 — 無需 LLM。
 
-**📦 團隊共享** — `memesh export > team-knowledge.json` → 與團隊共享 → `memesh import team-knowledge.json`
-匯入的組合保持可搜尋，但 MeMesh 不會自動將匯入的記憶注入 Claude hooks，直到你檢查或在本地重新儲存。
+**📦 個人備份與搬遷** — `memesh export > memesh-backup.json` → 複製到另一台機器 → `memesh import memesh-backup.json`
+匯入的組合保持可搜尋，但 MeMesh 不會自動將匯入的記憶注入 host context，直到你檢查或在本地重新儲存。
 
 ---
 
@@ -425,8 +435,8 @@ MeMesh 的檢索引擎**只用 FTS5**（熱路徑上不使用 LLM、不使用嵌
 > 「MeMesh 記得我們三週前選擇了 PKCE 而不是隱式流程。當我再次問 Claude 關於身份驗證的問題時，它已經知道了——不需要重新解釋。」
 > — **獨立開發者，正在打造 SaaS**
 
-> 「我們每個星期五匯出團隊的記憶，星期一匯入。每個人的 Claude 在新一週開始時都知道團隊上週學到的東西。」
-> — **3 人新創公司，共享知識庫**
+> 「我在 Claude Code 儲存的決策，隔天可以從 Codex 找回來。同一份在地記憶跟著工作走，不會被綁在單一代理上。」
+> — **使用多個程式開發代理的個人開發者**
 
 > 「儀表板顯示我 90% 的記憶是自動生成的對話日誌。我開始有意使用 `remember` 來記錄架構決策。改變了遊戲規則。」
 > — **發現分析面板的開發者**
@@ -480,7 +490,7 @@ memesh config set embedder.provider openai          # or: ollama
 | `remember` | 用觀察、關係和標籤儲存知識 |
 | `recall` | FTS5 + sqlite-vec 搜尋，包含多因素評分（相關性、近期性、頻率、信心、回憶影響）— 熱路徑上不使用 LLM |
 | `forget` | 軟歸檔（永不刪除）或移除特定觀察 |
-| `export` | 在專案或團隊成員之間以 JSON 共享記憶 |
+| `export` | 以 JSON 備份、搬遷記憶，或在相容代理之間轉移 |
 | `import` | 匯入記憶，包含合併策略（跳過 / 覆寫 / 追加） |
 | `learn` | 記錄來自錯誤的結構化教訓（錯誤、根本原因、修復、預防） |
 | `task_state` | 讀取或記下工作進度——目標、下一步、卡住的地方、剛完成的事 |