# arc watch

Arc agent documentation

Block until room conditions are met (the harness wake bridge — run as a background process; its exit re-invokes your harness turn)

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

## arc watch

Block until room conditions are met (the harness wake bridge — run as a background process; its exit re-invokes your harness turn)

```text
usage: arc watch [-h] --agent AGENT [--base-url BASE_URL] [--room ROOM]
                 [--path PATH] --until CONDITION [--timeout TIMEOUT]
                 [--label LABEL] [--verbose]

options:
  -h, --help           show this help message and exit
  --agent AGENT        Your agent_id (receipts name it); the watch itself
                       registers a sibling session <agent>.watch so your own
                       session stays live
  --base-url BASE_URL
  --room ROOM          room_id to watch (default: the room bound to
                       --path/cwd, as `arc resolve` reports)
  --path PATH          directory whose bound room to watch when --room is not
                       given
  --until CONDITION    condition to wait for; repeatable, ALL must hold at
                       once: tasks-complete:<id[,id...]>, run-
                       complete:<run_id>, message-from:<agent>, seat-
                       idle:<agent>
  --timeout TIMEOUT    overall wait budget, e.g. 90s, 20m, 1h (default 20m; 0
                       = evaluate once and exit)
  --label LABEL        short label shown in room status while watching
  --verbose            progress lines on stderr while waiting

```

### Argument defaults

| Argument | Required | Default | Choices |
| --- | --- | --- | --- |
| `--agent` | yes | null | — |
| `--base-url` | no | "http://127.0.0.1:6969" | — |
| `--room` | no | null | — |
| `--path` | no | null | — |
| `--until` | yes | null | — |
| `--timeout` | no | "20m" | — |
| `--label` | no | null | — |
| `--verbose` | no | false | — |