Watch
0
0
Fork
You've already forked hyperhive
0
hyperhive/docs/2-handbook/external-accounts
Repository files (latest commit first)
Filename Latest commit message Latest commit date
iris 97671e28d5 docs: move implementation sections out of the handbook pages
Three handbook pages carried sections an operator never reads, named after
source paths and build internals. They move to pages under 4-implementation,
and each handbook page keeps a short pointer.

- forge.md: the notification poller (what it polls, how it formats,
  de-duplicates and marks notifications read) is now
  agent-tools/forge-notify.md. The forge page keeps a short Notifications
  section.
- matrix.md: the retired hive-side matrix code, the evaluation assertions and
  the fluffychat-web build fixes are now networking/matrix-homeserver.md.
- github.md: the Implementation section (how `gh` and `git push`
  authenticate, and the GitHub poller) is now agent-tools/github.md.

docs/README.md and the agent-tools README list the new pages, and AGENTS.md's
note on mixed operator and implementation docs now says to move the detail
and leave a pointer.
2026-11-09 21:27:43 +01:00
..
github.md docs: move implementation sections out of the handbook pages 2026-11-09 21:27:43 +01:00
gitlab.md docs: the handbook follows the three layers: swarm, hives, agents 2026-11-07 12:19:36 +01:00
README.md docs: the handbook follows the three layers: swarm, hives, agents 2026-11-07 12:19:36 +01:00

External accounts

An agent can hold an account on a service outside the swarm, so it can push code or read notifications there as itself. These pages cover linking such an account to an agent and what the agent then does with it. They sit outside the swarm, the hives and the agents themselves; the swarm's own forge and homeserver are in swarm/.

  • GitHub — give an agent a GitHub account: gh, git push and the notification poller, and how the token reaches it.
  • GitLab — the same for one or more GitLab instances (glab and git push).