Health reminders for vibe coders — stretches, eye breaks, hydration nudges woven into your Claude Code flow.
Vibe Check is a Claude Code plugin that tracks your coding session and gently reminds you to take care of your body. No OS popups or interruptions — reminders appear as visually distinct cards right in your Claude conversation.
────────────────────────────────────────────────────────────────────────────────
⏰ VIBE CHECK — 👁️ Eye Reset (20 min since last break)
────────────────────────────────────────────────────────────────────────────────
Look at something 20+ feet away for 20 seconds (the 20-20-20 rule). Then blink
rapidly 15 times to re-lubricate your eyes.
────────────────────────────────────────────────────────────────────────────────
- Micro-breaks every 20 min (eye rest, wrist stretches, shoulder rolls)
- Full breaks every 50 min (stand up, walk, full-body stretch)
- Hydration nudges every 30 min (water, snacks, caffeine check)
- Smart break tracking — detects when you take a suggested break and adjusts the next reminder accordingly
/plugin marketplace add majidmanzarpour/vibe-check
/plugin install vibe-check@vibe-check
That’s it. Health tracking starts automatically on your next session.
After updating the plugin, restart your Claude Code session so the new hooks are loaded. Hooks are registered at session start and won’t refresh mid-session.
claude --plugin-dir /path/to/vibe-check
- SessionStart hook loads or creates the shared state file — if an active session already exists (within the last 60 min), it joins without resetting timers
- Every prompt you send, a Python script checks elapsed time since your last break
- Break compliance — after firing a reminder, the system measures whether you actually took the break (based on the gap before your next prompt) and resets the timer accordingly
- Spontaneous break detection — if you step away for 15+ minutes without a pending reminder, all timers reset
- If you’re due for a break, it formats a reminder with unicode horizontal lines
- Claude renders it as a visually distinct card in the conversation
- Coding continues seamlessly after the reminder
Multiple Claude Code sessions share the same timers automatically. A Stop hook records when Claude finishes each response, enabling precise gap measurement. After 60 minutes of inactivity, the next session starts fresh.
Customize intervals via environment variables:
| Variable | Default | Description |
|---|---|---|
VIBE_CHECK_MICRO_INTERVAL |
1200 (20 min) |
Seconds between micro-breaks (eyes, wrists) |
VIBE_CHECK_FULL_INTERVAL |
3000 (50 min) |
Seconds between full breaks (stand, stretch) |
VIBE_CHECK_HYDRATION_INTERVAL |
1800 (30 min) |
Seconds between hydration reminders |
VIBE_CHECK_MICRO_BREAK_DURATION |
60 (1 min) |
Gap after a micro reminder to credit as “took the break” |
VIBE_CHECK_HYDRATION_BREAK_DURATION |
120 (2 min) |
Gap after a hydration reminder to credit as “took the break” |
VIBE_CHECK_FULL_BREAK_DURATION |
300 (5 min) |
Gap after a full-break reminder to credit as “took the break” |
VIBE_CHECK_GAP_THRESHOLD |
900 (15 min) |
Seconds of inactivity before crediting as a spontaneous break |
VIBE_CHECK_STALE_THRESHOLD |
3600 (60 min) |
Seconds of inactivity before a new session resets timers |
VIBE_CHECK_BOX_WIDTH |
80 |
Inner display width of the reminder box in columns |
Example — test with shorter intervals:
VIBE_CHECK_MICRO_INTERVAL=60 VIBE_CHECK_HYDRATION_INTERVAL=120 VIBE_CHECK_FULL_INTERVAL=180 claude
Run /vibe-check:health anytime for a full reference card of:
- Quick stretches (neck, wrists, back, shoulders, hips)
- Eye exercises (20-20-20, palming, near-far focus)
- Breathing techniques (box breathing, 4-7-8, physiological sigh)
- Ergonomic checklist (monitor, chair, posture)
The timing intervals are evidence-based:
- 20-20-20 rule — endorsed by the American Academy of Ophthalmology to reduce digital eye strain
- 52-17 work-break ratio — the DeskTime study found top performers work ~52 min then break ~17 min, aligning with ultradian rhythms
- Hydration and cognition — even 1-2% dehydration impairs cognitive performance by up to 25% (Journal of Nutrition, 2012)
- Micro-breaks — a meta-analysis in PLOS ONE found brief breaks reduce discomfort and improve task performance across occupations
/plugin uninstall vibe-check@vibe-check
/plugin marketplace remove vibe-check
The state file at ~/.claude/vibe-check-state.json can be safely deleted after uninstall.
MIT