← Zurück zum Blog
Aica. 7 Min. Lesezeit

agent-autoloop speichert das Warten auf einen Menschen als Datenbankzeile

Veröffentlicht 15. Nov. 2026
agent-autoloop speichert das Warten auf einen Menschen als Datenbankzeile

Alle paar Wochen sehe ich dieselbe Szene: Jemand startet einen Coding-Agent im Terminal, steht auf, um Kaffee zu machen, und kommt zurück zu einem Agenten, der auf eine Frage wartet, die niemand gesehen hat. Die übliche Antwort ist ein lauterer Benachrichtigungston. agent-autoloop greift die Verschwendung darunter an: ein Prozess und ein Kontextfenster, die offen stehen und nichts tun, während ein Mensch nicht an der Tastatur ist.

Es ist ein lokaler Hub, 5,459 GitHub-Sterne am 15. November 2026, MIT-Lizenz. Er beobachtet Ereignisse, gibt sie an den Kommandozeilen-Agenten weiter, den Sie ohnehin nutzen, und hält sich heraus. Der Agent beendet eine Runde, schreibt seine Antwort, beendet sich. Braucht er eine Entscheidung, schickt der Hub eine Karte auf Ihren Desktop oder an Feishu, DingTalk, WeCom, Slack oder Discord. Sie wählen eine Option. Der Agent nimmt das Gespräch wieder auf.

Keine Cloud-Maschine, kein offener Port, kein Dashboard.

Installation, und der eine Befehl, der beweist, dass es läuft

Voraussetzungen: Node 24 oder neuer, Git und ein bereits installierter, angemeldeter Kommandozeilen-Agent. Unter macOS und Linux brauchen Sie außerdem curl.

irm https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.ps1 | iex
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh

Führen Sie dann agent-autoloop try aus. Ein Installationsskript, das eine Versionsnummer ausgibt, beweist nichts darüber, ob die Flags und die Anmeldung Ihres Agenten funktionieren. try durchläuft mit Ihrem eigenen Agenten einen echten Zyklus aus Fragen, Warten, Antworten, Weitermachen: ein Ereignis geht hinaus, der Agent arbeitet, hält an, stellt eine Frage mit Optionen, beendet sich und wartet. Sie antworten, der Hub setzt die Sitzung fort und schließt ab. Ist etwas falsch konfiguriert, wissen Sie es in zwei Minuten, nicht um 2 Uhr nachts, wenn eine Cron-Regel danebengreift.

Ein Satz Vertrag, eine Datei Regeln

Die Schnittstelle zwischen Hub und Agent ist eine einzige Konvention: das Ergebnis in die letzte Antwort schreiben. Kein SDK, kein Wrapper, kein gepatchtes Binary. Alles, was einen Prompt annimmt und eine letzte Nachricht ausgibt, lässt sich anhängen, deshalb steht ein generischer Befehlsadapter neben Claude Code, Codex, ACP, DeepSeek Harness und ZCode.

Fragen ist ein Anhängen. Der Agent beendet seine Antwort mit einem eingezäunten Block namens agent-autoloop, der JSON enthält: ein ask-Array mit Titel, Text, Optionen und einem Key, dazu notice, resolve, later und events für die anderen Verben. Mehr Protokoll muss ein Agent-Autor nicht lernen.

Regeln liegen in ~/.agent-autoloop/rules.json. Eine Regel beantwortet drei Fragen: was passiert ist, welcher Agent es bekommt, in welchem Verzeichnis er läuft.

{
  "when": { "cron": "0 9 * * *" },
  "to": "codex",
  "cwd": "~/notes"
}

Eine Ereignisregel tauscht die Uhr gegen eine Quelle: GitHub issues.opened abgleichen, parallel: 3 und eine Skill ergänzen, gleiche Form. Zwei Dateien tragen die Konfiguration, diese und die, die Ihr Agent ohnehin liest. Mir gefällt, dass sie prüfbar und leicht zu diffen ist.

Vier Mechanismen aus der Systemarbeit

Der Kernel ist die Stelle, an der das Design interessant wird. Einzeln betrachtet ist fast nichts daran neu.

Zuerst die Aussetzung ohne Kosten. Während des Wartens beendet sich der Prozess, der Zustand wandert in eine Datenbank. Drei Tage Stille kosten drei Tage ohne Tokens und ohne laufenden Agenten. Nur der Hub bleibt stehen, was wenig ist, um es laufen zu lassen.

Zweitens Event Sourcing. Jeder Zustand leitet sich aus einem Append-only-Log ab, und das Log wird in derselben Transaktion wie der Index geschrieben, bevor der Hub antwortet. Töten Sie den Prozess, bestätigte Arbeit überlebt. Jede Runde lässt sich später über ihre Nummer erklären. Schemaänderungen bauen aus dem Log neu auf, statt Migrationsskripte zu verlangen.

Drittens die Trennung von Anweisung und Daten. Externer Text, etwa ein Issue-Titel, wird als Material in einer Datei gespeichert und nie in den Prompt eingefügt. Der Prompt trägt nur validierten Typ, Id und Link. Welcher Agent läuft, in welchem Verzeichnis, mit welchem Zugriff, kommt vollständig aus Ihren lokalen Regeln. Ein Ereignis, das cwd, agent oder access mitbringt, wird abgelehnt.

Viertens die Hop-Sicherung, mein Favorit. Von Agenten erzeugte Ereignisse, die an Agenten zurückgehen, sammeln Tiefe an, so wie ein Paket ein TTL sammelt. Menschliche Fragen und geplante Nachprüfungen setzen den Zähler nicht zurück, und der Agent kann ihn nicht ändern. Ab 8 Ebenen stellt der Hub die Zustellung ein, zeichnet das Ereignis auf und schickt Ihnen stattdessen eine Karte.

