Skip to content

Neo-tree Extra

editor.neotree adds Neo-tree as an optional sidebar explorer. It does not replace Blak’s default Oil explorer on <leader>e; it adds Neo-tree on <leader>E.

Enable it

-- ~/.config/blak/lua/blak/user.lua
return {
extras = {
enabled = {
"editor.neotree",
},
},
}

Because this extra adds a plugin, run:

:BlakExtras sync

What it adds

SurfaceContribution
Pluginnvim-neo-tree/neo-tree.nvim on branch v3.x
Dependenciesplenary.nvim, mini.icons, nui.nvim
Keymap<leader>E toggles Neo-tree
DefaultsFollow current file and use libuv file watcher

The keymap appears in :BlakKeys.

user.lua configuration

Opt into the extra:

return {
extras = {
enabled = { "editor.neotree" },
},
}

Oil remains the configured explorer unless you also change explorer settings:

return {
explorer = {
provider = "oil",
},
extras = {
enabled = { "editor.neotree" },
},
}

Blak does not expose a Neo-tree options table in user.lua. For a custom Neo-tree layout, create a local extra with your own neo-tree.nvim spec.

Use it

<leader>E
:Neotree reveal

Disable it with :BlakExtras disable editor.neotree, then run :BlakExtras sync and restart.