Cindy x Nowledge Mem
通过 MCP 与可复用 skills 把 Nowledge Mem 接入 Cindy；真实 transcript 捕获仍由产生会话的子运行时负责。
Cindy 是一个开源的本地 agent host。它可以运行 Claude Code、Codex、Pi 等 harness，同时保持同一个 workspace、memory、skills 和工具面。
Nowledge Mem 现在支持 Cindy 的方式是 MCP 和共享 skills。我们暂时不启用 Cindy 原生 transcript 同步，因为 Cindy 公开客户端还没有给第三方导入器提供稳定的消息级 export、post-turn hook，或已经验证过的 Ghost package 安装路径。
安全边界
Cindy 内置 agent 用 Mem MCP 和 skills。Cindy 启动 Codex、Claude Code、Pi 或 OMP 时，请同时安装对应子运行时的 Nowledge 专属连接；真实 transcript 捕获属于那个子运行时。
设置
先确认 Nowledge Mem 正在运行，再用同一份 nmem 客户端配置生成 Cindy 的 MCP 配置：
nmem status
nmem config mcp show --host cindy在 Cindy 里添加一个名为 nowledge-mem 的自定义 MCP server，使用命令输出里的 URL 和 headers。本机桌面端默认是 http://127.0.0.1:14242/mcp/。如果你用的是 Nowledge Cloud、Access Anywhere 或自托管远程 Mem，命令输出会按当前 nmem 配置生成正确的远程 endpoint 和认证形式。
如果你的 Cindy 版本支持共享 Agent Skills 或 Agent Plugins package，可以添加 Nowledge Mem 共享包：
https://github.com/nowledge-co/community/tree/main/nowledge-mem-agent-plugin如果这个 package 流程暂时不可用，把以下 guide 里的内容复制到 Cindy 的项目或 agent 指令里：
https://github.com/nowledge-co/community/tree/main/nowledge-mem-cindy-connector/guide.mdMCP 是必需路径。Skills 或 guide 是行为层，让 Cindy 知道什么时候读取 Working Memory、搜索旧工作、保存长期经验，以及创建 handoff。
你会得到什么
- 通过 Mem MCP 读取 Working Memory 和 Context Bundle
- Cindy 工作时搜索 Memory 和 Thread
- 把决策、流程、偏好和有价值的调试结论保存成长期记忆
- 在 Mem server 暴露对应能力时使用 Library 和图谱工具
- Cindy 会话里的可复用行为指引
- 通过同一份
nmem客户端配置支持本地或远程 Mem
子运行时捕获
Cindy 可以在同一个 app 里运行多个 harness。捕获 transcript 时，请把来源归给真正产生对话的运行时：
| Cindy runtime | Mem 路径 |
|---|---|
| Cindy 内置 agent | Cindy MCP + 可选 skills |
| Cindy 启动的 Codex | Codex 连接 |
| Cindy 启动的 Claude Code | Claude Code 连接 |
| Cindy 启动的 Pi | Pi package |
| Cindy 启动的 OMP | OMP plugin |
这样 source_app 才不会乱。一个从 Cindy 启动的 Codex transcript 仍然应该是 Codex thread。Cindy 是 host；真正产生 transcript 的是子运行时。
如果 Cindy 在你的 Mem 里代表一个长期 persona 或 worker，可以单独设置身份：
NMEM_AGENT_ID=cindy这会选择 Mem AI Identity。它不会改变 transcript source。
当前 Thread 同步边界
Cindy 公开仓库已经有 MCP 能力、共享 skills、Ghost plugin runtime 和本地桌面会话存储。Ghost 可以打包 skills、tools 和本地 mcp-stdio Node worker，这是很好的后续原生路径。
但在以下任一能力稳定并验证前，Mem 不声称 Cindy 原生自动 thread 同步：
- Cindy 的消息级 export schema；
- 可在 settled turn 后调用
nmem的 lifecycle hook； - 用于读取 Cindy sessions 的正式 API；
- 或经过验证的 Nowledge Cindy Ghost package 安装路径。
所以目前 Cindy 原生工作请使用 MCP/skills 生成 handoff summary；需要精确捕获的 transcript，继续走子运行时专属连接。
常见问题
MCP 工具没有出现。 重新运行：
nmem config mcp show --host cindy确认 Cindy 里有名为 nowledge-mem 的自定义 MCP server，并且 URL 与 headers 都来自命令输出。远程 Mem 需要命令输出里的认证 headers。
nmem config mcp show --host cindy 不认识。 按你安装 CLI 的来源更新：
nmem --version
python3 -m pip install --user --upgrade nmem-cli如果你使用桌面端内置 CLI，请在 Nowledge Mem 设置里的 Preferences -> Developer Tools 重新安装 bundled CLI。
Cindy 启动了 Codex 或 Claude Code，但 Threads 没有出现。 请在对应子工具里安装并验证它自己的专属连接。Cindy 的 MCP server 让 Cindy 使用记忆工具；它不读取 Codex 或 Claude Code transcript 文件。