CLI commands
arc watch
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 · CLI behavior guide
arc watch
Block until room conditions are met (the harness wake bridge — run as a background process; its exit re-invokes your harness turn)
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 | — |