AgentHeartbeat

CompozyOS RuntimeAgent

compozy agent heartbeat status

Read Heartbeat policy status and wake eligibility

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

compozy agent heartbeat status

Read Heartbeat policy status and wake eligibility

compozy agent heartbeat status <agent> [flags]

Examples

  compozy agent heartbeat status coder --session sess_123 --workspace checkout-api --json

Options

  -h, --help                     help for status
      --include-session-health   Include session health when a session id is supplied
      --include-wake-events      Include recent wake audit rows
      --session string           Session id for wake state and health
      --workspace string         Override workspace context (ID, name, or path)

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

Example:

compozy agent heartbeat status <agent> -o json

compozy agent heartbeat rollback

Rollback HEARTBEAT.md to a managed revision or snapshot digest

compozy agent heartbeat validate

Validate a proposed Heartbeat policy body

On this page

compozy agent heartbeat status Examples Options Options inherited from parent commands Output Formats