False warning: treesitter parser was not found

[IstiCusi]

Title:
False warning: "norg / norg_meta treesitter parser was not found" despite parsers being installed and working

Body:

Description

Neorg emits the warning:

norg treesitter parser was not found! Many plugin features will not work.
norg_meta treesitter parser was not found! Many plugin features will not work.

However, both parsers (norg and norg_meta) are correctly installed and fully functional via nvim-treesitter.

Expected behavior

No warning should be shown when:

• parsers exist in runtimepath (parser/*.so)
• vim.treesitter.language.add() works
• highlighting and features function correctly

Actual behavior

Neorg reports missing parsers even though:

• :checkhealth nvim-treesitter shows them as installed
• vim.treesitter.language.add("norg") works
• vim.treesitter.language.add("norg_meta") works
• highlighting and Neorg features work correctly

Root cause (analysis)

The issue originates from:

neorg/modules/core/integrations/treesitter/module.lua

Specifically:

package.searchpath("parser." .. lang, package.cpath)

This relies on package.cpath, which does not reflect how nvim-treesitter manages parsers (runtimepath-based).

Result:
Parsers exist and work, but Neorg fails to detect them → false negative.

Workaround

Disabling Neorg’s parser handling removes the warning:

["core.integrations.treesitter"] = {
config = {
configure_parsers = false,
warn_missing_parsers = false,
},
}

Environment

• Neovim: 0.12.1
• nvim-treesitter: latest
• Neorg: latest stable
• OS: Linux (Ubuntu 24.04)

[NikhilSaini38]

same happened with my setup, asked qwen 3.6 to look at it. This is what it came up with.

1. Symlinks lazy-rocks/tree-sitter-norg/lib/lua/5.1/parser/norg.so → site/parser/norg.so
2. Symlinks lazy-rocks/tree-sitter-norg-meta/lib/lua/5.1/parser/norg_meta.so → site/parser/norg_meta.so
3. Registers both parsers with vim.treesitter.language.register
   This is needed because lazy-rocks installs the parsers in a nested path that neovim's vim.api.nvim_get_runtime_file("parser/> *.so") doesn't find

and this is the fix it implemented.

local function setup_norg_parsers()
    local lazy_rocks = vim.fn.stdpath("data") .. "/lazy-rocks"
    local site_parser = vim.fn.stdpath("data") .. "/site/parser"
    vim.fn.mkdir(site_parser, "p")
    local parsers = {
        { "tree-sitter-norg", "norg" },
        { "tree-sitter-norg-meta", "norg_meta" },
    }
    for _, pkg in ipairs(parsers) do
        local src = lazy_rocks .. "/" .. pkg[1] .. "/lib/lua/5.1/parser/" .. pkg[2] .. ".so"
        local dst = site_parser .. "/" .. pkg[2] .. ".so"
        if vim.uv.fs_stat(src) and not vim.uv.fs_stat(dst) then
            vim.fn.symlink(src, dst)
        end
    end
    for _, pkg in ipairs(parsers) do
        pcall(vim.treesitter.language.register, pkg[2], ".norg")
    end
end
return {
    "nvim-neorg/neorg",
    lazy = false,
    version = "*",
    config = function()
        setup_norg_parsers()
        require("neorg").setup({})
    end,
}

(I am a new user of nvim and lua, so i used my local llm for this )

[rmercer33]

I installed Neorg yesterday and had no problem. Today though, I get the "norg / norg_meta treesitter parser was not found" message. But it doesn't always happen. Maybe three or four times when I start nvim the error happens then the next tiime it works fine. The fixes mentioned above did not work for me.