Skip to main content

Synopsis

dorgu watch <subcommand> [flags]
Stream real-time updates from the Dorgu Operator over a WebSocket connection. The watch command opens a persistent connection to the operator and displays updates as they happen, without polling. All subcommands require the Dorgu Operator to be running with WebSocket support enabled (websocket.enabled=true in the Helm values).

Subcommands

watch personas

dorgu watch personas [flags]
Watch ApplicationPersona resources for real-time updates. Streams creation, modification, and deletion events for personas across the cluster.
FlagTypeDefaultDescription
-n, --namespacestringFilter persona updates to a specific namespace

watch cluster

dorgu watch cluster
Watch ClusterPersona resources for real-time updates. Streams changes to cluster-scoped persona definitions. No additional flags beyond the common flags.

watch events

dorgu watch events [flags]
Watch validation and reconciliation events emitted by the operator. Useful for debugging persona sync issues and observing the operator lifecycle.
FlagTypeDefaultDescription
-n, --namespacestringFilter events to a specific namespace

Common flags

These flags apply to all watch subcommands:
FlagTypeDefaultDescription
--operator-urlstringws://localhost:9090/wsWebSocket URL of the Dorgu Operator
The watch command requires the Dorgu Operator to be running with websocket.enabled=true in the Helm values. If the operator is not reachable or WebSocket support is disabled, the command will fail to connect.

Examples

Watch all persona updates:
dorgu watch personas
Watch personas in a specific namespace:
dorgu watch personas --namespace production
Watch cluster-wide persona changes:
dorgu watch cluster
Watch events with a custom operator URL:
dorgu watch events --operator-url ws://operator.dorgu.svc:9090/ws
Watch events in a specific namespace:
dorgu watch events -n staging