Inspect and manage runs

Terminal

woml inspect [--state <path>] [--no-color]

Opens the live colored terminal view of runtime health, workflows, recent runs, queues, waits, and failures. It is the htop-like operations experience and does not open a browser dashboard.

`woml list`

Terminal

woml list [--workflow <workflowId>] [--status <status>] \
  [--limit <1-200>] [--state <path>] [--json]

Lists recent durable runs with optional workflow/status filters. It uses the active authenticated local runtime when available and safe offline projection otherwise.

`woml get`

Terminal

woml get <runId> [--state <path>] [--json]

Shows one redacted run: status, steps, attempts, waits, control-flow selection, lifecycle state, policy state, cancellation, and bounded workflow-call relations. It intentionally omits payloads, full context, output values, secrets, credentials, idempotency keys, and stack traces.

`woml cancel`

Terminal

woml cancel <runId> [--state <path>] [--json]

Records a durable cancellation request. Rust stops new work, signals active scripts/capabilities, invalidates approval capabilities, preserves committed effects/results, settles ambiguity honestly, then runs <on-cancel> and <on-complete>. It does not roll back external effects or automatically cancel independent child workflows.

`woml stop`

Terminal

woml stop [--state <path>] [--json]

Authenticates to and gracefully stops the background runtime owning the selected state boundary.

Follow logs

Terminal

woml <run-id|workflow-id> --logs \
  [--state <path>] [--config <path>] [--json] \
  [--color=auto|always|never]

Prints matching historical output and follows new records. Ctrl+C exits the viewer without stopping the background automation.

`woml emit`

Terminal

woml emit <eventName> \
  --id <publisherEventId> \
  --data @<jsonFile> \
  --server <url> \
  --token-secret <NAME>

Publishes to an authenticated public event endpoint. --id is the stable publisher occurrence identity; repeating the same ID/data deduplicates, while reusing it with changed data conflicts. The token value is loaded by symbolic secret name. Applications may call the same HTTP endpoint directly; this CLI is an operator convenience.

Provider doctors

Terminal

woml telegram doctor \
  [--token-secret <NAME>] [--destination <chatId>] \
  [--json] [--color=auto|always|never]

woml discord doctor \
  [--token-secret <NAME>] [--destination <channelId>] \
  [--json] [--color=auto|always|never]

woml whatsapp doctor \
  [--access-token-secret <NAME>] [--app-secret <NAME>] \
  [--verify-token-secret <NAME>] [--phone-number-id <id>] \
  [--callback-url <https-url>] \
  [--json] [--color=auto|always|never]

Doctor commands authenticate, verify permissions/identity, and optionally check a destination or callback without creating a workflow run or sending a message. Credentials are redacted from human and JSON output.

Slack setup currently relies on startup diagnostics and the included Slack app manifest rather than a public woml slack doctor CLI command.