tree-sitter-manager.nvim

The plugin provides several commands and a TUI (Text User Interface) for managing parsers.

Commands

• :TSManager: Open the parser management interface.
• :TSInstall <lang>: Install specific parsers.
• :TSUninstall <lang>: Uninstall specific parsers.
• :TSUpdate: Update parsers (use ! to force update all).

TUI Keybindings

When the :TSManager window is open, use these keys:

• i: Install parser under cursor
• x: Remove parser under cursor
• u: Update parser under cursor
• r: Refresh installation status
• q or <Esc>: Close window

To use this plugin, ensure the following requirements are met:

Mandatory

• Neovim 0.12+
• tree-sitter CLI (must be in your $PATH)
• git
• C compiler (e.g., gcc or clang)

Optional

• Nerd Font: Required for proper display of icons (✅, ❌, 📦) in the TUI.

Install the plugin using your preferred Neovim plugin manager. Note that the tree-sitter CLI must be installed system-wide for the plugin to function.

lazy.nvim

{
  "romus204/tree-sitter-manager.nvim",
  dependencies = {},
  config = function()
    require("tree-sitter-manager").setup()
  end,
}

vim.pack

vim.pack.add {
  { src = "https://github.com/romus204/tree-sitter-manager.nvim" }
}

require("tree-sitter-manager").setup()

To automatically install missing parsers when opening a new filetype, set auto_install = true. You can prevent specific languages from being auto-installed using the noauto_install list.

require("tree-sitter-manager").setup({
  auto_install = true,
  noauto_install = {
    "c", "lua", "markdown", "markdown_inline", "query", "vim", "vimdoc"
  },
})

Use the setup() function to configure parser directories, installation behavior, and highlighting.

Default Options

require("tree-sitter-manager").setup({
  parser_dir = vim.fn.stdpath("data") .. "/site/parser",
  query_dir = vim.fn.stdpath("data") .. "/site/queries",
  assume_installed = {}, -- blacklist languages
  ensure_installed = {}, -- parsers to install at startup
  auto_install = false, -- auto-install when a new filetype is encountered
  noauto_install = {}, -- blacklist from auto_install
  highlight = true, -- enable treesitter highlighting (use list to whitelist)
  nohighlight = {}, -- blacklist from highlight
  languages = {}, -- override or add new parser sources
  nerdfont = true, -- use Nerd Font icons in the manager UI
  border = "rounded", -- border style for the TUI window
  min_width = 78, -- minimum size of the TUI
  min_height = 40,
})

You can control how Treesitter highlighting is applied via the highlight and nohighlight options.

Opt-out approach (Blacklist)

Use nohighlight to specify languages that should use standard regex highlighting instead of Treesitter.

require("tree-sitter-manager").setup({
  nohighlight = { "yaml", "zsh" },
})

Opt-in approach (Whitelist)

Use highlight to specify only the languages that should use Treesitter highlighting. If highlight is an empty table {}, all Treesitter highlighting is disabled.

require("tree-sitter-manager").setup({
  highlight = { "lua", "c" },
})

When writing tests for this project, use the helper module at tests/child.lua to spawn and run tests in an isolated Neovim child process. This is required for testing asynchronous functions.

Global Variables

• _G.languages: The list of languages passed via make test ....
• eq, neq, er, ner: Aliases for MiniTest.expect (equality, no_equality, error, no_error).
• child: require("tests.child").
• tsm: require("tree-sitter-manager").
• config: require("tree-sitter-manager.config").
• installer: require("tree-sitter-manager.installer").

Global Functions

• new_set(opts, tbl): A wrapper for MiniTest.new_set(opts, tbl) that includes default hooks for child.setup() and child.cleanup().
• parametrize(list): Wraps every item in a list into a singleton table, useful for parameterizing tests.