agent-autoloop conserva l'attesa di un umano come riga di database

Ogni paio di settimane vedo la stessa scena: qualcuno avvia un agente di codice in un terminale, si alza a fare il caffè e torna trovandolo fermo su una domanda che nessuno ha visto. La soluzione abituale è alzare il volume della notifica. agent-autoloop attacca lo spreco che sta sotto: un processo e una finestra di contesto aperti, fermi a non fare nulla, mentre una persona è lontana dalla tastiera.
È un hub locale, 5,459 stelle GitHub al 15 novembre 2026, licenza MIT. Osserva eventi, li passa all'agente da riga di comando che già usi e si fa da parte. L'agente chiude un giro, scrive la risposta, esce. Quando serve una decisione, l'hub manda una scheda sul desktop, oppure a Feishu, DingTalk, WeCom, Slack o Discord. Scegli un'opzione. L'agente riprende la conversazione.
Nessuna macchina nel cloud, nessuna porta aperta, nessuna dashboard.
Installare, e il solo comando che dimostra che funziona
Requisiti: Node 24 o superiore, Git e un agente da riga di comando già installato e con accesso effettuato. Su macOS e Linux serve anche 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
Poi esegui agent-autoloop try. Uno script di installazione che stampa un numero di versione non dimostra nulla sul fatto che i flag e l'accesso del tuo agente funzionino. try percorre con il tuo agente un ciclo reale chiedi, aspetta, rispondi, continua: parte un evento, l'agente lavora, si ferma, fa una domanda con opzioni, esce, poi aspetta. Rispondi e l'hub riprende la sessione e chiude. Se qualcosa è configurato male lo scopri in due minuti, non alle 2 di notte quando una regola cron parte per traverso.
Una frase di contratto, un file di regole
L'interfaccia tra hub e agente è una sola convenzione: mettere il risultato nella risposta finale. Nessun SDK, nessun wrapper, nessun binario modificato. Qualsiasi cosa accetti un prompt e stampi un ultimo messaggio si può collegare, ed è per questo che un adattatore di comandi generico sta accanto a Claude Code, Codex, ACP, DeepSeek Harness e ZCode.
Chiedere è un'aggiunta. L'agente chiude la risposta con un blocco delimitato chiamato agent-autoloop che contiene JSON: un array ask con titolo, testo, opzioni e una chiave, più notice, resolve, later ed events per gli altri verbi. È tutto il protocollo che un autore di agenti deve imparare.
Le regole stanno in ~/.agent-autoloop/rules.json. Una regola risponde a tre domande: cosa è successo, quale agente lo riceve, in quale directory gira.
{
"when": { "cron": "0 9 * * *" },
"to": "codex",
"cwd": "~/notes"
}
Una regola a evento sostituisce l'orologio con una sorgente: intercettare issues.opened di GitHub, aggiungere parallel: 3 e una skill, stessa forma. Due file contengono la configurazione, questo e quello che il tuo agente già legge. Mi piace che sia ispezionabile e facile da mettere in diff.
Quattro meccanismi presi dal lavoro sui sistemi
Il kernel è il punto in cui il progetto diventa interessante. Presi singolarmente, quasi nulla è nuovo.
Prima la sospensione a costo zero. Durante l'attesa il processo esce e lo stato passa in un database. Tre giorni di silenzio costano tre giorni senza token e senza agente in esecuzione. Resta su solo l'hub, che è poca cosa da lasciare acceso.
Secondo l'event sourcing. Ogni pezzo di stato deriva da un log append-only, e il log viene scritto nella stessa transazione dell'indice prima che l'hub risponda. Uccidi il processo e il lavoro confermato sopravvive. Ogni giro si può spiegare dopo con il suo numero. Un cambio di schema si ricostruisce dal log invece di richiedere script di migrazione.
Terzo la separazione tra istruzioni e dati. Il testo esterno, come il titolo di un issue, viene salvato come materiale in un file e non è mai concatenato nel prompt. Il prompt porta solo tipo, id e link validati. Quale agente gira, in quale directory, con quale accesso, viene interamente dalle tue regole locali. Un evento che arriva con cwd, agent o access viene rifiutato.
Quarto il hop fuse, il mio preferito. Gli eventi generati da un agente e rispediti ad altri agenti accumulano profondità, come un pacchetto accumula un TTL. Le domande umane e i ricontrolli programmati non azzerano il contatore, e l'agente non può modificarlo. Oltre 8 livelli l'hub smette di consegnare, registra l'evento e ti manda una scheda.
I numeri, e dove smetto di crederci
La tabella di benchmark viene da un Apple M5 Pro con 24 GB e Node 24.21.0, con ogni scrittura confermata singolarmente e la transazione su disco prima della risposta. Avvio a freddo 88.78 ms. Memoria inattiva 59.94 MB RSS. Mille long poll simultanei a 170.49 MB. 2,394 scritture durevoli al secondo. p99 di consegna 1.82 ms, e un p99 di heartbeat di 1.66 ms con 5,000 elementi in coda. Avvio su 1.1 milioni di fatti in 99.8 ms. Zero dipendenze a runtime.
Sono numeri di coda, non di applicazione, ed è esattamente il punto. Un hub che salva l'attesa come riga e il lavoro come evento dovrebbe comportarsi come una coda.
Il mio scetticismo: una macchina, un operatore, una page cache calda e un harness scritto da chi ha scritto il kernel. Il benchmark non gira mai su un portatile con una videochiamata e una build in background, quindi leggilo come limite inferiore, non come promessa. La cifra di 1.1 milioni di fatti è accompagnata altrove anche da un costo onesto. Il README dice che il primo avvio dopo un cambio di formato ricostruisce dal log, e che ci sono voluti 43.1 secondi. Va bene su un portatile, scomodo se pensavi altro.
Due punti in cui l'autonomia può farti male, e cosa erediti
La sicurezza è il punto in cui gli autori sono stati meno furbi, e lo dico come elogio. La separazione tra istruzioni e dati significa che un titolo di issue ostile non può spostare un'esecuzione in un'altra directory o verso un altro agente, perché quei campi vengono rifiutati alla porta. Il hop fuse significa che un gruppo di agenti che si passano lavoro non può girare all'infinito, perché la profondità la incrementa l'hub e non i partecipanti.
Nessuna delle due è una prova. Il fuse è una policy a 8 livelli. Se un flusso legittimo ne richiede 9 hai un problema, e se il caso pericoloso è un ciclo lento a due livelli che fa danni veri a ogni salto, il fuse non scatta mai. La separazione protegge la decisione di consegna, non quello che l'agente fa dopo aver ottenuto una shell nella directory che gli hai dato.
La simulazione è più solida della maggior parte dei progetti. node sim/random.ts 24301 200000 esegue 200,000 passi di connessioni cadute, pacchetti persi, crash e invii duplicati sotto un seed fisso, così un guasto si può riprodurre. node sim/crash.ts 1000 12648430 uccide il processo 1,000 volte e verifica che nessun record confermato sparisca. Poi il README aggiunge che la perdita di alimentazione dell'intera macchina non è stata provata. Rispetto quella frase, e mi fa chiedere cos'altro non sia stato provato. I template webhook sono stati eseguiti solo contro server mock locali. Il webhook GitLab è stato verificato contro il formato documentato e mai contro un GitLab vero. Gli script delle ricette sono stati validati contro un finto CLI Feishu. Ognuno è un punto in cui "testato" significa meno di quanto un lettore supporrà.
Quello che erediti con un kernel scritto a mano e zero dipendenze a runtime è la manutenzione. Un albero di dipendenze piccolo invecchia bene se qualcuno ci guarda e male quando l'autore passa ad altro. È il prezzo di un avvio a freddo da 88 ms.
Un dettaglio di fatturazione resta fuori dal progetto. L'hub guida gli strumenti CLI già installati e con accesso sulla tua macchina, quindi l'uso finisce sul tuo account o abbonamento. Il README nota che i fornitori preferiscono le API key per l'automazione ad alta frequenza, perché i piani personali sono pensati per un'interazione al ritmo umano. Rileggilo due volte prima di puntare una regola cron sulla tua sessione Claude Code e andare a dormire.
Un rischio sopravvive a tutti i meccanismi sopra. Un ciclo che può aprire issue su GitHub, e con la pipeline di consegna fare merge di pull request con etichetta deliver, è un attore della supply chain con le tue credenziali. Tutto quanto sopra lo rende affidabile e gli mette un guinzaglio corto. Il passo di review che hai configurato è l'unica cosa tra lui e un merge sbagliato, e nessuna quantità di event sourcing migliora una review che non hai letto.
Articoli correlati
Un foglio di calcolo comunitario di tocchi che spegne la pubblicità negli Android cinesi
Non tocca il sistema, non sblocca niente, non flasha niente. Ribalta solo gli interruttori che i produttori hanno già previsto. Il prezzo è una lista che qualcuno deve continuare a scrivere.
GPT Image 2.6 ha tenuto il prezzo dei token e alzato la fattura
GPT Image 2.6 conserva ogni tariffa per token di 2.5 e costa comunque di più per immagine, perché buona parte del lavoro passa ora nei token di output. Undici giorni dopo il lancio, la struttura dei prezzi dice più della classifica.
Qualcuno ha ricostruito IDM dall'esterno e ha scritto cosa non ha toccato
Una reimplementazione in Rust di Internet Download Manager promette 5 volte la velocità e 86 lingue. Il documento più interessante è il paragrafo che spiega come è stata costruita senza copiare nulla.
Rune è un framework UI per Rust costruito perché un agente possa verificare il proprio lavoro
Rune renderizza headless, esporta il suo albero di elementi e accetta input scriptato, dando a un agente di coding un segnale diffabile che nessuno screenshot può offrire. Il framework è in pre-release e non accetta pull request.