aboutsummaryrefslogtreecommitdiffstats
path: root/AGENTS.md
diff options
context:
space:
mode:
Diffstat (limited to 'AGENTS.md')
-rw-r--r--AGENTS.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
index 138148f..83c1b2d 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -308,6 +308,14 @@ the whole screen use `ExclusionMode.Ignore`.
| a component's QML | quickshell hot-reloads on save; no restart |
| palette | regenerate with `udt-accent <wallpaper>`; watched, no restart |
| Hyprland binds, layer rules, autostart | `hyprctl reload` |
+| a running shell in a bad state | `./reload.sh [component...]`, from the user's terminal |
+
+`reload.sh` restarts components rather than hot-reloading them. The volume OSD
+once drew only its label, with the icon, bar and device line clipped off, and
+a hot reload fixed it while the code and the layout both measured correct, so
+the stuck state lived in the running process. Do not run the script from an
+agent's tool call: the detached `qs` it starts dies with the call (see
+Verifying above), which leaves the user's desktop without its shells.
Hot reload covers adding and removing windows too: the keepalive window above
was added to a running shell and took effect on save.