pickfit

瀏覽開發者 CLI

agent-history

使用 Ollama embeddings 與 SQLite 對 AI coding agent 轉錄內容進行本機語意搜尋。

已在 macOS、Linux 和 Windows 上測試

使用

macOS arm64

需要先準備

  • 執行環境:python>=3.10
  1. 透過 uv tool install git+https://github.com/d3layd/agent-history 安裝

    uv tool install git+https://github.com/d3layd/agent-history

確認能用

agent-history --version 2>&1; echo ---; agent-history --help 2>&1

輸出應包含「agent-history 0.16.0」。

先試試這個

agent-history inject status 2>&1; echo "---TOGGLE---"; agent-history inject toggle 2>&1; agent-history inject status 2>&1; agent-history inject toggle 2>&1

執行 agent-history inject status 查看是否已開啟過往工作階段注入。

Linux x86_64

需要先準備

  • 執行環境:python>=3.10
  1. 透過 uv tool install git+https://github.com/d3layd/agent-history 安裝

    uv tool install git+https://github.com/d3layd/agent-history

確認能用

agent-history inject --help 2>&1
agent-history inject status 2>&1; echo ---; agent-history inject off 2>&1; agent-history inject on 2>&1

輸出應包含「inject: on」。

執行 agent-history inject status 查看是否已開啟過往工作階段注入。

Windows x86_64

需要先準備

  • 執行環境:python>=3.10
  1. 透過 uv tool 從 git 安裝 agent-history

    uv tool install git+https://github.com/d3layd/agent-history

確認能用

agent-history --version

輸出應包含「agent-history 0.16.0」。

先試試這個

New-Item -ItemType Directory -Force -Path docs-sample | Out-Null && Set-Content -Path docs-sample/runbook.md -Value "# Gateway Restart Runbook`nTo restart the gateway, run restart script and check auth middleware split reason.`nThe session refresh needs to run before auth check.`n" && Get-Content docs-sample/runbook.md
agent-history docs add ./docs-sample
agent-history sources

執行 agent-history inject status 查看是否已開啟過往工作階段注入。

它能做什麼

  • 依語意搜尋過往代理對話紀錄
    未測試
  • 結合語意搜尋與全文搜尋
    未測試
  • 檢視搜尋結果前後的對話
    未測試
  • 將相關的過往工作階段加入提示
    沒有看到它可用

pickfit 測到哪一步

macOS arm64

  1. 可以安裝
  2. 可以啟動
  3. 4 項功能中 0 項可用
  4. 可離線使用

Linux x86_64

  1. 可以安裝
  2. 可以啟動
  3. 4 項功能中 0 項可用
  4. 可離線使用

Windows x86_64

  1. 可以安裝
  2. 可以啟動
  3. 主要功能可用
  4. 可離線使用

適合用來

  • 依語意搜尋過往 agent 討論內容
  • 顯示搜尋結果周圍的對話
  • 透過本機網頁檢視器瀏覽搜尋
  • 為文件樹建立搜尋索引
  • 向量與全文混合搜尋

可替代 claude-mem。

pickfit 怎麼測的

每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證

macOS arm64

主要功能可用

  • 從頭重跑
  • 可離線使用
  • 檢查於 2026年11月1日
  • 版本 0.16.0

測試機器遇到的差異

  • README: agent-history index works with Ollama HTTP endpoint, --mode text needs no Ollama
    測試中: 即使是純文字文件內容,index 也需要 Ollama;必須在 11434 上執行假的 Ollama 伺服器回傳 768 維測試嵌入,建立索引後 search/show 才能運作
  • README: prerequisites python>=3.10
    測試中: Homebrew python 3.15.2 可正常運作(sqlite 擴充可載入),因此不需鎖定 3.10

Linux x86_64

主要功能可用

  • 從頭重跑
  • 可離線使用
  • 檢查於 2026年10月31日
  • 版本 0.16.0

測試機器遇到的差異

  • README: agent-history index embeds everything; search --mode text needs no Ollama
    測試中: index 一律需要 Ollama 嵌入端點(/api/embeddings 與 /api/tags);此沙箱在 127.0.0.1:11434 啟動了回傳固定 16 維嵌入的假 Ollama 伺服器以便建立索引,之後 --mode text 搜尋可在無向量下運作
  • README: uv tool install git+https://github.com/d3layd/agent-history
    測試中: 已驗證先決條件 python>=3.10 與 sqlite-vec 可載入擴充;doctor 回報在此 Python 3.12 上 sqlite-vec: loadable

Windows x86_64

主要功能可用

  • 從頭重跑
  • 可離線使用
  • 檢查於 2026年10月31日
  • 版本 0.16.0

測試機器遇到的差異

  • README: README says `--mode text` (BM25 full-text) works without Ollama and hybrid degrades gracefully
    測試中: Ollama 未執行時,`agent-history index` 會以 `error: cannot reach Ollama at http://localhost:11434` 拒絕,因此無法建立索引;沒有 Ollama 與嵌入模型時,即使使用 --mode text,`agent-history search "query"` 也無法執行(exit 1,`error: no index ... Run: agent-history index`)
  • README: README lists `agent-history doctor` to diagnose installation without documenting exit code
    測試中: `agent-history doctor` 以 exit 1 結束,但仍印出完整診斷(data home、ollama up: NO、sqlite-vec: loadable、adapter/index 狀態);exit 1 代表發現問題,而非當機
  • README: (Windows steps)
    測試中: pickfit 以一般使用者身分在 PowerShell 7(pwsh 7.6.9)中執行這些步驟;內建的 Windows PowerShell 5.1 未經驗證,且不支援 `&&`。

怎麼看工具卡

縫線
pickfit 親自安裝過這款工具,縫線下方的內容都來自那次測試。沒測過的工具,一律沒有縫線。
已在你的作業系統上驗證
安裝步驟在你選的系統上跑過。「只在 Linux 上執行過」表示還沒在你的系統上跑過。
macOS、Linux 和 Windows在哪裡測過
綠色系統標記:pickfit 在該系統跑過安裝步驟。灰色:README 說支援,但 pickfit 還沒試過。
測試進行到哪一步
能安裝並啟動、主要功能可用、服務有回應、能產生模型輸出。視窗代表桌面應用程式已開啟;插頭代表 MCP 用戶端用過它。標記在測試結果旁邊:展開「為什麼適合、我們怎麼知道」,或在「pickfit 怎麼測的」裡。
視覺檢查
pickfit 看過應用程式的截圖。綠色:畫面正常。黃色加數字:有看起來不對的地方,點開就能看到。灰色虛線:還沒檢查。
已知漏洞
它安裝的套件有沒有已知的高風險或嚴重漏洞(OSV.dev)。綠色:沒有已知漏洞。紅色加數字:有幾個,點開看清單,安裝前先看過。灰色虛線:沒有檢查,不代表安全。
關於這次測試
測試日期,以及測到的版本。
理由的來源
每個推薦理由都依據簡介裡的一個欄位。展開理由就能看到欄位和值。
寶藏
品質高、少有人知。
品質與知名度
兩個分數,滿分都是 100。品質:pickfit 試裝、試用的結果,以及安裝文件和維護狀況。知名度:看星數、下載量和 Hacker News。
已檢查的功能
README 宣傳的主要功能裡,實測通過幾項(綠色)、失敗幾項(紅色)。灰色是沒檢查的,工具卡會說明原因。
未驗證
Fitz 依一般知識提到的知名工具。沒有測試紀錄、沒有步驟、沒有分數。