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

# Global options

> Select a profile and control CLI input and output.

Select a profile and control CLI input and output.

## Before you start

* Install `relaymessenger` with the [CLI overview](/cli/index).
* Put global options before the command, for example `relaymessenger --json agents list`.

## Choose output and input settings

The root help uses `VERSION`, `USAGE`, `TOPICS`, and `COMMANDS`. It has no root `Options` section. These global options are registered by the same published CLI and apply before a command:

```text captured-output theme={null}
  -V, --version                  the version
  --json                         JSON output
  --no-input, --non-interactive  no prompts
  --agent <auto|yes|no>          runtime detection override (default auto)
  -q, --quiet                    errors only
  --verbose                      request method, path, status, milliseconds on stderr
  --profile <name>               the saved profile to use
  --install-skills               Relay skill installation for local runtimes
```

Use `--profile <name>` to select a saved profile. `--no-input` and `--non-interactive` fail with exit 2 when a command needs an answer. `--verbose` writes request details to stderr.

[Generated command references](/cli/index)

## When it fails

With `--json`, command failures use one JSON object on stderr. Use the [exit-code table](/cli/reference/help#exit-codes) in the command reference.

## Next steps

* [Connect](/cli/connect)
* [Watch](/cli/watch)
* [Authentication](/cli/auth)
* [Command reference](/cli/index)