Heartbeat & Scheduled Tasks

Periodic tasks and cron. Configure in config. Store jobs in workspace/cron/. See Docs.

HEARTBEAT.md

Create HEARTBEAT.md in your workspace. The agent reads it every 30 minutes (configurable) and runs tasks. Example: “Check my email”, “Review calendar”, “Check weather”.

Task types

  • One-time reminders: “Remind me in 1 hour”
  • Recurring: “Send daily report at 8am”
  • Cron expressions: “Remind me at 9am daily”

CLI: picoclaw cron list, picoclaw cron add .... See CLI reference.

Async tasks with spawn

For long tasks (web search, API calls), use the spawn tool to create a subagent. Subagent runs independently and can use the message tool to reply. Heartbeat continues without blocking. Details: GitHub README.

Config

heartbeat.enabled, heartbeat.interval (minutes, min 5). Env: PICOCLAW_HEARTBEAT_ENABLED, PICOCLAW_HEARTBEAT_INTERVAL. See Configuration.

Related