ctxrs/ctx

Search the coding agent history already on your machine

它解決了什麼問題

程式碼代理往往缺乏先前會話的記憶,無法找回先前工作中具體的決策、失敗嘗試與使用過的指令。這會導致代理重複錯誤,或遺失先前討論中建立的意圖與限制。

工作原理

ctx 是一個基於 Rust 的 CLI 工具,會從各種程式碼代理的外掛(例如 Cursor、Claude Code、Windsurf)中發掘並匯入本地歷史檔案。它會將這些資料正規化為本機的 SQLite 資料庫,並針對檢索進行最佳化。這讓目前的代理能以自然語言、特定檔案或關鍵字搜尋過去的會話,並取得精確的事件或會話文字稿作為上下文。

目標使用者

使用 AI 程式碼代理的開發者,想要為代理提供一種持久且 token 效率高的方式,來存取他們的歷史專案上下文。

重點特色

  • 廣泛的代理支援:支援包括 Claude Code、Cursor、Windsurf 以及 GitHub Copilot CLI 在內的多種代理外掛。
  • Token 效率:相較於直接搜尋完整文字稿,透過返回排序後、帶引用的匹配結果,大幅降低 token 使用量。
  • 本地且私密:所有索引與搜尋皆在本機 SQLite 中完成,資料不會傳送至雲端服務或模型 API。
  • 代理就緒:提供一個 CLI,讓代理本身即可使用,搜尋並復原先前會話的上下文。