Repolode
Enviar
dmtrKovalenko

dmtrKovalenko/fff

Toolkit rápido de busca de arquivos e conteúdo, tolerante a erros de digitação, para Neovim, agentes de IA e aplicações em Rust, Node, Bun, Python e C.

Ver no GitHubSite
Estrelas
11,153
Forks
468
Issues abertas
80
Último commit
há 10 horas

O que é?

FFF é um toolkit de busca de arquivos que combina busca de caminhos e conteúdo tolerante a erros de digitação, acesso a arquivos ranqueado por frecency, um file watcher em segundo plano e um índice de conteúdo leve em memória. Ele foi desenvolvido para processos de longa duração que fazem buscas repetidamente, nos quais manter o índice residente evita o custo de iniciar um novo CLI, como ripgrep ou fzf, a cada consulta.

O projeto está disponível em várias formas: um plugin fff.nvim para Neovim com seletores de arquivos e live grep, um servidor MCP para clientes como Claude Code, Codex, OpenCode e Cursor, uma extensão para o agente Pi, uma crate Rust chamada fff-search, uma biblioteca C com um arquivo de header e um SDK TypeScript para Node.js e Bun. Todos compartilham o mesmo mecanismo de busca central.

A busca oferece modos glob e regex, filtros por status do git, como git:modified, e classificação que prioriza definições, exibindo declarações antes de usos comuns nos resultados de grep.

Recursos principais

  • 01Correspondência fuzzy tolerante a erros de digitação para caminhos e conteúdo de arquivos.
  • 02Classificação por frecency que prioriza arquivos abertos recentemente e com frequência.
  • 03File watcher em segundo plano e índice de conteúdo em memória para buscas repetidas.
  • 04Modos de busca glob, regex e literal, com linhas de contexto e paginação por cursor.
  • 05Filtros que levam o git em conta, como arquivos modificados, staged e não rastreados.

Casos de uso

  • Oferecer a um agente de programação com IA uma busca rápida e precisa de arquivos e código por meio de MCP.
  • Substituir os seletores de arquivos e grep do Neovim por uma alternativa mais rápida e ranqueada.
  • Incorporar um recurso personalizado de busca de arquivos a uma aplicação em Node.js, Bun ou Rust.

Início rápido

  1. 1

    Instale o servidor fff-mcp com o Homebrew (macOS/Linux).

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

    Registre o binário instalado no Codex usando o caminho absoluto.

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

    Ou instale a extensão do agente Pi pelo npm.

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

Antes de usar

  • A etapa de build do plugin do Neovim baixa um binário pré-compilado ou, se isso não for possível, recorre à compilação com cargo.
  • Os resultados de benchmark publicados foram medidos pelo próprio projeto em repositórios e modelos específicos.

Tópicos

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

Perguntas frequentes

O que é fff?
Toolkit rápido de busca de arquivos e conteúdo, tolerante a erros de digitação, para Neovim, agentes de IA e aplicações em Rust, Node, Bun, Python e C. FFF é um toolkit de busca de arquivos que combina busca de caminhos e conteúdo tolerante a erros de digitação, acesso a arquivos ranqueado por frecency, um file watcher em segundo plano e um índice de conteúdo leve em memória. Ele foi desenvolvido para processos de longa duração que fazem buscas repetidamente, nos quais manter o índice residente evita o custo de iniciar um novo CLI, como ripgrep ou fzf, a cada consulta.
fff é gratuito? Qual é a licença?
fff é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
fff ainda é mantido?
Manutenção ativa. O último commit de fff foi em 20 de out. de 2026.
Para que posso usar fff?
Oferecer a um agente de programação com IA uma busca rápida e precisa de arquivos e código por meio de MCP. Substituir os seletores de arquivos e grep do Neovim por uma alternativa mais rápida e ranqueada. Incorporar um recurso personalizado de busca de arquivos a uma aplicação em Node.js, Bun ou Rust.
Como instalar fff?
Instale o servidor fff-mcp com o Homebrew (macOS/Linux).: brew install dmtrKovalenko/fff/fff-mcp Registre o binário instalado no Codex usando o caminho absoluto.: codex mcp add fff -- "$(brew --prefix)/bin/fff-mcp" Ou instale a extensão do agente Pi pelo npm.: pi install npm:@ff-labs/pi-fff
Onde consigo fff?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/dmtrKovalenko/fff

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados