Heartbeat Manager

Heartbeat são check-ins periódicos que um agent faz. O agent lê o arquivo HEARTBEAT.md do seu workspace e executa as instruções.

Como Funciona

•Agent tem heartbeat habilitado com intervalo (ex: 30min)
•A cada intervalo, o daemon envia prompt pro agent
•Agent lê HEARTBEAT.md e executa (ex: verificar pendências, enviar resumo)

Comandos

Ver status de todos

bash

ravi heartbeat status

Ver config de um agent

bash

ravi heartbeat show <agent>

Habilitar heartbeat

bash

ravi heartbeat enable <agent>
ravi heartbeat enable <agent> 30m    # Com intervalo

Desabilitar heartbeat

bash

ravi heartbeat disable <agent>

Configurar propriedades

bash

ravi heartbeat set <agent> interval 1h          # Intervalo
ravi heartbeat set <agent> model haiku          # Modelo (economia)
ravi heartbeat set <agent> active-hours 09:00-22:00  # Horário ativo
ravi heartbeat set <agent> active-hours always  # Sempre ativo

Disparar manualmente

bash

ravi heartbeat trigger <agent>

Arquivo HEARTBEAT.md

Cada agent precisa ter um HEARTBEAT.md no seu workspace com instruções do que fazer no check-in.

Exemplo:

markdown

# Heartbeat - Check-in Periódico

## O Que Verificar
- Tarefas pendentes
- Erros recentes nos logs
- Mensagens não respondidas

## Quando Notificar
- Se algo importante ficou pendente
- Se um processo crashou
- Se há muito tempo sem interação

## Como Notificar
Use cross_send para enviar mensagem:
ravi cross send target="agent:main:main" type="inform" message="..."

Exemplos

Configurar heartbeat básico:

bash

ravi heartbeat enable main 30m

Heartbeat só em horário comercial:

bash

ravi heartbeat enable main 1h
ravi heartbeat set main active-hours 09:00-18:00

Usar modelo mais barato:

bash

ravi heartbeat set main model haiku

Testar configuração:

bash

ravi heartbeat trigger main
ravi daemon logs -f