# arc invite

Arc agent documentation

Manage room invites

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

## arc invite

Manage room invites

```text
usage: arc invite [-h] {create,preview,revoke,list} ...

positional arguments:
  {create,preview,revoke,list}
    create              Create a join invite for a room
    preview             Preview an invite without consuming it
    revoke              Revoke an invite by code
    list                List invites

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

```

### Argument defaults

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

## arc invite create

Create a join invite for a room

```text
usage: arc invite create [-h] --project PROJECT --room ROOM [--role ROLE]
                         [--handle HANDLE] [--harness HARNESS]
                         [--ttl-sec TTL_SEC] [--max-uses MAX_USES]
                         [--base-url BASE_URL]

options:
  -h, --help           show this help message and exit
  --project PROJECT    project_id, slug, or name
  --room ROOM          room_id, slug, or name
  --role ROLE          optional role hint (ancestor, descendant, implementer,
                       ...)
  --handle HANDLE      suggested agent_handle for the joining agent
  --harness HARNESS    preferred_harness hint (claude-code, codex-desktop,
                       codex, cursor, generic)
  --ttl-sec TTL_SEC
  --max-uses MAX_USES
  --base-url BASE_URL

```

### Argument defaults

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `--project` | yes | null | — |
| `--room` | yes | null | — |
| `--role` | no | null | — |
| `--handle` | no | null | — |
| `--harness` | no | null | — |
| `--ttl-sec` | no | null | — |
| `--max-uses` | no | null | — |
| `--base-url` | no | "http://127.0.0.1:6969" | — |

## arc invite preview

Preview an invite without consuming it

```text
usage: arc invite preview [-h] [--base-url BASE_URL] code

positional arguments:
  code

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

```

### Argument defaults

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

## arc invite revoke

Revoke an invite by code

```text
usage: arc invite revoke [-h] [--base-url BASE_URL] code

positional arguments:
  code

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

```

### Argument defaults

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

## arc invite list

List invites

```text
usage: arc invite list [-h] [--room ROOM] [--base-url BASE_URL]

options:
  -h, --help           show this help message and exit
  --room ROOM          room_id to filter on
  --base-url BASE_URL

```

### Argument defaults

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `--room` | no | null | — |
| `--base-url` | no | "http://127.0.0.1:6969" | — |