███ ███ ███████ ███ ███ █████ ███████ ███████ ██ ██ ████ ████ ██ ████ ████ ██ ██ ██ ██ ██ ██ ██ ██ ██ ███ ██ ███████ ██ ███ ██ ██ ██ ██████ ███████ ███████ ██ █ ██ ██ ██ █ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ███████ ██ ██ █████ ██ ██ ██ ██ ██

---

English | 简体中文

在不同 AI 编程 Agent 之间无缝迁移会话

memorph 是一个会话记忆管理工具，在不同AI 编程 Agent 之间导出和切换宝贵的上下文。

---

快速上手

npx memorph web

或通过包管理器安装：

包管理器	安装命令	直接运行
npm	npm install -g memorph	memorph <命令>
uv	uv tool install memorph	memorph <命令>
pip	pip install memorph	memorph <命令>

安装完成后，使用 memorph web 启动 Web UI，或直接用 memorph <命令> 操作 CLI

---

Web

memorph web

在这里可以看到一个简洁的web操作页面

在列表中选择要迁移的会话

点击迁移，验证目标工具中是否加载成功

CLI

查看当前工作区的可用会话-list

memorph list [OPTIONS]

参数	说明
--all	显示所有工作区的会话
--claude	仅显示 Claude Code 会话
--codex	仅显示 Codex 会话
--opencode	仅显示 OpenCode 会话

示例

$ memorph list

将指定会话迁移-switch

memorph switch --<from>2<to> [OPTIONS]

参数	说明
--claude2codex	Claude → Codex
--codex2claude	Codex → Claude
--claude2opencode	Claude → OpenCode
--opencode2claude	OpenCode → Claude
--codex2opencode	Codex → OpenCode
--opencode2codex	OpenCode → Codex
-s, --session-id <ID>	源会话 ID，省略则取当前工作区最近会话
-d, --to-dir <DIR>	目标目录，默认：当前目录

示例

$ memorph switch --claude2codex --session-id abc-123-session-id

---

CLI 表格

命令	说明
list	列出会话（默认仅当前工作区）
export	导出会话为 .json / .md / .html 文件
import	将 .json / .md / .html 文件或已有会话导入目标工具
remove	删除指定会话
rename	重命名指定会话
switch	跨 Provider 迁移会话
find	按目录、标题或 ID 搜索会话

---

导入与导出

导出

memorph export <PROVIDER> <SESSION_ID> [OPTIONS]

参数	说明
PROVIDER	目标 Agent：claude / codex / opencode
SESSION_ID	会话 ID
-o, --output <PREFIX>	输出文件名前缀，默认：SESSION_ID
-f, --format <FORMAT>	json / md / html，默认：json

memorph export claude abc-123-session-id
memorph export claude abc-123-session-id -f md

导入

memorph import <PROVIDER> <FILE_OR_ID> [OPTIONS]

参数	说明
PROVIDER	目标 Agent：claude / codex / opencode
FILE_OR_ID	.json/.md/.html 文件路径，或已有会话 ID
-d, --to-dir <DIR>	目标项目目录，默认：当前目录

memorph import codex ./my-session.md
memorph import claude ./backup.json --to-dir ~/projects/my-app
memorph import claude xyz-456-session-id

---

删除与重命名

命令	语法	说明
remove	memorph remove <PROVIDER> <SESSION_ID>	删除会话
rename	memorph rename <PROVIDER> <SESSION_ID> <NEW_TITLE>	重命名会话

# 删除
memorph remove claude abc-123-session-id

# 重命名
memorph rename claude abc-123-session-id "修复登录 bug"

---

查询

memorph find [OPTIONS]

参数	说明
-d, --dir <DIR>	按项目目录路径模糊搜索
-s, --session <PATTERN>	按会话 ID 或标题模糊匹配
-p, --provider <PROVIDER>	限制 Provider（可多次使用）

查询约束： 至少需提供 --dir、--session、--provider 中的一个。

# 按目录搜索
memorph find --dir ~/projects/my-app

# 按标题或 ID 搜索
memorph find --session "登录 bug"

# 只在 Claude 和 Codex 中搜索
memorph find --session "refactor" -p claude -p codex

---

---

Star History

---