Sessões Heartbeats — Tarefas Longas Permanencem Ativas

Imagine que você está trabalhando com um assistente dedicado que não fica olhando por cima do seu ombro, mas, de vez em quando, dá uma olhadinha discreta naquilo que você pediu para ele monitorar — e só fala algo quando algo realmente muda. Essa é a realidade do dia a dia do /heartbeat: ele permite que a IA “revise” automaticamente uma tarefa em um agendamento, tudo dentro da mesma conversa.

O Que É?

O /heartbeat define um lembrete recorrente para a sua sessão atual. Quando a conversa está ociosa e o tempo se esgota, a IA envia uma mensagem para si mesma — exatamente como um usuário comum faria. O detalhe chave: ele nunca interrompe uma tarefa em andamento. Ele só entra durante uma “pausa”, usando uma mensagem de usuário normal, e não altera nenhuma configuração do sistema.

Qual a Diferença para o Cron?

	/heartbeat	hermes cron
Contexto	Conversa atual — memória e contexto completos	Sessão nova e isolada a cada vez
Após reiniciar	Estado salvo no banco de dados, retoma depois	Totalmente persistente
Quantidade	Um por sessão	Ilimitado
Melhor para	“Fique de olho neste tópico”	Tarefas independentes, relatórios agendados

Regra rápida: se o lembrete depende do histórico da conversa, use o /heartbeat. Se a tarefa for totalmente independente, use o cron.

Comandos Principais

# Define um heartbeat (verificar o deploy a cada 10 minutos)
/heartbeat every 10m Check the deployment and report meaningful changes

# Ver o status atual
/heartbeat status

# Pausar (sem deletar)
/heartbeat pause

# Retomar (o timer reinicia, não dispara imediatamente)
/heartbeat resume

# Remover completamente
/heartbeat clear

/hb é um atalho útil. Intervalos suportados: 90s, 10m, 2h, 1d (mínimo de 60 segundos).

Pequenos Detalhes Pensados

• Só dispara quando você está ocioso — se a IA estiver ocupada, o heartbeat espera pacientemente. Sem furar fila.
• Sem acúmulo — se vários ciclos passarem sem um disparo, apenas uma mensagem é enviada. Sem acúmulo de mensagens.
• Mensagens do usuário vêm primeiro — as suas mensagens sempre têm prioridade sobre um heartbeat.
• Sem trabalho forçado — as mensagens de heartbeat trazem uma instrução embutida: “se nada mudou, responda brevemente.” Sem necessidade de fingir atividade.

Um Exemplo Prático

Você: /heartbeat every 15m Check whether the CI run for PR #1234 finished; summarize the result when it does

  ♥ Heartbeat definido (a cada 15m): verificar CI do PR #1234; resumir quando terminar

[15 minutos depois, você está ocupado com outra coisa]

Hermes: [heartbeat disparado]
  💻 gh pr checks 1234   (1.2s)
  CI passou ✅ Todos os testes verdes

Resumo e Conselhos Práticos

O /heartbeat é como um despertador inteligente para a sua conversa — ele lembra do contexto, respeita o seu ritmo e só te cutuca quando é importante. Melhor caso de uso: cenários de “vigiar enquanto eu trabalho” — esperar um deploy, monitorar anomalias de log ou acompanhar o desdobramento de uma discussão. Lembre-se: se uma tarefa for completamente independente do chat atual, o cron é a aposta mais segura. Mas, se for sobre “ficar ligado neste tópico”, o heartbeat é o seu parceiro perfeito.

---