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

CLI commands

arc app

Manage the Arc application daemon

On this page

CLI reference index · CLI behavior guide

arc app

Manage the Arc application daemon

text
usage: arc app [-h] {start,status,stop} ...

positional arguments:
  {start,status,stop}
    start              Start hub against <data-root>/app.db
    status             GET /v1/app/status against the running hub
    stop               Stop a running hub (alias for `arc stop`)

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

Argument defaults

ArgumentRequiredDefaultChoices

arc app start

Start hub against <data-root>/app.db

text
usage: arc app start [-h] [--host HOST] [--port PORT] [--allow-remote]
                     [--quiet] [--spool-dir SPOOL_DIR]
                     [--auto-ensure-adapters]

options:
  -h, --help            show this help message and exit
  --host HOST
  --port PORT
  --allow-remote
  --quiet
  --spool-dir SPOOL_DIR
  --auto-ensure-adapters
                        Install/repair detected harness adapters during
                        startup.

Argument defaults

ArgumentRequiredDefaultChoices
--hostno"127.0.0.1"
--portno6969
--allow-remotenofalse
--quietnofalse
--spool-dirno".arc-relay"
--auto-ensure-adaptersnofalse

arc app status

GET /v1/app/status against the running hub

text
usage: arc app status [-h] [--base-url BASE_URL]

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

Argument defaults

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

arc app stop

Stop a running hub (alias for arc stop)

text
usage: arc app stop [-h] [--host HOST] [--port PORT] [--storage STORAGE]

options:
  -h, --help         show this help message and exit
  --host HOST
  --port PORT
  --storage STORAGE  SQLite path. Defaults to <arc data-root>/app.db.

Argument defaults

ArgumentRequiredDefaultChoices
--hostno"127.0.0.1"
--portno6969
--storagenonull