Set Beat
Schedule a reminder or a background "beat" with a 5-field cron expression.
tool name: set_beat
Saves a reminder (a scheduled nudge to the user) or a scheduled_beat (an automated background agent run) with a standard 5-field cron expression.
Default behavior is a one-time beat — every field is pinned; wildcards are used only when you explicitly ask for a recurring pattern ("every day", "every Monday").
Not available to the heartbeat sub-agent itself, so a beat cannot recursively schedule more beats.
Download from Koris
Run this from the koris repository root:
pnpm hub:pull set-beat
Trusted senders can also download it from chat:
/tools download set-beat
If the plugin is already installed, add --force to overwrite it.
Downloaded files go to plugins/tools/set-beat/
Tools, skills, and MCP servers are downloaded from the main branch.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| beat | string | yes | What the user wants to be reminded about, or the beat to schedule. |
| type | stringreminder, scheduled_beat | — | Defaults to "reminder". "scheduled_beat" runs the agent in the background. |
| cron_expression | string | yes | 5-field cron: "minute hour day-of-month month day-of-week". |
| channel | stringtelegram, whatsapp | — | Channel to use instead of the current chat, if this beat should notify a different chat. Must be provided together with target. |
| target | string | — | Recipient address (Telegram chat id or WhatsApp JID) to use instead of the current chat. Must be provided together with channel. |