claude-history
统一管理多AI编码助手的本地对话历史与导出工具。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：claude-history。 它的用途是：统一管理多AI编码助手的本地对话历史与导出工具。 完整的 Skill 内容见：https://321skill.com/skills/claude-history/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我列出上个月在 `project-x` 这个工作空间下，所有与Claude讨论过的关于身份验证的会话'，它会调用 agent-history 进行过滤和搜索，并返回匹配的会话列表及摘要。或者
对AI说：'把最近一周我和Gemini CLI关于优化数据库查询的所有对话，导出成一个可以分享的Markdown报告'，它会执行导出命令，生成结构清晰的文档。
介绍
agent-history 解决了开发者在使用 Claude Code、Codex CLI、Gemini CLI、Pi 等不同AI编码助手时，对话历史数据分散、格式不统一、难以查找和归档的痛点。它是一个命令行工具，能够自动扫描并整合存储在本地、WSL、Windows及SSH环境中的会话文件，将其统一为工作空间和会话模型，并提供浏览、筛选、导出和统计分析功能。
使用方式非常直接：在项目目录下运行 agent-history lss 即可列出当前项目的所有历史会话，运行 agent-history export 可将会话导出为Markdown或离线HTML。工具支持按工作空间、代理类型进行过滤，并能跨环境同步数据。
它非常适合频繁使用多种AI编码助手进行开发、需要回顾或分享过往代码讨论、或希望对AI辅助编码的使用情况进行量化分析的开发者。对于需要将AI对话作为项目文档一部分进行管理的团队也很有价值。
建议初次使用时，先通过 agent-history lss --ah 命令扫描所有环境下的历史记录，建立完整的数据库。导出HTML格式时，可以利用其内置的交互式控件（如折叠代码片段、工具输入输出）获得更佳的阅读体验。注意，该工具主要处理本地已存储的会话文件，不涉及实时对话或在线服务的API调用。
核心特点
与单一AI助手的官方导出功能不同，agent-history 是首个能跨 Claude、Codex、Gemini、Pi 四大主流编码助手，并支持跨本地、WSL、Windows、SSH 多环境统一管理和分析对话历史的工具，其核心在于解决了数据孤岛问题，并提供了工作空间维度的聚合视图和丰富的离线导出选项。
注意事项
该工具仅用于管理和导出本地已保存的会话历史文件，不支持实时对话、在线搜索或管理云端对话记录。
常见问题
agent-history 和原来的 claude-history 是什么关系？
agent-history 是 claude-history 的升级版，扩展了对多AI助手的支持，原 claude-history 命令作为兼容性包装脚本保留。
它需要网络权限或调用AI API吗？
完全不需要。它是一个纯本地命令行工具，仅读取和分析本地磁盘上的会话文件，不发送任何网络请求。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/claude-history/raw/index.md 读取 claude-history 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/claude-history/raw/index.md（查看排版版本）