Repolode
Предложить
dmtrKovalenko

dmtrKovalenko/fff

Быстрый поиск файлов и содержимого с поддержкой опечаток для Neovim, AI-агентов и приложений на Rust, Node, Bun, Python и C.

Открыть на GitHubСайт
Звёзды
11,153
Форки
468
Открытые issues
80
Последний коммит
15 часов назад

Что это?

FFF — это набор инструментов для поиска файлов: он объединяет поиск по путям и содержимому с поддержкой опечаток, ранжирование файлов по частоте и давности использования, фоновый мониторинг файлов и лёгкий индекс содержимого в памяти. Инструмент предназначен для долгоживущих процессов, которым приходится выполнять поиск снова и снова: если индекс остаётся в памяти, не нужно при каждом запросе запускать новый CLI, например ripgrep или fzf.

Проект доступен в нескольких вариантах: плагин fff.nvim для Neovim с пикерами файлов и live grep, MCP-сервер для клиентов вроде Claude Code, Codex, OpenCode и Cursor, расширение для агента Pi, Rust-крейт fff-search, библиотека C с заголовочным файлом и TypeScript SDK для Node.js и Bun. Во всех вариантах используется один и тот же поисковый движок.

Поиск поддерживает режимы glob и regex, фильтры по статусу Git, например git:modified, а также приоритетное отображение определений: в результатах grep объявления показываются выше обычных использований.

Ключевые возможности

  • 01Поиск с нечётким сопоставлением и поддержкой опечаток как по путям к файлам, так и по их содержимому.
  • 02Ранжирование по частоте и давности использования: недавно и часто открывавшиеся файлы поднимаются выше.
  • 03Фоновый мониторинг файлов и индекс содержимого в памяти для повторных поисков.
  • 04Режимы поиска glob, regex и по точному совпадению, контекстные строки и постраничная навигация по результатам с помощью курсора.
  • 05Фильтры с учётом Git, например для изменённых, добавленных в индекс и неотслеживаемых файлов.

Сценарии использования

  • Предоставить AI-агенту для написания кода быстрый и точный поиск по файлам и коду через MCP.
  • Заменить пикеры файлов и grep в Neovim более быстрым вариантом с ранжированием.
  • Добавить собственный поиск файлов в приложение на Node.js, Bun или Rust.

Быстрый старт

  1. 1

    Установите сервер fff-mcp через Homebrew (macOS/Linux).

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

    Зарегистрируйте установленный бинарный файл в Codex, указав его абсолютный путь.

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

    Или установите расширение агента Pi через npm.

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

Что важно знать

  • На этапе сборки плагин для Neovim загружает готовый бинарный файл или, если это не удаётся, собирает его с помощью cargo.
  • Опубликованные результаты бенчмарков были получены самим проектом на определённых репозиториях и моделях.

Темы

#file-search#fuzzy-search#neovim#ai-agent#mcp#grep#rust#typescript#bun#fff

Частые вопросы

Что такое fff?
Быстрый поиск файлов и содержимого с поддержкой опечаток для Neovim, AI-агентов и приложений на Rust, Node, Bun, Python и C. FFF — это набор инструментов для поиска файлов: он объединяет поиск по путям и содержимому с поддержкой опечаток, ранжирование файлов по частоте и давности использования, фоновый мониторинг файлов и лёгкий индекс содержимого в памяти. Инструмент предназначен для долгоживущих процессов, которым приходится выполнять поиск снова и снова: если индекс остаётся в памяти, не нужно при каждом запросе запускать новый CLI, например ripgrep или fzf.
fff можно использовать бесплатно? Какая у него лицензия?
fff распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
fff всё ещё поддерживается?
Активно поддерживается. Последний коммит в fff — 20 окт. 2026 г..
Для чего можно использовать fff?
Предоставить AI-агенту для написания кода быстрый и точный поиск по файлам и коду через MCP. Заменить пикеры файлов и grep в Neovim более быстрым вариантом с ранжированием. Добавить собственный поиск файлов в приложение на Node.js, Bun или Rust.
Как установить fff?
Установите сервер fff-mcp через Homebrew (macOS/Linux).: brew install dmtrKovalenko/fff/fff-mcp Зарегистрируйте установленный бинарный файл в Codex, указав его абсолютный путь.: codex mcp add fff -- "$(brew --prefix)/bin/fff-mcp" Или установите расширение агента Pi через npm.: pi install npm:@ff-labs/pi-fff
Где скачать fff?
Исходный код и инструкции по установке — на GitHub: https://github.com/dmtrKovalenko/fff

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты