本帖使用社区开源推广,符合推广要求。我申明并遵循社区要求的以下内容:
- 我的帖子已经打上 开源推广 标签: 是
- 我的开源项目完整开源,无未开源部分: 是
- 我的开源项目已链接认可 LINUX DO 社区: 是
- 我帖子内的项目介绍,AI生成、润色内容部分已截图发出: 是
- 以上选择我承诺是永久有效的,接受社区和佬友监督: 是
我和同学平时会在Codex、Claude Code、OpenCode和Pi之间来回切换。在这个过程中遇到了一个比较麻烦的问题:
每个Agent的历史会话都存放在不同的位置,而且格式也不一样。
因此在切换Agent或者迁移电脑时进度共享比较困难,只能整理输出文档再把整个上下文重新丢给另一个Agent,不仅浪费Token,还容易丢失一些细节。
因此我们做了AgentHist:
一个统一管理、迁移、转换多个Agent本地历史记录的Cli工具
目前已经支持Codex、ClaudeCode、OpenCode和Pi。
下面是已经实现的功能:
1. 导出历史
导出时会先列出各个 Agent 的历史,可以在交互界面里浏览、预览,再选择要带走的会话。
可以导出全部历史,也可以只带走某个项目或几段会话。导出后会得到一个 .agenthist 文件,方便备份或传到另一台机器。
2. 导入和跨 Agent 转换
到了另一台机器,导入刚才的文件后,可以先查看里面有哪些会话,再选择要恢复的内容,并重新指定项目路径。
会话可以导回原来的Agent,也可以转到其他支持的Agent。
为什么不直接复制目录?
同一个 Agent、系统和路径下,直接复制有时能用,但是如果换了 Agent、系统、项目路径或 provider,就容易出问题。AgentHist 会先检查再导入,出问题也能回滚或恢复。
3. 跨会话经验提炼
除了迁移,我还做了一个可能比较实用的功能:
试着从多个历史会话里找出你反复提到的要求、偏好和工作方法,同时保留对应的原始证据。
比如写代码时,你可能在不同会话里反复强调:
- 修复问题前先构造最小复现,确认失败原因后再改代码;
- Git 提交只包含当前任务相关的改动。
AgentHist 会把这类反复出现的内容整理到一起。你可以把结果交给一个新会话继续筛选、合并和改写,逐渐形成适合自己的长期工作经验。
提炼时可以使用本机已经配置好的 Agent,也可以接入自己的模型 API。
示例:
4. 让 Agent 直接使用 AgentHist
AgentHist 还提供了一份 Skill,可以安装到受支持的 Agent 中:
agenthist skill install
安装后,就可以直接让 Agent 帮你管理、迁移历史或提炼经验。
后续计划
目前AgentHist主要还是CLI形态。
接下来准备重点做GUI 桌面端,希望把它逐渐做成一个更直观的多Agent历史和项目管理工具。
感兴趣的朋友可以试试,也欢迎反馈真实历史、跨平台迁移和跨Agent转换中遇到的问题。
如果觉得有用欢迎 Star、Issue 和 PR。




