Skip to main content
Nowledge MemNowledge Mem
连接

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.md

MCP 是必需路径。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 runtimeMem 路径
Cindy 内置 agentCindy MCP + 可选 skills
Cindy 启动的 CodexCodex 连接
Cindy 启动的 Claude CodeClaude Code 连接
Cindy 启动的 PiPi package
Cindy 启动的 OMPOMP 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 文件。

来源

On this page