Die Zahlen, und wo ich aufhöre, ihnen zu glauben

Die Benchmark-Tabelle stammt von einem Apple M5 Pro mit 24 GB und Node 24.21.0, jede Schreiboperation einzeln committet und die Transaktion auf der Platte, bevor die Antwort kommt. Kaltstart 88.78 ms. Leerlaufspeicher 59.94 MB RSS. Tausend gleichzeitige Long Polls bei 170.49 MB. 2,394 dauerhafte Schreibvorgänge pro Sekunde. Dispatch-p99 von 1.82 ms und ein Heartbeat-p99 von 1.66 ms, während 5,000 Einträge in der Warteschlange liegen. Start über 1.1 Millionen Fakten in 99.8 ms. Null Laufzeitabhängigkeiten.

Das sind Warteschlangenzahlen, keine App-Zahlen, und genau das ist der Punkt. Ein Hub, der Warten als Zeile und Arbeit als Ereignis speichert, sollte sich wie eine Warteschlange verhalten.

Meine Skepsis: eine Maschine, ein Bediener, ein warmer Page Cache und ein Harness, geschrieben von der Person, die den Kernel geschrieben hat. Der Benchmark läuft nie auf einem Laptop mit einem Videoanruf und einem Build im Hintergrund, also lesen Sie ihn als Untergrenze, nicht als Versprechen. Die Zahl von 1.1 Millionen Fakten ist anderswo auch mit ehrlichen Kosten verbunden. Das README sagt, der erste Start nach einer Formatänderung baut aus dem Log neu auf, und das habe 43.1 Sekunden gedauert. Für einen Laptop in Ordnung, unangenehm, wenn Sie etwas anderes angenommen haben.

Zwei Stellen, an denen Autonomie wehtun kann, und was Sie erben

Sicherheit ist die Stelle, an der die Autoren am wenigsten clever waren, und das meine ich als Lob. Die Trennung von Anweisung und Daten bedeutet, dass ein feindseliger Issue-Titel einen Lauf nicht in ein anderes Verzeichnis oder zu einem anderen Agenten umleiten kann, weil diese Felder an der Tür abgelehnt werden. Die Hop-Sicherung bedeutet, dass eine Gruppe von Agenten, die sich Arbeit weiterreichen, nicht ewig drehen kann, weil die Tiefe vom Hub erhöht wird und nicht von den Teilnehmern.

Beides ist kein Beweis. Die Sicherung ist eine Politik bei 8 Ebenen. Braucht ein legitimer Workflow 9, haben Sie ein Problem, und wenn der gefährliche Fall eine langsame Schleife über zwei Ebenen ist, die bei jedem Sprung echten Schaden anrichtet, löst die Sicherung nie aus. Die Trennung schützt die Zustellentscheidung, nicht das, was der Agent tut, sobald er eine Shell in dem Verzeichnis hat, das Sie ihm gegeben haben.

Die Simulation ist stärker als bei den meisten. node sim/random.ts 24301 200000 fährt 200,000 Schritte aus abgebrochenen Verbindungen, verlorenen Paketen, Abstürzen und doppelten Einreichungen unter einem festen Seed, sodass ein Fehler reproduzierbar ist. node sim/crash.ts 1000 12648430 tötet den Prozess 1,000 Mal und prüft, dass kein bestätigter Datensatz verschwindet. Dann ergänzt das README, dass ein Stromausfall der ganzen Maschine nicht getestet wurde. Ich respektiere diesen Satz, und er bringt mich dazu zu fragen, was sonst nicht getestet wurde. Die Webhook-Vorlagen liefen nur gegen lokale Mock-Server. Der GitLab-Webhook wurde gegen sein dokumentiertes Format geprüft und nie gegen ein echtes GitLab. Die Rezeptskripte wurden gegen eine gefälschte Feishu-CLI validiert. Jede dieser Stellen ist ein Ort, an dem "getestet" weniger bedeutet, als ein Leser annimmt.

Was Sie mit einem handgeschriebenen Kernel und null Laufzeitabhängigkeiten erben, ist die Wartung. Ein kleiner Abhängigkeitsbaum altert gut, wenn jemand aufpasst, und schlecht, wenn der Autor weiterzieht. Das ist der Preis für einen Kaltstart von 88 ms.

Ein Abrechnungsdetail liegt völlig außerhalb des Designs. Der Hub treibt die CLI-Werkzeuge, die auf Ihrer Maschine bereits installiert und angemeldet sind, also landet die Nutzung auf Ihrem eigenen Konto oder Abonnement. Das README merkt an, dass Anbieter für hochfrequente Automatisierung API-Keys bevorzugen, weil persönliche Tarife für menschlich getaktete Interaktion gebaut sind. Lesen Sie das zweimal, bevor Sie eine Cron-Regel auf Ihre Claude-Code-Sitzung richten und schlafen gehen.

Ein Risiko überlebt alle Mechanismen oben. Eine Schleife, die GitHub-Issues anlegen und über die Lieferpipeline Pull Requests mit einem deliver-Label mergen kann, ist ein Akteur in der Lieferkette mit Ihren Zugangsdaten. Alles oben macht sie zuverlässig und gibt ihr eine kurze Leine. Der Review-Schritt, den Sie konfiguriert haben, ist das Einzige zwischen ihr und einem schlechten Merge, und kein Event Sourcing verbessert ein Review, das Sie nicht gelesen haben.

Verwandte Artikel