Skip to content
Ch
CompozyOS RuntimeCh

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

compozy ch reply

Reply to a received coordination message

compozy ch reply [flags]

Examples

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

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

Options

      --body string              Raw JSON body for the reply message
      --channel-id string        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 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 ch reply -o json

On this page