grepai

grepai 是一款開源的語意程式碼搜尋 CLI，由開發者 Yoan Bernabeu 打造，以 MIT 授權釋出。名稱是向 1973 年的原始 grep 致意，但理念不同。經典 grep 比對文字樣式。grepai 把你的函式與類別轉成向量並比對意義，所以搜尋「錯誤處理」可以撈出一個叫 catchException 的函式，你壓根想不到要打這個字。

這款工具為兩種人而生。第一種是厭倦在大型儲存庫裡猜符號名稱的開發者。第二種是 AI 程式代理，它們在真正理解任何東西之前，就為了 grep 和反覆讀檔燒掉大量 token。把一份簡短的相關程式碼清單交給代理，而不是原始的搜尋輸出，grepai 就能砍掉這些代理所需的輸入 token。r/ClaudeAI 上的使用者回報的正是這件事。有位開發者說，他的 Claude Code 輸入 token 大幅下降。

主要限制在於安裝設定。grepai 需要嵌入供應商把程式碼轉成向量，這意味著你要安裝 Ollama 並拉一個模型，或者交出一組雲端供應商的 API 金鑰。它不是執行一次就能忘掉的指令。在效能普通的機器上，大型儲存庫的首次索引也要花點時間。對活在終端機裡的開發者來說，這筆交易划算。對其他人來說，這套機械大概比他們想要的還多。

開始使用

1. 用對應你系統的一行指令稿安裝 grepai，或在 macOS 上用 Homebrew。Windows 就從 GitHub 頁面取得 PowerShell 指令。
2. 為 Ollama 拉一個嵌入模型，通常是 nomic-embed-text，因為本機嵌入能讓你的程式碼留在自己的機器上。
3. 在專案內執行 grepai init，建立設定並架好索引。
4. 啟動 grepai watch，讓檔案監看器在你編輯時讓索引保持最新。
5. 用平實英文搜尋，例如 grepai search "error handling"，或用 grepai trace callers "Login" 追蹤關係。