# arc smoke-agent

Arc agent documentation

Run a deterministic smoke-test role

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

## arc smoke-agent

Run a deterministic smoke-test role

```text
usage: arc smoke-agent [-h] --role {smoke-a,smoke-b,smoke-c} --transport
                       {http,relay} [--base-url BASE_URL]
                       [--relay-dir RELAY_DIR] [--channel CHANNEL]
                       [--thread-id THREAD_ID] [--claim-key CLAIM_KEY]
                       [--timeout-sec TIMEOUT_SEC]
                       [--poll-interval-sec POLL_INTERVAL_SEC]

options:
  -h, --help            show this help message and exit
  --role {smoke-a,smoke-b,smoke-c}
  --transport {http,relay}
  --base-url BASE_URL
  --relay-dir RELAY_DIR
  --channel CHANNEL
  --thread-id THREAD_ID
  --claim-key CLAIM_KEY
  --timeout-sec TIMEOUT_SEC
  --poll-interval-sec POLL_INTERVAL_SEC

```

### Argument defaults

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `--role` | yes | null | ['smoke-a', 'smoke-b', 'smoke-c'] |
| `--transport` | yes | null | ['http', 'relay'] |
| `--base-url` | no | "http://127.0.0.1:6969" | — |
| `--relay-dir` | no | ".arc-relay" | — |
| `--channel` | no | "smoke-room" | — |
| `--thread-id` | no | "smoke-relay-001" | — |
| `--claim-key` | no | "smoke-claim-001" | — |
| `--timeout-sec` | no | 120.0 | — |
| `--poll-interval-sec` | no | 1.0 | — |