You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
blob42 7efc6653ec fix for nvim 0.9+ 4 months ago
.github/workflows ci: bump action versions 12 months ago
after/ftplugin feat: add omnifunc for query filetype 3 years ago
lua fix for nvim 0.9+ 4 months ago
plugin feat!: update to Neovim 0.7 APIs (#75) 2 years ago
queries/query Query linter: update queries 2 years ago
syntax refactor(printer): integrate injected languages 3 years ago
.editorconfig Initial commit 3 years ago
.luacheckrc Add CI checks 2 years ago
.stylua.toml Add CI checks 2 years ago
LICENSE Initial commit 3 years ago docs: Add note about query linter assumptions 11 months ago

Neovim Treesitter Playground

View treesitter information directly in Neovim!




Install the plugin (vim-plug shown):

Plug 'nvim-treesitter/nvim-treesitter'
Plug 'nvim-treesitter/playground'

It's also recommended that you install the query parser for query editor highlighting. Run this after installing the above plugins.

:TSInstall query

The configuration is like any other nvim-treesitter module.

require "nvim-treesitter.configs".setup {
  playground = {
    enable = true,
    disable = {},
    updatetime = 25, -- Debounced time for highlighting nodes in the playground from source code
    persist_queries = false, -- Whether the query persists across vim sessions
    keybindings = {
      toggle_query_editor = 'o',
      toggle_hl_groups = 'i',
      toggle_injected_languages = 't',
      toggle_anonymous_nodes = 'a',
      toggle_language_display = 'I',
      focus_language = 'f',
      unfocus_language = 'F',
      update = 'R',
      goto_node = '<cr>',
      show_help = '?',


The tree can be toggled using the command :TSPlaygroundToggle.


  • R: Refreshes the playground view when focused or reloads the query when the query editor is focused.
  • o: Toggles the query editor when the playground is focused.
  • a: Toggles visibility of anonymous nodes.
  • i: Toggles visibility of highlight groups.
  • I: Toggles visibility of the language the node belongs to.
  • t: Toggles visibility of injected languages.
  • f: Focuses the language tree under the cursor in the playground. The query editor will now be using the focused language.
  • F: Unfocuses the currently focused language.
  • <cr>: Go to current node in code buffer

Query Editor

Press o to show the query editor. Write your query like (node) @capture, put the cursor under the capture to highlight the matches.


When you are on a query buffer, you can get a list of suggestions with Ctrl-X Ctrl-O. See :h 'omnifunc'.

Query Linter

The playground can lint query files for you. For that, you need to activate the query_linter module:

require "nvim-treesitter.configs".setup {
  query_linter = {
    enable = true,
    use_virtual_text = true,
    lint_events = {"BufWrite", "CursorHold"},

Note: Query linter assumes certain directory structure to identify which language queries belong to. It expect query files to be under ./queries/<language_name>


Show treesitter and syntax highlight groups under the cursor

The playground comes with :TSHighlightCapturesUnderCursor that shows any treesitter or syntax highlight groups under the cursor.

Show treesitter node under the cursor

If you only wish to view information about the node your cursor is currently on (without having to open up the full tree), you can use :TSNodeUnderCursor instead. A floating window containing information about the parser, node name and row/col ranges will be shown.