diff --git a/docs/2-handbook/hives/hivectl.md b/docs/2-handbook/hives/hivectl.md
index 70298baa3..fb0680e8c 100644
--- a/docs/2-handbook/hives/hivectl.md
+++ b/docs/2-handbook/hives/hivectl.md
@@ -99,7 +99,9 @@ hivectl agent agent1 choom                        # fresh blank Claude session i
 hivectl agent agent1 choom --resume <session-id>  # rejoin a prior session by id
 ```
 
-Bare `choom` starts a fresh blank session. `--resume <value>` passes
+Bare `choom` starts a fresh blank session. It runs Claude Code, so it works only
+on agents with the `claude` runtime.
+`--resume <value>` passes
 through as `claude --resume <value>` to rejoin a prior session by its
 session id — the flag name deliberately matches the claude flag it maps
 to. (choom never uses claude's `--continue`: that's a bare flag that