raine/claude-history

解决的问题

claude-history 是为 Claude Code、Pi 和 Oh My Pi（OMP）等 AI 编程代理用户设计的终端式历史浏览器。它解决了这些代理生成的大量本地对话记录（通常以 JSONL 文件形式存储）难以导航、搜索和管理的问题。

工作原理

该工具会扫描项目目录以自动发现会话文件。它提供一个终端用户界面（TUI），允许用户使用关键词（词汇）和语义（基于含义）搜索方式来浏览对话。它会索引工具输出、思考块和对话内容，使其可被搜索。用户可以在类似账本的查看器中以 vim 风格导航查看对话记录，导出消息，或直接将对话恢复或分叉回原始代理环境。

适用人群

使用 AI 编程代理（Claude Code、Pi、OMP）并需要高效检索过往交互、管理会话历史、在不同项目工作树之间切换的开发者和高级用户。

主要亮点

• 多代理支持：兼容 Claude Code、Pi 和 Oh My Pi。
• 混合搜索：结合模糊词汇搜索与本地语义嵌入，实现基于语义的检索。
• TUI 对话查看器：支持 Markdown 渲染、vim 风格滚动，以及可切换的思考/工具块显示。
• 会话管理：可在界面中直接恢复、分叉、重命名或删除对话。
• 跨项目分叉：可将一个项目的对话分叉到当前工作目录中。
• Claude Code 技能：包含一个配套技能，使 Claude 能够搜索并读取自己的历史记录。