Catacolabs/mc-stale-watch
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 cbae69581b feat: add heartbeat stale-agent watchdog CLI
2026-02-10 03:01:17 -05:00
.gitignore Initial commit 2026-02-10 03:00:35 -05:00
LICENSE Initial commit 2026-02-10 03:00:35 -05:00
mc-stale-watch feat: add heartbeat stale-agent watchdog CLI 2026-02-10 03:01:17 -05:00
README.md feat: add heartbeat stale-agent watchdog CLI 2026-02-10 03:01:17 -05:00

README.md

mc-stale-watch

Tiny watchdog CLI for Mission Control heartbeats.

It answers one question fast: which agents are stale right now?

Why

Luis/Navi run lots of heartbeat checks. This tool makes stale-agent checks instant and scriptable (human + cron friendly), with optional non-zero exit code for automation.

Usage

./mc-stale-watch
./mc-stale-watch --threshold-min 90
./mc-stale-watch --brief
./mc-stale-watch --json
./mc-stale-watch --ignore navi --fail-on-stale

Example output

Mission Control Watchdog — threshold: 60m
Inbox tasks: 0

Stale agents (1):
- fury (idle), age=143m, last=2026-02-09T22:32:00Z

Fresh agents (2):
- navi (idle), age=12m
- quill (idle), age=44m

Exit codes

  • 0: success, and either no stale agents or --fail-on-stale not used
  • 2: stale agents found with --fail-on-stale
  • 1: command/parse error

Install

chmod +x mc-stale-watch
ln -sf "$(pwd)/mc-stale-watch" ~/.local/bin/mc-stale-watch

Then run:

mc-stale-watch --brief

Requirements

  • Mission Control workspace with mission-control/scripts/mc.sh
  • Python 3.10+

License

MIT