ctx 是一個開源的命令列介面（CLI）工具，用於快速搜尋您過往程式開發代理人（coding agent）的本地紀錄。
程式開發代理人通常從零開始。牠們可以檢查目前的程式碼儲存庫，但往往無法恢復早期工作中包含的討論、決策、失敗嘗試、指令和測試結果。
這些對話紀錄充滿了寶貴的脈絡資訊：
ctx 將這些紀錄索引至您機器上的 SQLite 資料庫，然後提供一個 CLI 介面，讓目前的及未來的代理人能夠在重複之前的工作前，找到先前的討論、指令或失敗的嘗試。
透過將代理人紀錄結構化為不同的階段、事件、元數據和索引欄位，然後返回排序並引用來源的匹配結果，代理人可以存取有意義的歷史紀錄，而使用的 token 遠少於原始搜尋。結果因查詢和語料庫而異，但原始搜尋通常非常耗費 token，以至於實際上等同於沒有可用的歷史紀錄。
您過去的代理人對話紀錄儲存在本地供應商的紀錄檔中。ctx 會發現支援的來源，匯入實際持久化的記錄，並將標準化的階段和事件資料儲存在本地 SQLite 資料庫中，以優化檢索。
ctx 以 Rust 編寫並儲存本地 SQLite 索引，因此搜尋速度快、可腳本化，且不需要背景服務。
這些 ID 讓您目前的代理人能夠恢復先前對話紀錄中所需的盡可能多的脈絡資訊。
ctx 不會將您的提示、對話紀錄或索引的歷史紀錄傳送至雲端服務，不會呼叫模型 API，不需要 API 金鑰，也不會寫入您的原始程式碼儲存庫。
如需了解完整的處理流程，請參閱 ctx 如何運作 。如需快速首次運行，請參閱 快速入門 。
代理人記憶體工具通常會儲存精簡的事實、摘要、向量或圖節點。這些工具對於穩定的偏好設定有幫助，但當下一個代理人需要知道某個決策的來源、哪個指令失敗，或在原始對話中哪個選項被拒絕時，這些工具的證據就顯得薄弱。
Graphify 風格的工具可以回答不同的問題。牠們會繪製目前的程式碼儲存庫地圖：檔案、符號、匯入、資料夾和關係。ctx 搜尋先前代理人對話紀錄，解釋在人們和代理人變更該程式碼儲存庫期間發生了什麼事。
ctx 讓檢索與階段和事件保持關聯，因此另一個代理人可以在使用之前檢查來源。詳細閱讀有關代理人記憶體 、Graphify 風格的程式碼庫圖 ，以及 grep 或日誌搜尋 。
安裝 ctx，初始化本地儲存，並索引已發現的本地歷史紀錄。
搜尋本地歷史紀錄，檢查某個事件，開啟該階段，並使用 JSON 輸出。
匯入 Cursor 代理人的對話紀錄，並在編輯前要求 Cursor 引用已檢索的本地歷史紀錄。
了解發現、匯入、SQLite 儲存、搜尋刷新和引用式檢索。
查看 ctx 今日可以發現、匯入和搜尋哪些代理人歷史紀錄。
檢閱設定、狀態、來源、整合、匯入、顯示、定位、搜尋、MCP 和 doctor。