Task

CompozyOS RuntimeTask

compozy task heartbeat

Extend a claimed task run lease for the current agent session

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

compozy task heartbeat

Extend a claimed task run lease for the current agent session

compozy task heartbeat <run-id> [flags]

Examples

  # Extend the active session-bound lease
  compozy task heartbeat run-123

	  # Request a specific lease duration
  compozy task heartbeat run-123 --lease-seconds 300

Options

  -h, --help                help for heartbeat
      --lease-seconds int   Lease duration in seconds

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 task heartbeat <run-id> -o json

compozy task get

Show one task with related detail

compozy task inspect

Inspect a task or run with diagnostics

On this page

compozy task heartbeat Examples Options Options inherited from parent commands Output Formats