/loop: o vigia da sessão, com hora marcada

Por SkyNet · 25 de outubro de 2026

Para trabalho repetido, o Hermes tinha duas ferramentas dentro da sessão e nenhuma delas é um relógio: o /goal serve um objetivo com fim, com um juiz a decidir se chegaste lá; o /heartbeat é uma instrução que volta quando a sessão está parada. Fora dela, o cron marca as horas, mas noutro sítio. Faltava a peça do meio: repetir a mesma coisa a horas certas, aqui dentro. É o /loop.

O comando re-executa um prompt (ou um slash command) numa cadência recorrente, na sessão atual. Cada wakeup é um turno a sério: o agente relê o estado do zero (o CI, a fila, o ficheiro, o processo), faz o que houver para fazer e cala-se até ao tick seguinte. É a versão do Hermes do /loop do Claude Code; /proactive é alias.

Como se usa

/loop 5m check the deploy status and tell me if it's live yet
/loop 10m /recap
/loop keep an eye on the migration and summarize progress

A sintaxe é /loop [intervalo] <prompt> [--times N] [--until <condição>]. O intervalo aceita 30s, 5m, 2h ou unidades compostas como 1h30m; sem intervalo, o loop passa a self-paced.

/loop ou /loop status mostra o estado:

↻ Loop (active, every 5m, 0/100 budget, next in 4m): check the deploy status…
No loop set. Start one with /loop [interval] <prompt>.

Com --times a contagem sai em runs (0/30 runs); sem ele, vês o backstop (0/100 budget), e só com max_ticks: 0 aparece o número cru de ticks. Desde a v0.22.3, o CLI e a TUI mostram uma linha a contar para o próximo wakeup (↻ loop · every 5m · 2 runs · next in 4m · <prompt>), e no desktop é um cartão com contagem ao segundo.

Para travar: /loop pause pára sem perder, /loop resume volta a ligar, /loop stop termina.

As duas cadências

Com intervalo fixo, o relógio é teu. É o que queres quando o trabalho muda no tempo dele:

/loop 2m poll the build at ci.example.com/job/42 and ping me the moment it finishes

Sem intervalo, o ritmo é do agente. Arranca no piso (60 segundos por omissão) e, enquanto as respostas não mudarem, faz backoff: 2m, 4m, 8m, até ao tecto de 900 segundos. À primeira resposta diferente, volta ao piso. A mudança é detetada por um digest local que ignora timestamps: um «verificado às 14:02:33» não estraga o backoff, e esperar não custa tokens.

Regra prática: intervalo fixo quando é um relógio externo que manda no trabalho; self-paced quando é o trabalho a ditar o ritmo.

Quando é que isto pára

  • O agente decide que acabou. O prompt de wakeup ensina-o a terminar a resposta com LOOP_COMPLETE numa linha própria quando a tarefa está feita ou deixou de fazer sentido.
  • --times N: /loop 2m poll CI --times 30 dispara no máximo 30 vezes.
  • --until <condição>: /loop 5m watch the queue --until queue depth reaches zero. Depois de cada wakeup, o mesmo juiz auxiliar do /goal avalia a resposta; se o veredicto for «inatingível», o loop pausa com a razão em vez de disparar contra uma parede. Falhas do juiz são fail-open.
  • Tu: /loop stop ou /loop pause.
  • O backstop loops.max_ticks (100 por omissão), para uma sessão abandonada não queimar tokens para sempre.

O primeiro wakeup dispara logo; os seguintes esperam pela cadência.

O que se configura

# ~/.hermes/config.yaml
loops:
  min_interval_seconds: 30        # piso para intervalos fixos
  max_ticks: 100                  # backstop; 0 = sem limite
  self_paced_floor_seconds: 60    # arranque do self-paced
  self_paced_ceiling_seconds: 900 # tecto do backoff

O juiz do --until usa a tarefa auxiliar goal_judge, portanto auxiliary.goal_judge.* (provider e modelo) vale também para as condições do loop.

Onde corre

CLI, TUI, chat do dashboard, app desktop e todos os gateways. No Telegram ou no Discord, o gateway dispara os wakeups entre as tuas mensagens: o loop pertence à sessão daquele chat e os resultados chegam como respostas normais.

No desktop e no dashboard, uma sessão com /loop ativo está isenta do reaper: os wakeups esperam por ti ao reabrir a janela. Mas o backend tem de continuar a correr — um loop sem ninguém a olhar pede hermes serve ou o dashboard.

Com quem partilha a sessão

Um /goal ativo manda: enquanto o juiz disser «continua», os wakeups do loop adiam-se e só voltam a usar o tempo idle quando o goal termina, pausa ou estaciona num /goal wait. Um goal à espera de algo assíncrono com um /loop a vigiar outra coisa ao lado é uma boa combinação.

Uma mensagem tua ganha sempre aos dois: os wakeups só disparam com a sessão idle e nada teu na fila.

Trabalho autónomo, de noite, que sobreviva a fechar o terminal é cron. O /loop vive dentro de uma sessão; o cron vive fora de todas.

O que morde

O /loop não se acumula: um novo substitui o anterior daquela sessão. Para vigiar duas coisas ao mesmo tempo, são duas sessões.

Um Ctrl+C durante um wakeup pausa o loop em vez de o matar, e recuperas com /loop resume.

Intervalo abaixo de min_interval_seconds (30 segundos) é subido ao piso. Cada tick é um turno completo, e cadências mais apertadas são quase sempre acidente.

O estado vive no state_meta do SessionDB, em loop:<sessão>, partilhado entre CLI, TUI e gateway, e o gateway relê do DB: não há dois loops a disparar em duplicado. Pela mesma razão, um loop numa sessão descartável morre com o backend — não tem a durabilidade de um cron.

Fecho

O /loop resolve uma coisa pequena que chateia muito: perguntar de dois em dois minutos se já está. E as condições de paragem evitam a versão cara do problema: um agente a olhar para o mesmo ecrã durante uma hora.

O countdown da v0.22.3 parece detalhe de interface, mas muda o uso: vês quando é o próximo wakeup em vez de adivinhar se o loop está armado. Numa funcionalidade cujo custo é tempo de modelo, ver o relógio é metade do controlo.

Docs: Recurring Loops · /goal · Session Heartbeats · Release v0.22.3

Tags: #hermes #automacao #loops