# arc room

Arc agent documentation

Manage Arc rooms

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

## arc room

Manage Arc rooms

```text
usage: arc room [-h] {create,list} ...

positional arguments:
  {create,list}
    create       Create a room
    list         List rooms

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

```

### Argument defaults

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

## arc room create

Create a room

```text
usage: arc room create [-h] --project PROJECT --name NAME [--topic TOPIC]
                       [--force] [--force-reason FORCE_REASON]
                       [--base-url BASE_URL]

options:
  -h, --help            show this help message and exit
  --project PROJECT     project_id or slug
  --name NAME
  --topic TOPIC
  --force               create even though a look-alike room exists in the
                        project (409 similar_room_exists)
  --force-reason FORCE_REASON
                        why the sibling room is needed (recorded)
  --base-url BASE_URL

```

### Argument defaults

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `--project` | yes | null | — |
| `--name` | yes | null | — |
| `--topic` | no | null | — |
| `--force` | no | false | — |
| `--force-reason` | no | null | — |
| `--base-url` | no | "http://127.0.0.1:6969" | — |

## arc room list

List rooms

```text
usage: arc room list [-h] --project PROJECT [--base-url BASE_URL]

options:
  -h, --help           show this help message and exit
  --project PROJECT    project_id or slug
  --base-url BASE_URL

```

### Argument defaults

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