1 files changed, 5 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
index faf6b18..cefaf5b 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -546,6 +546,11 @@ back.
 `qs -p <dir>` runs one directly. `qs -p <dir> ipc call <target> <fn>` reaches a
 running one, which is how `SUPER+v` opens the VM drawer.
 
+An `IpcHandler` function named after a `qs ipc` subcommand (`show`, `call`,
+`wait`, `listen`, `prop`) cannot be called from the CLI: `ipc call companion
+show` runs `ipc show` instead, prints the target list and exits 0. Three
+handlers had a `show()` nobody could reach; they are `open()` now.
+
 ## Conventions
 
 - GPLv2 only, with the header notice in every source file.