subagent-overseer
от globalcaos
Web & Frontend DevelopmentКратко
Monitor sub-agent health and progress via a pull-based bash daemon.
Описание
Что делает этот навык
A bash daemon that monitors sub-agent health without consuming AI tokens. It reads /proc filesystem data and calls openclaw sessions list on a configurable interval, writing results atomically to a JSON status file. The main agent reads that file on each heartbeat instead of making live tool calls.
Replaces in-agent polling loops with a zero-token OS-level daemon, so heartbeat cost stays flat regardless of how many sub-agents are running.
Когда его использовать
- Detecting a stuck sub-agent in a parallel coding pipeline
- Monitoring filesystem activity across multiple concurrent agents
- Getting local voice alerts when an agent stops making progress
- Checking gateway process health without spending context tokens
- Auto-stopping the monitor once all sub-agents have finished
Пример сценария
User asks: watch my 4 sub-agents and alert me if any get stuck
- 1
Start overseer.sh in the background with --workdir, --interval 180, and --max-stale 4
- 2
Overseer polls /proc for gateway health, runs openclaw sessions list, and checks find -newer each cycle
- 3
Overseer writes completed JSON atomically to /tmp/overseer/status.json
- 4
On each heartbeat trigger, agent reads status.json with a single cat call
- 5
If any agent shows stale count >= 4, report that label as stuck and offer to kill it
status.json shows subagent 'worker-2' as stuck after 12 minutes of no filesystem changes
Требования
- jarvis command (local TTS via sherpa-onnx) for --voice alerts
Установка
clawhub install globalcaos/subagent-overseerВыполните команду CLI или вставьте промпт в Claude Code, Cursor, Codex — любой кодинг-агент, которым пользуетесь.