uudruid74/sucky-monitor

Sucky Monitor is a small personal automation script built for one specific robot vacuum, a Wyze robot vacuum nicknamed Sucky that keeps getting stuck on things like socks, towels, and charging cables. The problem it solves is that Wyze's default behavior after the vacuum gets stuck and recovers is to restart cleaning across the entire house, so if the vacuum chokes on a sock in the kitchen, it is then free to drag that same sock through every other room. This project runs alongside your regularly scheduled Wyze cleaning job and watches the vacuum's position and status roughly every 30 seconds. If the vacuum stops moving and reports an error state for three checks in a row, meaning about ninety seconds of no movement, the monitor cancels the cleaning run and sends the vacuum back to its dock. When the schedule tries again, it calls a room restricted cleaning function instead of the whole house one, so the vacuum only ever cleans the specific rooms you have allowed, currently the kitchen and living room, rather than the entire house. A daily cron job kicks off the cleaning script at 9 AM using the Wyze SDK to trigger the room restricted clean, and a separate Python script does the ongoing status polling and stuck detection. The vacuum's device identifier, the allowed room IDs, the stuck detection threshold, and the daily schedule are all listed as simple configuration values in the README. The README notes it was built with a tool called Hermes Agent on top of the Wyze SDK, and the project has an informal, personal tone throughout, describing the vacuum's history of eating towels and cables that led to this fix being written. No license is stated in the README.