Mirasim x Nowledge Mem
通过 MCP 与共享 skills 把 Nowledge Mem 接入 Mirasim;Mirasim 里启动的 Claude Code 和 Codex 仍用各自专属连接捕获真实 transcript。
Mirasim 是一个 local-first 的多智能体工作台。它的公开文档说明了内置 agent、Claude Code 和 Codex 启动方式、MCP server、可复用 skills、connectors、ui-cli、本机会话/history 命令和 raw recordings。
Nowledge Mem 现在支持 Mirasim 的方式是 MCP 和 skills。我们暂时不启用 Mirasim 原生 transcript 同步,因为 Mirasim 还没有公开稳定的消息级 export schema 或 post-turn hook contract 供第三方导入器使用。
安全边界
Mirasim 内置 agent 用 Mem MCP 和 skills。Mirasim pane 里运行 Claude Code 或 Codex 时,请同时安装对应工具的 Nowledge 专属连接;真实 transcript 捕获属于那个子运行时。
设置
先确认 Nowledge Mem 正在运行,再用同一份 nmem 客户端配置生成 Mirasim 的 MCP 配置:
nmem status
nmem config mcp show --host mirasim在 Mirasim 里添加一个名为 nowledge-mem 的自定义 MCP server,使用命令输出里的 URL 和 headers。本机桌面端默认是 http://127.0.0.1:14242/mcp/。如果你用的是 Nowledge Cloud、Access Anywhere 或自托管远程 Mem,命令输出会按当前 nmem 配置生成正确的远程 endpoint 和认证形式。
然后在正在运行的 Mirasim 里做一次 health check:
mirasim ui-cli --port 4970 mcp health --name nowledge-mem如果你的 Mirasim 版本支持从 GitHub skill source 或 Agent Plugins package 导入 skills,可以添加 Nowledge Mem 的共享 skills:
https://github.com/nowledge-co/community/tree/main/nowledge-mem-agent-pluginMCP 是必需路径。Skills 是行为层,让 agent 知道什么时候读取 Working Memory、搜索、保存长期经验,以及创建 handoff。
你会得到什么
- 通过 Mem MCP 读取 Working Memory 和 Context Bundle
- 工作时搜索 Memory 和 Thread
- 把决策、流程和有价值的调试结论保存成长期记忆
- 在 Mem server 暴露对应能力时使用 Library 和图谱工具
- Mirasim 会话里的可复用 skill 指引
- 通过同一份
nmem客户端配置支持本地或远程 Mem
Claude Code 与 Codex pane
Mirasim 可以启动 Claude Code 和 Codex,并保留它们自己的终端 UI 和登录状态。捕获 transcript 时,请把这些 pane 当作子工具处理:
| Mirasim pane | Mem 路径 |
|---|---|
| Mirasim 内置 agent | Mirasim MCP + 可选 skills |
| Mirasim 启动的 Codex | Codex 连接 |
| Mirasim 启动的 Claude Code | Claude Code 连接 |
这样 source_app 才不会乱。一个从 Mirasim 启动的 Codex transcript 仍然应该是 Codex thread。Mirasim 是工作台;真正产生 transcript 的是子运行时。
当前 Thread 同步边界
Mirasim 公开了 ui-cli sessions、ui-cli history,也记录 raw model data 到 ~/.mirasim/recordings。这些是有价值的信号,但在 Mirasim 公开以下任一能力前,还不足以做无损 Mem 导入器:
- 稳定的消息级 export schema;
- 可在 settled turn 之后调用
nmem的 lifecycle hook; - 或用于读取 session transcript 的正式 API。
所以目前内置 Mirasim 会话请使用 MCP/skills 生成 handoff summary。暂时不要期待 nmem t sync --from mirasim 已经存在。
常见问题
MCP 工具没有出现。 运行 Mirasim 的 health probe:
mirasim ui-cli --port 4970 mcp health --name nowledge-memMirasim 自己的排障文档也说明,MCP handshake 失败时,agent 可能会安静地拿不到你以为已经配置好的工具。
nmem config mcp show --host mirasim 不认识。 按你安装 CLI 的来源更新:
nmem --version
python3 -m pip install --user --upgrade nmem-cli如果你使用桌面端内置 CLI,请在 Nowledge Mem 设置里的 Preferences -> Developer Tools 重新安装 bundled CLI。
Mirasim 启动了 Codex 或 Claude Code,但 Threads 没有出现。 请在对应子工具里安装并验证它自己的专属连接。Mirasim 的 MCP server 让内置 Mirasim agent 使用记忆工具;它不读取 Codex 或 Claude Code transcript。