Sobre o projeto

telescope.nvim é um localizador difuso altamente extensível sobre listas, construído sobre os recursos principais do Neovim e escrito em Lua. É centrado na modularidade, permitindo personalização globalmente via setup() ou por seletor através de opções passadas para funções integradas. Os requisitos incluem Neovim com LuaJIT e plenary.nvim. Dependências recomendadas são ripgrep (necessário para live_grep e grep_string), fd e nvim-web-devicons para ícones. Classificadores nativos como telescope-fzf-native.nvim ou telescope-fzy-native.nvim são sugeridos para melhorar o desempenho da classificação. A instalação geralmente é feita fixando uma tag de lançamento, por exemplo com lazy.nvim, e os usuários são aconselhados a executar :checkhealth telescope após a configuração. O plugin fornece um grande conjunto de seletores integrados. Seletores de arquivo incluem find_files, git_files, grep_string e live_grep. Seletores Vim cobrem buffers, oldfiles, commands, tags, command_history, search_history, help_tags, man_pages, marks, colorscheme, quickfix, loclist, jumplist, vim_options, registers, autocommands, spell_suggest, keymaps, filetypes, highlights, current_buffer_fuzzy_find, current_buffer_tags, resume e pickers. Seletores LSP do Neovim incluem lsp_references, lsp_incoming_calls, lsp_outgoing_calls, lsp_document_symbols, lsp_workspace_symbols, lsp_dynamic_workspace_symbols, diagnostics, lsp_implementations, lsp_definitions e lsp_type_definitions. Seletores Git incluem git_commits, git_bcommits, git_bcommits_range, git_branches, git_status e git_stash. Há também um seletor treesitter e seletores de lista como planets, builtin, reloader e symbols. Visualizadores são fornecidos para arquivos, resultados de grep e listas quickfix, com variantes vim_buffer_ usando buffers do Neovim e realce de árvore-sintática ou regex, e variantes de terminal usando cat ou bat. Os visualizadores padrão usam vim.filetype para adivinhar tipos de arquivo inspecionando nome do arquivo, shebang e modeline. Um autocmd TelescopePreviewerLoaded permite configuração da janela de visualização por tipo de arquivo. Classificadores, layouts e temas são configuráveis, e os mapeamentos são totalmente personalizáveis com um conjunto padrão documentado cobrindo navegação, seleção, abertura de arquivos em divisões ou abas, rolagem de visualizações, alternância de multi-seleção, envio de resultados para a lista quickfix e inserção de palavras da janela original no prompt. As ações podem ser remapeadas ou ações personalizadas podem ser criadas via transform_mod. Extensões são suportadas através de uma tabela de configuração dedicada, e o projeto mantém uma wiki com demonstrações, receitas de configuração e informações sobre extensões.