aboutsummaryrefslogtreecommitdiffstats
path: root/AGENTS.md
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-09-25 12:21:12 +0200
committerDanilo M. <danix@danix.xyz>2026-09-25 12:21:12 +0200
commit30bebb6f36cc32fdeac03d4848635a1911ebcdd8 (patch)
treeddff8e32890b5f7b6caaab403318bcf54229591c /AGENTS.md
parentd0a946798700cc0dea6d338296f1cffa413d2541 (diff)
downloadquickshell-30bebb6f36cc32fdeac03d4848635a1911ebcdd8.tar.gz
quickshell-30bebb6f36cc32fdeac03d4848635a1911ebcdd8.zip
feat: reload.sh restarts quickshell components
The volume OSD drew only its "Output 72%" label, with the icon, bar and device line clipped below the panel edge. The code and the theme were not at fault: a hot reload fixed it, and a debug line logged just after showed the volume row laid out correctly at the top of the panel. The stuck state lived in the running process, so the fix is a restart. quickshell has no reload subcommand and no IPC target for it, and a hot reload needs a real content change to a file. reload.sh kills and restarts each named component, or every directory holding a shell.qml, and prints the qs count afterwards, since the process is qs and not quickshell. It must run from the user's terminal. A detached qs started from an agent's tool call dies with the call, which would leave the desktop without its shells; AGENTS.md now says so under Reloading. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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.