diff options
| -rw-r--r-- | AGENTS.md | 12 |
1 files changed, 10 insertions, 2 deletions
@@ -38,9 +38,17 @@ no-visible-window exit above and sent a debugging session in the wrong direction for a dozen calls. Start it so the harness owns the process, and confirm with the log rather than a later `pgrep`. +**The process is called `qs`, not `quickshell`.** Both binaries ship, but `qs` +is what runs, so `pkill -x quickshell` and `pgrep -x quickshell` match nothing +and silently succeed. During development this meant every "stopped" was a lie +and every restart stacked another instance: 47 accumulated before the user +noticed. It also produced "0 processes" readings that were mistaken twice for +the shell exiting, and sent a debugging session after a bug that was not +there. Use `pkill -x qs` and `pgrep -cx qs`, and check the count after. + **`pkill -f` matches the agent's own shell.** The working directory is in the -command line, so `pkill -f quickshell` or `pkill -f "foo.qml"` kills the caller -and returns 144. Use `pkill -x quickshell`. +command line, so `pkill -f qs` or `pkill -f "foo.qml"` kills the caller and +returns 144. Always `-x`, never `-f`. For anything visual, ask. Screenshots of a transient OSD are a race, and the user has the screen. |