justrach/codedb

解決する課題

codedb は、AIコーディングエージェントが大規模なコードベースをナビゲートし理解するのを支援するために設計されたコンテキストエンジンです。リポジトリの構造マップをエージェントに提供することで、「ハルシネーション（幻覚）」やコンテキストの欠如といった問題を解決し、リポジトリ内のすべてのファイルを読み込むことなく、定義、呼び出し元、依存関係を見つけることを可能にします。

仕組み

Zigで構築された codedb は、ローカルファイルシステムをインデックス化し、Model Context Protocol (MCP) を介して一連のツールを提供します。トライグラム加速による全文検索、O(1)での単語検索のための転置インデックス、およびオプションのセマンティック検索（ホスト型埋め込みまたはローカルANN検索を使用）を組み合わせたハイブリッド検索システムを採用しています。シンボル、コールパス、依存関係グラフを含むコードベースの構造マップを作成し、MCPサーバー、HTTPサーバー、またはCLIを通じてエージェントに提供できます。

対象ユーザー

AIコーディングエージェント（Claude Code、Cursor、Windsurf、Devin、Copilot CLIなど）を使用しており、プロジェクトの構造的関係やソースコードのコンテキストをより深く、正確に理解させる必要がある開発者。

ハイライト

• MCP統合: 幅広いMCPクライアントをネイティブサポートしており、エージェントが codedb_explain や codedb_callpath といったツールを使用可能です。
• 高性能: ripgrep や grep といった従来のツールと比較して、シンボル検索や全文検索のレイテンシが極めて低いです。
• トークン効率: 生の行データではなく、構造化された関連性の高い結果を返すため、AIエージェントのトークン消費量を大幅に削減します。
• 幅広い言語サポート: Zig、C/C++、Python、TypeScript/JavaScript、Rust、Go、PHP、Ruby、HCL、R、Dart/Flutter、OCaml のパーサーを搭載しています。
• マルチプラットフォーム: macOS、Linux、Windows向けのネイティブバイナリを提供しています。