From b7fd4278bc3edb943c0f03d659fa8f010357047d Mon Sep 17 00:00:00 2001
From: slowsage <84777606+slowsage@users.noreply.github.com>
Date: Thu, 5 Feb 2026 17:54:34 -0500
Subject: [PATCH] feat(reference): AstroUpdateCompleted usage for headless
 update

---
 src/content/docs/reference/autocmds.mdx | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/content/docs/reference/autocmds.mdx b/src/content/docs/reference/autocmds.mdx
index 67e2d15fa..c7083c8b5 100644
--- a/src/content/docs/reference/autocmds.mdx
+++ b/src/content/docs/reference/autocmds.mdx
@@ -42,7 +42,10 @@ Neovim autocmd events, check the help page with `:h autocmd-events`.
 - `AstroUpdateCompleted`: AstroNvim provides a custom command for easily
   updating all plugins and packages using `:AstroUpdate`.
   `AstroUpdateCompleted` is triggered after all of the available updates have
-  been applied.
+  been applied. Useful for headless updates:
+  ```bash
+  nvim --headless -c "autocmd User AstroUpdateCompleted quitall" -c "AstroUpdate"
+  ```
 
 - `AstroRenameFilePre`: AstroCore provides a `rename_file` method for easily
   renaming files. `AstroRenameFilePre` is triggered immediately prior to