AIエージェントもNeovimも爆速ファイル検索！タイポにも強い賢いファインダー — fff.nvim

アーキテクチャ・仕組み

• コア部分はRustで実装されており、高速なファジーマッチング・grep・グロブ処理を実現
• MCP（Model Context Protocol）サーバーとして動作し、AIエージェントにファイル検索ツールを提供
• Neovimプラグインとしても動作し、Luaで設定・拡張が可能
• Smith-Watermanスコアリング（バイオインフォマティクス由来のアルゴリズム）によるファジーマッチング
• 独自のグロブライブラリ zlob を使用

メモリ・スコアリングシステム

• Frecency（頻度×最新度）: よく開くファイルや最近開いたファイルを優先表示
• コンボブースト: 同じクエリで繰り返し開いたファイルにボーナススコアを付与（min_combo_countで閾値設定可能）
• Git連携: ファイルのGitステータス（変更済み、ステージ済み、未追跡など）を検索結果に反映
• クエリ履歴: 過去の検索クエリと結果を記録し、検索精度を向上

検索モード

ファイル検索

• ファジー（あいまい）マッチング
• 制約フィルタ: git:modified, test/, !除外, ./**/*.{rs,lua}（glob）の組み合わせ可能

Live Grep（全文検索）

3つのモードを <S-Tab> で切り替え可能：

• Plain: リテラル（そのまま）マッチ
• Regex: 正規表現対応（[a-z], foo|bar, \b など）
• Fuzzy: Smith-Watermanによるあいまいマッチ（例: mtxlk → mutex_lock）

追加のフィルタ: *.md, *.{c,h} での拡張子絞り込み、src/main.rs での単一ファイルgrep

クロスモード提案

• ファイル検索で結果がない場合 → grep結果を提案として表示
• grep検索で結果がない場合 → ファイル名マッチを提案として表示

対応環境

• Neovim: 0.10.0以上
• インストール: ビルド済みバイナリの自動ダウンロード、またはRust (rustup) からのソースビルド
• NixOS: nix run .#release でビルド可能
• AIエージェント連携: Claude Code, Codex, OpenCode などMCP対応エージェント

パフォーマンス

• Linuxリポジトリ（10万ファイル、8GB）での動作デモあり
• grep時の time_budget_ms（デフォルト150ms）でUI フリーズを防止
• max_results（デフォルト100）、max_matches_per_file（デフォルト100）で結果量を制御
• max_threads（デフォルト4）で並列処理スレッド数を設定可能

主な機能一覧

• ファジーファイル検索、Live Grep、マルチグレップ
• Git ステータスのサインカラム表示・テキストカラーリング
• マルチセレクト＆クイックフィックスリスト連携（<Tab> で選択、<C-q> で送信）
• ファイルプレビュー（サイズ制限、チャンク読み込み、バイナリ検出、ImageMagick情報表示）
• .gitignore と .ignore ファイルによるフィルタリング
• フレックスレイアウト（画面幅に応じたプレビュー配置自動切替）
• クエリ履歴のサイクル（<C-Up>）
• 豊富なハイライトカスタマイズ

コマンド一覧

• :FFFScan - ファイル再スキャン
• :FFFRefreshGit - Gitステータス更新
• :FFFClearCache [all|frecency|files] - キャッシュクリア
• :FFFHealth - ヘルスチェック
• :FFFDebug [on|off|toggle] - デバッグモード切替
• :FFFOpenLog - ログファイルを開く

制約・注意点

• 現在ベータ段階で、デバッグモード有効での協力が推奨されている
• ログファイルは ~/.local/state/nvim/log/fff.log に保存される

MCP（AIエージェント向け）インストール

curl -L https://dmtrkovalenko.dev/install-fff-mcp.sh | bash

インストール後、表示される指示に従ってClaude Code、Codex、OpenCodeなどに接続します。CLAUDE.md に以下を追記するだけで利用開始できます：

For any file search or grep in the current git indexed directory use fff tools

Neovim（lazy.nvim）インストール

{
  'dmtrKovalenko/fff.nvim',
  build = function()
    require("fff.download").download_or_build_binary()
  end,
  lazy = false,
  keys = {
    { "ff", function() require('fff').find_files() end, desc = 'FFFind files' },
    { "fg", function() require('fff').live_grep() end, desc = 'LiFFFe grep' },
  }
}

Neovim 0.10.0以上が必要です。ビルド済みバイナリが自動ダウンロードされるか、Rustツールチェーンからビルドされます。