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

docs(setup): point operator forge/matrix account creation at swarm SSO

Browse source
This commit is contained in:
damocles 2026-08-17 18:39:34 +02:00 • committed by mara
commit 1d9a06482a
1 changed files with 16 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

28
docs/setup.md
View file

@ -21,16 +21,19 @@ operator has to place, and where.
### 1 · Forge ### 1 · Forge
```bash ```bash
# Provision (or refresh) ruth's own forge account — do this first # Provision (or refresh) ruth's own forge account — do this first. Ruth's
# bootstrap bypasses the normal spawn-approval flow (see step 6), so unlike
# every other agent it does not get its forge account auto-provisioned —
# this manual step is still load-bearing.
hivectl forge create-user ruth hivectl forge create-user ruth
# Create a human operator account (prints the token to stdout) # Sub-agents spawned later (via the approval flow in step 6) get their
hivectl forge create-user mara --password hunter2 # forge accounts auto-provisioned — nothing to run here for them.
# Provision forge accounts for any sub-agents spawned later
hivectl forge create-user <agent>
``` ```
The human operator's own forge account is created via swarm SSO instead of
a manual `hivectl` step — see step 3 (`swarmctl user add`).
### 2 · Gateway (HTTP Basic auth) ### 2 · Gateway (HTTP Basic auth)
```bash ```bash
@ -89,20 +92,21 @@ control: [`swarm/ui.md`](swarm/ui.md).
# 5a. Ensure the hive-internal admin account exists first # 5a. Ensure the hive-internal admin account exists first
hivectl matrix sync-admin hivectl matrix sync-admin
# 5b. Provision ruth's own matrix account # 5b. Provision ruth's own matrix account — same bootstrap-bypass reasoning
# as forge above, still a required manual step.
hivectl matrix create-user ruth hivectl matrix create-user ruth
# 5c. Create a human matrix account # 5c. Invite the operator to the hive Space (and optionally to rooms)
hivectl matrix create-user mara --password hunter2
# 5d. Invite the operator to the hive Space (and optionally to rooms)
hivectl matrix invite mara hivectl matrix invite mara
hivectl matrix invite @mara:yourserver --room '#hive-chat:yourserver' hivectl matrix invite @mara:yourserver --room '#hive-chat:yourserver'
# 5e. Promote the operator to homeserver admin if needed # 5d. Promote the operator to homeserver admin if needed
hivectl matrix promote-user mara hivectl matrix promote-user mara
``` ```
The human operator's own matrix account is created via swarm SSO instead of
a manual `hivectl` step — see step 3 (`swarmctl user add`).
### 6 · Spawn sub-agents ### 6 · Spawn sub-agents
Sub-agent creation goes through the approval queue — ruth proposes, the Sub-agent creation goes through the approval queue — ruth proposes, the