Skip to content
Core ConceptsCLI ReferenceAPI Reference
NetworkDirects
CompozyOS RuntimeNetwork

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

compozy network directs messages

List messages in one direct room

compozy 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")
      --workspace string   Override workspace binding (ID, name, or path)

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

compozy network directs list

List direct rooms in a channel

compozy network directs resolve

Create or return the deterministic direct room for two peers

On this page

compozy network directs messagesOptionsOptions inherited from parent commandsOutput Formats