Skip to main content

​
Welcome to Vibe Check

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.
────────────────────────────────────────────────────────────────────────────────

Installation

Get started with Vibe Check in seconds

How It Works

Learn about the intelligent tracking system

Configuration

Customize intervals and break durations

​
Key Features

Micro-breaks every 20 min

Eye rest, wrist stretches, and shoulder rolls to combat repetitive strain

Full breaks every 50 min

Stand up, walk around, and do full-body stretches

Hydration nudges every 30 min

Water reminders, snack checks, and caffeine awareness

Smart break tracking

Detects when you actually take breaks and adjusts timers accordingly

​
Intelligent Break Detection

  • Break compliance tracking — measures whether you actually took the suggested break based on the gap before your next prompt
  • Spontaneous break detection — if you step away for 15+ minutes without a pending reminder, all timers reset automatically
  • Multi-session support — multiple Claude Code sessions share the same timers automatically
  • Seamless continuation — if an active session already exists (within the last 60 min), new sessions join without resetting timers

​
Evidence-Based Science

The timing intervals in Vibe Check are rooted in scientific research:
Endorsed by the American Academy of Ophthalmology to reduce digital eye strain. Every 20 minutes, look at something 20+ feet away for 20 seconds.
The DeskTime study found top performers work ~52 minutes then break ~17 minutes, aligning with natural ultradian rhythms. Vibe Check’s 50-minute interval follows this evidence.
Even 1-2% dehydration impairs cognitive performance by up to 25% (Journal of Nutrition, 2012). Regular hydration reminders keep your brain functioning optimally.
A meta-analysis in PLOS ONE found brief breaks reduce physical discomfort and improve task performance across occupations.

​
On-Demand Health Tips

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)
Health tracking starts automatically on your next session after installation. No configuration required to get started!

Build docs developers (and LLMs) love

Get started for freeTalk to us