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

GitHub stars GitHub forks GitHub license npm version

English | 简体中文

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

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

快速上手

curl -fsSL https://raw.githubusercontent.com/ip2a/memorph/main/install.sh | bash
memorph web

也可以直接运行：

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

memorph