feat: hivectl matrix invite — add a user to the hive Space or a room (closes #1402)

This commit is contained in:
damocles 2026-06-05 20:11:30 +02:00 committed by mara
commit e8d5eee659
3 changed files with 128 additions and 2 deletions

View file

@ -44,6 +44,8 @@ hivectl matrix create-user mara --password hunter2 # set a client-login passwor
hivectl matrix sync-admin # provision / refresh the hive internal admin account
hivectl matrix promote-user mara # promote an existing matrix user to homeserver admin
hivectl matrix reset-password iris # generate and set a new random password for `iris`; prints it
hivectl matrix invite mara # invite a user to the hive Space
hivectl matrix invite @mara:server --room '#hive-chat:server' # ...or to a specific room/alias
```
- `create-user`: for agents, persists the `access_token` to
@ -58,6 +60,12 @@ hivectl matrix reset-password iris # generate and set a new random password
- `reset-password`: calls the matrix admin API to set a new random
password and prints it to stdout. Useful if an agent or human lost
credentials.
- `invite`: invites a matrix user (full `@user:server` or a bare
localpart, qualified with the homeserver's `server_name`) to the hive
Space by default, or to a `--room` id / `#alias`. Uses the hive admin
token; the admin account must be a member of the target room with
invite power (it owns the hive Space, so that case always works).
Idempotent — already-member / already-invited is a no-op.
## Gateway