简体中文 | English
统一管理、搜索、迁移你的 Coding Agent 会话 —— 并把这些历史交还给 Agent 自己使用。
Ferry 将 Claude Code、Codex CLI、OpenCode、Pi Agent、Grok Build 和 Cursor
的对话历史汇入同一个会话库。
浏览上千条会话、跨 Agent 迁移上下文并预览迁移影响、掌握 Token 用量;
再通过 ferry 命令行与配套 skill,让任何 Coding Agent 都能检索、续接、审计这些历史 ——
隐私优先,无需注册账号,数据不离开本机。
各个 Coding Agent 把会话锁在自己的私有存储里 —— ~/.claude、~/.codex、
OpenCode 的本地数据库、Cursor 的 state.vscdb。它们彼此看不见对方的历史,
想查看就得手动翻 JSONL 文件;而 Agent 自己更是对"上周怎么解决的"一无所知。
Ferry 解决四个问题:
- 统一会话库 —— 所有 Agent 的会话并排展示,可按标题、目录、命令搜索,工具调用、推理摘要、会话树在同一套界面里呈现。
- 跨 Agent 迁移 —— 在 Agent 之间搬运对话,迁移前先展示影响:哪些原生保留、哪些会降级、哪些无法迁移。源会话全程只读。
- 让 Agent 用上自己的历史 —— 一条
ferry命令加两个 skill,Claude Code、Codex 等任何 Agent 都能全文检索过往会话、接手另一个会话继续干活、审计别的 Agent 做过什么。 - 用量统计 —— 全年活跃度视图、按模型和项目拆分的成本、迁移方向汇总。
| Agent | 浏览会话 | 跨 Agent 迁移 | 续聊(ferry-resume) |
|---|---|---|---|
| Claude Code | ✓ | ✓ | ✓ |
| Codex CLI | ✓ | ✓ | ✓ |
| OpenCode | ✓ | ✓ | ✓ |
| Pi Agent | ✓ | ✓ | ✓ |
| Grok Build | ✓ | ✓ | ✓ |
| Cursor | ✓ | 迁出 ✓ / 迁入 — | ✓ |
Cursor 可作为迁移来源(把 Cursor 会话迁到其它 Agent),但不再支持迁入 Cursor。
需要在 Cursor 里接着聊时,请用 续聊(ferry-resume)接手。
在一个统一的界面中浏览所有 Agent 的所有会话。会话按时间分组,标注来源 Agent。
- 搜索:按
⌘K(macOS)或Ctrl+K(Windows),通过标题、目录或命令跳转到任意会话。 - 筛选:按来源 Agent、时间范围或项目目录缩小范围。
- 大规模:为大会话库设计 —— 上千条会话的点击、滚动与筛选依然跟手。
- 会话树:完整对话拓扑,包含子会话(subagent)对话,会话内图片可直接预览。
- 本地元数据:重命名、打标签、置顶,不修改原始文件。
把一个会话从一个 Agent 迁移到另一个。各家 Agent 存储格式不同,迁移很难无损。 Ferry 会在你确认之前把代价摆出来 —— 在写入之前。
- 影响预览 —— 看清哪些原生保留、哪些降级、哪些丢失,再决定是否执行。
- 原生输出 —— 按目标 Agent 的原生格式写入会话。
- 接续命令 —— Ferry 会给出可直接粘贴到终端继续对话的命令。
- 来源可追溯 —— 迁来的会话在详情里标明由哪个 Agent 迁入。
原生迁移保真但有前提(目标格式可写、目标 Agent 支持迁入)。续聊是另一条永远走得通的路: 不写入任何存储,由接手的 Agent 自己读历史、写摘要、核对仓库,然后接着干。
- 在 Ferry 里右键会话 → 复制续聊指令,得到一行
/ferry-resume <agent> <session id>。 - 粘贴到任何装了
ferry-resumeskill 的 Coding Agent。 - 它通过 Ferry 读取历史,写一份接手摘要(目标、已完成、未完成、停在哪),核对仓库 状态后继续。
目标可以是同一个 Agent:Claude Code 的会话续聊到一个全新的 Claude Code 会话, 就是换一个干净的上下文接着做。迁移被拒绝时(例如目标不支持迁入),Ferry 也会把这条 指令作为兜底提供。
安装:设置 → Agent 集成 → 一键安装 ferry 命令和配套 skill。
无需 sudo;桌面 App 不在运行时命令也照常可用。
ferry 命令让 Agent 能检索、分页阅读、迁移会话和查看用量;skill 负责教它什么时候用、
怎么读、哪些事必须先征得你同意(比如迁移写入前要你确认影响汇总)。装好之后,下面这些话
可以直接对 Agent 说:
| 场景 | 对 Agent 说 | 背后发生了什么 |
|---|---|---|
| 上次怎么解决的 | "上次 Playwright 超时是怎么修的?找找以前的会话" | 跨 Agent、跨项目全文检索,定位相关消息后分页读取,引用会话标题和日期作答;找不到就明说,不编造 |
| 伪无限上下文 | 上下文快满时开新会话,粘入 /ferry-resume claude <id> |
新会话从旧会话末尾读起,写接手摘要、核对仓库状态再继续 —— 不是压缩,而是换一个干净的上下文接着做 |
| 跨 Agent 接力 | 在 Claude Code 里做完规划,把续聊指令粘到 Codex:"接着这个会话把方案实现掉" | 接手方只读历史,不碰任何存储;原生迁移不可行时的兜底 |
| 审计另一个 Agent | "看看刚才 Codex 在这个项目里改了什么,有没有问题" | 重建时间线:用户意图 → 工具调用 → 结果 → 落盘改动 |
| 挖掘可沉淀的工作流 | "翻一下最近两周的会话,找出我反复让你做的事和反复踩的坑,整理成 skill 或 CLAUDE.md 规则" | 按项目和时间窗口列会话,低成本通读,归纳重复模式与失败模式 |
| 周报 / 项目复盘 | "汇总这个项目最近 7 天的会话:尝试了什么、落地了什么、还没解决什么" | 按项目和时间窗口列会话,按主题汇总,只对关键会话深读 |
| 给新机器 / 新成员补上下文 | "读一遍这个项目的历史会话,写一份项目上手笔记 / 初版 CLAUDE.md" | 从历史里提取架构决策、约定和踩坑,产出项目记忆文件 |
长期追踪你的 Coding Agent 使用习惯:
- 总览仪表盘 —— 会话总数、Token 消耗、估算成本、连续活跃天数。
- 模型分布 —— 主力模型如何逐月变迁。
- 项目分布 —— 每个项目的成本一目了然。
- 活跃热力图 —— 52 周的每日编码活跃度一览。
接续对话前先修改内容:
- 删除轮次 —— 移除单个对话轮次。
- 改写消息 —— 原地编辑用户提示词和 AI 回复。
- 替换助手回复 —— 通过同一条编辑操作链路替换 AI 回复及其有序工具调用。
- 安全设计 —— 每次修改以 diff 预览,应用前自动备份,会话随时可回滚。
- 启动时自动检测已安装的 Agent 与本地会话数据
- 原生 macOS 菜单栏与侧边栏毛玻璃材质,跟随系统浅色/深色主题
- 有新版本时侧栏出现更新按钮,一键下载、安装并重启;重启后展示本次更新内容
| 平台 | 文件 |
|---|---|
| macOS(Apple Silicon) | Ferry_<version>_aarch64.dmg |
| Windows 10/11(x64) | Ferry_<version>_x64-setup.exe |
macOS:首次打开若被系统拦截,在 系统设置 → 隐私与安全性 中允许运行即可。
Windows:安装包目前没有 Authenticode 商业证书签名,因此 Microsoft Defender SmartScreen 可能显示未知发布者。请确认文件来自本项目的 GitHub Releases,再选择 更多信息 → 仍要运行。应用内自动更新产物仍使用 Ferry 的更新密钥签名校验。
Ferry 直接读取本机 Agent 的会话存储,不上传任何数据,也不需要注册账号。
环境要求:Node.js 22.19+、Rust(stable);Python 3.12 仅用于仓库的构建与契约 生成脚本。
会话引擎(Rust)与 Ferry Runtime(Node.js)以原生 sidecar 的形式与 Tauri 外壳一起分发。
# 开发模式:构建原生引擎与编译后的 TypeScript runtime
cargo build --manifest-path crates/ferry-engine/Cargo.toml
npm --prefix ferry-runtime ci
npm --prefix app ci
npm --prefix app run desktopdebug 宿主运行 crates/ferry-engine/target/{debug,release}/ferry-engine;
没有产物时直接报错并提示构建命令,不存在回退路径。
从仓库根目录打包完整的原生发布版本:
python scripts/build.py复用已安装的 npm 依赖:
python scripts/build.py --skip-install根构建会校验原生 target 与工具链,生成两个 sidecar,再调用 Tauri。sidecar 只为
aarch64-apple-darwin 或 x86_64-pc-windows-msvc 原生构建;交叉构建 sidecar 会被
明确拒绝。
在 macOS 或 Windows 上测试完整的首次启动流程:
npm --prefix app run desktop:fresh这是开发用的破坏性命令:它会先停止 Ferry,再清除应用数据、会话索引、WebView
存储、已安装的 ferry CLI,以及 Ferry 提供的 ferry / ferry-resume skill。
只想查看清理范围时可运行 npm --prefix app run fresh -- --dry-run。
仅前端开发:
cd app
npm run dev| 层 | 技术 | 职责 |
|---|---|---|
| 桌面宿主 | Tauri v2 (Rust) | 原生能力、进程监督、IPC、审批与事件路由 |
| 前端 | React 18 + Vite 6 | 展示、局部交互状态、工作流进度与用户审批 |
| 会话引擎 | Rust(原生 sidecar) | 原生会话格式适配、全文索引、查询、迁移操作、快照与校验;同时为 ferry CLI 提供服务 |
ferry CLI + Skill |
Rust + Markdown | 引擎的薄客户端;ferry / ferry-resume 两个 skill 供 Coding Agent 读取 |
| Ferry Runtime | Node.js 22 + TypeScript | 实验性内置助手(默认关闭):Provider、角色、LLM 工作流 |
Rust 宿主分别监督会话引擎和 Ferry Runtime 两个 sidecar。外部 Coding Agent 是 会话来源;内置助手是实验性功能,需在设置 → 实验性功能中手动开启。
MIT © kzheart




