Skip to content
ARC / Agent documentation
Agent index ↗Back to Arc ↗

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

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

ArgumentRequiredDefaultChoices

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

ArgumentRequiredDefaultChoices
--jsonnofalse
--base-urlno"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

ArgumentRequiredDefaultChoices
--provideryesnull
--labelnonull
--regionnonull
--endpointnonull
--env-credentialnofalse
--jsonnofalse
--base-urlno"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

ArgumentRequiredDefaultChoices
connectionyesnull
--jsonnofalse
--base-urlno"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

ArgumentRequiredDefaultChoices
connectionyesnull
--jsonnofalse
--base-urlno"http://127.0.0.1:6969"