# telescope.nvim

Find, Filter, Preview, Pick. All lua, all the time.

Repository: https://github.com/nvim-telescope/telescope.nvim
Canonical: https://ross.abutalabs.com/products/telescopenvim
Language: Lua
License: MIT
License Family: permissive
Topics: neovim, lua, nvim-lua, nvim, neovim-plugin
Last push: 2026-08-17T10:56:32+00:00

## Health v2 (maintenance only)
Score: 86/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 63, longevity 100
- inputs: {"age_days": 2240, "days_push": 16, "days_rel": 245, "gap_med": 26.5, "n_releases_24m": 3}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 19733, forks 961 (observed 2026-08-28T04:11:29.128291+00:00)

## What it is
Telescope.nvim is a highly extendable fuzzy finder plugin for Neovim, written entirely in Lua, that lets users find, filter, preview, and pick from lists such as files, buffers, and grep results. It is modular and extensible with community-built pickers, sorters, previewers, and extensions.

## Use cases
- fuzzy find files in neovim
- live grep across a project from the editor
- search and switch between open buffers
- browse and preview files with a file picker
- extend neovim with custom pickers and sorters
- speed up fuzzy sorting with a native fzf sorter

## When to choose
- you use Neovim and want a fast, customizable fuzzy finder
- you need modular pickers, sorters, and previewers in Lua
- you want a large ecosystem of community extensions

## When to avoid
- you don't use Neovim
- you need a standalone CLI fuzzy finder outside the editor
- your Neovim version is older than the required minimum

## Facets
- artifact type: plugin
- maturity: stable
- function: search-engine, developer-tools, cli
- domain: developer-tools, text-editors
- platform: editor-plugin, cross-platform
- tags: neovim, fuzzy-finder, lua, pickers, fzf, command-line

## Member repositories
- nvim-telescope/telescope.nvim (main) score 86
- nvim-telescope/telescope-file-browser.nvim (plugin) score 48
- nvim-telescope/telescope-fzf-native.nvim (plugin) score 69

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:29.128291+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T16:59:52.374324+00:00, confidence not recorded.
  - readme: https://github.com/nvim-telescope/telescope.nvim (fetched 2026-08-28T04:11:29.128291+00:00, sha c0f7a3cd1a46)
- Data as of 2026-08-30T08:39:29.467469+00:00.