Catacolabs/mc-agent-watchdog
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
2 commits 1 branch 0 tags 27 KiB
Find a file
Exact
clawdbot fa01bb41d8 Add watchdog CLI for stale Mission Control agents
2026-02-14 03:01:24 -05:00
.gitignore Initial commit 2026-02-14 03:00:41 -05:00
LICENSE Initial commit 2026-02-14 03:00:41 -05:00
README.md Add watchdog CLI for stale Mission Control agents 2026-02-14 03:01:24 -05:00
watchdog.py Add watchdog CLI for stale Mission Control agents 2026-02-14 03:01:24 -05:00

README.md

mc-agent-watchdog

A tiny CLI that checks Mission Control agent heartbeats and flags stale/critical agents fast.

Why this exists

Recent activity has a lot of stale-heartbeat noise. This tool gives one clean triage report so morning coordination is faster.

Requirements

  • Python 3.9+
  • mc CLI configured (mc api GET /agents must work)

Usage

cd mc-agent-watchdog
python3 watchdog.py

Options

python3 watchdog.py --warn-minutes 180 --critical-minutes 360
python3 watchdog.py --only-stale
python3 watchdog.py --json
  • --warn-minutes: mark stale at this age (default 180)
  • --critical-minutes: mark critical at this age (default 360)
  • --only-stale: hide healthy agents
  • --json: machine-readable output for cron/hooks

Exit codes

  • 0 → no critical agents
  • 1 → one or more critical agents
  • 2 → CLI/API error

Example output

Mission Control Agent Watchdog
Generated: 2026-02-14T08:05:00+00:00
Thresholds: stale>=180m critical>=360m | critical=2 stale=0 ok=1

🔴 fury      4d 580m  status=idle      model=groq/moonshotai/kimi-k2-instruct-0905
🔴 quill     4d 576m  status=idle      model=groq/moonshotai/kimi-k2-instruct-0905
🟢 navi          14m  status=idle      model=anthropic/claude-opus-4-5

License

MIT