← Voltar ao blog
Aicerca de 8 min de leitura

agent-autoloop guarda a espera por um humano como uma linha no banco de dados

Publicado 15 de nov. de 2026
agent-autoloop guarda a espera por um humano como uma linha no banco de dados

A cada poucas semanas vejo a mesma cena: alguém inicia um agente de código no terminal, levanta para fazer café e volta encontrando ele parado numa pergunta que ninguém viu. A correção de sempre é aumentar o volume da notificação. O agent-autoloop ataca o desperdício por baixo: um processo e uma janela de contexto abertos, sem fazer nada, enquanto a pessoa está longe do teclado.

É um hub local, 5,459 estrelas no GitHub em 15 de novembro de 2026, licença MIT. Ele observa eventos, entrega ao agente de linha de comando que você já usa e sai da frente. O agente conclui uma rodada, escreve a resposta, encerra. Quando precisa de uma decisão, o hub manda um card para a sua área de trabalho, ou para Feishu, DingTalk, WeCom, Slack ou Discord. Você escolhe uma opção. O agente retoma a conversa.

Sem máquina na nuvem, sem porta aberta, sem dashboard.

Instalar, e o único comando que prova que funciona

Requisitos: Node 24 ou mais novo, Git e um agente de linha de comando já instalado e com login feito. No macOS e no Linux você também precisa de 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

Depois rode agent-autoloop try. Um script de instalação que imprime um número de versão não prova nada sobre as flags e o login do seu agente funcionarem. O try percorre com o seu próprio agente um ciclo real de perguntar, esperar, responder, continuar: um evento sai, o agente trabalha, para, faz uma pergunta com opções, encerra e espera. Você responde, o hub retoma a sessão e termina. Se algo estiver mal configurado, você descobre em dois minutos, não às 2 da manhã quando uma regra cron dispara errado.

Uma frase de contrato, um arquivo de regras

A interface entre hub e agente é uma única convenção: colocar o resultado na resposta final. Sem SDK, sem wrapper, sem binário com patch. Qualquer coisa que aceite um prompt e imprima uma última mensagem pode ser conectada, e é por isso que um adaptador de comando genérico fica ao lado de Claude Code, Codex, ACP, DeepSeek Harness e ZCode.

Perguntar é um acréscimo. O agente termina a resposta com um bloco delimitado chamado agent-autoloop contendo JSON: um array ask com título, texto, opções e uma chave, mais notice, resolve, later e events para os outros verbos. Esse é todo o protocolo que um autor de agente precisa aprender.

As regras ficam em ~/.agent-autoloop/rules.json. Uma regra responde a três perguntas: o que aconteceu, qual agente recebe, em qual diretório roda.

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

Uma regra de evento troca o relógio por uma fonte: casar issues.opened do GitHub, adicionar parallel: 3 e uma skill, mesma forma. Dois arquivos guardam a configuração, este e o que o seu agente já lê. Gosto do fato de ser inspecionável e fácil de diffar.

Quatro mecanismos emprestados do trabalho de sistemas

O kernel é onde o desenho começa a ficar interessante. Isoladamente, quase nada ali é novo.

Primeiro, a suspensão de custo zero. Enquanto espera, o processo encerra e o estado vai para um banco de dados. Três dias de silêncio custam três dias sem tokens e sem agente rodando. Só o hub fica de pé, o que é pouca coisa para deixar ligada.

Segundo, event sourcing. Cada pedaço de estado deriva de um log append-only, e o log é escrito na mesma transação do índice antes de o hub responder. Mate o processo e o trabalho confirmado sobrevive. Qualquer rodada pode ser explicada depois pelo número. Mudança de schema se reconstrói a partir do log, sem scripts de migração.

Terceiro, separação entre instrução e dados. Texto externo, como o título de um issue, é guardado como material num arquivo e nunca concatenado no prompt. O prompt carrega apenas tipo, id e link validados. Qual agente roda, em qual diretório, com qual acesso, vem inteiramente das suas regras locais. Um evento que chega com cwd, agent ou access é rejeitado.

