# arc connection

Arc agent documentation

Manage hosted provider connections without the desktop

[CLI reference index](/arc/docs/reference/cli) · [CLI behavior guide](/arc/docs/guides/cli)

## arc connection

Manage hosted provider connections without the desktop

```text
usage: arc connection [-h] {list,create,verify,models} ...

positional arguments:
  {list,create,verify,models}
    list                List provider connections
    create              Create a connection; the key comes from the OS store
                        or the provider's env var (see `arc providers`)
    verify              Live-verify a connection (fetches the provider
                        catalog)
    models              List a connection's cached provider models

options:
  -h, --help            show this help message and exit

```

### Argument defaults

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |

## arc connection list

List provider connections

```text
usage: arc connection list [-h] [--json] [--base-url BASE_URL]

options:
  -h, --help           show this help message and exit
  --json
  --base-url BASE_URL

```

### Argument defaults

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `--json` | no | false | — |
| `--base-url` | no | "http://127.0.0.1:6969" | — |

## arc connection create

Create a connection; the key comes from the OS store or the provider's env var (see `arc providers`)

```text
usage: arc connection create [-h] --provider PROVIDER [--label LABEL]
                             [--region REGION] [--endpoint ENDPOINT]
                             [--env-credential] [--json] [--base-url BASE_URL]

options:
  -h, --help           show this help message and exit
  --provider PROVIDER  preset id, e.g. openrouter, anthropic, groq
  --label LABEL
  --region REGION
  --endpoint ENDPOINT  base URL (custom provider only)
  --env-credential     require the daemon to resolve the key from the
                       provider's env var; exit 2 if it cannot
  --json
  --base-url BASE_URL

```

### Argument defaults

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `--provider` | yes | null | — |
| `--label` | no | null | — |
| `--region` | no | null | — |
| `--endpoint` | no | null | — |
| `--env-credential` | no | false | — |
| `--json` | no | false | — |
| `--base-url` | no | "http://127.0.0.1:6969" | — |

## arc connection verify

Live-verify a connection (fetches the provider catalog)

```text
usage: arc connection verify [-h] [--json] [--base-url BASE_URL] connection

positional arguments:
  connection           connection id, label, or id prefix

options:
  -h, --help           show this help message and exit
  --json
  --base-url BASE_URL

```

### Argument defaults

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `connection` | yes | null | — |
| `--json` | no | false | — |
| `--base-url` | no | "http://127.0.0.1:6969" | — |

## arc connection models

List a connection's cached provider models

```text
usage: arc connection models [-h] [--json] [--base-url BASE_URL] connection

positional arguments:
  connection           connection id, label, or id prefix

options:
  -h, --help           show this help message and exit
  --json
  --base-url BASE_URL

```

### Argument defaults

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `connection` | yes | null | — |
| `--json` | no | false | — |
| `--base-url` | no | "http://127.0.0.1:6969" | — |