Skip to content

compozy agent heartbeat status

Read Heartbeat policy status and wake eligibility

For people running agent work9 pages in this section

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

The root -o, --output flag accepts these values. A renderer is supported only when this command writes that result; jsonl is for commands that emit one JSON record per line.

FormatCommand result
humanInteractive terminal rendering
jsonMachine-readable JSON rendering
jsonlOne JSON record per line when supported
toonCompact agent-readable rendering

Example:

compozy agent heartbeat status <agent> -o json

On this page