From 4f1a05da7b946ecb96e5cadedd785620cee684b4 Mon Sep 17 00:00:00 2001
From: Barrett Ruth <62671086+barrettruth@users.noreply.github.com>
Date: Tue, 30 Jun 2026 13:58:58 -0500
Subject: [PATCH] fix(dir): use `nvim.dir` augroup #40507

---
 runtime/doc/plugins.txt | 5 +++++
 runtime/plugin/dir.lua  | 3 ++-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/runtime/doc/plugins.txt b/runtime/doc/plugins.txt
index 95616834d2..5d2dc30c34 100644
--- a/runtime/doc/plugins.txt
+++ b/runtime/doc/plugins.txt
@@ -48,6 +48,11 @@ Builtin plugin: dir                                                      *dir*
 Nvim opens a directory listing when |:edit| is used with a directory path.  The
 listing is a buffer with 'filetype' set to "directory".
 
+To disable the built-in directory browser, delete its autocommand group from an
+after/plugin file: >lua
+	vim.api.nvim_del_augroup_by_name('nvim.dir')
+<
+
 Mappings:                                                       *dir-mappings*
 >
 	-	Open the parent directory of the current file or directory.
diff --git a/runtime/plugin/dir.lua b/runtime/plugin/dir.lua
index f17ed194d1..bc05cd646d 100644
--- a/runtime/plugin/dir.lua
+++ b/runtime/plugin/dir.lua
@@ -33,7 +33,8 @@ local function should_open(buf, path)
   return vim.fn.isdirectory(path) == 1
 end
 
-local group = api.nvim_create_augroup('FileExplorer', { clear = true })
+api.nvim_create_augroup('FileExplorer', { clear = true })
+local group = api.nvim_create_augroup('nvim.dir', { clear = true })
 -- Latch on our own VimEnter, not v:vim_did_enter (set just before VimEnter
 -- autocmds), so an earlier VimEnter autocmd's BufEnter can't preempt startup.
 local vimentered = vim.v.vim_did_enter == 1