filesift

FileSift

AI コーディングエージェントがコードベースを効率よく検索し、理解するのに役立つ、ローカルで動作するオープンソースのユーティリティです。

---

FileSift を使うと、AI コーディングエージェントは、コードの見た目ではなく、コードが何をするかに基づいてコードベース全体を検索できます。grep の後にファイル全体をくまなく調べる代わりに、エージェントは「認証ミドルウェア」や「データベースの接続プーリング」といった自然言語のクエリを使って、最も関連性の高いコードに直接アクセスできます。すべての処理はお使いのマシン上でローカルに実行され、コードが環境の外に出ることはありません。

主なメリット：

• よりスマートな検索 — キーワード検索とセマンティック検索を組み合わせ、文字列の一致だけでなく意図に基づいてコードを見つけます
• コンテキストの無駄を削減 — エージェントが適切なファイルをすぐに見つけられるため、探索に費やすトークンを節約できます

インストール

pip install filesift

使い方

ワークフローに応じて、FileSift を使う方法は 3 つあります。

1. CLI

最も簡単な方法です。クエリのテスト、インデックスの管理、設定の変更に適しています。

# Index a project
filesift index /path/to/your/project

# Search for files by what they do
filesift find "authentication and session handling"

# Search in a specific directory
filesift find "retry logic for API calls" --path /path/to/project

2. MCP サーバー

FileSift をインストールすると、filesift-mcp コマンドも利用できます。これは、インデックス作成と検索を STDIO 経由でツールとして公開する軽量な MCP サーバーです。Claude Code、Cursor、Copilot など、一般的な多くのコーディングエージェントで使用できます。

エージェントの MCP 設定に追加します。

{
  "mcpServers": {
    "filesift": {
      "command": "filesift-mcp"
    }
  }
}

MCP サーバーは 4 つのツールを公開します。

• filesift_search — 自然言語のクエリでインデックス済みのコードベースを検索します
• filesift_find_related — インポートとセマンティック類似度に基づいて、指定したファイルに関連するファイルを見つけます
• filesift_index — 検索できるようにディレクトリをインデックス化します
• filesift_status — ディレクトリのインデックス作成状況を確認します

3. スキル

FileSift には search-codebase スキルが付属しており、コーディングエージェントのスキルディレクトリに直接インストールできます。これにより、MCP に対応していない場合でも、bash 経由でエージェントが FileSift CLI を利用できます。

# Install for Claude Code (default)
filesift skill install

# Install for other agents
filesift skill install --agent cursor
filesift skill install --agent copilot
filesift skill install --agent codex

対応エージェント：claude、codex、cursor、copilot、gemini、roo、windsurf。

仕組み

FileSift はデーモン化された埋め込みモデルを使用し、検索を高速に保ちます。基本的には、コードの説明から埋め込みを生成し、インデックスと呼ばれる小さなベクトルストアを対象に検索を行います。

1. インデックス作成 — filesift index はまず高速なキーワード／構造インデックスを作成します（数秒で完了）。その後、バックグラウンドでセマンティックインデックス作成を開始し、各ファイルの埋め込みを生成します。

2. デーモン — バックグラウンドデーモンがインデックスをメモリに読み込み、設定可能な時間だけ操作がないと自動的に終了します。最初のコールドスタート検索の後は、以降の検索はほぼ瞬時に完了します。

3. 検索 — クエリはキーワード検索（BM25）とセマンティック検索（FAISS）の両方で照合され、その後、両方の手法の長所を生かすために Reciprocal Rank Fusion によって統合されます。

インデックスは、インデックス化された各プロジェクト内の .filesift ディレクトリに保存されます。

設定

FileSift は TOML 設定ファイルを使用します。CLI から管理できます。

# View all settings
filesift config list --all

# Set a value
filesift config set search.MAX_RESULTS 20
filesift config set daemon.INACTIVITY_TIMEOUT 600

# Manage ignore patterns
filesift config add-ignore "node_modules" ".venv"
filesift config list-ignore

設定セクション：search、indexing、daemon、models、paths。

コントリビューション

コントリビューションを歓迎します。始めるには：

git clone https://github.com/roshunsunder/filesift.git
cd filesift
pip install -e .

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/my-feature）
3. 変更をコミットして、プルリクエストを作成します

ライセンス

Apache 2.0 — 詳細は LICENSE を参照してください。