Repolode
ix-infrastructure

ix-infrastructure/Ix

Ixはリポジトリをシンボル、呼び出し、インポートの永続的なグラフに変換し、開発者やAIコーディングエージェントがその構造を照会できるようにします。

スター
1,097
フォーク
82
未解決の Issue
25
最終コミット
昨日

これは何?

Ixは、コードベースをシンボル、呼び出し、インポート、包含関係のグラフに変換するCLIツールです。tree-sitterでリポジトリを解析し、その結果をローカルのバックエンドに保存するため、毎回検索結果からグラフを作り直すことなく、セッションをまたいで利用できます。

CLIでは、あるシンボルの正体や、そのシンボルを呼び出す箇所、依存先、変更による影響範囲などを調べられます。出力形式はプレーンテキスト、JSON、トークン数を抑えたLLM向け形式から選べます。MCPサーバーを使えば、Claude Code、Codex、Cursor、VS CodeなどのMCP対応クライアントから同じグラフにアクセスできます。また、`ix view`を実行すると、Compassというビジュアライザーが起動します。

バックエンドは、メモリレイヤーを備えたArangoDBを使うDockerイメージとして動作します。インストーラーは、Node.js、ripgrep、Dockerが見つからない場合にセットアップします。CLIのビルド済みパッケージはApple Silicon搭載のmacOS、Linux、Windows x86-64向けに提供されており、Intel MacではHomebrew経由でソースからビルドできます。

主な機能

  • 01tree-sitterでリポジトリを解析し、シンボル、呼び出し、インポートのグラフを作成します。
  • 02コードグラフをローカルに保存し、セッションをまたいで利用できます。
  • 03指定したシンボルについて、説明、追跡、影響範囲、呼び出し元などを調べられます。
  • 04MCPサーバーを提供し、複数のAIクライアントへの登録を行うインストーラーを備えています。
  • 0527のプログラミング言語に加え、複数の設定・データ形式に対応しています。

ユースケース

  • 不慣れなコードベースの全体像をすばやく把握する。
  • 関数を編集する前に、変更によって何が壊れる可能性があるかを確認する。
  • ファイル全体を貼り付けずに、コーディングエージェントへ構造的なコンテキストを渡す。
  • 依存先の数を基準に順位付けし、影響の大きいモジュールを見つける。

クイックスタート

  1. 1

    READMEにある公式インストールスクリプトを実行する(macOS/Linux)

  2. 2

    リポジトリをマッピングする

    ix map .
  3. 3

    MCPサーバーにAIクライアントを登録する

    ix mcp install

使う前に知っておきたいこと

  • ローカルのArangoDBバックエンドにはDockerとDocker Composeが必要です。
  • インストールスクリプトはリモートのスクリプトをシェルにパイプします。また、Intel搭載MacではHomebrewからソースビルドする必要があります。

トピック

よくある質問

Ix とは?
Ixはリポジトリをシンボル、呼び出し、インポートの永続的なグラフに変換し、開発者やAIコーディングエージェントがその構造を照会できるようにします。 Ixは、コードベースをシンボル、呼び出し、インポート、包含関係のグラフに変換するCLIツールです。tree-sitterでリポジトリを解析し、その結果をローカルのバックエンドに保存するため、毎回検索結果からグラフを作り直すことなく、セッションをまたいで利用できます。
Ix は無料で使えますか?ライセンスは?
Ix は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
Ix は今もメンテナンスされていますか?
活発にメンテナンス中。Ix の最終コミットは 2026年10月21日 です。
Ix は何に使えますか?
不慣れなコードベースの全体像をすばやく把握する。 関数を編集する前に、変更によって何が壊れる可能性があるかを確認する。 ファイル全体を貼り付けずに、コーディングエージェントへ構造的なコンテキストを渡す。 依存先の数を基準に順位付けし、影響の大きいモジュールを見つける。
Ix のインストール方法は?
READMEにある公式インストールスクリプトを実行する(macOS/Linux) リポジトリをマッピングする: ix map . MCPサーバーにAIクライアントを登録する: ix mcp install
Ix はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/ix-infrastructure/Ix

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト