CLI commands
arc invite
Manage room invites
CLI reference index · CLI behavior guide
arc invite
Manage room invites
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
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
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
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
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" | — |