bartolli/codanna

解決的問題

Codanna 消除了 AI 編碼代理通常使用的低效率「grep 與讀取」循環。它不會強制代理手動搜尋字串並逐一開啟檔案，而是提供結構化、語意化的程式碼理解，讓代理能透過單一請求即時取得符號上下文、呼叫圖與影響分析。

工作原理

Codanna 在本地磁碟上索引程式碼庫，並建立程式碼的語意地圖。它可作為 Model Context Protocol (MCP) 伺服器或一次性 CLI 工具運作。使用本地嵌入模型實現自然語言搜尋，並解析 15 種不同語言的程式碼，以追蹤符號、呼叫者與被呼叫者之間的關係。這讓它能在不將原始碼傳送至遠端 API 的情況下，執行語意搜尋、相依性追蹤與文件 RAG（Retrieval-Augmented Generation）。

適用對象

專為使用 AI 編碼代理（如 Claude Code、Cursor、Windsurf、Codex 或 Gemini）的開發者設計，希望為其助手提供「X 光視力」，以實現更快、更精確的程式碼導航與修改。

主要特色

• 本地優先架構：所有索引與嵌入生成皆在使用者裝置上完成；預設情況下原始碼不會離開裝置。
• 統一上下文取得：單一指令即可回傳符號的識別、簽名、文件、呼叫者、被呼叫者，以及變更的潛在「爆發範圍」。
• 多語言支援：支援 15 種語言，包括 Rust、Python、JavaScript、TypeScript、Java、Go、C++ 與 C#。
• 彈性整合：可作為持久的 MCP 伺服器用於長時間工作，或作為 CLI 用於指令碼與 CI/CD 管線。
• 高效率：具備快速解析吞吐量與暖伺服器查詢下低於 10ms 的查詢速度。