// 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
Share

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

  1. FIX 1Install the tools

    1. 01Install ripgrep and fd with brew, apt, pacman or winget
    2. 02Run rg --version in your shell and from :!rg --version
    Did this fix it?
  2. FIX 2Run the health check

    1. 01Run :checkhealth telescope
    2. 02Fix any missing dependency it lists, including plenary.nvim
    Did this fix it?
  3. FIX 3Fix preview errors

    1. 01Update telescope.nvim and nvim-treesitter together
    2. 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 us

Watch Neovim Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other Neovim errors

All 16 Neovim errors and fixes →