OpenMemory:跨 Claude Code / Codex / OpenCode 迁移 AI 编码会话的开源 CLI 与 TUI
OpenMemory 是 mem0ai 推出的开源命令行工具(同时提供 TUI 交互向导),用于在不同 AI 编码 harness(编程助手宿主)之间导入、导出会话,让开发者在切换 Claude Code、Codex、OpenCode 等工具时延续此前的上下文。它强调全向迁移、本地会话预览与按需选择,而非单向批量导入。
社区作者 · zZz
它解决什么问题
OpenMemory 是一个开源 CLI & TUI 工具,目标是把 AI 编码会话(coding sessions)在不同编码 harness 之间搬运,从而解决“开发者被主用 harness 锁定、换新工具就要丢掉历史上下文”的问题。
核心定位与差异点(来自来源正文):
- Codex 的 “Import from Claude Code” 是单向的,只支持一个来源 harness,并且只能做 “import all conversations” 的批量导入。
- OpenCode 的导入是手动的:需要先把 JSON 文件手工拼好,再用 opencode import 指向该文件,没有发现(discovery)、预览(preview),也无法挑选要迁移哪些会话。
- OpenMemory 是全向的(omni-directional),会展示本机会话的预览,允许用户自行选择要导入的会话,明确知道自己带走了什么。
当前状态:Beta,已支持 Claude Code、Codex、OpenCode,官方表示更多 harness 即将支持。可通过 TUI 向导或 CLI 使用。
发展规划(Roadmap):
- 移植 Skills、MCPs、Plugins 以及 CLAUDE.md / AGENTS.md。
- 跨 harness 的会话实时自动同步(Autosync,标注为 coming soon)。
- 支持 OpenClaw、Hermes。
社区与贡献:仓库欢迎贡献,提供 Contributing Guide(贡献流程与编码规范)与 Report an Issue(问题反馈)入口。
许可证:来源正文未提及,标注为待核验。 界面示意:配图 1 为 openmemory banner;配图 3 为 openmemory welcome screen;配图 4 为 openmemory select screen(会话选择界面)。
— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
- 环境准备:来源未给出操作系统、Python/Node 版本等前置依赖说明,需按仓库实际要求执行,相关细节待核验。
步骤 2 · 安装(官方给出的安装脚本,通过
curl 拉取并直接交给 bash 执行):
curl -fsSL https://raw.githubusercontent.com/mem0ai/openmemory/main/scripts/install.sh | bash- 首次运行(推荐方式,交互式向导):
openmemory tui
界面向导会引导完成会话的发现与选择,可参考配图 3(welcome screen)与配图 4(select screen)。
- 纯命令行方式(不想用向导时):
openmemory port --from <src> --to <dest> --all
说明:port 需要 --from / --to 两个参数,并搭配 --all 或一个/多个 --id <session-id>;追加 --force 可强制重新导出,追加 --json 可获得机器可读输出。
- 常见问题与注意事项:
- 目前为 Beta 阶段,官方列出的可用 harness 为 Claude Code、Codex、OpenCode。
- 与 Codex 的 “Import from Claude Code” 相比,本工具支持全向迁移并可挑选单个会话;与 OpenCode 的手动 import 相比,本工具提供本地会话发现与预览,无需手工组装 JSON。
- Autosync(跨 harness 自动实时同步)标注为 coming soon,当前不要依赖自动同步能力。
- 安装脚本以 curl | bash 形式执行,执行前请自行确认脚本内容与安全策略。