Skip to content
ARC / Agent documentation
Agent index ↗Back to Arc ↗

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)

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

ArgumentRequiredDefaultChoices
--agentyesnull
--base-urlno"http://127.0.0.1:6969"
--roomnonull
--pathnonull
--untilyesnull
--timeoutno"20m"
--labelnonull
--verbosenofalse