hyperhive/hivectl

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, the approval queue, and provisioning 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 (spawn/kill/rebuild/restart/…).
• approvals.rs — the config/init-config/meta-input approval queue.
• 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, matrix.rs, github.rs, gateway.rs — per-integration account/token provisioning.
• 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.