agent-history
统一浏览和导出多环境AI编程助手对话历史
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:agent-history。 它的用途是:统一浏览和导出多环境AI编程助手对话历史 完整的 Skill 内容见:https://321skill.com/skills/agent-history/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我列出这个项目最近和Claude Code的所有对话。” 它会调用agent-history,按时间倒序列出当前项目目录下的相关会话ID、时间和概览。或者
对AI说:“把上个月关于用户模块重构的讨论导出成一份报告。” 它会筛选出相关会话,并生成一份包含完整对话和代码片段的Markdown文档供你分享或存档。
介绍
你是否曾苦恼于Claude Code、Codex CLI、Gemini CLI、Pi等AI编程助手的对话历史散落在本地、WSL、Windows、SSH等不同环境的各个角落,难以按项目查找、分享或复盘?agent-history正是为解决这一痛点而生。
它是一个纯Python标准库实现的CLI工具,无需额外安装依赖。只需进入你的项目目录,运行agent-history lss即可列出当前项目的所有会话;运行agent-history export则可将会话导出为Markdown或离线HTML。HTML导出支持丰富的交互控制,可折叠/展开工具调用详情和完整追踪信息。
该工具非常适合需要跨多个环境(如本地开发、WSL、远程服务器)使用不同AI编程助手的开发者、技术负责人或对工作流有复盘和审计需求的团队。它能帮你将碎片化的对话历史统一管理,形成可搜索、可导出的知识资产。
建议初次使用时,先使用agent-history lss和agent-history lsw(列出工作区)命令了解其数据收集范围。对于需要长期追踪的跨环境项目,可以使用--alias功能为相关的工作区设置别名,方便统一查询和统计。
核心特点
与单一AI助手的会话导出工具不同,它首次实现了对Claude Code、Codex CLI、Gemini CLI、Pi四种主流AI编程助手历史记录的跨环境统一收集、标准化和查询,并提供了基于工作区(项目)的过滤、别名管理以及详细的Token、工具使用和时间统计功能。
注意事项
目前仅支持Claude Code、Codex CLI、Gemini CLI和Pi四种AI编程助手,不支持其他AI工具或通用聊天机器人的历史记录。
常见问题
支持哪些AI编程助手?
目前完全支持Claude Code、Codex CLI、Gemini CLI和Pi。
导出的HTML文件是离线的吗?
是的,导出的HTML是纯静态文件,包含所有样式和交互逻辑,无需网络即可查看。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/agent-history/raw/index.md 读取 agent-history 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/agent-history/raw/index.md(查看排版版本)