Repolode
dmtrKovalenko

dmtrKovalenko/fff

Neovim、AIエージェント、Rust、Node、Bun、Python、Cアプリケーション向けの、高速でタイポに強いファイル・コンテンツ検索ツールキット。

スター
11,153
フォーク
468
未解決の Issue
80
最終コミット
10 時間前

これは何?

FFFは、タイポに強いパス・コンテンツ検索、frecencyによるファイルのランキング、バックグラウンドのファイル監視、軽量なインメモリコンテンツインデックスを組み合わせたファイル検索ツールキットです。検索を繰り返す長時間稼働プロセスを想定しており、インデックスをメモリ上に保持することで、クエリのたびにripgrepやfzfなどのCLIを起動するコストを避けられます。

このプロジェクトは複数の形態で提供されています。ファイル検索とライブgrepのpickerを備えたNeovim用プラグインのfff.nvim、Claude Code、Codex、OpenCode、Cursorなどのクライアント向けMCPサーバー、Piエージェント拡張機能、fff-searchというRust crate、ヘッダーファイル付きのCライブラリ、Node.jsとBun向けのTypeScript SDKがあります。いずれも同じコア検索エンジンを使用します。

検索ではglobモードとregexモード、git:modifiedなどのGitステータス条件に対応しています。また、定義を優先して分類する機能により、grepの結果で通常の使用箇所より宣言を先に表示できます。

主な機能

  • 01ファイルパスとファイル内容の両方に対応した、タイポに強いファジーマッチング。
  • 02最近開いたファイルや、頻繁に開くファイルを上位に表示するfrecencyランキング。
  • 03繰り返し検索に備えたバックグラウンドのファイル監視とインメモリコンテンツインデックス。
  • 04コンテキスト行とカーソルページネーションに対応した、glob、regex、リテラル検索モード。
  • 05変更済み、ステージ済み、未追跡ファイルなどを対象にできる、Git連携フィルター。

ユースケース

  • MCP経由でAIコーディングエージェントに高速かつ正確なファイル・コード検索を提供する。
  • Neovimのファイル検索とgrepのpickerを、より高速でランキング機能を備えた代替手段に置き換える。
  • Node.js、Bun、Rustアプリケーションに独自のファイル検索機能を組み込む。

クイックスタート

  1. 1

    Homebrewでfff-mcpサーバーをインストールする(macOS/Linux)

    brew install dmtrKovalenko/fff/fff-mcp
  2. 2

    インストールしたバイナリを絶対パスでCodexに登録する

    codex mcp add fff -- "$(brew --prefix)/bin/fff-mcp"
  3. 3

    または、npmからPiエージェント拡張機能をインストールする

    pi install npm:@ff-labs/pi-fff

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

  • Neovimプラグインのビルド時に、ビルド済みバイナリをダウンロードするか、ダウンロードできない場合はcargoでコンパイルします。
  • 公開されているベンチマーク結果は、プロジェクト側が特定のリポジトリとモデルを使って測定したものです。

トピック

よくある質問

fff とは?
Neovim、AIエージェント、Rust、Node、Bun、Python、Cアプリケーション向けの、高速でタイポに強いファイル・コンテンツ検索ツールキット。 FFFは、タイポに強いパス・コンテンツ検索、frecencyによるファイルのランキング、バックグラウンドのファイル監視、軽量なインメモリコンテンツインデックスを組み合わせたファイル検索ツールキットです。検索を繰り返す長時間稼働プロセスを想定しており、インデックスをメモリ上に保持することで、クエリのたびにripgrepやfzfなどのCLIを起動するコストを避けられます。
fff は無料で使えますか?ライセンスは?
fff は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
fff は今もメンテナンスされていますか?
活発にメンテナンス中。fff の最終コミットは 2026年10月20日 です。
fff は何に使えますか?
MCP経由でAIコーディングエージェントに高速かつ正確なファイル・コード検索を提供する。 Neovimのファイル検索とgrepのpickerを、より高速でランキング機能を備えた代替手段に置き換える。 Node.js、Bun、Rustアプリケーションに独自のファイル検索機能を組み込む。
fff のインストール方法は?
Homebrewでfff-mcpサーバーをインストールする(macOS/Linux): brew install dmtrKovalenko/fff/fff-mcp インストールしたバイナリを絶対パスでCodexに登録する: codex mcp add fff -- "$(brew --prefix)/bin/fff-mcp" または、npmからPiエージェント拡張機能をインストールする: pi install npm:@ff-labs/pi-fff
fff はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/dmtrKovalenko/fff

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

関連プロジェクト