// troubleshooting guide · neovim
Neovim Telescope Not Working (live_grep, find_files)
- Status
- Workaround available
- platforms:
- Windows, macOS, Linux
- updated:
- November 21, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · neovim/telescope-not-working3 FIXES
// quick answer
Telescope's live_grep needs ripgrep and find_files works best with fd. Install them, confirm they are on PATH, and check :checkhealth telescope.
Most likely fix: Install the tools
How to fix it
// try these in order, the most common fix is first
FIX 1Install the tools
- 01Install ripgrep and fd with brew, apt, pacman or winget
- 02Run rg --version in your shell and from :!rg --version
Did this fix it?FIX 2Run the health check
- 01Run :checkhealth telescope
- 02Fix any missing dependency it lists, including plenary.nvim
Did this fix it?FIX 3Fix preview errors
- 01Update telescope.nvim and nvim-treesitter together
- 02Disable preview temporarily with previewer = false to confirm the cause
Did this fix it?
SANDBOX · neovim RUNS IN YOUR BROWSER
Try it: edit code in a Neovim-style modal editor
A hands-on Neovim-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
live_grep does nothing, 'You need to install ripgrep' error, previews are blank or errors on opening the picker.
Why it happens
- C-01ripgrep (rg) not installed or not on PATH
- C-02fd missing so find_files falls back to slow find
- C-03Previewer treesitter errors after a treesitter rewrite
- C-04Plugin dependency plenary.nvim missing
// this guide also covers
- neovim telescope not working
- telescope live_grep not working
- telescope ripgrep not found
Still not working?
If Neovim keeps failing, you're not alone. See every Neovim problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usOther Neovim errors
- Neovim LSP Not Working or Not Attaching
- require('lspconfig') Is Deprecated Warning in Neovim
- Neovim Treesitter Highlighting Not Working
- Neovim Clipboard Not Working (clipboard: No provider)
- Neovim Colors Wrong in tmux
- Neovim Escape Key Delay in tmux
- Mason Failed to Install Language Server in Neovim
- Why Is Neovim So Slow? (Startup Lag and Large Files)