Quarto, o hop fuse, meu favorito. Eventos gerados por agente e despachados de volta para agentes acumulam profundidade, como um pacote acumula um TTL. Perguntas humanas e rechecagens agendadas não zeram o contador, e o agente não consegue editá-lo. Passados 8 níveis, o hub para de despachar, registra o evento e manda um card para você.

Os números, e onde eu paro de acreditar neles

A tabela de benchmark vem de um Apple M5 Pro com 24 GB e Node 24.21.0, com cada escrita confirmada individualmente e a transação em disco antes da resposta. Início a frio 88.78 ms. Memória ociosa 59.94 MB RSS. Mil long polls simultâneos a 170.49 MB. 2,394 escritas duráveis por segundo. p99 de despacho de 1.82 ms, e um p99 de heartbeat de 1.66 ms com 5,000 itens na fila. Início sobre 1.1 milhão de fatos em 99.8 ms. Zero dependências em tempo de execução.

São números de fila, não de aplicação, e esse é o ponto. Um hub que guarda a espera como linha e o trabalho como evento deveria se comportar como uma fila.

Meu ceticismo: uma máquina, um operador, um cache de páginas quente e um harness escrito por quem escreveu o kernel. O benchmark nunca roda num notebook com uma chamada de vídeo e um build em segundo plano, então leia como limite inferior, não como promessa. O número de 1.1 milhão de fatos também vem acompanhado, em outro lugar, de um custo honesto. O README diz que o primeiro início após mudança de formato reconstrói a partir do log, e que isso levou 43.1 segundos. Tudo bem num notebook, incômodo se você supunha outra coisa.

Dois lugares onde a autonomia pode te machucar, e o que você herda

Segurança é onde os autores foram menos espertos, e digo isso como elogio. A separação entre instrução e dados significa que um título de issue hostil não consegue redirecionar uma execução para outro diretório ou outro agente, porque esses campos são recusados na porta. O hop fuse significa que um conjunto de agentes passando trabalho adiante não gira para sempre, porque a profundidade é incrementada pelo hub e não pelos participantes.

Nenhuma das duas é prova. O fuse é uma política de 8 níveis. Se um fluxo legítimo precisa de 9, o problema é seu, e se o caso perigoso é um loop lento de dois níveis que causa dano real a cada salto, o fuse nunca dispara. A separação protege a decisão de despacho, não o que o agente faz depois de conseguir um shell no diretório que você entregou.

A simulação é mais forte que na maioria. node sim/random.ts 24301 200000 roda 200,000 passos de conexões derrubadas, pacotes perdidos, crashes e envios duplicados sob uma seed fixa, então uma falha pode ser reproduzida. node sim/crash.ts 1000 12648430 mata o processo 1,000 vezes e verifica que nenhum registro confirmado desaparece. Depois o README acrescenta que a perda total de energia da máquina não foi testada. Respeito essa frase, e ela me faz perguntar o que mais não foi. Os templates de webhook só rodaram contra servidores mock locais. O webhook do GitLab foi conferido contra o formato documentado e nunca contra um GitLab real. Os scripts de receita foram validados contra um CLI falso do Feishu. Cada um é um lugar onde "testado" significa menos do que um leitor vai supor.

O que você herda com um kernel escrito à mão e zero dependências em tempo de execução é a manutenção. Uma árvore de dependências pequena envelhece bem quando alguém está olhando e mal quando o autor segue em frente. Esse é o preço de um início a frio de 88 ms.

Um detalhe de cobrança fica completamente fora do desenho. O hub conduz as ferramentas CLI já instaladas e logadas na sua máquina, então o uso cai na sua própria conta ou assinatura. O README observa que os fornecedores preferem chaves de API para automação de alta frequência, porque planos pessoais são feitos para interação no ritmo humano. Leia isso duas vezes antes de apontar uma regra cron para a sua sessão do Claude Code e ir dormir.

Um risco sobrevive a todos os mecanismos acima. Um loop que consegue abrir issues no GitHub, e com o pipeline de entrega fazer merge de pull requests com a label deliver, é um ator da cadeia de suprimentos com as suas credenciais. Tudo acima o torna confiável e coloca uma coleira curta nele. O passo de review que você configurou é a única coisa entre ele e um merge ruim, e nenhuma quantidade de event sourcing melhora uma review que você não leu.

Artigos relacionados