Comando hermes cron — Referencia Completa y Ejemplos

Descripción General

hermes cron gestiona el programador cron integrado. Puedes crear trabajos programados que invoquen al agente, ejecuten un script o entreguen el resultado a una plataforma de mensajería. Los horarios admiten formas legibles (30m, every 2h) y expresiones cron estándar (0 9 * * *).

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

Subcomandos

list — Ver trabajos programados

hermes cron list
hermes cron list --all      # Incluir trabajos deshabilitados

create / add — Crear un trabajo programado

hermes cron create "0 9 * * 1-5" "Resumir las sesiones de ayer y planificar las tareas de hoy"
hermes cron add "every 2h" --name "health-check" --script ~/.hermes/scripts/health.py

Banderas clave: --name, --deliver, --repeat, --skill, --script, --no-agent, --workdir, --model, --provider.

• --script ejecuta un script en ~/.hermes/scripts/. Sin --no-agent, su salida se inyecta en el prompt del agente. Con --no-agent, el script es el trabajo completo y su salida se entrega directamente.
• --no-agent omite el LLM por completo; útil para alertas de vigilancia (disco, CI, memoria).

edit — Modificar un trabajo existente

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

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

pause / resume — Controlar un trabajo

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

run — Ejecutar un trabajo en el siguiente tick

hermes cron run <job_id>

Usa --accept-hooks para aprobar automáticamente los shell hooks que el trabajo solicite.

remove / rm / delete — Eliminar un trabajo

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

status — Verificar si el programador está activo

hermes cron status

runs / history — Mostrar intentos de ejecución

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

tick — Ejecutar trabajos pendientes una vez y salir

hermes cron tick
hermes cron tick --accept-hooks

Escenarios Comunes

Resumen matutino diario

hermes cron create "0 9 * * 1-5" "Resumir las sesiones de ayer y planificar las tareas de hoy" --name morning-briefing

Verificación de salud basada en script

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

Probar e iterar

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

Consejos

• create y add son alias.
• tick procesa los trabajos pendientes y termina; ideal para depurar y para schedulers externos.
• Se requiere un gateway en ejecución para usar --deliver hacia plataformas de chat.
• Usa --model y --provider para fijar el modelo de inferencia de un trabajo.
• --workdir inyecta contexto del proyecto (AGENTS.md, CLAUDE.md, .cursorrules) y establece el directorio de trabajo.