Repo & link directory
Where each piece of the system actually lives, and every external reference the site leans on — each with a one-line “why we care.” Our repos are on the Agent54 forge (Forgejo, the origin of record, d/007); distribution stays cluster-internal until Luke flips it public (d/065), so forge URLs are reachable from inside the fabric. External links are public.
Our forge repositories
Forge web base: forge.discus-mora.ts.net:3000/agent54/<repo> (cluster-internal). Code citations
throughout the reviews pin commits on these repos.
| Repo | What it is | Why we care |
|---|---|---|
xenon-launcher | The runtime/launcher monorepo (crates/launcher, crates/apps, crates/net/group, crates/substrate, crates/xe-sync, package-index). | The core: the plane, origin router, app model, engine socket contract, peer serving, and the membership plane all live here. Most Part III citations are @56e94575; post-P-201w main is @2671bea9. |
prism | The super-app shell (an IWA): Controlled-Frame hosting, the frame↔shell channel, composition, the hash-linked journal. | The rendering layer and the agency-ladder host; Part III shell citations are @98acaa3. |
xenon-runtime | The device-fabric runtime and the phone companion (companion-core, companion-android, the on-device plane). | Enrollment, membership over iroh, the companion apps.list protocol, the session audit chain; devices/agent citations are @b0cfc90. |
android-iwa | A patch series (three patches + gn args + validation scripts) on a stock Chromium base, not a full fork. | The Xenon-on-Android track; the fork-maintenance cadence is an open gap. |
xe-example-apps | The example-app monorepo (Excalidraw, guestbook, compose-board, and the dev-signed swbn samples). | Proof material for every app kind; kept out of any super-app’s repo by d/079. Citations @5752a3e. |
xe-darc | The agent-layer research preview (darc) and its design docs (injection-boundary-design, capability-model-design). | Where darc → Reagent and the delegation model are being worked out; the least-built, highest-mission layer. |
iroh (fork) | agent54/iroh — upstream iroh plus one commit exposing a network-change hook; explicitly temporary. | The transport; the fork is meant to be upstreamed and repinned vanilla (d/046). |
xe-docs | This site (mdBook). | The successor review surface to the retired docs/map.html (d/099). |
The trust chain & key names
- catalog — the signed static index publishing produces (Ed25519, serial-anchored, d/067); install verifies signature + content hash first.
- console — the witness surface for receipts and the update ledger (d/064).
- Production signing keys do not exist yet — the orchestrator holds only build-phase seeds (d/066); the ceremony is an open scheduling item.
External references — web platform
- Isolated Web Apps — explainer — the IWA / Signed-Web-Bundle mechanism the super tier is built on.
- Controlled Frame — WICG explainer · spec — the partitioned embedding element Prism frames guests in.
- workerd — Cloudflare’s runtime; our pinned, launcher-managed origin router.
- Chrome DevTools Protocol — the wire protocol the agency ladder’s driven rung uses.
- Content-Security-Policy — MDN — the declared trust boundary the shell’s CSP is.
- Helium · Chromium — the browser base Xenon forks (phrasing pending confirmation; see glossary).
External references — transport, identity & capabilities
- iroh — the peer-to-peer transport (dial by public key; relays for discovery + fallback).
- UCAN — working group & spec · delegation · invocation — the capability-token model our grant/lease semantics align to (d/027).
- did:key — expressing a public key as a DID, free for us since device keys are already Ed25519.
- Ed25519 — RFC 8032 — the signature scheme for device identity and the catalog.
- UnifiedPush — the sovereign, self-hostable push option weighed against FCM for the Android wake path.
External references — engines, apps & tooling
- smolvm — the default microVM app engine; gets the socket-connector capability first as an upstream contribution (d/094).
- mdBook — the static-site tool this book is built with; the Mermaid diagrams use mdbook-mermaid.
- Excalidraw — the real production app proven end-to-end through the peer pipeline (P-211).
- Immich — the compose / whole-origin target gated on d/103-B (it dropped its ML service to install; see GPU/ML gap).
- Patchwork — the first real-app target named by d/076.
External references — the audience & context
- Internet Archive — the first audience; Brewster Kahle has seen the work and the backing is “warm” (d/041).
- the decentralized web (DWeb) · User & Agents — the local-first / agent community that will check the sovereignty litmus first.