hivectl

The operator-facing host CLI. A thin client for the hive-c0re daemon — speaks the host admin socket protocol (hive-host-sock) and does not link the daemon crate. Container lifecycle and the matrix/gateway verbs all forward to the daemon and need it running; a few (wg/peer-config, choom) work off local host state instead.

When to use it

Reach for this crate when adding an operator-run host command — agents talk to the daemon over their own MCP tool surface (hive-agent-mcp), not this binary. hivectl is what a human operator (or a host-side script) runs.

Shape

One module per subcommand family; main.rs is just the clap parse + dispatch:

• agents.rs — container lifecycle for an EXISTING agent (start/stop/kill/rebuild/restart/…); creation is swarm-level (swarmctl agent create).
• dag_progress.rs — rebuild-queue progress rendering.
• power.rs — restart/start/stop at the container level.
• choom.rs — drop into an interactive claude session in a container.
• forge.rs — reconciles an agent's config against its forge repo.
• matrix.rs — invite a matrix user to the hive Space or a room.
• wg.rs — WireGuard mesh helpers.
• subvol.rs — btrfs state-subvolume ops.
• quota.rs, util.rs, completions.rs, open.rs — shared helpers, shell completions, browser-open.

Full verb reference: docs/tools/hivectl.md.