Skip to content
AgentHeartbeat
CompozyOS RuntimeAgent

compozy agent heartbeat

Inspect and manage agent HEARTBEAT.md files

Audience
Operators running durable agent work
Focus
Agent guidance shaped for scanability, day-two clarity, and operator context.

compozy agent heartbeat

Inspect and manage agent HEARTBEAT.md files

Options

  -h, --help   help for heartbeat

Options inherited from parent commands

      --json            Emit JSON output
  -o, --output string   Output format: human, json, jsonl, or toon (default "human")

Output Formats

Every Compozy command supports -o, --output:

  • human for interactive terminal use
  • json for scripts and other machine-readable consumers
  • jsonl for wait or streaming commands that emit one JSON record per line
  • toon for compact agent-readable summaries

Subcommands

CommandDescription
compozy agent heartbeat deleteDelete HEARTBEAT.md through managed authoring
compozy agent heartbeat historyList managed Heartbeat authoring revisions
compozy agent heartbeat inspectInspect one agent's resolved Heartbeat policy
compozy agent heartbeat rollbackRollback HEARTBEAT.md to a managed revision or snapshot digest
compozy agent heartbeat statusRead Heartbeat policy status and wake eligibility
compozy agent heartbeat validateValidate a proposed Heartbeat policy body
compozy agent heartbeat wakeRequest one manual advisory Heartbeat wake
compozy agent heartbeat writeCreate or replace HEARTBEAT.md through managed authoring

On this page