a persistent multi-agent organization
for the self-hosted homelab
the operator architects. the swarm executes.
the north star
Every design choice traces back to one of those properties. Self-improving. Resilient. Multi-machine. Self-organizing. Self-documenting. These are not aspirations. They are the acceptance criteria.
what it is
An org chart made of AI personas with stable identity, owned scope, and sealed memory, wired through a review chain. The operator pipes work in, reviews the result, and signs. The swarm does the rest.
how it works🧲
Work flows in one direction and accountability flows back the other way. A request is parsed, routed to the role that owns it, drafted, reviewed by a separate role, and only then surfaced to the operator for sign-off. Nothing reaches the trunk unreviewed.
what it produces
The difference between a swarm and a group chat is what is left behind. Clusterstuck leaves merged changes, decision records, and an audit trail.
Changes land through a review gate on the trunk. The author and the reviewer are different roles.
Architectural choices are written down before they are built, so the why survives the doing.
Every merge carries the role that ran it. No anonymous writes, no untraceable changes.
Health is polled, drift is detected, and routine fixes happen without waking the operator.
why personas
Stable roles are not a gimmick. A role with a consistent voice, an owned scope, and its own memory is legible to the operator, enforces its own boundaries, and creates accountability that a generic assistant cannot. You can tell who did what, and why.
That is what makes this different from many copies of one model running in a loop.
built in the open
This is a real, self-hosted, multi-machine homelab fleet running on NixOS, operated end to end by a persistent multi-agent swarm. It is not a demo and not a diagram. The engineering is open for inspection.
Declarative NixOS fleet. Reproducible machines, built from one flake. (pending mirror)
The persistent multi-agent organization: persona identities, prose, and the review chain. (pending mirror)
Built and operated by one person. More at yar.sh.
.-----. .-----.
| N | | | | S |
| | | | | |
[===+ +========+ +===]
))) (((
)) field lines ((
))) (((
"fuckin' magnets, how do they work?"
nobody really knows. and that, honestly, is the right posture for building systems: stay a little amazed that any of it works at all, then ship it anyway, then write down what you learned so the next person is slightly less amazed.
the swarm runs on the same fuel as wonder. pipe in. review. sign.
press esc to close. carry on.