Skip to main content
Global flags apply to every CLI command. Use them to control output format, override authentication, and enable debug logging.

Flag reference

FlagShortTypeDefaultDescription
--output-ostringtableOutput format: table, json, or yaml
--api-tokenstringOverride API token for this command
--api-urlstringhttps://api.devhelm.ioOverride API base URL
--verbose-vbooleanfalseEnable debug logging
--helpbooleanShow help for any command
--versionbooleanShow CLI version
The deploy command uses its own output flag with values text and json (not table/yaml). See deploy commands for details.

Output formats

Table (default)

Human-readable columns, suitable for terminal use:
devhelm monitors list
 ID  Name             Type  Status  Frequency
 42  API Health       HTTP  UP      60s
 43  Marketing Site   HTTP  UP      300s

JSON

Machine-readable output for scripting:
devhelm monitors list -o json
Pipe to jq for filtering:
devhelm monitors list -o json | jq '.[].name'

YAML

Useful for generating config-as-code snippets:
devhelm monitors get 42 -o yaml

Verbose mode

Enable debug logging to see API request and response details:
devhelm monitors list --verbose
This prints the HTTP method, URL, headers, and response status for each API call. Useful for troubleshooting authentication or network issues.

Next steps

Exit codes

Handle CLI outcomes in scripts and CI.

Authentication

Token resolution and named contexts.