v0.4.0 beta

[bassamsdata]

🚀 New Modules in namu.nvim: watchtower, diagnostics, workspace, call hierarchy, ctags, ctags watchtower

Three new modules have landed in namu.nvim, along with a Ctags-powered variant:

Big thanks to @idr4n for thoroughly testing the new modules ahead of the release and for his new ideas!

⸻

🔭 watchtower

• Lists symbols from all open buffers, regardless of filetype or location
• Respects symbol hierarchy — even after filtering, parent/child relationships are preserved
• Perfect for jumping around large projects, even polyglot ones
• Fallback to treesitter if lsp not found for a buffer
• Support live filtering with preserve buffer names via eg: /fn or /bf: for buffer names [see below]

buffer_filtering.mp4

🗺️ workspace

• Fully interactive symbol picker for the current workspace
• Results appear as you type, with live preview

workspace.mp4

🩺 diagnostics

• View and filter diagnostics by severity (Error, Warn, Info, Hint)
• Includes symbol context, icons, and custom highlights
• Actions: yank, delete, open in split, or send to CodeCompanion
• Ability to filter be severity like /er for errors, /wa for warnings, /hi for hints and so on.

diagnostics.mp4

📞 call hierarchy

• Navigate incoming/outgoing call trees using LSP
• Supports recursion, max depth, and cycle detection
• Optional: sort calls by nesting depth

call_hierarchy.mp4

🏷️ ctags_watchtower

• Same as watchtower, but powered by ctags
• Great for filetypes with no/weak LSP
• Also includes a buffer-local ctags module

ctags.mp4

⸻

🔍 Live Filtering

All modules support live filtering:
• /fn:init → filter by kind + name
• /bf:main.lua → filter by buffer name
• /bf:main:doSomething → combine buffer and symbol filters

buffer_filtering.mp4

⸻

🌲 Preserve Hierarchy + Tree View

To keep parent/child relationships intact even after filtering.

⸻

📎 Actions & CodeCompanion

• CodeCompanion integration: send symbol(s) or diagnostics into chat
  • now includes functions/methods with their line numbers
  • for Lua: also captures Lua annotations above functions and sends them too
  • for diagnostics: sends the symbol’s text as context, along with details about the error/warning

codecompanion.mp4

Most modules support actions like:
• Vertical/horizontal splits
• Yank/delete (multi-select supported)

⸻

📄 Docs

Each module has its own config section with examples and screenshots:
➡️ See the docs directory.

⸻

As always, feedback is welcome — let me know what breaks or feels off!

---

This discussion was created from the release v0.4.0 beta.

[LintaoAmons]

what's the term you're using in the demo videos? It looks so smooth

[bassamsdata]

Hey,
I'm using neovide as my main GUI.

[olimorris]

Congrats on this release! Supremely powerful and the workspace feature is incredible. Going to save so much time!

[bassamsdata]

Thank you for the kind words! really appreciate it!

The interactive workspace used to be my favorite, at least until I made Watchtower for open buffers 🙂

[przepompownia]

Thanks for creating this tool! I tried several symbol plugins for years, but often switched back to use quickfix window (+bqf and (if fuzzy needed) telescope - both rather not actively maintained for long time).

Input ready at the start, fuzzy search and using float window (as opposed to split-based UI) is what I need.

Another advantage for me is that the only dependencies are symbol providers: it's standalone - no need to install additional plugins (or even the whole set of tools like in some popular alternative).

[bassamsdata]

Thanks a lot for the kind words, really appreciate it! It means a lot to hear that the plugin fits your workflow, especially after trying so many other tools for long time.