docs/tools/hivectl-cli.md

@@ -55,7 +55,7 @@ Sibling to the `hive-c0re` daemon binary. Covers host-side admin operations that
 * `peer-config` — Generate the federation peer-config block for THIS hive — the nix a peer operator pastes into their `services.hyperhive.swarm.peers` to trust + reach this hive. Emits `caCert` (+ a `cp` line for the cert) when this hive serves a self-signed CA, the WireGuard public key when the mesh key exists, and the `wireguard{Address,Endpoint}` you pass. The hive's own domain is filled in automatically from the running daemon (`services.hyperhive.domain`). Reads local state (the TLS CA cert, the wg key); never mutates. `wg init` calls this at the end, so a fresh mesh setup prints the hand-over block too
 * `choom` — Open an interactive Claude session inside an agent container
 * `stop` — Stop containers hive-wide in one operator action. Bare `hivectl stop` stops **everything** — all sub-agents plus the ci, forge, gateway, and matrix infra containers. Narrow it with scope flags: `--agents` (all sub-agents), `--ci` / `--forge` / `--gateway` / `--matrix` (named infra), and `--agent <name>` (repeatable) for specific sub-agents. Flags are additive (e.g. `--agents --matrix`). Requires the hive-c0re daemon (connects to the host admin socket). hive-c0re itself is never stopped — it services the request
-* `start` — Start containers hive-wide — the inverse of `hivectl stop`. Bare `hivectl start` restores the previously-running agents from the last broad-scope `stop`, or starts everything if no prior stop exists; the same scope flags as `stop` narrow it (`--agents`, `--ci`, `--forge`, `--gateway`, `--matrix`, `--agent <name>`). A targeted `--agent <name>` start is never filtered. Requires the hive-c0re daemon
+* `start` — Start containers hive-wide — the inverse of `hivectl stop`. Bare `hivectl start` starts everything back up; the same scope flags as `stop` narrow it (`--agents`, `--ci`, `--forge`, `--gateway`, `--matrix`, `--agent <name>`). Requires the hive-c0re daemon
 * `restart` — Restart containers hive-wide — `stop` then `start` over the same scope. Bare `hivectl restart` restarts **everything** (all sub-agents plus the ci/forge/gateway/matrix infra containers); the same scope flags as `stop`/`start` narrow it (`--agents`, `--ci`, `--forge`, `--gateway`, `--matrix`, `--agent <name>`). If the stop phase reports a failure the start phase is skipped so the operator can investigate. Requires the hive-c0re daemon
 * `quota` — Per-agent disk accounting + optional quotas via btrfs qgroups
 * `subvol` — btrfs subvolume management for agent state dirs
@@ -422,7 +422,7 @@ Stop containers hive-wide in one operator action. Bare `hivectl stop` stops **ev
 
 ## `hivectl start`
 
-Start containers hive-wide — the inverse of `hivectl stop`. Bare `hivectl start` restores the previously-running agents from the last broad-scope `stop`, or starts everything if no prior stop exists; the same scope flags as `stop` narrow it (`--agents`, `--ci`, `--forge`, `--gateway`, `--matrix`, `--agent <name>`). A targeted `--agent <name>` start is never filtered. Requires the hive-c0re daemon
+Start containers hive-wide — the inverse of `hivectl stop`. Bare `hivectl start` starts everything back up; the same scope flags as `stop` narrow it (`--agents`, `--ci`, `--forge`, `--gateway`, `--matrix`, `--agent <name>`). Requires the hive-c0re daemon
 
 **Usage:** `hivectl start [OPTIONS]`
 

hive-c0re/src/bin/hivectl.rs

@@ -152,12 +152,9 @@ enum Cmd {
         no_wait: bool,
     },
     /// Start containers hive-wide — the inverse of `hivectl stop`. Bare
-    /// `hivectl start` restores the previously-running agents from the
-    /// last broad-scope `stop`, or starts everything if no prior stop
-    /// exists; the same scope flags as `stop` narrow it (`--agents`,
-    /// `--ci`, `--forge`, `--gateway`, `--matrix`, `--agent <name>`). A
-    /// targeted `--agent <name>` start is never filtered. Requires the
-    /// hive-c0re daemon.
+    /// `hivectl start` starts everything back up; the same scope flags as
+    /// `stop` narrow it (`--agents`, `--ci`, `--forge`, `--gateway`,
+    /// `--matrix`, `--agent <name>`). Requires the hive-c0re daemon.
     Start {
         #[command(flatten)]
         scope: ScopeArgs,