diff options
| author | Danilo M. <danix@danix.xyz> | 2026-09-11 19:03:23 +0200 |
|---|---|---|
| committer | Danilo M. <danix@danix.xyz> | 2026-09-11 19:03:23 +0200 |
| commit | f909b171956f280e80842191fa1c46bc4b5a282d (patch) | |
| tree | 14de41741992ffd46b39984262157fe85064c14e | |
| parent | d72b4bd6a39236093eed24d8b20f8e4d455c1fd3 (diff) | |
| download | quickshell-f909b171956f280e80842191fa1c46bc4b5a282d.tar.gz quickshell-f909b171956f280e80842191fa1c46bc4b5a282d.zip | |
docs: the process is qs, not quickshell
Both binaries ship and qs is the one that runs, so pkill -x quickshell
matches nothing and exits successfully. Every restart during development
therefore left the old instance running, and 47 accumulated before the
user noticed. The same mistake produced pgrep readings of zero that were
twice taken for the shell having exited, and sent one debugging session
after a bug that did not exist.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01G7NRsGyF9jGfPYS4zPqpN7
| -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. |
