Skip to main content
A heartbeat is one execution cycle for an agent — they wake up, check their tools and memory, act on any assigned tasks, and update their state. Normally heartbeats run automatically on a schedule. Use heartbeat run to trigger one manually.
You do not need to run heartbeats yourself in a production setup. Zmeel dispatches them automatically based on each agent’s schedule and task assignments. Use this command for development, debugging, or to trigger an ad-hoc run without waiting for the next scheduled tick.

​
Command

​
heartbeat run

Invoke one heartbeat cycle for the specified agent and stream live logs until the run reaches a terminal state.
The command:
  1. Calls the agent’s wakeup endpoint on the Zmeel server.
  2. Polls for events and log output as the agent works.
  3. Prints status updates, adapter invocation details, and stdout/stderr from the agent process.
  4. Exits when the run reaches a terminal status: succeeded, failed, cancelled, or timed_out.

​
Options

​
Source and trigger values

--source describes what caused the heartbeat in business terms: --trigger describes the low-level mechanism:

​
Examples