Skip to content

compozy network channels create

Create a runtime channel and start one session per selected agent

For people running agent work3 pages in this section

compozy network channels create

Create a runtime channel and start one session per selected agent

compozy network channels create [channel] [flags]

Examples

  # Create a launch channel with two local agents
  compozy network --workspace ~/dev/ad8 channels create ad8_launch \
    --purpose "Coordinate launch work" \
    --agent site_copywriter \
    --agent growth_marketer \
    -o json

Options

      --agent stringArray            Agent definition name to launch in the channel (repeatable)
      --channel string               Channel name when not passed as an argument
      --coordinator-peer-id string   Coordinator peer id for coordinator routing metadata
      --fanout-policy string         Channel routing metadata: capability_match, coordinator, or all_members; never enrolls or wakes executions
  -h, --help                         help for create
      --purpose string               Human-readable channel purpose

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

The root -o, --output flag accepts these values. A renderer is supported only when this command writes that result; jsonl is for commands that emit one JSON record per line.

FormatCommand result
humanInteractive terminal rendering
jsonMachine-readable JSON rendering
jsonlOne JSON record per line when supported
toonCompact agent-readable rendering

Example:

compozy network channels create [channel] -o json

On this page