Skip to Content

hiveloom schedule

Creates and manages cron-style scheduled jobs for an agent. Each job has a prompt template and a schedule expression; at each fire, Hiveloom runs the prompt against the agent and persists the result.

Synopsis

hiveloom schedule [GLOBAL FLAGS] <COMMAND>

Global flags

FlagDefaultDescription
--tenant <TENANT>defaultTenant slug.
--endpoint <URL>API endpoint.
--token <TOKEN>Bearer token.
--jsonJSON output.

Subcommands

SubcommandPurpose
createCreate a scheduled job.
listList jobs for an agent.
showShow one job, including last run + next fire.
pausePause a job (kept on disk; stops firing).
resumeResume a paused job.
deleteDelete a job.

Examples

Daily 09:00 summary fed to a “summariser” agent:

hiveloom schedule create \ --agent summariser \ --cron "0 9 * * *" \ --prompt "Summarise yesterday's events." \ --label morning-summary

Inspect:

hiveloom schedule list --agent summariser hiveloom schedule show sch_abc123 --agent summariser

Pause for the weekend, resume Monday:

hiveloom schedule pause sch_abc123 --agent summariser hiveloom schedule resume sch_abc123 --agent summariser

Delete:

hiveloom schedule delete sch_abc123 --agent summariser

Cron format

Standard 5-field cron (min hour dom month dow). Schedules are evaluated in the host’s local timezone. There is no second-precision; the smallest interval is one minute.

See also