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 文件。
来源
Mirasim x Nowledge Mem
Connect Nowledge Mem to Mirasim through MCP and reusable skills, while keeping Claude Code and Codex panes on their dedicated transcript connectors.
通用 Agent Plugin
Use the Agent Plugins standard package when your AI client supports Agent Plugins and does not have a dedicated Nowledge connector yet.