| name | operate |
| description | Watch an already-detached clawback proxy as an event stream — surface only actionable log lines (error/warn/4xx/5xx/crash signatures, plus rebind and runtime-mode toggles) AND announce a loud "PROXY DOWN" line the instant the proxy pid dies. Fills the gap that run_monitor.sh --attach leaves: a bare tail goes SILENT on a crash (BSD tail has no --pid), so silence reads as healthy-idle. Use when acting as the operator agent keeping the server alive — point an agent's Monitor tool at it (persistent), react to PROXY DOWN by reading the log tail for the crash cause and restarting via the restart skill. |
clawback operate (operator watch)
Run .skills/operate/scripts/operator_watch.sh from the project root. It watches a proxy you
already started with the monitor skill
(run_monitor.sh --detach) and emits one line per actionable event on
stdout, staying quiet during healthy idle.
.skills/operate/scripts/operator_watch.sh
.skills/operate/scripts/operator_watch.sh data/clawback.run.log data/clawback.run.pid
Defaults match run_monitor.sh:
LOG_FILE = data/clawback.run.logPID_FILE = data/clawback.run.pid- poll cadence:
OPERATOR_WATCH_POLL_SEC (default 5s)
What it emits
- log lines matching
[error] / [warn] / → 4xx|5xx / failed /
self-loop / EADDRINUSE / ECONN* / unhandled / Error:
- two INFO signals an operator wants:
clawback listening (a (re)bind) and
runtime mode toggled (e.g. the baseline→armed flip after a fresh proxy's
5-turn capture window, or any admin toggle)
- a synthetic
[error] PROXY DOWN … line the moment the proxy pid stops
responding — then it exits non-zero so the watch ends deliberately
instead of hanging silent
Why not just run_monitor.sh --attach?
--attach only tails the log. macOS/BSD tail has no --pid, so a crash
makes the log go quiet and an attached follower can't tell "dead" from
"idle". Only run_monitor.sh's foreground follow mode has a liveness
watcher — but that mode starts its own proxy and would collide on the
port with one already detached. This script adds liveness to the
already-detached case without touching the port.
Agent usage (the operator loop)
.skills/scripts/run_monitor.sh --detach — start the proxy.- Point the Monitor tool at
.skills/operate/scripts/operator_watch.sh with
persistent: true. Each emitted line becomes a notification.
- On a
PROXY DOWN (or a crash signature), read the tail of
data/clawback.run.log to find the cause — that's the "pattern in the
logs that needs fixing" — then bring it back with the
restart skill and re-arm the Monitor.
Stop the proxy with the shutdown skill; the watch
exits on its own when the proxy is gone.
