Busca instantânea de arquivos em disco no macOS ganha força em Rust

Dados rápidos

• Repositório: noahdunnagan/fsearch
• Licença: MIT
• Linguagem: Rust
• Estrelas e forks: 1.307 estrelas e 86 forks
• Ranking: Trendshift (diário: número 21)
• Data da consulta: 2026-10-10

O problema da lentidão em buscas locais

Localizar um arquivo específico ou uma linha de código em discos grandes costuma exigir ferramentas lentas ou serviços de indexação que consomem muita memória. Em sistemas operacionais com milhões de itens, varreduras completas no momento da consulta geram atrasos perceptíveis para desenvolvedores que trabalham no terminal.

Erros de digitação frequentes tornam a experiência frustrante na maioria dos utilitários tradicionais de linha de comando. Quando o usuário troca letras em um nome longo, as ferramentas padrão costumam retornar listas vazias, forçando nova tentativa manual.

A pesquisa de texto dentro de arquivos em projetos extensos também costuma exigir abertura e leitura física de cada documento. Sem uma estrutura prévia de índices, essa tarefa eleva o uso de processamento e atrasa o fluxo de trabalho diário.

Arquitetura interna e instalação

O sistema realiza uma primeira varredura no disco utilizando a chamada de sistema getattrlistbulk, desenhada para coletar metadados em lote de forma rápida. As atualizações posteriores acompanham as alterações do sistema de arquivos por meio da interface de eventos FSEvents do macOS. Em caso de reinicialização, o processo reaplica apenas as modificações pendentes.

A estrutura armazena os nomes dos arquivos em um arquivo mapeado diretamente na memória, conhecido como mmap, organizado pasta por pasta. A busca textual interna utiliza um índice de trigramas, técnica que divide palavras em sequências de três letras consecutivas para acelerar correspondências. Os trechos encontrados são relidos diretamente do disco no instante da consulta para evitar dados defasados.

cargo build --release && ./target/release/fsearch install

O comando compila o binário otimizado em Rust e instala o utilitário no caminho local do usuário para execução imediata no terminal.

Casos de uso práticos no dia a dia

• Localização de arquivos com pequenas falhas de digitação: palavras com cinco ou mais letras toleram um caractere incorreto, permitindo encontrar documentos mesmo quando o usuário comete deslizes ortográficos rápidos.
• Filtragem por metadados de sistema: desenvolvedores podem filtrar resultados combinando extensão, tipo de arquivo, pastas específicas e limites de data de modificação recente.
• Pesquisa de expressões regulares dentro de códigos: o recurso de grep integrado aceita buscas por símbolos ou estruturas de código diretamente em arquivos de texto.
• Integração em outras ferramentas via soquete local: serviços externos ou editores podem se comunicar com o daemon por linhas JSON através de um soquete local ou pela entrada padrão do terminal.

Diferenças em relação a outras alternativas

Em testes comparativos documentados contra o projeto fff na base de código do Chromium, com 509 mil arquivos no mesmo equipamento Mac, o fsearch localizou arquivos por nome em 1,1 milissegundo, enquanto o concorrente levou 13,8 milissegundos. Na pesquisa interna de conteúdo, o tempo registrado foi de 5,6 milissegundos contra 53 milissegundos da alternativa.

O consumo de memória do fsearch ficou em 50 megabytes para o disco inteiro, frente a 358 megabytes demandados pelo concorrente apenas para a pasta analisada. O índice do fsearch ignora intencionalmente certos tipos de arquivo e diretórios como build e vendor, o que reduz o volume de itens indexados em cerca de 9% se comparado a ferramentas que leem todas as pastas sem exceção.

Limitações técnicas e cuidados de segurança

O utilitário foi publicado recentemente, tendo sido criado em 2026-10-08 e recebido seu último commit em 2026-10-09, sem nenhuma versão estável fechada até o momento. Não há tópicos informados no repositório nem página oficial fora do controle de versão.

O funcionamento completo requer permissão de acesso total ao disco, conhecida como Full Disk Access, concedida nas configurações de privacidade do macOS. Sem essa autorização manual, pastas restritas do sistema são ignoradas silenciosamente durante a coleta de dados. Quando instalado como item de início de sessão, o executável exige renovação manual dessa permissão a cada nova compilação feita pelo usuário.

Resumo rápido

• Projeto: noahdunnagan/fsearch
• Licença: MIT
• Linguagem: Rust
• Estrelas: 1.307
• Ranking: Trendshift (diário: número 21)
• Risco principal: projeto recém-criado sem releases oficiais e dependente de permissões amplas no macOS

Fontes

• Repositório no GitHub: https://github.com/noahdunnagan/fsearch
• Página oficial: sem site oficial
• Ranking Trendshift: Trendshift (daily: #21)