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 能夠搜尋並讀取自己的歷史記錄。