# arc app

Arc agent documentation

Manage the Arc application daemon

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

## 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

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

## 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

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `--host` | no | "127.0.0.1" | — |
| `--port` | no | 6969 | — |
| `--allow-remote` | no | false | — |
| `--quiet` | no | false | — |
| `--spool-dir` | no | ".arc-relay" | — |
| `--auto-ensure-adapters` | no | false | — |

## 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

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `--base-url` | no | "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

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `--host` | no | "127.0.0.1" | — |
| `--port` | no | 6969 | — |
| `--storage` | no | null | — |