[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-70820":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":32,"readmeContent":33,"aiSummary":34,"trendingCount":16,"starSnapshotCount":16,"syncStatus":35,"lastSyncTime":36,"discoverSource":37},70820,"telescope.nvim","nvim-telescope\u002Ftelescope.nvim","nvim-telescope","Find, Filter, Preview, Pick. All lua, all the time.","",null,"Lua",19528,955,50,377,0,21,46,119,63,118.94,"MIT License",false,"master",true,[27,28,29,30,31],"lua","neovim","neovim-plugin","nvim","nvim-lua","2026-06-12 04:00:57","# telescope.nvim\n\n[![LuaRocks](https:\u002F\u002Fimg.shields.io\u002Fluarocks\u002Fv\u002FConni2461\u002Ftelescope.nvim?logo=lua&color=purple)](https:\u002F\u002Fluarocks.org\u002Fmodules\u002FConni2461\u002Ftelescope.nvim)\n\nGaze deeply into unknown regions using the power of the moon.\n\n## What Is Telescope?\n\n`telescope.nvim` is a highly extendable fuzzy finder over lists. Built on the\nlatest awesome features from `neovim` core. Telescope is centered around\nmodularity, allowing for easy customization.\n\nCommunity driven builtin [pickers](#pickers), [sorters](#sorters) and\n[previewers](#previewers).\n\n![Preview](https:\u002F\u002Fi.imgur.com\u002FTTTja6t.gif)\n\u003Csub>For more showcases of Telescope, please visit the [Showcase\nsection](https:\u002F\u002Fgithub.com\u002Fnvim-telescope\u002Ftelescope.nvim\u002Fwiki\u002FShowcase) in the\nTelescope Wiki\u003C\u002Fsub>\n\n## Telescope Table of Contents\n\n- [Getting Started](#getting-started)\n- [Usage](#usage)\n- [Customization](#customization)\n- [Default Mappings](#default-mappings)\n- [Pickers](#pickers)\n- [Previewers](#previewers)\n- [Sorters](#sorters)\n- [Layout](#layout-display)\n- [Themes](#themes)\n- [Commands](#vim-commands)\n- [Autocmds](#autocmds)\n- [Extensions](#extensions)\n- [API](#api)\n- [Media](#media)\n- [Contributing](#contributing)\n- [Changelog](https:\u002F\u002Fgithub.com\u002Fnvim-telescope\u002Ftelescope.nvim\u002Fblob\u002Fmaster\u002Fdoc\u002Ftelescope_changelog.txt)\n\n## Getting Started\n\nThis section should guide you to run your first builtin pickers.\n\n### Requirements\n\n* [Neovim >=v0.11.7](https:\u002F\u002Fgithub.com\u002Fneovim\u002Fneovim\u002Freleases\u002Ftag\u002Fv0.11.6) built **with LuaJIT** (check `:version`).\n* [nvim-lua\u002Fplenary.nvim](https:\u002F\u002Fgithub.com\u002Fnvim-lua\u002Fplenary.nvim).\n\n>[!IMPORTANT]\n> Only the **latest version** ([`stable`](https:\u002F\u002Fgithub.com\u002Fneovim\u002Fneovim\u002Freleases\u002Ftag\u002Fstable)) and the **latest commit of `HEAD`** ([`nightly`](https:\u002F\u002Fgithub.com\u002Fneovim\u002Fneovim\u002Freleases\u002Ftag\u002Fnightly)) are tested and supported; before opening an issue, download the latest available release and confirm that the problem persists.\n\n### Recommended dependencies\n\n* [BurntSushi\u002Fripgrep](https:\u002F\u002Fgithub.com\u002FBurntSushi\u002Fripgrep) is required for\n  `live_grep` and `grep_string` and is the first priority for `find_files`.\n* [sharkdp\u002Ffd](https:\u002F\u002Fgithub.com\u002Fsharkdp\u002Ffd) (finder)\n* [devicons](https:\u002F\u002Fgithub.com\u002Fnvim-tree\u002Fnvim-web-devicons) (icons)\n\nWe also strongly suggest installing a native telescope sorter to significantly improve\nsorting performance:\n* [telescope-fzf-native.nvim](https:\u002F\u002Fgithub.com\u002Fnvim-telescope\u002Ftelescope-fzf-native.nvim)\nor\n* [telescope-fzy-native.nvim](https:\u002F\u002Fgithub.com\u002Fnvim-telescope\u002Ftelescope-fzy-native.nvim).\nFor more information and a performance benchmark take a look at the\n[Extensions](https:\u002F\u002Fgithub.com\u002Fnvim-telescope\u002Ftelescope.nvim\u002Fwiki\u002FExtensions)\nwiki.\n\n### Installation\n\nWe recommend pinning to the latest release\n[tag](https:\u002F\u002Fgithub.com\u002Fnvim-telescope\u002Ftelescope.nvim\u002Ftags),\ne.g. using [lazy.nvim](https:\u002F\u002Fgithub.com\u002Ffolke\u002Flazy.nvim)\n\n```lua\n{\n    'nvim-telescope\u002Ftelescope.nvim', version = '*',\n    dependencies = {\n        'nvim-lua\u002Fplenary.nvim',\n        -- optional but recommended\n        { 'nvim-telescope\u002Ftelescope-fzf-native.nvim', build = 'make' },\n    }\n}\n```\n\n### Checkhealth\n\nMake sure you call `:checkhealth telescope` after installing telescope to ensure\neverything is set up correctly.\n\nAfter this setup you can continue reading here or switch to `:help telescope`\nto get an understanding of how to use Telescope and how to configure it.\n\n## Usage\n\nTry the command `:Telescope find_files`\nto see if `telescope.nvim` is installed correctly.\n\n```lua\nlocal builtin = require('telescope.builtin')\nvim.keymap.set('n', '\u003Cleader>ff', builtin.find_files, { desc = 'Telescope find files' })\nvim.keymap.set('n', '\u003Cleader>fg', builtin.live_grep, { desc = 'Telescope live grep' })\nvim.keymap.set('n', '\u003Cleader>fb', builtin.buffers, { desc = 'Telescope buffers' })\nvim.keymap.set('n', '\u003Cleader>fh', builtin.help_tags, { desc = 'Telescope help tags' })\n```\n\nSee [builtin pickers](#pickers) for a list of all builtin functions.\n\n## Customization\n\nThis section should help you explore available options to configure and\ncustomize your `telescope.nvim`.\n\nUnlike most vim plugins, `telescope.nvim` can be customized by either applying\ncustomizations globally, or individually per picker.\n\n- **Global Customization** affecting all pickers can be done through the main\n  `setup()` method (see defaults below)\n- **Individual Customization** affecting a single picker by passing `opts` to\n  builtin pickers (e.g. `builtin.find_files(opts)`) see\n  [Configuration recipes](https:\u002F\u002Fgithub.com\u002Fnvim-telescope\u002Ftelescope.nvim\u002Fwiki\u002FConfiguration-Recipes)\n  wiki page for ideas.\n\n### Telescope setup structure\n\n```lua\nrequire('telescope').setup{\n  defaults = {\n    -- Default configuration for telescope goes here:\n    -- config_key = value,\n    mappings = {\n      i = {\n        -- map actions.which_key to \u003CC-h> (default: \u003CC-\u002F>)\n        -- actions.which_key shows the mappings for your picker,\n        -- e.g. git_{create, delete, ...}_branch for the git_branches picker\n        [\"\u003CC-h>\"] = \"which_key\"\n      }\n    }\n  },\n  pickers = {\n    -- Default configuration for builtin pickers goes here:\n    -- picker_name = {\n    --   picker_config_key = value,\n    --   ...\n    -- }\n    -- Now the picker_config_key will be applied every time you call this\n    -- builtin picker\n  },\n  extensions = {\n    -- Your extension configuration goes here:\n    -- extension_name = {\n    --   extension_config_key = value,\n    -- }\n    -- please take a look at the readme of the extension you want to configure\n  }\n}\n```\n\nTo look at what default configuration options exist please read: `:help\ntelescope.setup()`. For picker specific `opts` please read: `:help\ntelescope.builtin`.\n\nTo embed the above code snippet in a `.vim` file\n(for example in `after\u002Fplugin\u002Ftelescope.nvim.vim`),\nwrap it in `lua \u003C\u003C EOF code-snippet EOF`:\n\n```lua\nlua \u003C\u003C EOF\nrequire('telescope').setup{\n  -- ...\n}\nEOF\n```\n\n## Default Mappings\n\nMappings are fully customizable.\nMany familiar mapping patterns are set up as defaults.\n\n| Mappings       | Action                                                    |\n| -------------- | --------------------------------------------------------- |\n| `\u003CC-n>\u002F\u003CDown>` | Next item                                                 |\n| `\u003CC-p>\u002F\u003CUp>`   | Previous item                                             |\n| `j\u002Fk`          | Next\u002Fprevious (in normal mode)                            |\n| `H\u002FM\u002FL`        | Select High\u002FMiddle\u002FLow (in normal mode)                   |\n| `gg\u002FG`         | Select the first\u002Flast item (in normal mode)               |\n| `\u003CCR>`         | Confirm selection                                         |\n| `\u003CC-x>`        | Go to file selection as a split                           |\n| `\u003CC-v>`        | Go to file selection as a vsplit                          |\n| `\u003CC-t>`        | Go to a file in a new tab                                 |\n| `\u003CC-u>`        | Scroll up in preview window                               |\n| `\u003CC-d>`        | Scroll down in preview window                             |\n| `\u003CC-f>`        | Scroll left in preview window                             |\n| `\u003CC-k>`        | Scroll right in preview window                            |\n| `\u003CM-f>`        | Scroll left in results window                             |\n| `\u003CM-k>`        | Scroll right in results window                            |\n| `\u003CC-\u002F>`        | Show mappings for picker actions (insert mode)            |\n| `?`            | Show mappings for picker actions (normal mode)            |\n| `\u003CC-c>`        | Close telescope (insert mode)                             |\n| `\u003CEsc>`        | Close telescope (in normal mode)                          |\n| `\u003CTab>`        | Toggle selection and move to next selection               |\n| `\u003CS-Tab>`      | Toggle selection and move to prev selection               |\n| `\u003CC-q>`        | Send all items not filtered to quickfixlist (qflist)      |\n| `\u003CM-q>`        | Send all selected items to qflist                         |\n| `\u003CC-r>\u003CC-w>`   | Insert cword in original window into prompt (insert mode) |\n| `\u003CC-r>\u003CC-a>`   | Insert cWORD in original window into prompt (insert mode) |\n| `\u003CC-r>\u003CC-f>`   | Insert cfile in original window into prompt (insert mode) |\n| `\u003CC-r>\u003CC-l>`   | Insert cline in original window into prompt (insert mode) |\n\nTo see the full list of mappings, check out `lua\u002Ftelescope\u002Fmappings.lua` and the\n`default_mappings` table.\n\n**Tip**: you can use `\u003CC-\u002F>` and `?` in insert and normal mode, respectively, to show the actions mapped to your picker.\n\nMuch like [builtin pickers](#pickers), there are a number of\n[actions](https:\u002F\u002Fgithub.com\u002Fnvim-telescope\u002Ftelescope.nvim\u002Fblob\u002Fmaster\u002Flua\u002Ftelescope\u002Factions\u002Finit.lua)\nyou can pick from to remap your telescope buffer mappings, or create a new\ncustom action:\n\n```lua\n-- Built-in actions\nlocal transform_mod = require('telescope.actions.mt').transform_mod\n\n-- or create your custom action\nlocal my_cool_custom_action = transform_mod({\n  x = function(prompt_bufnr)\n    print(\"This function ran after another action. Prompt_bufnr: \" .. prompt_bufnr)\n    -- Enter your function logic here. You can take inspiration from lua\u002Ftelescope\u002Factions.lua\n  end,\n})\n```\n\nTo remap telescope mappings, please read `:help telescope.defaults.mappings`.\nTo do picker specific mappings, its suggested to do this with the `pickers`\ntable in `telescope.setup`. Each picker accepts a `mappings` table like its\nexplained in `:help telescope.defaults.mappings`.\n\n## Pickers\n\nBuilt-in functions. Ready to be bound to any key you like.\n\n### File Pickers\n\n| Functions             | Description                                                                                                                                                              |\n| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `builtin.find_files`  | Lists files in your current working directory, respects .gitignore                                                                                                       |\n| `builtin.git_files`   | Fuzzy search through the output of `git ls-files` command, respects .gitignore                                                                                           |\n| `builtin.grep_string` | Searches for the string under your cursor or selection in your current working directory                                                                                 |\n| `builtin.live_grep`   | Search for a string in your current working directory and get results live as you type, respects .gitignore. (Requires [ripgrep](https:\u002F\u002Fgithub.com\u002FBurntSushi\u002Fripgrep)) |\n\n### Vim Pickers\n\n| Functions                           | Description                                                                                                                                                 |\n| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `builtin.buffers`                   | Lists open buffers in current neovim instance                                                                                                               |\n| `builtin.oldfiles`                  | Lists previously open files                                                                                                                                 |\n| `builtin.commands`                  | Lists available plugin\u002Fuser commands and runs them on `\u003Ccr>`                                                                                                |\n| `builtin.tags`                      | Lists tags in current directory with tag location file preview (users are required to run ctags -R to generate tags or update when introducing new changes) |\n| `builtin.command_history`           | Lists commands that were executed recently, and reruns them on `\u003Ccr>`                                                                                       |\n| `builtin.search_history`            | Lists searches that were executed recently, and reruns them on `\u003Ccr>`                                                                                       |\n| `builtin.help_tags`                 | Lists available help tags and opens a new window with the relevant help info on `\u003Ccr>`                                                                      |\n| `builtin.man_pages`                 | Lists manpage entries, opens them in a help window on `\u003Ccr>`                                                                                                |\n| `builtin.marks`                     | Lists vim marks and their value                                                                                                                             |\n| `builtin.colorscheme`               | Lists available colorschemes and applies them on `\u003Ccr>`                                                                                                     |\n| `builtin.quickfix`                  | Lists items in the quickfix list                                                                                                                            |\n| `builtin.quickfixhistory`           | Lists all quickfix lists in your history and open them with `builtin.quickfix` or quickfix window                                                           |\n| `builtin.loclist`                   | Lists items from the current window's location list                                                                                                         |\n| `builtin.jumplist`                  | Lists Jump List entries                                                                                                                                     |\n| `builtin.vim_options`               | Lists vim options, allows you to edit the current value on `\u003Ccr>`                                                                                           |\n| `builtin.registers`                 | Lists vim registers, pastes the contents of the register on `\u003Ccr>`                                                                                          |\n| `builtin.autocommands`              | Lists vim autocommands and goes to their declaration on `\u003Ccr>`                                                                                              |\n| `builtin.spell_suggest`             | Lists spelling suggestions for the current word under the cursor, replaces word with selected suggestion on `\u003Ccr>`                                          |\n| `builtin.keymaps`                   | Lists normal mode keymappings                                                                                                                               |\n| `builtin.filetypes`                 | Lists all available filetypes                                                                                                                               |\n| `builtin.highlights`                | Lists all available highlights                                                                                                                              |\n| `builtin.current_buffer_fuzzy_find` | Live fuzzy search inside of the currently open buffer                                                                                                       |\n| `builtin.current_buffer_tags`       | Lists all of the tags for the currently open buffer, with a preview                                                                                         |\n| `builtin.resume`                    | Lists the results incl. multi-selections of the previous picker                                                                                             |\n| `builtin.pickers`                   | Lists the previous pickers incl. multi-selections (see `:h telescope.defaults.cache_picker`)                                                                |\n\n### Neovim LSP Pickers\n\n| Functions                               | Description                                                                                                                |\n| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| `builtin.lsp_references`                | Lists LSP references for word under the cursor                                                                             |\n| `builtin.lsp_incoming_calls`            | Lists LSP incoming calls for word under the cursor                                                                         |\n| `builtin.lsp_outgoing_calls`            | Lists LSP outgoing calls for word under the cursor                                                                         |\n| `builtin.lsp_document_symbols`          | Lists LSP document symbols in the current buffer                                                                           |\n| `builtin.lsp_workspace_symbols`         | Lists LSP document symbols in the current workspace                                                                        |\n| `builtin.lsp_dynamic_workspace_symbols` | Dynamically Lists LSP for all workspace symbols                                                                            |\n| `builtin.diagnostics`                   | Lists Diagnostics for all open buffers or a specific buffer. Use option `bufnr=0` for current buffer.                      |\n| `builtin.lsp_implementations`           | Goto the implementation of the word under the cursor if there's only one, otherwise show all options in Telescope          |\n| `builtin.lsp_definitions`               | Goto the definition of the word under the cursor, if there's only one, otherwise show all options in Telescope             |\n| `builtin.lsp_type_definitions`          | Goto the definition of the type of the word under the cursor, if there's only one, otherwise show all options in Telescope |\n\n### Git Pickers\n\n| Functions                    | Description                                                                                                                                                                                           |\n| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `builtin.git_commits`        | Lists git commits with diff preview, checkout action `\u003Ccr>`, reset mixed `\u003CC-r>m`, reset soft `\u003CC-r>s` and reset hard `\u003CC-r>h`                                                                        |\n| `builtin.git_bcommits`       | Lists buffer's git commits with diff preview and checks them out on `\u003Ccr>`                                                                                                                            |\n| `builtin.git_bcommits_range` | Lists buffer's git commits in a range of lines. Use options `from` and `to` to specify the range. In visual mode, lists commits for the selected lines                                                |\n| `builtin.git_branches`       | Lists all branches with log preview, checkout action `\u003Ccr>`, track action `\u003CC-t>`, rebase action`\u003CC-r>`, create action `\u003CC-a>`, switch action `\u003CC-s>`, delete action `\u003CC-d>` and merge action `\u003CC-y>` |\n| `builtin.git_status`         | Lists current changes per file with diff preview and add action. (Multi-selection still WIP)                                                                                                          |\n| `builtin.git_stash`          | Lists stash items in current repository with ability to apply them on `\u003Ccr>`                                                                                                                          |\n\n### Treesitter Picker\n\n| Functions            | Description                                       |\n| -------------------- | ------------------------------------------------- |\n| `builtin.treesitter` | Lists Function names, variables, ... using treesitter [`locals` queries](https:\u002F\u002Fgithub.com\u002Fnvim-treesitter\u002Fnvim-treesitter\u002Fblob\u002Fmain\u002FCONTRIBUTING.md#locals) |\n\n### Lists Picker\n\n| Functions          | Description                                                                                                                                                                               |\n| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `builtin.planets`  | Use the telescope...                                                                                                                                                                      |\n| `builtin.builtin`  | Lists Built-in pickers and run them on `\u003Ccr>`.                                                                                                                                            |\n| `builtin.reloader` | Lists Lua modules and reload them on `\u003Ccr>`.                                                                                                                                              |\n| `builtin.symbols`  | Lists symbols inside a file `data\u002Ftelescope-sources\u002F*.json` found in your rtp. More info and symbol sources can be found [here](https:\u002F\u002Fgithub.com\u002Fnvim-telescope\u002Ftelescope-symbols.nvim) |\n\n## Previewers\n\n| Previewers                          | Description                                               |\n| ----------------------------------- | --------------------------------------------------------- |\n| `previewers.vim_buffer_cat.new`     | Default previewer for files. Uses vim buffers             |\n| `previewers.vim_buffer_vimgrep.new` | Default previewer for grep and similar. Uses vim buffers  |\n| `previewers.vim_buffer_qflist.new`  | Default previewer for qflist. Uses vim buffers            |\n| `previewers.cat.new`                | Terminal previewer for files. Uses `cat`\u002F`bat`            |\n| `previewers.vimgrep.new`            | Terminal previewer for grep and similar. Uses `cat`\u002F`bat` |\n| `previewers.qflist.new`             | Terminal previewer for qflist. Uses `cat`\u002F`bat`           |\n\nThe default previewers are from now on `vim_buffer_` previewers. They use vim\nbuffers for displaying files and use tree-sitter or regex for file highlighting.\n\nThese previewers are using `vim.filetype` to guess the filetype for the\nselected file. The guessing is done by inspecting the filename, the head of the\nfile(shebang) and the tail of the file (modeline). If you have trouble with\nfiletype detection you should read `:help vim.filetype`.\n\nWe need to do it manually because we can't determine the filetype in the\ntraditional way: We don't do `bufload` and instead read the file asynchronously\nwith `vim.uv.fs_` and attach only a highlighter; otherwise the speed of the\npreviewer would slow down considerably.\n\nIf you want to configure the `vim_buffer_` previewer (e.g. you want the line to wrap), do this:\n\n```lua\nvim.api.nvim_create_autocmd(\"User\", {\n  pattern = \"TelescopePreviewerLoaded\",\n  callback = function(args)\n    if args.data.filetype ~= \"help\" then\n      vim.wo.number = true\n    elseif args.data.bufname:match(\"*.csv\") then\n      vim.wo.wrap = false\n    end\n  end,\n})\n```\n\nA data field is passed to the callback, which contains the filetype and the buffer name.\n\n```lua\n{\n  title: string, # preview window title\n  filetype: string,\n  bufname: string,\n}\n```\n\n## Sorters\n\n| Sorters                            | Description                                                     |\n| ---------------------------------- | --------------------------------------------------------------- |\n| `sorters.get_fuzzy_file`           | Telescope's default sorter for files                            |\n| `sorters.get_generic_fuzzy_sorter` | Telescope's default sorter for everything else                  |\n| `sorters.get_levenshtein_sorter`   | Using Levenshtein distance algorithm (don't use :D)             |\n| `sorters.get_fzy_sorter`           | Using fzy algorithm                                             |\n| `sorters.fuzzy_with_index_bias`    | Used to list stuff with consideration to when the item is added |\n\nA `Sorter` is called by the `Picker` on each item returned by the `Finder`. It\nreturns a number, which is equivalent to the \"distance\" between the current\n`prompt` and the `entry` returned by a `finder`.\n\n## Layout (display)\n\nLayout can be configured by choosing a specific `layout_strategy` and\nspecifying a particular `layout_config` for that strategy.\nFor more details on available strategies and configuration options,\nsee `:help telescope.layout`.\n\nSome options for configuring sizes in layouts are \"resolvable\". This means that\nthey can take different forms, and will be interpreted differently according to\nwhich form they take.\nFor example, if we wanted to set the `width` of a picker using the `vertical`\nlayout strategy to 50% of the screen width, we would specify that width\nas `0.5`, but if we wanted to specify the `width` to be exactly 80\ncharacters wide, we would specify it as `80`.\nFor more details on resolving sizes, see `:help telescope.resolve`.\n\nAs an example, if we wanted to specify the layout strategy and width,\nbut only for this instance, we could do something like:\n\n```lua\nrequire('telescope.builtin').find_files({layout_strategy='vertical',layout_config={width=0.5}})\n```\n\nIf we wanted to change the width for every time we use the `vertical`\nlayout strategy, we could add the following to our `setup()` call:\n\n```lua\nrequire('telescope').setup({\n  defaults = {\n    layout_config = {\n      vertical = { width = 0.5 }\n      -- other layout configuration here\n    },\n    -- other defaults configuration here\n  },\n  -- other configuration values here\n})\n```\n\n## Themes\n\nCommon groups of settings can be set up to allow for themes.\nWe have some built in themes but are looking for more cool options.\n\n![dropdown](https:\u002F\u002Fi.imgur.com\u002FSorAcXv.png)\n\n| Themes                | Description                                                                                 |\n| --------------------- | ------------------------------------------------------------------------------------------- |\n| `themes.get_dropdown` | A list like centered list. [dropdown](https:\u002F\u002Fi.imgur.com\u002FSorAcXv.png)                      |\n| `themes.get_cursor`   | [A cursor relative list.](https:\u002F\u002Fgithub.com\u002Fnvim-telescope\u002Ftelescope.nvim\u002Fpull\u002F878)        |\n| `themes.get_ivy`      | Bottom panel overlay. [Ivy #771](https:\u002F\u002Fgithub.com\u002Fnvim-telescope\u002Ftelescope.nvim\u002Fpull\u002F771) |\n\nTo use a theme, simply append it to a builtin function:\n\n```vim\nnnoremap \u003CLeader>f :lua require'telescope.builtin'.find_files(require('telescope.themes').get_dropdown({}))\u003Ccr>\n\" Change an option\nnnoremap \u003CLeader>f :lua require'telescope.builtin'.find_files(require('telescope.themes').get_dropdown({ winblend = 10 }))\u003Ccr>\n```\n\nOr use with a command:\n\n```vim\nTelescope find_files theme=dropdown\n```\n\nOr you can configure it in the pickers table in `telescope.setup`:\n\n```lua\nrequire('telescope').setup{\n  defaults = {\n    -- ...\n  },\n  pickers = {\n    find_files = {\n      theme = \"dropdown\",\n    }\n  },\n  extensions = {\n    -- ...\n  }\n}\n```\n\nThemes should work with every `telescope.builtin` function. If you wish to make\na theme, check out `lua\u002Ftelescope\u002Fthemes.lua`.\n\n## Vim Commands\n\nAll `telescope.nvim` functions are wrapped in `vim` commands for easy access,\ntab completions and setting options.\n\n```vim\n\" Show all builtin pickers\n:Telescope\n\n\" Tab completion\n:Telescope |\u003Ctab>\n:Telescope find_files\n\n\" Setting options\n:Telescope find_files prompt_prefix=🔍\n\n\" If the option accepts a Lua table as its value, you can use, to connect each\n\" command string, e.g.: find_command, vimgrep_arguments are both options that\n\" accept a Lua table as a value. So, you can configure them on the command line\n\"like so:\n:Telescope find_files find_command=rg,--ignore,--hidden,--files prompt_prefix=🔍\n```\n\nfor more information and how to realize more complex commands please read\n`:help telescope.command`.\n\n## Autocmds\n\nTelescope user autocmds:\n\n| Event                           | Description                                             |\n| ------------------------------- | ------------------------------------------------------- |\n| `User TelescopeFindPre`         | Do it before Telescope creates all the floating windows |\n| `User TelescopePreviewerLoaded` | Do it after Telescope previewer window is created       |\n| `User TelescopeResumePost`      | Do it after Telescope resume action is fully completed  |\n\n## Extensions\n\nTelescope provides the capabilities to create & register extensions, which\nimproves telescope in a variety of ways.\n\nSome extensions provide integration with external tools, outside of the scope of\n`builtins`. Others provide performance enhancements by using compiled C and\ninterfacing directly with Lua over LuaJIT's FFI library.\n\nA list of community extensions can be found in the\n[Extensions](https:\u002F\u002Fgithub.com\u002Fnvim-telescope\u002Ftelescope.nvim\u002Fwiki\u002FExtensions)\nwiki. Always read the README of the extension you want to install, but here is a\ngeneral overview of how most extensions work.\n\n### Loading extensions\n\nTo load an extension, use the `load_extension` function as shown in the example\nbelow:\n\n```lua\n-- This will load fzy_native and have it override the default file sorter\nrequire('telescope').load_extension('fzy_native')\n```\n\nYou may skip explicitly loading extensions (they will then be lazy-loaded), but\ntab completions will not be available right away.\n\n### Accessing pickers from extensions\n\nPickers from extensions are added to the `:Telescope` command under their\nrespective name. For example:\n\n```vim\n\" Run the `configurations` picker from nvim-dap\nTelescope dap configurations\n```\n\nThey can also be called directly from Lua:\n\n```lua\n-- Run the `configurations` picker from nvim-dap\nrequire('telescope').extensions.dap.configurations()\n```\n\n## API\n\nFor writing your own picker and for information about the API please read the\n[Developers Documentation](developers.md).\n\n## Media\n\n- [What is Telescope? (Video)](https:\u002F\u002Fwww.twitch.tv\u002Fteej_dv\u002Fclip\u002FRichDistinctPlumberPastaThat)\n- [More advanced configuration (Video)](https:\u002F\u002Fwww.twitch.tv\u002Fvideos\u002F756229115)\n- [telescope.nvim 0.1 reflection (Video)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=3WEAjCXFiiM)\n- [Why Telescope? (Video)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=8SqFt5h2Lsg)\n- [Telescope and Nvim 0.5 Intro (Video)](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=guxLXcG1kzQ)\n\n## Contributing\n\nAll contributions are welcome! Just open a pull request.\nPlease read [CONTRIBUTING.md](.\u002FCONTRIBUTING.md)\n\n## Related Projects\n\n- [snacks.picker](https:\u002F\u002Fgithub.com\u002Ffolke\u002Fsnacks.nvim\u002Fblob\u002Fmain\u002Fdocs\u002Fpicker.md)\n- [mini.pick](https:\u002F\u002Fgithub.com\u002Fnvim-mini\u002Fmini.pick)\n- [fzf-lua](https:\u002F\u002Fgithub.com\u002Fibhagwan\u002Ffzf-lua)\n- [fzf.vim](https:\u002F\u002Fgithub.com\u002Fjunegunn\u002Ffzf.vim)\n- [denite.nvim](https:\u002F\u002Fgithub.com\u002FShougo\u002Fdenite.nvim)\n- [vim-clap](https:\u002F\u002Fgithub.com\u002Fliuchengxu\u002Fvim-clap)\n","telescope.nvim 是一个基于 Neovim 的高度可扩展的模糊查找工具，专为处理列表数据而设计。它利用了 Neovim 最新的强大功能，并且完全用 Lua 编写，以模块化为核心，便于用户自定义选择器、排序器和预览器。项目支持多种内置与社区驱动的功能插件，如文件搜索、实时代码搜索等，并且能够通过安装额外的依赖（例如 ripgrep 或 fd）来进一步提升性能。适用于需要在 Neovim 中快速定位文件、代码片段或其他信息的开发者场景中，极大地提高了工作效率。",2,"2026-06-11 03:34:23","high_star"]