bartolli/codanna

何を解決するか

Codannaは、AIコーディングエージェントが通常使用する非効率な「grepと読み取り」のループを排除します。エージェントが文字列を手動で検索し、ファイルを1つずつ開くのを強制するのではなく、構造的で意味的なコード理解を提供し、1回のリクエストでシンボルのコンテキスト、コールグラフ、影響分析を即座に取得できるようにします。

動作方法

Codannaはローカルのリポジトリをディスク上にインデックス化し、コードの意味的マップを作成します。これはModel Context Protocol (MCP) サーバーとして、またはワンショットCLIツールとして動作します。ローカルの埋め込みモデルを使用して自然言語検索を可能にし、15の異なる言語のコードを解析してシンボル、呼び出し元、呼び出し先間の関係を追跡します。これにより、ソースコードをリモートAPIに送信せずに、意味的検索、依存関係追跡、ドキュメントRAG（Retrieval-Augmented Generation）を実行できます。

対象ユーザー

Claude Code、Cursor、Windsurf、Codex、GeminiなどのAIコーディングエージェントを使用している開発者で、ローカルプロジェクトに対する「X線視力」を提供して、より高速かつ正確なコードナビゲーションと修正を可能にしたい方におすすめです。

特徴

• ローカル優先アーキテクチャ: インデックス作成と埋め込み生成はすべてユーザーのマシン上で行われます。デフォルトではソースコードはデバイスから出ません。
• 統合されたコンテキスト取得: 1つのコマンドでシンボルの識別子、シグネチャ、ドキュメント、呼び出し元、呼び出し先、変更の潜在的な「爆発範囲」を取得できます。
• 多言語対応: Rust、Python、JavaScript、TypeScript、Java、Go、C++、C#など15の言語をサポートしています。
• 柔軟な統合: セッション全体にわたって使用する永続的なMCPサーバーとして、またはスクリプトやCI/CDパイプライン用のCLIとして動作します。
• 高性能: 高速なパーサー処理速度と、ウォームサーバークエリで10ms未満の検索を実現しています。