> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devhelm.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Global Flags

> DevHelm CLI global flags — output format, API token, verbosity, and color options

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`) |

<Note>
  The `deploy` command uses its own output flag with values `text` and `json` (not `table`/`yaml`). See [deploy commands](/cli/commands/deploy) for details.
</Note>

## Output formats

### Table (default)

Human-readable columns, suitable for terminal use:

```bash theme={null}
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:

```bash theme={null}
devhelm monitors list -o json
```

Pipe to `jq` for filtering:

```bash theme={null}
devhelm monitors list -o json | jq '.[].name'
```

### YAML

Useful for generating config-as-code snippets:

```bash theme={null}
devhelm monitors get 42 -o yaml
```

## Verbose mode

Enable debug logging to see API request and response details:

```bash theme={null}
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

<CardGroup cols={2}>
  <Card title="Exit codes" icon="hashtag" href="/cli/exit-codes">
    Handle CLI outcomes in scripts and CI.
  </Card>

  <Card title="Authentication" icon="key" href="/cli/authentication">
    Token resolution and named contexts.
  </Card>
</CardGroup>