Codeix

🚀 codeix

Fast semantic code search for AI agents — find symbols, references, and callers across any codebase.

codeix                 # MCPサーバーを起動し、変更を監視する
codeix build           # ソースファイルを解析し、.codeindexを書き込む
codeix -r ~/project build  # 特定のディレクトリからビルドする

🚀 クイックスタート

AIコーディングエージェントは、コードに取り組む前に、大部分のトークン予算をコードの「検索」に費やします。彼らはgrepを実行し、ファイルを読み、再度grepを実行し、戻る操作を繰り返します。大規模なコードベースでは、エージェントは正しい関数を見つけるだけで数千のトークンを消費することがあります。最悪の場合は、関数を見逃してホールミラーを引き起こすことさえあります。

Codeixはエージェントにコードベースの事前構築済みマップを提供します。 1つの構造化されたクエリで、シンボル名、ファイル、行範囲、シグネチャ、および親を返します。スキャンや推測は必要ありません。

✨ 主な機能

既存のツールが誤っている点

codeixの違い

• gitにコミットされる — インデックスは.codeindexディレクトリで、コードと一緒にコミットされます。リポジトリをクローンすると、インデックスはすでに存在します。再インデックス化は必要ありません。
• 共有可能 — ライブラリの作者は、npm/PyPI/crates.ioパッケージに.codeindexを含めることができます。消費者は依存関係の即時ナビゲーションができます。
• 合成可能 — MCPサーバーは依存関係のインデックスを自動的に検出し、マウントします。1か所で自分のコードと依存関係をクエリできます。
• LLM向けに構造化されている — シンボルには種類、シグネチャ、親関係、および行範囲があります。エージェントは1つのツール呼び出しで必要なものを正確に取得でき、生のテキストから組み立てる必要はありません。
• 文章検索 — search --scope textは、コメント、ドキュメント文字列、および文字列リテラルを対象としています。TODOを見つけ、ユーザーが報告したエラーメッセージを見つけ、関数のドキュメント文字列が何を言っているかを見つけることができます。コードからのノイズはありません。
• 高速 — 数秒でビルドし、ミリ秒でクエリを実行します。内部ではRust + tree-sitter + メモリ内SQLite FTS5を使用しています。

📚 ドキュメント

.codeindex形式

構造化されたコードインデックス用のオープンでポータブルな形式です。コードと一緒にコミットするプレーンなJSONLファイルです。gitに友好的な差分があり、grepとjqで人間が読め、バイナリブロブはありません。

.codeindex/
  index.json        # マニフェスト: バージョン、名前、言語
  files.jsonl       # ソースファイルごとに1行 (パス、言語、ハッシュ、行数)
  symbols.jsonl     # シンボルごとに1行 (関数、クラス、インポート、シグネチャ付き)
  texts.jsonl       # コメント、ドキュメント文字列、文字列リテラルごとに1行

JSONを解析できる任意のツールは.codeindexを消費できます。Codeixはtree-sitterを使用してそれを構築し、AIエージェントはMCP (Model Context Protocol) を介してそれをクエリします。

例 — symbols.jsonl:

{"file":"src/main.py","name":"os","kind":"import","line":[1,1]}
{"file":"src/main.py","name":"Config","kind":"class","line":[22,45]}
{"file":"src/main.py","name":"Config.__init__","kind":"method","line":[23,30],"parent":"Config","sig":"def __init__(self, path: str, debug: bool = False)"}
{"file":"src/main.py","name":"main","kind":"function","line":[48,60],"sig":"def main(args: list[str]) -> int"}

パッケージと一緒にインデックスを配布する

パッケージに.codeindexを含めると、あなたに依存するすべての開発者があなたのAPIの即時ナビゲーションができます。セットアップや再インデックス化は必要ありません。

Gitリポジトリ、npm、PyPI、およびcrates.ioで動作します。

MCPツール

セットアップ不要の7つのツールです。エージェントはすぐにクエリを実行できます。初期化、設定、更新は必要ありません。

プロジェクトの検出

任意のディレクトリからcodeixを起動します。下方向に探索し、.git/を含むすべてのディレクトリを別々のプロジェクトとして扱います。それぞれに独自の.codeindexが作成されます。

単一のリポジトリ、モノレポ、兄弟リポジトリ、およびgitサブモジュールで一様に動作します。設定は必要ありません。

サポートする言語

コンパイル時に機能ゲート付きのTree-sitter文法:

Markdownサポート

Markdownファイルは見出し (ATX # とSetextアンダーラインスタイルの両方) を解析し、それらを階層的な親子関係を持つsectionシンボルとしてインデックス化します。これにより、目次の抽出とドキュメント構造のナビゲーションが可能になります。

フェンス付きコードブロックはcodeテキストエントリとして抽出され、それらが含まれるセクションを親とします。

埋め込みスクリプト

HTML、Vue、Svelte、およびAstroファイルは、埋め込まれた<script>ブロックを抽出するために前処理され、その後JavaScriptまたはTypeScript文法で解析されます:

インデックス内の行番号は、抽出されたスクリプトブロックではなく、元のファイルを指します。

📦 インストール

# npm / npx — インストールせずに実行
npx codeix

# pip / uvx — インストールせずに実行
uvx codeix

# Rust
cargo install codeix

# Homebrew
brew install codeix

# またはソースからビルド
git clone https://github.com/montanetech/codeix.git
cd codeix
cargo build --release

すべてのチャネルで同じ単一のバイナリがインストールされます。ランタイム依存関係はありません。

💻 使用例

基本的な使用法

# 現在のプロジェクトのインデックスをビルドする
codeix build

# 特定のディレクトリからビルドする (以下のすべてのgitリポジトリを検出する)
codeix -r ~/projects build

# MCPサーバーを起動する (デフォルトのコマンド、変更を監視する)
codeix

# または明示的に
codeix serve
codeix serve --no-watch

# 特定のディレクトリからサーブする
codeix -r ~/projects serve

MCPクライアントの設定

MCPクライアントの設定 (例: Claude Desktop、Cursor) に追加します:

{
  "mcpServers": {
    "codeix": {
      "command": "codeix"
    }
  }
}

🔧 技術詳細

設計原則

• ローカルのみ — ネットワークやAPIキーは必要なく、オフラインでもエアギャップ環境でも動作します。
• 決定的 — 同じソースは常に同じインデックスを生成します (クリーンな差分)。
• 合成可能 — 依存関係のインデックスはクエリ時に自動的に検出され、マウントされます。
• 最小限の表面 — 7つのクエリツールで、管理のための余分な手順はありません。

アーキテクチャ

完全なアーキテクチャ決定レコードについては、 を参照してください。

📄 ライセンス

MIT OR Apache-2.0