diff --git a/AGENTS.md b/AGENTS.md
index e3b4fb9d..89b16428 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -109,6 +109,8 @@ The Quickshell desktop runs as a single long-running process out of
 not start additional standalone `quickshell -p` instances for individual
 components.
 
+Run `omarchy restart shell` after making changes to QML files.
+
 Plugin contract:
 
 - Each plugin lives in its own directory under