Skip to content
Network
AGH RuntimeNetwork

agh network send

Send one envelope through the daemon-owned network runtime

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

agh network send

Send one envelope through the daemon-owned network runtime

agh network send [flags]

Options

      --body string           Raw JSON object for the envelope body
      --causation-id string   Optional causation id
      --channel string        Target channel
      --direct string         Direct room id for direct-surface messages
      --expires-at string     Optional expiry as unix seconds or RFC3339
      --ext string            Optional JSON object of extension metadata
  -h, --help                  help for send
      --id string             Optional explicit message id
      --kind string           Envelope kind
      --reply-to string       Optional reply-to message id
      --session string        Local source session id
      --surface string        Conversation surface: thread or direct
      --thread string         Thread id for thread-surface messages
      --to string             Directed target peer id
      --trace-id string       Optional trace id
      --work string           Optional work id

Options inherited from parent commands

      --json               Emit JSON output
  -o, --output string      Output format: human, json, jsonl, or toon (default "human")
      --workspace string   Workspace root, name, or ID for scoped network data

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 network send -o json

On this page