使用
安裝前先知道:有已知漏洞
pickfit 在安裝時會一併裝上的套件裡找到 10 個已知的高風險或嚴重漏洞(OSV.dev,2026年11月3日),安裝前請先考慮。
npm:protobufjs 6.11.6protobufjs 中的任意程式碼執行 (GHSA-xq3m-2v4x-88gg,嚴重,7.5.5 已修正)npm:sharp 0.32.6sharp 在 libvips 中繼承的弱點:CVE-2026-33327、CVE-2026-33328、CVE-2026-35590、CVE-2026-35591 (GHSA-f88m-g3jw-g9cj,高風險,0.35.0 已修正)
再看 8 個
npm:protobufjs 6.11.6— GHSA-66ff-xgx4-vchm(高風險),7.5.6 已修正npm:protobufjs 6.11.6— GHSA-685m-2w69-288q(高風險),7.5.6 已修正npm:protobufjs 6.11.6— GHSA-75px-5xx7-5xc7(高風險),7.5.6 已修正npm:protobufjs 6.11.6— GHSA-jvwf-75h9-cwgg(高風險),7.5.6 已修正npm:protobufjs 6.11.6— GHSA-wcpc-wj8m-hjx6(高風險),7.6.1 已修正npm:sharp 0.32.6— GHSA-rgj7-g3m4-5g8c(高風險),0.35.4 已修正npm:sharp 0.32.6— GHSA-wq5f-xc86-pv6w(高風險),0.35.5 已修正npm:zod 3.25.76— GHSA-mrhx-c7xc-m3w5(高風險),4.6.6 已修正
Linux x86_64
需要先準備
- 執行環境:
Node.js 20 or newer
透過 npm 安裝 ai-cortex
npm install -g ai-cortex
README 與實測不符之處
- README 寫: MCP tools listed as recall_memory(worktreePath), record_memory(worktreePath), index_project etc
實際可行: 實際 MCP schema 中 index_project 使用 `path`、suggest_files 使用 `task`(探測時名稱被截斷);以 worktreePath/query 呼叫會得到 Invalid arguments
確認能用
ai-cortex --version輸出應包含「ai-cortex 0.18.1」。
加進你的 agent
claude mcp add ai-cortex -- ai-cortex mcpClaude Desktop、Cursor 等用戶端用的 JSON
{
"mcpServers": {
"ai-cortex": {
"command": "ai-cortex",
"args": [
"mcp"
]
}
}
}在程式設計代理的設定中將 ai-cortex mcp 加入為 MCP 伺服器,再從代理使用其工具。
它能做什麼
- 儲存分類的專案記憶已測試
怎麼使用
- 將 MCP 用戶端連接到
ai-cortex mcp。 - 呼叫
record_memory工具,將worktreePath設為 <your repo path>,並提供type(例如decision)、title與body。
- 將 MCP 用戶端連接到
- 為 git 儲存庫建立索引未測試
- 依任務排序最相關的檔案未測試
- 搜尋先前的代理工作階段沒有看到它可用
pickfit 測到哪一步
Linux x86_64
- 可以安裝
- 可以連線
- 4 項功能中 1 項可用
- 需要網路
適合用來
- 為 git 儲存庫建立索引,並依任務排序相關檔案
- 搜尋過往 agent 工作階段中的決策與修正
- 儲存並回想具型別的專案記憶,例如決策與陷阱
pickfit 怎麼測的
每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證
Linux x86_64
MCP 用戶端成功呼叫工具
- 從頭重跑
- 需要網路
- 檢查於 2026年10月31日
- 版本 0.18.1
MCP 用戶端透過 stdio 連線,列出 39 個工具,呼叫 search_history 也回傳了結果。
測試機器遇到的差異
- README: ai-cortex index /path/to/repo
測試中: CLI index 可正常運作;MCP index_project 也需要 `path` 而非 `worktreePath`,且受 cwd 影響