Comando hermes cron — Referência Completa e Exemplos

Visão Geral

hermes cron gerencia o agendador cron integrado. Você pode criar tarefas agendadas que invocam o agente, executam um script ou entregam a saída a uma plataforma de mensagens. Os agendamentos suportam formas legíveis (30m, every 2h) e expressões cron padrão (0 9 * * *).

hermes cron <list|create|add|edit|pause|resume|run|remove|rm|delete|status|runs|history|tick>

Subcomandos

list — Listar tarefas agendadas

hermes cron list
hermes cron list --all      # Incluir tarefas desabilitadas

create / add — Criar uma tarefa agendada

hermes cron create "0 9 * * 1-5" "Resumir as sessões de ontem e planejar as tarefas de hoje"
hermes cron add "every 2h" --name "health-check" --script ~/.hermes/scripts/health.py

Principais flags: --name, --deliver, --repeat, --skill, --script, --no-agent, --workdir, --model, --provider.

• --script executa um script em ~/.hermes/scripts/. Sem --no-agent, sua saída é injetada no prompt do agente. Com --no-agent, o script é a própria tarefa e sua saída é entregue diretamente.
• --no-agent ignora o LLM por completo; útil para alertas de vigilância (disco, CI, memória).

edit — Modificar uma tarefa existente

hermes cron edit <job_id> --schedule "0 8 * * *" --prompt "Novo prompt"

Flags: --schedule, --prompt, --name, --deliver, --repeat, --skill, --add-skill, --remove-skill, --clear-skills, --script, --no-agent, --agent, --workdir, --model, --provider.

pause / resume — Controlar uma tarefa

hermes cron pause <job_id>
hermes cron resume <job_id>

run — Acionar uma tarefa no próximo tick

hermes cron run <job_id>

Use --accept-hooks para aprovar automaticamente os shell hooks solicitados pela tarefa.

remove / rm / delete — Remover uma tarefa

hermes cron remove <job_id>
hermes cron rm <job_id>
hermes cron delete <job_id>

status — Verificar se o agendador está em execução

hermes cron status

runs / history — Mostrar tentativas de execução

hermes cron runs
hermes cron runs <job_id> --limit 20

tick — Executar tarefas pendentes uma vez e sair

hermes cron tick
hermes cron tick --accept-hooks

Cenários Comuns

Resumo matinal diário

hermes cron create "0 9 * * 1-5" "Resumir as sessões de ontem e planejar as tarefas de hoje" --name morning-briefing

Verificação de saúde baseada em script

hermes cron add "*/30 * * * *" --name health-check --script ~/.hermes/scripts/health.sh --no-agent --deliver telegram:123456

Testar e iterar

hermes cron create "* * * * *" "Teste rápido" --name test-job
hermes cron run test-job-id
hermes cron edit test-job-id --schedule "0 9 * * *"

Dicas

• create e add são apelidos.
• tick processa as tarefas pendentes e encerra; ideal para depuração e schedulers externos.
• É necessário um gateway em execução para usar --deliver em plataformas de chat.
• Use --model e --provider para fixar um modelo de inferência específico.
• --workdir injeta arquivos de contexto do projeto (AGENTS.md, CLAUDE.md, .cursorrules) e define o diretório de trabalho.