Muvon/octocode

Semantic code searcher and codebase utility

What it solves

AI アシスタントは、コードを平坦なテキストとして扱うため、コードベース全体のコンテキストを把握するのに苦労します。ファイル同士の関係性を理解できないため、依存関係の追跡やインポートのナビゲーション、セッション間でのアーキテクチャ決定の記憶が困難になります。

How it works

Octocode は tree‑sitter の AST パーシングを利用し、任意のテキストチャンクではなく実際のコードシンボル（関数やクラスなど）を抽出します。その後、プロジェクト全体の imports、calls、implements といった関係をマッピングした GraphRAG ナレッジグラフを構築します。この構造化インテリジェンスは Model Context Protocol (MCP) サーバーを通じて公開され、AI エージェントはセマンティック検索、コードシグネチャの閲覧、依存関係グラフへのクエリを実行できます。

Who it’s for

MCP 互換の AI ツール（Claude Desktop、Cursor、Windsurf など）を使用する開発者で、ローカルコードベースを深く構造的に理解した AI アシスタントを求めている方。オンボーディング、リファクタリング、コードレビューの品質向上に役立ちます。

Highlights

  • Structural Intelligence: 標準的な RAG を超えて、シンボルと関係性のナレッジグラフとしてコードベースをインデックス化します。
  • Native MCP Integration: セマンティックかつ構造的検索のためのツールを AI エージェントに直接提供する組み込み MCP サーバーを提供します。
  • Hybrid Search: セマンティック類似度と BM25 フルテキスト検索、再ランク付けを組み合わせ、検索精度を向上させます。
  • Multi-language Support: Rust、Python、TypeScript、Go、C++、Java など、tree‑sitter が対応する多数の言語をサポートします。
  • Local-first Privacy: .gitignore を尊重し、ローカル埋め込みオプションを提供するローカルファースト設計です。