Skip to content
Core ConceptsCLI ReferenceAPI Reference
NetworkDirects
AGH RuntimeNetwork

agh network directs messages

List messages in one direct room

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

agh network directs messages

List messages in one direct room

agh network directs messages [flags]

Options

      --after string     Cursor after which to list messages
      --before string    Cursor before which to list messages
      --channel string   Target channel
      --direct string    Direct room id
  -h, --help             help for messages
      --kind string      Envelope kind filter
      --limit int        Maximum number of messages to return
      --work string      Work id filter

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 network directs messages -o json

agh network directs list

List direct rooms in a channel

agh network directs resolve

Create or return the deterministic direct room for two peers

On this page

agh network directs messagesOptionsOptions inherited from parent commandsOutput Formats