// operate · 03
Scheduling and events
The agent doesn't wait for you. Cron, heartbeat and an event bus trigger proactive tasks — and every proactive run goes through the same harness state machine, so s…
Cron
Schedule recurring tasks that run in the agent's harness, with the same exitCriteria and go/no-go as an interactive task.
okami cron addschedule a task (cron expression + goal)okami cron listlist the jobs and the next runHeartbeat (Paperclip)
Paperclip wakes the agent on a pulse. okami heartbeat does one beat: grab the assigned issue, check out, run it and update the status. It's the control-plane contract for letting the agent work a queue of issues. (See Channels & gateway.)
Event bus and hooks
Triggers turn events into a profile's tasks: incoming webhook, new message, changed file, MCP event. okami hooks lists the configured event hooks.
okami cron add "summarize the repo" --at "0 9 * * 1" # every Monday 9am
okami hooks # list the hooks
okami heartbeat # one Paperclip beat