CLI commands
arc connection
Manage hosted provider connections without the desktop
On this page
CLI reference index · CLI behavior guide
arc connection
Manage hosted provider connections without the desktop
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
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)
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)
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
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" | — |