Extensions
Here are a few simple guidelines to make an extension for Telescope:
It's suggested to install one native sorter, for better performance
| Extension | Description |
|---|---|
| telescope-fzf-native.nvim | Native FZF sorter that uses compiled C to do the matching, supports fzf syntax |
| telescope-fzy-native.nvim | Native FZY sorter that uses compiled C to do the matching |
| telescope-zf-native.nvim | Native zf sorter that prioritizes matches on filenames |
Below are benchmarks to show the performance difference between lua, fzf, and fzy. Done with an early version of plenary.benchmark. The benchmark was done by calculating the score for 240201 file strings in a table. For each score > 0 we also calculated the positions (this is the slower part for both algorithms, and telescope tends to only do this for the displayed results, usually less than 50 entries).
The benchmark between fzf-native and fzy-native isn't that meaningful. The benefit of fzf-native is the support with the fzf syntax.
| Extension | Description |
|---|---|
| telescope-all-recent | (F)recency sorting for all Telescope pickers. |
| telescope-http.nvim | Quickly investigate HTTP status codes |
| telescope-frecency.nvim | A "smart" picker using Frecency Algorithm that can learn from your habit |
| telescope-recent-files.nvim | Merges the find_files and oldfiles picker, so files are sorted by how recently they were opened |
| telescope-session.nvim | A "xray23" picker to help you manage your vim sessions |
| octo.nvim | Edit and review GitHub issues and pull requests from the comfort of your favorite editor with telescope integration |
| telescope-pathogen.nvim | Switch working directory for builtin actions on the fly |
| telescope-project.nvim | Switch between projects |
| telescope-code-fence.nvim | Fetch Markdown Code Fences from Github |
| telescope-software-licenses.nvim | View and paste common software licenses into your project |
| telescope-git-grep.nvim | Search the current buffer's worktree using git grep
|
| telescope-git-selector.nvim | Quickly search for Git worktrees and open/search files in the selected worktree |
| telescope-github.nvim | Integration with github cli |
| telescope-media-files.nvim | Preview images, pdf, epub, video, and fonts from Neovim using Telescope |
| telescope-fzf-writer.nvim | Incorporating some fzf concepts with plenary jobs and Telescope |
| telescope-symbols.nvim | Picking symbols and insert them at point |
| telescope-ghq.nvim | Integration with ghq |
| telescope-repo.nvim | Jump into the repositories (git, mercurial…) of your filesystem |
| telescope-node-modules.nvim | List all node packages under node_modules directory |
| telescope-z.nvim | Integration with z |
| telescope-ros.nvim | Pick packages from ROS and ROS2 workspaces |
| telescope_hoogle | Live search Haskell functions and docs using Hoogle and Telescope! |
| telescope-tele-tabby.nvim | Tab switcher |
| telescope-lsp-handlers.nvim | Handlers for built-in LSP commands |
| browser-bookmarks.nvim | Open your browser bookmarks from Neovim using Telescope |
| telescope-heading.nvim | Switch between document's headings (Markdown, AsciiDoc, rst, org, latex, and Vim Help) |
| telescope-emoji.nvim | Find emojis😃 |
| telescope-glyph.nvim | Find font glyphs |
| telescope-opds | browse opds catalogs |
| goimpl.nvim | generate interface stubs for a type |
| telescope-gott.nvim | exec a specific go test |
| telescope-switch.nvim | switch between files with given rules |
| nvim-neoclip.lua | clipboard manager |
| telescope-tmuxinator.nvim | tmuxinator integration |
| cheatsheet.nvim | Cheatsheet plugin for neovim with Telescope as UI, actively maintained fork of the original plugin |
| telescope-hop.nvim | Navigate, select, and perform actions with motions inspired by hop.nvim |
| scaladex.nvim | Search & add scaladex for dependencies/libraries for your scala projects! |
| telescope-ctags-outline.nvim | get ctags outline |
| telescope-command-palette.nvim | Create key-bindings and watch them with telescope |
| telescope-terraform-doc.nvim | Browse Terraform providers resources |
| telescope-windowizer.nvim | Open and edit files in another tmux window and kill the window when exit vim |
| telescope-ag | A Telescope picker for Silver Searcher(Ag) similar to that of fzf.vim
|
| telescope-scriptnames.nvim | A Telescope extension wrapper around :scriptnames
|
| telescope-changes.nvim | A Telescope extension wrapper around :changes
|
| telescope-gitmoji.nvim | A Telescope integration of gitmoji. |
| telescope-cc.nvim | A Telescope integration of Conventional Commits. |
| telescope-cmdline-word.nvim | Search word for substitute with tab |
| telescope-ports.nvim | Watch open ports on your system with telescope |
| command_center.nvim | A command palette for neovim |
| yanky.nvim | Improved Yank and Put functionalities for Neovim |
| vim-p4-files | List and select files in Perforce repository |
| run-code.nvim | Create and manage custom commands you can run while writing code |
| telescope-everything.nvim | Everything integration |
| telescope-recent-files | Picker for recently opened files, including buffers which are not yet saved in v:oldfiles
|
| easypick.nvim | Create Telescope pickers from arbitrary console commands |
| telescope-extension-maker.nvim | Easy to make a telescope extension |
| ad-telescope-extensions.nvim | A set of telescope extensions, which build on telescope-extension-maker |
| telescope-file-browser.nvim | A file browser extension supporting synchronized creation, deletion, renaming, and moving of files and folders |
| telescope-alternate | Alternate between common files using pre-defined regexp. Just map the patterns and starting navigating between files that are related. |
| scout | Browse packages on Hackage and open their haddock in your browser. |
| telescope-tabs | Fly through your tabs in neovim |
| telescope-manix | Search Nix documentation using Manix and Telescope. |
| telescope-color-names.nvim | Picker for X11 / web color names. |
| lsp-toggle.nvim | Disable/Enable LSP clients for buffers. |
| dir-telescope.nvim | Perform telescope functions in selected directories |
| telescope-directory.nvim | Search for directories with telescope and perform any action. |
| haskell-tools.nvim | Hoogle search for the type signature of the value under the cursor |
| telescope-menu.nvim | Add a custom menu that executes a command |
| tailiscope.nvim | TailwindCSS cheatsheet within Telescope |
| telescope-undo.nvim | Visualize and search all changes in your undo tree |
| telescope-monorepos.nvim | A telescope extension for fuzzy searching packages in a monorepo(rush) and navigating to its folder |
| adjacent.nvim | A telescope extension for finding files in the same directory as the current buffer |
| telescope-search-dir-picker.nvim | A Telescope extension for picking the search directory before live_grep
|
| telescope-filelinks.nvim | Add file links to your wiki, the README.md or any other file using telescope. |
| telescope-docker.nvim | Manage docker containers, images and compose files from a telescope prompt. |
| telescope-tasks.nvim | Run and preview the definitions and outputs of custom or auto-generated tasks from a telescope prompt. |
| telescope-import.nvim | Import modules faster based on import patterns you've already used elsewhere in your project. |
| telescope-texsuite | Telescope menus for latex. |
| whaler.nvim | Move between directories blazingly fast. |
| telescope-picker-list.nvim | List all telescope pickers including user extensions. Free your brain. |
| telescope-git-submodules.nvim | List and preview your project's git submodules. Interact with them with your favourite git TUI. |
| telescope-cmdline.nvim | Telescope extension to use command line in a floating window, rather than in bottom-left corner. |
| telescope-git-conflicts | Telescope git conflicts picker. |
| telescope-rails.nvim | Navigate Rails app easily. |
| telescope-helpgrep.nvim | Use helpgrep to grep through help files. |
| cscope-picker | Simple picker for cscope references. |
| telescope-just.nvim | A Telescope picker for just |
| telescope-zotero.nvim | A Telescope picker for Zotero |
| telescope-foldmarkers.nvim | A Telescope picker for Vim fold markers. Build a navigable table of contents for long files in your comments. |
| telescope-jj.nvim | A telescope picker to use with Jujutsu repos |
| grit-telescope.nvim | A telescope picker for Grit |
| telescope-live-grep-args.nvim | Enables passing arguments to the grep command |
| Extension | Description |
|---|---|
| telescope-dap.nvim |
nvim-dap integration |
| telescope-dapzzzz | facilitate dap to load vscode adapter configure file or user custom configuration file |
| telescope-packer.nvim | A Telescope extension that provides extra functionality for Packer.nvim |
| telescope-vimspector.nvim | Integration for vimspector |
| telescope-asynctasks.nvim | Integration for asynctasks |
| telescope-ultisnips.nvim | Integration for ultisnips |
| telescope-coc.nvim | Integration with coc.nvim |
| session-lens | A Session Switcher extension built on top of auto-session |
| telescope-openbrowser.nvim | Integration for open-browser.vim with Telescope.nvim |
| telescope-vim-bookmarks.nvim | Integration with the vim-bookmarks plugin |
| telescope-tmux.nvim | Integration for tmux |
| telescope-zoxide | Integration with zoxide, a smart directory picker that tracks your usage |
| neorg-telescope | Integration with neorg |
| telescope-luasnip.nvim | Integration for LuaSnip |
| telescope-git-diffs.nvim | Integration for diffview.nvim |
| telescope-lazy.nvim | Integration for Lazy.nvim, provides handy functionality about installed plugins |
| toggleterm-manager.nvim | Customizable Telescope extension to manage toggleterm.nvim terminal buffers |
| telescope-gpt.nvim | Integration for chatGPT.nvim |
| telescope-cscope.nvim | Integration for cscope_maps |
.
├── README.md # README for your awesome extension
└── lua
├── tests # TODO: Layout for unit tests
└── telescope
└── _extensions # The underscore is significant
├─ plugin_name.lua # Init and register your extension
└─ plugin_name
├─ file1.lua # Break up the heavy-lifting in
├─ file2.lua # several files
└─ ...