Hermes Scheduler

Schedule recurring agent tasks on cron/interval/one-shot schedules — start with /hermes-scheduler. Triggers: 'run this every 30m', 'schedule a daily 9am job', 'cron job that invokes Claude Code', 'background scheduler for agent tasks'. A standalone Python daemon that runs natural-language jobs via `claude --print`, persists jobs across restarts, and saves per-run output. Inspired by NousResearch/hermes-agent. NOT for one-off tasks you can run now, NOT a system-cron/systemd replacement, and NOT for orchestrating multi-agent swarms.

dreamlab-ai Updated 23 repo stars
Conceptual modular agent workshop with connected workspaces

File contents

Hermes Scheduler

Background cron scheduler that runs agent tasks on schedule. Jobs are defined in natural language, executed via claude --print, and output is saved per-run. Jobs persist across restarts.

Quick start

The scheduler is a single baked binary, hermes-scheduler (on PATH from the agentbox-ops crate).

hermes-scheduler start                     # start daemon (60s tick)
hermes-scheduler add \
  --prompt "check disk usage and alert if over 80%" \
  --schedule "every 30m" --name "disk-monitor"
hermes-scheduler list                       # list jobs
hermes-scheduler status                     # daemon status

Schedules accept durations (30m, one-shot), intervals (every 2h), cron (0 9 * * *), or ISO timestamps (2026-04-07T09:00).

Runtime state lives under ~/.claude/scheduler/ (jobs, output, PID) and is created by the daemon on first run.

Depth

  • Full command reference, schedule formats, job execution, persistence, and architecture: references/commands.md

dreamlab-ai/agentbox commit 40c21be7e5

Frequently asked questions

npx get-skill add dreamlab-ai/hermes-scheduler