herdr-event-watchlisted

# herdr-event-watch — event-driven lane/PR watching **English** | [日本語](SKILL.ja.md) Get notified the moment something changes instead of polling on a schedule. Fixed-interval patrol loses twice: a lane that parks 3 minutes in goes unnoticed for up to the full interval, and the patrol burns turns even when nothing happened. ## Usage (Codex runtime: background terminal) Codex has no persistent monitor tool — run the watcher in a **background terminal** and check its output when you come back to the foreground: ```bash # start (background terminal) bash <skill-dir>/scripts/herdr-event-watch.sh \ --workspace <wsId> --prefix <laneLabelPrefix> \ --inbox <receiptDir> --inbox-prefix <filePrefix> \ --repo <owner/repo> --check <requiredCheckName> --pr <n> [--pr <n> ...] \ | tee /tmp/herdr-events.$$.log ``` - Each stdout line is one event; `tee` keeps a durable log so events are not lost while you work. - For a one-shot state check (no background terminal), add `--once`. - Stop the watcher with `/stop` on the background terminal **before you park** — a leaked watcher process outlives your turn. ## Arguments | Arg | Required | Meaning | |---|---|---| | `--workspace` | ✔ | herdr workspace ID (`herdr workspace list`) | | `--prefix` | | lane-label prefix filter (default: all labeled panes) | | `--inbox` (repeatable) | | **durable artifact arrival watch (primary)** — dir where receipts/verdicts land | | `--inbox-prefix` | | filename prefix filter | | `--repo` / `--pr` (r