vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat(#2554): add hivectl forge reconcile-config to reconcile local applied config against forge main

Browse source
This commit is contained in:
damocles 2026-07-17 12:31:08 +02:00 • committed by mara
commit d124dd205a
9 changed files with 335 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

10
docs/tools/hivectl.md
View file

@ -28,6 +28,10 @@ hivectl forge create-user iris # provision (or refresh) forge account f
hivectl forge create-user mara # create forge account for a human user; prints token to stdout
hivectl forge create-user mara --password hunter2 # set a web-login password
hivectl forge create-user mara --password-stdin # read password from stdin (safer for scripting)
hivectl forge reconcile-config iris # show local-applied <-> forge config divergence, then prompt
hivectl forge reconcile-config iris --from forge # reset local applied checkout to forge main (effective next deploy)
hivectl forge reconcile-config iris --verbose # include the full diff, not just --stat
```
- For **agents** (name has a state dir under `/var/lib/hyperhive/agents/`):
@ -38,6 +42,12 @@ hivectl forge create-user mara --password-stdin # read password from stdin (s
re-mints the token and prints it again — safe for password resets.
- Without `--password` / `--password-stdin` a random throwaway password
is used (fine for agents — they auth by token).
- `reconcile-config <agent>` shows the divergence between the agent's local
applied config checkout and its forge `agent-configs/<agent>` `main`, then
reconciles. `--from forge` resets the local checkout to forge `main` (takes
effect on the next deploy — it does not auto-rebuild). `--from local` is not
supported yet (forge `main` is core-only branch-protected; resolve via a
config PR). With no `--from` it prompts for the direction after the diff.
## Matrix