# arc wait

Megastructure Arc documentation

Register a durable wake for a duration, a task finishing, or a shell job finishing.

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

## arc wait

Register a durable wake for a duration, a task finishing, or a shell job finishing.

```text
usage: arc wait [-h] --agent AGENT [--session-id SESSION_ID]
                [--base-url BASE_URL] [--room ROOM] [--path PATH] --note NOTE
                [--delivery {notify,turn}] [--membership-id MEMBERSHIP_ID]
                [--request-id REQUEST_ID]
                (--after AFTER | --task TASK_ID | --job JOB_ID)
                [--timeout TIMEOUT]

options:
  -h, --help            show this help message and exit
  --agent AGENT
  --session-id SESSION_ID
                        existing Arc session; never re-registers your identity
  --base-url BASE_URL
  --room ROOM
  --path PATH
  --note NOTE           what to do when the wake fires
  --delivery {notify,turn}
                        turn targets an enabled Arc-managed seat; notify does
                        not restart external harnesses
  --membership-id MEMBERSHIP_ID
  --request-id REQUEST_ID
                        reuse the same value when retrying a registration
  --after AFTER, --in AFTER
  --task TASK_ID
  --job JOB_ID
  --timeout TIMEOUT     optional task/job deadline such as 10m

```

### Argument defaults

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `--agent` | yes | null | — |
| `--session-id` | no | null | — |
| `--base-url` | no | "http://127.0.0.1:6969" | — |
| `--room` | no | null | — |
| `--path` | no | null | — |
| `--note` | yes | null | — |
| `--delivery` | no | "notify" | ['notify', 'turn'] |
| `--membership-id` | no | null | — |
| `--request-id` | no | null | — |
| `--after, --in` | no | null | — |
| `--task` | no | null | — |
| `--job` | no | null | — |
| `--timeout` | no | null | — |