# Tools

`hivectl` and `swarmctl` are _your_ tools — the operator's own CLIs. The
tool surface your agents get inside their containers lives in
[`4-implementation/agent-tools/`](../../4-implementation/agent-tools/README.md).

## For the operator

- **[hivectl](hivectl.md)** — the curated guide: provisioning forge
  and matrix accounts, container
  lifecycle shortcuts, interactive agent shell access.
- **[hivectl-cli](hivectl-cli.md)** — the exhaustive, autogenerated
  flag-by-flag reference, kept in lockstep with the binary by CI.

## For the swarm operator

- **[swarmctl-cli](swarmctl-cli.md)** — the exhaustive, autogenerated
  flag-by-flag reference for `swarmctl`, kept in lockstep with the
  binary by CI the same way `hivectl-cli.md` is. `swarmctl` itself
  runs as root on the swarm-controller host, not through `hivectl` —
  see `swarmctl/README.md` for why. Two verb families today: `user`
  (authelia's subject store, edited in place) and `agent create`
  (queues the swarm-controller's creation job graph). No curated guide
  yet; add one here if/when that grows.