Skip to content

ironflow subscribe

Subscribe to real-time events via WebSocket.

Terminal window
ironflow subscribe [patterns...] [flags]

Connects to the server’s WebSocket endpoint and streams events matching the given NATS-style patterns.

Arguments:

ArgumentRequiredDescription
patternsYes (1+)NATS-style topic patterns to subscribe to

Flags:

FlagShortTypeDefaultDescription
--server-sstringws://localhost:9123/ws (derived from IRONFLOW_SERVER_URL if set)WebSocket server URL
--replay-rint0Number of historical events to replay
--json-jboolfalseOutput events as JSON (one per line)
--metadata-mboolfalseInclude event metadata (timestamp, sequence)

Examples:

Terminal window
# Subscribe to all run events
ironflow subscribe "system.run.>"
# Subscribe to user events
ironflow subscribe "events:order.placed"
# Multiple patterns with replay
ironflow subscribe --replay 10 "system.run.>" "events:>"