name: rig-check description: System-domain health snapshot of the fuzz rig — host memory/disk/swap, systemd unit state, worker counts with uptime, OOM-kill events from dmesg, watchdog respawn rate, spurious kernel signals. Orthogonal to $check-in (which only covers fuzz-domain state). Use when the operator asks about VM/host health, OOM investigation, why workers keep dying, or invokes $rig-check. Equivalent of /rig-check in Claude Code.
Run the shared rig-check.sh. It auto-detects host:
- Mac / Linux host with
orb→ proxies commands throughorb -m fuzzer - Inside the fuzzing VM / host → runs commands directly
bash "$(git rev-parse --show-toplevel 2>/dev/null || echo .)/shared/rig-check.sh"
After the output prints, summarize anything flagged with [!]:
- Available memory < 512 MiB — under pressure; check afl-tmin or concurrent ASAN children.
- Disk free < 5 GB — archive
findings/or extend storage. - Systemd service inactive — report which unit, suggest
systemctl --user start …. - OOM-kill count ≥ 5 — categorize victims:
total-vm ≈ 38 TB= ASAN child (unavoidable; ASAN shadow needs unbounded virtual). Expected noise.total-vm few GB= fast-build child that escaped-m 1024— check if afl-tmin is invoked with the right flag.
- Watchdog respawns > 10/hr — flap loop; drill into which role dies.
- Spurious kernel signals — non-fuzzer-child SIGSEGV / GPF; surface the listed process.
If nothing is flagged, report "rig healthy" — don't manufacture follow-ups.