Skip to content
Core ConceptsCLI ReferenceAPI Reference
AgentHeartbeat
AGH RuntimeAgent

agh 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.

agh agent heartbeat rollback

Rollback HEARTBEAT.md to a managed revision or snapshot digest

agh agent heartbeat rollback <agent> [flags]

Examples

  agh agent heartbeat rollback coder --revision-id rev_123 --if-match sha256:old --json

Options

  -h, --help                     help for rollback
      --idempotency-key string   Optional idempotency key
      --if-match string          Expected current Heartbeat digest for CAS
      --revision-id string       Managed Heartbeat revision id to restore
      --target-digest string     Heartbeat snapshot digest to restore
      --workspace string         Resolve the agent from a workspace 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 AGH 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:

agh agent heartbeat rollback <agent> -o json

agh agent heartbeat inspect

Inspect one agent's resolved Heartbeat policy

agh agent heartbeat status

Read Heartbeat policy status and wake eligibility

On this page

agh agent heartbeat rollbackExamplesOptionsOptions inherited from parent commandsOutput Formats