Treetags: A Modern, Tree-Sitter Powered Code Navigation Tool for Vim

For years, Vim and Neovim users have relied on tag generators like Universal Ctags to jump to function definitions and other symbols. While battle-tested, these tools often use regular-expression matching that can struggle with modern language syntax. Treetags, a new open-source project, takes a different approach: it builds on tree-sitter, the incremental parsing library, to provide code navigation that is both fast and accurate across many languages.

What makes treetags different?

Treetags leverages tree-sitter's syntax trees to identify tags. This means it understands the structure of your code, not just text patterns, reducing false positives and improving reliability. The project is also multithreaded, parsing multiple files simultaneously to generate a tags file quickly, even on large codebases.

Another standout feature is its extensibility through WASM plugins. While many languages are supported out of the box, users can add new language support—Kotlin, for instance—by providing a tree-sitter grammar and a tags query. This is a significant step forward in maintainability, as plugins can be updated independently of the main tool.

Getting started

Installing treetags is straightforward. You'll need Rust and a C development toolchain, plus the wasm32-wasip2 target for rustc. Then, clone the repo and build:

cargo install --path .

Once built, you can generate a tags file for a project and integrate it with Vim or Neovim using the gutentags plugin, which automatically updates tags files as you edit. Users report this combination feels seamless, with navigation working smoothly.

Treetags vs. LSP

A common question is why not just use an LSP for code navigation. An LSP provides rich features like go-to-definition and find references, but it requires a language server to be running, which can be heavy. Tags files are lighter and work offline, making them a good complement for quick jumps. Treetags itself works alongside LSPs; the tag file is not a replacement but another tool in your arsenal.

Treetags is young and maintained by a single developer, so it's not as battle-tested as Universal Ctags. But its design choices—tree-sitter, WASM plugins, and parallelism—offer a compelling glimpse into the future of code navigation in the Vim ecosystem. If you're a Vim/Neovim power user, it's worth trying, especially if you work with multiple languages or large codebases.