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 或你在用的任意编程智能体里。