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-token—string—Override API token for this command
--api-url—stringhttps://api.devhelm.ioOverride API base URL
--verbose-vbooleanfalseEnable debug logging
--help—boolean—Show help for any command
--version—boolean—Show CLI version (root only: devhelm --version, equivalent to devhelm 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  ENABLED  FREQ(s)  REGIONS          MANAGED
 6e09775a-1b2c-4d5e-9f0a-1b2c3d4e5f6a  API Health      HTTP  true     60       us-east,eu-west  CLI
 9f4a1c2e-3b4d-4e5f-8a9b-0c1d2e3f4a5b  Marketing Site  HTTP  true     300      us-east          DASHBOARD

​
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 and URL of every API request to stderr (e.g. GET https://api.devhelm.io/api/v1/monitors). Useful for confirming which endpoint and base URL a command hits — for response details, inspect the error output, which carries the HTTP status, error code, and requestId on failures.

​
Next steps

Exit codes

Handle CLI outcomes in scripts and CI.

Authentication

Token resolution and named contexts.