bartolli/codanna

What it solves

Codanna 為 AI 助手提供程式碼庫的結構化理解，省去基本關鍵字搜尋（grep）與重複的來回互動需求。它讓代理人能夠了解函式之間的關係、追蹤相依性，並根據意圖（而非僅僅是名稱）找出實作。

How it works

Codanna 會索引專案的原始程式碼與文件。它使用語意搜尋將自然語言查詢對應到程式碼意圖，並追蹤跨檔案的呼叫圖與相依關係。它透過 Model Context Protocol（MCP）與 AI 助手整合，支援 stdio、HTTP 與 HTTPS 等多種傳輸方式。

Who it’s for

開發者與 AI 代理人（例如 Claude Code、Cursor、Windsurf），在研發與配對程式設計時，需要在大型程式碼庫中進行深度、具情境感知的導覽與搜尋。

Highlights

• Semantic Search: 以自然語言查詢，依功能與行為找出函式與邏輯。
• Relationship Tracking: 即時提供跨檔案的呼叫圖與相依性分析。
• Document Search: 索引 markdown 與文字檔，支援 RAG 工作流程，同時查詢文件與程式碼。
• MCP Protocol Integration: 透過 Model Context Protocol 與 Claude、Gemini、Codex 原生相容。
• High Performance: 每秒可解析超過 75,000 個符號，查詢延遲低於 10 毫秒。