diff --git a/docs/tools/hivectl-cli.md b/docs/tools/hivectl-cli.md
index 93829e90..6031b7f5 100644
--- a/docs/tools/hivectl-cli.md
+++ b/docs/tools/hivectl-cli.md
@@ -24,6 +24,8 @@ This document contains the help content for the `hivectl` command-line program.
 * [`hivectl agents list`↴](#hivectl-agents-list)
 * [`hivectl agents restart`↴](#hivectl-agents-restart)
 * [`hivectl agents restart-all`↴](#hivectl-agents-restart-all)
+* [`hivectl agents pause`↴](#hivectl-agents-pause)
+* [`hivectl agents resume`↴](#hivectl-agents-resume)
 * [`hivectl agents spawn`↴](#hivectl-agents-spawn)
 * [`hivectl agents request-spawn`↴](#hivectl-agents-request-spawn)
 * [`hivectl agents kill`↴](#hivectl-agents-kill)
@@ -339,6 +341,8 @@ Lifecycle actions on managed agent containers. Needs the hive-c0re daemon runnin
 * `list` — Show all managed agents with their status and technical state
 * `restart` — Stop and start a single agent container without rebuilding config
 * `restart-all` — Restart all managed agent containers
+* `pause` — Park an agent's turn loop, leaving the container running
+* `resume` — Resume a paused agent — it drains whatever queued up while parked
 * `spawn` — Spawn a new agent container directly, bypassing the approval queue
 * `request-spawn` — Queue a spawn request for operator approval
 * `kill` — Stop a managed container (graceful)
@@ -388,6 +392,32 @@ Restart all managed agent containers
 
 
 
+## `hivectl agents pause`
+
+Park an agent's turn loop, leaving the container running.
+
+The harness stops driving turns but keeps serving its web UI and MCP daemons, so the container, its mounts and its warm caches stay up while it burns no tokens. Inbox messages queue unacked and the backlog drains on `resume`. Sticky: it survives a restart, and pausing a stopped agent makes it come up paused.
+
+**Usage:** `hivectl agents pause <NAME>`
+
+###### **Arguments:**
+
+* `<NAME>` — Agent name
+
+
+
+## `hivectl agents resume`
+
+Resume a paused agent — it drains whatever queued up while parked
+
+**Usage:** `hivectl agents resume <NAME>`
+
+###### **Arguments:**
+
+* `<NAME>` — Agent name
+
+
+
 ## `hivectl agents spawn`
 
 Spawn a new agent container directly, bypassing the approval queue.