Repolode
Enviar
junegunn

junegunn/fzf

Um fuzzy finder de linha de comando versátil que filtra qualquer lista de entrada e transforma scripts de shell em seletores interativos no terminal.

Ver no GitHubSite
Estrelas
83,703
Forks
5,336
Issues abertas
336
Último commit
há 8 horas

O que é?

O fzf lê uma lista da entrada padrão, permite digitar uma busca aproximada para filtrá-la interativamente e escreve o item selecionado na saída padrão. Como funciona com qualquer fluxo de texto, pode ser usado com arquivos, histórico de comandos, listas de processos, branches do git ou qualquer outra saída que possa ser encadeada por pipe.

Além da seleção simples, o fzf oferece uma janela de pré-visualização que executa um comando para o item em foco, modo de seleção múltipla, atalhos de teclado configuráveis e modos de exibição como tela cheia, uma área de altura limitada abaixo do cursor ou um popup do tmux/Zellij. Ele é distribuído como um único binário e oferece integração com Bash, Zsh, Fish e Nushell, adicionando atalhos como CTRL-T e CTRL-R e conclusão fuzzy de tabulação.

Ele também conta com um sistema de ações orientado a eventos para recarregar listas, executar programas externos e substituir a si próprio por outro processo, o que permite criar interfaces personalizadas no terminal. A integração com Vim e Neovim está disponível por meio de um plugin separado.

Recursos principais

  • 01Lê qualquer entrada linha a linha de stdin e a filtra por correspondência fuzzy.
  • 02Oferece sintaxe de busca avançada com correspondências exatas, por prefixo, por sufixo e inversas.
  • 03Fornece uma janela de pré-visualização que executa um comando para o item em foco.
  • 04Oferece modos de exibição em tela cheia, com altura limitada e em popup do tmux/Zellij.
  • 05Integra-se ao Bash, Zsh, Fish e Nushell para buscar no histórico e completar caminhos.
  • 06Distribuído como um único binário em gerenciadores de pacotes para Linux, macOS e Windows.

Casos de uso

  • Encontrar e abrir arquivos rapidamente em uma sessão de terminal usando um seletor fuzzy.
  • Pesquisar o histórico de comandos do shell com CTRL-R, em vez de percorrê-lo manualmente.
  • Criar menus de seleção interativos em scripts de shell.
  • Explorar branches do git, processos ou logs com pré-visualizações em tempo real.

Início rápido

  1. 1

    Instale o fzf com o Homebrew

    brew install fzf
  2. 2

    Configure a integração com o bash (atalhos de teclado e conclusão fuzzy) adicionando isto à configuração do shell

    eval "$(fzf --bash)"
  3. 3

    Execute o fzf para iniciar o localizador interativo

    fzf

Tópicos

#cli#fuzzy-search#terminal#shell#productivity-tool#command-line-tool#bash#fish#fzf#go

Perguntas frequentes

O que é fzf?
Um fuzzy finder de linha de comando versátil que filtra qualquer lista de entrada e transforma scripts de shell em seletores interativos no terminal. O fzf lê uma lista da entrada padrão, permite digitar uma busca aproximada para filtrá-la interativamente e escreve o item selecionado na saída padrão. Como funciona com qualquer fluxo de texto, pode ser usado com arquivos, histórico de comandos, listas de processos, branches do git ou qualquer outra saída que possa ser encadeada por pipe.
fzf é gratuito? Qual é a licença?
fzf é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
fzf ainda é mantido?
Manutenção ativa. O último commit de fzf foi em 20 de out. de 2026.
Para que posso usar fzf?
Encontrar e abrir arquivos rapidamente em uma sessão de terminal usando um seletor fuzzy. Pesquisar o histórico de comandos do shell com CTRL-R, em vez de percorrê-lo manualmente. Criar menus de seleção interativos em scripts de shell. Explorar branches do git, processos ou logs com pré-visualizações em tempo real.
Como instalar fzf?
Instale o fzf com o Homebrew: brew install fzf Configure a integração com o bash (atalhos de teclado e conclusão fuzzy) adicionando isto à configuração do shell: eval "$(fzf --bash)" Execute o fzf para iniciar o localizador interativo: fzf
Onde consigo fzf?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/junegunn/fzf

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

Projetos relacionados