Dicklesworthstone/coding_agent_session_search

Unified TUI and CLI to index and search your local coding agent session history across 11+ providers (Codex, Claude, Gemini, Cursor, Aider, etc.)

解決的問題

編程代理（如 Cursor、Claude Code 和 Aider）會產生大量的對話歷史，但這些數據通常分散在不同的專有格式和儲存位置中。這使得跨不同工具尋找過去對話中的特定解決方案或上下文變得非常困難。cass 提供了一個統一、高性能的介面，用於索引和搜尋這些本地歷史紀錄。

工作原理

cass 將來自各種代理的對話數據規範化為通用模式，並將其儲存在本地 SQLite 資料庫中。它採用多層搜尋方法：

  • Lexical Search：使用帶有 edge N-grams 的 BM25 全文搜尋，實現對精確術語和程式碼符號的即時、基於前綴的匹配。

  • Semantic Search：一個可選的、選擇性啟用的功能，使用本地 MiniLM 模型（透過 frankensearch）在無需網路連接的情況下執行概念查詢的向量相似性搜尋。

  • Hybrid Search：預設模式，使用倒數排名融合 (RRF) 結合詞法和語義搜尋結果，以平衡精確率和召回率。

它具有面向人類的終端使用者介面 (TUI) 和專門為其他 AI 代理查詢歷史而設計的「機器人模式」（帶 JSON 輸出的 CLI）。

適用對象

  • 個人開發者：希望擁有單一可搜尋的 AI 輔助編程對話存檔的人。
  • 團隊：希望在不同的工具偏好之間共享組織知識的團隊。
  • AI 代理：需要存取使用者歷史上下文以改進當前問題解決能力的 AI 代理。

亮點

  • 廣泛的相容性：聚合來自 Codex、Claude Code、Gemini CLI、Cursor、Aider、GitHub Copilot 等許多工具的歷史紀錄。
  • 低於 60ms 的延遲：由 Rust 原生後端驅動的高速「隨打隨搜」體驗。
  • 隱私優先：所有索引和推論都在本地進行；數據不會發送到外部伺服器。
  • 機器人模式：具有穩定 JSON 契約的專用 API 介面，可與其他 AI 代理無縫整合。
  • 原子更新：使用原子交換確保索引完整性，防止在背景索引期間出現損壞的搜尋結果。