Global Flags

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

Flag reference

Flag	Short	Type	Default	Description
`--output`	`-o`	string	`table`	Output format: `table`, `json`, or `yaml`
`--api-token`	—	string	—	Override API token for this command
`--api-url`	—	string	`https://api.devhelm.io`	Override API base URL
`--verbose`	`-v`	boolean	`false`	Enable 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.

Getting Started

Commands

Flag reference

Output formats

Table (default)

JSON

YAML

Verbose mode

Next steps

Exit codes

Authentication

​Flag reference

​Output formats

​Table (default)

​JSON

​YAML

​Verbose mode

​Next steps

Exit codes

Authentication

Flag reference

Output formats

Table (default)

JSON

YAML

Verbose mode

Next steps