From b864dd6a7bc924858ac1952780d99af390109783 Mon Sep 17 00:00:00 2001 From: lexis Date: Fri, 10 Jul 2026 12:37:13 +0200 Subject: [PATCH 1/3] docs(hivectl): clarify start command restores previously-running agents (follow-up to #1946) --- hive-c0re/src/bin/hivectl.rs | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/hive-c0re/src/bin/hivectl.rs b/hive-c0re/src/bin/hivectl.rs index f2b20942..5f4398b7 100644 --- a/hive-c0re/src/bin/hivectl.rs +++ b/hive-c0re/src/bin/hivectl.rs @@ -152,9 +152,12 @@ enum Cmd { no_wait: bool, }, /// 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. + /// `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 { #[command(flatten)] scope: ScopeArgs, From aba3a3a4ea2b52c188536516ec61d9be8f1d88ab Mon Sep 17 00:00:00 2001 From: lexis Date: Fri, 10 Jul 2026 12:40:51 +0200 Subject: [PATCH 2/3] regen docs/tools/hivectl-cli.md per CI check --- docs/tools/hivectl-cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tools/hivectl-cli.md b/docs/tools/hivectl-cli.md index 6c3fe955..0d42dba3 100644 --- a/docs/tools/hivectl-cli.md +++ b/docs/tools/hivectl-cli.md @@ -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` starts everything back up; the same scope flags as `stop` narrow it (`--agents`, `--ci`, `--forge`, `--gateway`, `--matrix`, `--agent `). Requires the hive-c0re daemon +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 **Usage:** `hivectl start [OPTIONS]` From d01d6d91e27bb6b39ce37b687cbd8f253ca4f448 Mon Sep 17 00:00:00 2001 From: lexis Date: Fri, 10 Jul 2026 12:52:18 +0200 Subject: [PATCH 3/3] regen docs/tools/hivectl-cli.md with updated hivectl help text --- docs/tools/hivectl-cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/tools/hivectl-cli.md b/docs/tools/hivectl-cli.md index 0d42dba3..4e685019 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` starts everything back up; the same scope flags as `stop` narrow it (`--agents`, `--ci`, `--forge`, `--gateway`, `--matrix`, `--agent `). Requires the hive-c0re daemon +* `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 * `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