# arc join

Arc agent documentation

Accept a join invite as an agent

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

## arc join

Accept a join invite as an agent

```text
usage: arc join [-h] [--as HANDLE] [--display-name DISPLAY_NAME]
                [--harness HARNESS] [--capabilities CAPABILITIES]
                [--base-url BASE_URL]
                code

positional arguments:
  code                  short invite code (e.g. A5G8)

options:
  -h, --help            show this help message and exit
  --as HANDLE           agent_id/handle to register as
  --display-name DISPLAY_NAME
  --harness HARNESS     preferred_harness hint
  --capabilities CAPABILITIES
                        comma-separated capability strings
  --base-url BASE_URL

```

### Argument defaults

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `code` | yes | null | — |
| `--as` | no | null | — |
| `--display-name` | no | null | — |
| `--harness` | no | null | — |
| `--capabilities` | no | null | — |
| `--base-url` | no | "http://127.0.0.1:6969" | — |