error311

error311 / wayfinder.nvim

Public

Guided code exploration for Neovim - definitions, refs, callers, tests, git, and a trail from the current symbol

code-navigation developer-tools lsp lua neovim
15
0
100% credibility
Found Apr 24, 2026 at 15 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Lua
AI Summary

wayfinder.nvim is a guided exploration tool for Neovim that displays definitions, references, callers, tests, and recent commits related to the current code symbol in a three-pane interactive picker.

How It Works

1
💡 Discover Wayfinder

While working on code and wondering where a function is used, you learn about Wayfinder, a friendly guide that gathers related code spots for you.

2
📥 Add it easily

You simply add Wayfinder to your coding setup, and it's ready with minimal changes.

3
🖱️ Open on a word

Hover your text pointer over any function or word in your code and launch Wayfinder.

4
✨ Magic window appears

A beautiful centered view opens with handy sections for connections, mentions, tests, changes, and previews of everything.

5
🔍 Explore sections

Switch between sections, scroll through lists, peek at code snippets, and pin favorites to build a personal trail.

6
🚀 Jump anywhere

Pick any item and instantly jump to that spot in your code, seeing it highlighted.

🎉 Code feels simple

You now effortlessly navigate your entire project, finding definitions, tests, and history without frustration.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 15 to 15 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is wayfinder.nvim?

wayfinder.nvim is a Lua plugin for Neovim 0.10+ that launches guided code exploration from your cursor's symbol or current file, surfacing definitions, callers, references via LSP or text matches, heuristic tests, and recent git commits. It pops up a centered 3-pane picker with facet tabs (Calls, Refs, Tests, Git, Trail), syntax previews, and async loading, letting you filter, jump, split, or pin items to a breadcrumb trail. Perfect for ditching the tedious jump-grep-back dance in codebases.

Why is it gaining traction?

Unlike Telescope or grep tools, it hyper-focuses on the symbol under your cursor with ranked, grouped results and a trail for chaining explorations—pin a caller, then its def, without losing context. The dense UI packs badges, counts, mouse support, and vim-like keys (h/l facets, p pin, / filter) into a non-modal float. Devs dig the progressive load and LSP/git integration that feels snappy even in guided code generation workflows.

Who should use this?

Neovim users with LSP setups navigating mid-sized TypeScript, Lua, or JS projects, especially backend devs tracing callers in services or frontend folks hunting refs across components. Ideal for anyone refactoring functions amid tests and git history, skipping broad searches.

Verdict

Try it if you're deep in symbol-heavy code—solid demo fixture and :checkhealth make onboarding easy, despite 15 stars and 1.0% credibility signaling early days. Polish the config for your layout, but expect reliable basics over flashy maturity.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.