Skip to content
Ch
AGH RuntimeCh

agh ch reply

Reply to a received coordination message

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

agh ch reply

Reply to a received coordination message

agh ch reply [flags]

Examples

  # Reply to one received coordination message
  agh ch reply --to-message msg-123 --body '{"answer":"ready for review"}'

  # Add explicit correlation metadata when replying from outside an inherited delivery
  agh ch reply \
    --to-message msg-123 \
    --task-id task-123 \
    --run-id run-123 \
    --coordination-channel-id coord-run-123 \
    --correlation-id run-123 \
    --body '{"answer":"ready for review"}'

Options

      --body string                      Raw JSON body for the reply message
      --coordination-channel-id string   Coordination channel id; defaults to channel
      --correlation-id string            Correlation id; defaults to run id
  -h, --help                             help for reply
      --idempotency-key string           Optional idempotency key/message id
      --kind string                      Coordination message kind (default "reply")
      --metadata-ext string              Optional JSON object for coordination metadata ext
      --run-id string                    Run id for coordination metadata
      --task-id string                   Task id for coordination metadata
      --to-message string                Message id to reply to
      --workflow-id string               Workflow id for coordination metadata

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 ch reply -o json

On this page