diff --git a/docs/tools/hivectl-cli.md b/docs/tools/hivectl-cli.md index 4e685019..6c3fe955 100644 --- a/docs/tools/hivectl-cli.md +++ b/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 ` (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 `). A targeted `--agent ` 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 `). 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 `). 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 `). A targeted `--agent ` 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 `). Requires the hive-c0re daemon **Usage:** `hivectl start [OPTIONS]` diff --git a/hive-c0re/src/bin/hivectl.rs b/hive-c0re/src/bin/hivectl.rs index 5f4398b7..f2b20942 100644 --- a/hive-c0re/src/bin/hivectl.rs +++ b/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 `). A - /// targeted `--agent ` 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 `). Requires the hive-c0re daemon. Start { #[command(flatten)] scope: ScopeArgs,