ctx：用於從過去的程式碼代理會話中恢復歷史背景與決策的本地搜尋 CLI

它解決了什麼問題

程式碼代理通常會在每次會話時從頭開始，失去先前討論、失敗嘗試以及技術決策的背景。ctx 提供了一種方式，讓當前與未來的代理能夠在各種代理平台的過往會話中搜尋並恢復這些歷史背景。

工作原理

ctx 是一個基於 Rust 的 CLI 工具，會從受支援的代理平台中發現並匯入本地提供者的歷史檔案。它將這些資料正規化為本地的 SQLite 資料庫，以優化檢索。之後，代理可以使用 CLI 以自然語言搜尋特定關鍵字、檔案或事件，並從先前的會話中取得引用的匹配結果與片段。

目標使用者

使用 AI 程式碼代理（如 Cursor、Claude Code、Windsurf 等）的開發者，想讓他們的代理具備專案演進的長期記憶，避免重複錯誤。

重點特色

• 廣泛支援：支援多種代理歷史，包括 Cursor、Claude Code、Zed 與 GitHub Copilot CLI。
• 代幣效率：結構化索引讓代理能以遠少於原始文字紀錄搜尋的代幣數，取得有意義的歷史資訊。
• 本地與私密：所有索引與搜尋皆在本機透過 SQLite 完成，不會將資料傳送至雲端服務，也不需要 API 金鑰。
• 引用檢索：回傳排序過的匹配結果與 ID，讓代理能從原始文字紀錄中精確還原來源背景。
• 可擴充：提供多語言 SDK 與自訂歷史外掛支援。