metascope.nvim | Domiziano

A Neovim plugin built on top of Telescope that keeps a tidy history of every file you find, every grep you run, and every buffer you open, then takes you straight back to the exact file you opened last time, in a single keystroke.

What It Does

01
Opens to your recent files:
Shows the files you actually work with first, then your whole project as soon as you start typing.
02
Smarter grep:
Starts from your recent searches, then becomes a live grep the moment you type.
03
A searchable history:
A dashboard of everything you've searched, with a live preview, that jumps right back to the file you opened from it.
04
Remembers across sessions and projects:
History follows you between Neovim restarts and across projects, surfacing what's relevant to where you are.

Core API

→ metascope.hybrid() — recent files first, the whole project as you type.
→ metascope.hybrid_grep() — recent searches first, live grep as you type.
→ metascope.history_picker() — the full searchable history dashboard.
→ Custom pickers (LSP symbols, git files, …) can be registered via metascope.register_type() so they get history too.

No setup call is required — sensible defaults apply on load, with max_history, ranking decay (half_life_days), and a current-project boost (cwd_boost) all configurable. Written in Lua, MIT licensed, installable with lazy.nvim or packer.nvim.

Inspired by Atuin, which gives shell history magical search and sync — metascope.nvim brings that same "never lose what you searched for" feeling to Telescope.