Skip to content
Core ConceptsCLI ReferenceAPI Reference
AgentHeartbeat
CompozyOS RuntimeAgent

compozy agent heartbeat rollback

Rollback HEARTBEAT.md to a managed revision or snapshot digest

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

compozy agent heartbeat rollback

Rollback HEARTBEAT.md to a managed revision or snapshot digest

compozy agent heartbeat rollback <agent> [flags]

Examples

  compozy agent heartbeat rollback coder --revision-id rev_123 --expected-digest sha256:old --json

Options

      --expected-digest string   Expected current Heartbeat digest for CAS
  -h, --help                     help for rollback
      --idempotency-key string   Optional idempotency key
      --if-match string          Alias for --expected-digest
      --revision-id string       Managed Heartbeat revision id to restore
      --target-digest string     Heartbeat snapshot digest to restore
      --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 rollback <agent> -o json

compozy agent heartbeat inspect

Inspect one agent's resolved Heartbeat policy

compozy agent heartbeat status

Read Heartbeat policy status and wake eligibility

On this page

compozy agent heartbeat rollbackExamplesOptionsOptions inherited from parent commandsOutput Formats