Ralph

Ralph er en kontrolplan for autonome AI-kodningsagenter. Den styrer hele livscyklussen af automatiseret kodearbejde — fra at definere hvad der skal gøres, til at eksekvere det, til at verificere resultatet.

Stories er den centrale enhed. Hver story har en titel, scope, acceptkriterier, verifikationskommandoer, ejede filstier og afhængighedskæder til andre stories. Stories bor i backlogs, som kan importeres fra JSON eller bygges interaktivt. Når en run starter, gennemgår Ralph backloggen og sender stories til agenten i afhængighedsrækkefølge.

Runs eksekverer lokalt eller i skyen. Lokale agenter poller serveren for køede runs og eksekverer i din projektmappe — start en run fra din telefon og agenten tager den. Cloud-eksekvering sender runs til Google Cloud Batch, som kloner repoet, checker den rigtige ref ud og kører agenten i en isoleret container.

Worker-laget håndterer mekanikken: clone-run kloner et repo og claimer arbejde, execute-run arbejder fra et eksisterende checkout. Begge understøtter konfigurerbar Git-auth, repo-undermapper og ref-targeting.

Runtime-profiler konfigurerer agent-adfærd per repo — max concurrency, lease-varigheder, heartbeat- og fornyelsesintervaller, poll-frekvens. Profiler gemmes i .ralph.yaml ved siden af din kode.

Live log-streaming viser agent-output i realtid. Run-events sporer tilstandsovergange. Audit-logs registrerer hver handling på tværs af workspace. Stats aggregerer run-antal, story-færdiggørelsesrater og per-bruger aktivitet med tidsserienedbrydninger.

Ralph integrerer med PAC til backlog-drevet automatisering — PAC-opgaver kan sendes til Ralph til autonom eksekvering. Web-dashboardet på ralph.happenings.social giver workspace-administration, run-historik og story-styring.

Bygget med Go, ConnectRPC og Protocol Buffers. Server deployet på Cloud Run, storage på PostgreSQL med sqlc. CLI autentificerer via browser-login eller mobil QR-pairing og opdaterer sig selv.