Skip to content

Heartbeat

Sidebar → Heartbeats → New

Heartbeat lets an agent wake itself up on a fixed interval and run a prompt without any user message — useful for monitoring, daily summaries, scheduled outreach, or any "check in periodically and do X" workflow.

When to Use Heartbeat vs Agenda

NeedUse
Run a fixed prompt every N seconds/minutesHeartbeat
Track reminders, routines, or one-off tasks from conversation contentAgenda
Run on cron (e.g. weekdays at 9am) with item state and fire historyAgenda

Heartbeat is a fixed-interval loop attached to an agent + target. Agenda is the stateful system for reminders, routines, and cron-style triggers.

Configuration

FieldDescription
NameDisplay name
AgentWhich agent should run on each tick
TargetA specific channel user, web session, or working directory
IntervalTick period (seconds/minutes/hours)
PromptPrompt template the agent receives on each tick
EnabledToggle without deleting

Examples

  • Status digest — every 1h, summarize new messages in a busy Lark group and drop the digest in a "summary" thread
  • Watchdog — every 5min, query a health endpoint via the Web tool; ping you only on failure
  • Standup buddy — every weekday morning, ask the user how yesterday went and write a note

Notes

  • Each heartbeat target gets its own conversation thread (isolated history)
  • Combine with Memory so the agent learns from each tick
  • For stateful reminders/schedules driven by conversation content, use Agenda instead
  • Disable a heartbeat to pause without losing its config

Released under the MIT License.