Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Marketia-grade description, conversion block, skill pairings
What This Skill Does
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.
When to use it
- 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
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: watch my 4 sub-agents and alert me if any get stuck
- 1Start overseer.sh in the background with --workdir, --interval 180, and --max-stale 4
- 2Overseer polls /proc for gateway health, runs openclaw sessions list, and checks find -newer each cycle
- 3Overseer writes completed JSON atomically to /tmp/overseer/status.json
- 4On each heartbeat trigger, agent reads status.json with a single cat call
- 5If 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
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.