diff --git a/docs/tools/hivectl-cli.md b/docs/tools/hivectl-cli.md
index 4b48d834..a3bab285 100644
--- a/docs/tools/hivectl-cli.md
+++ b/docs/tools/hivectl-cli.md
@@ -398,7 +398,11 @@ Resume this paused agent — it drains whatever queued up while parked
 
 Start this EXISTING agent container. Fails immediately if `name` has no config/topology entry at all — it never attempts first-time creation. Use `create` for that
 
-**Usage:** `hivectl agent start`
+**Usage:** `hivectl agent start [OPTIONS]`
+
+###### **Options:**
+
+* `--paused` — Start (or leave) the agent paused: if it's currently down, the pause marker is written before the container boots, so it comes up paused instead of driving turns immediately. If it's already running, this pauses it in place and does not attempt a (re)start