Pomodoro Timer
Configurable 5-60 minute focus sessions with visual countdown
Presence Detection
Motion-based tracking knows when you leave your desk
Physical Nudges
Antenna wiggles and head shakes bring you back to focus
Victory Dance
Celebrate completed sessions with robot celebrations
Session Stats
Track focus time, nudges received, and completion rate
Configurable
Adjust duration, thresholds, and robot position
Install on Your Reachy Mini
Install the package
pip install git+https://huggingface.co/spaces/RyeCatcher/focus-guardian
Start the Reachy Mini daemon
reachy-mini-daemon
Launch from dashboard
Find Focus Guardian in Applications at localhost:8000
How It Works
Camera captures at 2Hz
Motion analyzed in your area
3+ seconds still = away
Robot nudges you back!
About This Project
Focus Guardian implements body doubling — the productivity technique where having someone nearby helps you stay on task. Reachy Mini becomes your accountability partner, watching over your work sessions and providing gentle physical reminders when you drift away.
Part of the Run Reachy Run project — documenting the journey of building apps with Reachy Mini. Built with Claude Code.