> ## 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>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.