Break Bestie — Water & Eye Break Companion for VS Code

Stop coding on empty. Meet Break Bestie, a thoughtfully designed, zero-distraction hydration and vision-care companion built for developers who spend long hours in deep focus.

Every developer knows the feeling: you sit down to fix a small bug in the morning, and hours pass before you look up. By the time you notice, your eyes are strained, your throat is dry, and your energy has dipped. Traditional reminder tools feel like rigid alarm clocks that interrupt your concentration and get dismissed without a second thought.

Break Bestie takes a more human approach. Instead of intrusive popups, iconic Malayalam cinema legends and global football champions appear beside your editor or glide across a live horizontal runway in your bottom panel — complete with signature catchphrases, a guided 20-second eye recovery bar, and an adaptive interface that never steals your keyboard focus while you type.

Meet Your Seven Celebrity Companions

Every caricature sticker is bundled directly inside the extension and runs 100% offline with zero configuration required. Choose the personality that fits your daily workflow:

Celebrity Companion	Persona	Signature Line	Motivation Style
Mohanlal (Default)	The Complete Actor (Aadu Thoma / Spadikam)	"എന്താ മോനേ?" (Entha Mone?)	Warm humor, effortless charm, and grounded wisdom.
Mammootty	The Megastar (Kottayam Kunjachan / Bilal)	"ഒരു സിംഹം!" (Oru Simham!)	Timeless style, sharp discipline, and focused reminders.
Ranga Annan (Fahadh Faasil)	The Aavesham Boss	"എടാ മോനേ! Happy അല്ലേ?" (Eda Mone! Happy Alle?)	White shirt, gold chains, dark shades, and infectious high energy.
Dashamoolam Damu (Salim Kumar)	The Ultimate Comedy Legend	"അയ്യോ അങ്ങനെ പറയരുത്! വെള്ളം കുടിക്ക്!"	Classic comedic timing and instant stress relief during tough debugging sessions.
Adi Pookkutti	The Cheerful Entertainer	"അടി പൂക്കുട്ടി!" (Adi Pookkutti!)	Studio headphones, musical rhythm, and upbeat encouragement.
Cristiano Ronaldo	CR7 / The Phenomenon	"SIUUU! Drink Agua!"	Relentless dedication, athletic recovery, and peak performance habits.
Lionel Messi	World Champion / La Pulga (#10)	"VAMOS! Drink Water!"	Iconic Argentina #10 composure, playmaker vision, and steady hydration.

Core Capabilities

1. Non-Intrusive Editor Flow (`preserveFocus: true`)

Nothing disrupts a programmer's momentum faster than a modal dialog that hijacks the cursor mid-line. When a break arrives, Break Bestie opens smoothly beside your active editor without stealing keyboard focus. Finish your thought at your own pace, then take your break.

2. Under-Editor Horizontal Runway & Scrolling Ticker (Bottom Panel)

Open the Break Bestie Companion tab in your VS Code bottom panel (alongside Terminal and Output) for a continuous, ambient workspace companion:

Horizontal Runway: Watch your chosen companion run, sprint, or groove smoothly across the width of the bottom panel.
Live Scrolling Ticker: A subtle marquee ticker along the bottom edge scrolls live hydration prompts and 20-20-20 vision reminders.
Synthesized Web Audio Pulse: Toggle a gentle, offline rhythm pulse generated natively through the Web Audio API.
Interactive Quotes: Click the companion sticker at any time to cycle through character catchphrases.

3. Intelligent Hydration & 20-20-20 Vision Care

Hydration Reminders: Prompts you to drink a full glass of water at your preferred interval (default: every 5 minutes for quick previewing; easily configurable to 20, 30, or 60 minutes).
20-20-20 Eye Rule: Guides you through looking 20 feet away for 20 seconds with a smooth visual countdown bar to reduce digital eye strain.
Unified Combined Breaks: When your water break and eye break land simultaneously, Break Bestie merges them into a single Combined Recovery session instead of triggering back-to-back alerts.
One-Click Snooze & Completion: In the middle of a critical deployment? Click Snooze to postpone the reminder, or Mark Completed to reset your countdown.

Monitor your upcoming break directly in the bottom-right VS Code Status Bar:

Unified Countdown: Break Bestie: 4m 32s
Independent Timers: Water 12m 10s · Eye 18m 00s
Paused State: Breaks: Paused
Click the Status Bar item anytime to switch companions, preview break panels, pause or resume timers, or adjust intervals.

Command Palette Reference

Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS) and type Break Bestie:

Command Title	Command ID	Description
Break Bestie: Choose Your Celebrity Companion	`waterBreak.selectCharacter`	Opens the studio gallery to preview and select your active companion.
Break Bestie: Open Dancing Sticker Widget (Bottom Panel)	`waterBreak.openDancingWidget`	Focuses the horizontal running companion and scrolling ticker in the bottom panel.
Break Bestie: Preview Character Sticker Animation	`waterBreak.previewCharacter`	Select any companion to preview their break panel and motion.
Break Bestie: Test Water Break Now	`waterBreak.testWaterBreak`	Immediately triggers a hydration break panel.
Break Bestie: Test Eye Break Now (20-20-20 Rule)	`waterBreak.testEyeBreak`	Immediately triggers a 20-second vision care panel.
Break Bestie: Test Combined Break Now (Water + Eye)	`waterBreak.testCombinedBreak`	Immediately triggers a combined hydration and eye care session.
Break Bestie: Start Health Reminders	`waterBreak.start`	Starts or restarts the reminder countdown timers.
Break Bestie: Pause Reminders	`waterBreak.pause`	Temporarily pauses all reminders during meetings or screen sharing.
Break Bestie: Resume Reminders	`waterBreak.resume`	Resumes reminders with a fresh timer baseline.
Break Bestie: Customize Reminder Settings	`waterBreak.changeSettings`	Opens an interactive menu to adjust intervals, sound, and display modes.
Break Bestie: Open Quick Menu	`waterBreak.showStatusMenu`	Opens the main Break Bestie quick-action menu.

Configuration & Settings

Open VS Code Settings (Ctrl+, or Cmd+,) and search for Break Bestie or waterBreak:

Setting Key	Type	Default	Description
`waterBreak.character`	`string`	`"mohanlal"`	Active companion: `"mohanlal"`, `"mammootty"`, `"ranga"`, `"damu"`, `"adipookkutti"`, `"messi"`, or `"ronaldo"`.
`waterBreak.waterIntervalMinutes`	`number`	`60`	Minutes between water break reminders (default: `60` minutes / 1 hour developer time).
`waterBreak.eyeIntervalMinutes`	`number`	`5`	Minutes between eye break reminders (default: `5` minutes / micro-rest).
`waterBreak.waterEnabled`	`boolean`	`true`	Enable or disable water break reminders.
`waterBreak.eyeEnabled`	`boolean`	`true`	Enable or disable eye break reminders.
`waterBreak.reminderDisplayMode`	`string`	`"panel"`	`"panel"` opens the visual companion beside your code; `"notification"` displays a compact toast notification first.
`waterBreak.snoozeMinutes`	`number`	`2`	Duration in minutes to postpone a reminder when clicking Snooze.
`waterBreak.soundEnabled`	`boolean`	`true`	Play a subtle, offline Web Audio chime when a break begins.

Build, Run & Package Locally

1. Install Dependencies

npm.cmd install

2. Run in Development Mode

Open this project folder in VS Code (code .).
Press F5 to launch the Extension Development Host window.
Click the Break Bestie status bar item in the bottom-right corner or run Break Bestie: Choose Your Celebrity Companion from the Command Palette.

3. Package as a `.vsix` Installer

npm.cmd run package

This compiles TypeScript and generates break-bestie-1.1.0.vsix in the project root.

4. Install the `.vsix` Extension in VS Code

code --install-extension break-bestie-1.1.0.vsix

(Alternatively, open the Extensions view in VS Code, click the ... menu at the top-right, and select Install from VSIX...)

Frequently Asked Questions (FAQ)

Does Break Bestie require an internet connection?
No. All celebrity caricature stickers and audio chimes are bundled locally or synthesized via the Web Audio API. The extension operates 100% offline.

Will the break panel interrupt my typing?
Never. The break panel opens with preserveFocus: true, keeping your cursor and keyboard locked in your active code editor. For an even more minimal workflow, set waterBreak.reminderDisplayMode to "notification".

How do I switch my companion to Ranga Annan, Dashamoolam Damu, or Lionel Messi?
Click the Break Bestie countdown in the bottom-right status bar, choose Change Bestie Companion, and select your preferred character from the gallery.

Search Keywords (SEO)

break bestie · vs code water reminder · eye strain relief · 20-20-20 rule timer · developer health extension · ergonomic break timer · hydration reminder vscode · mohanlal vscode extension · mammootty sticker · ranga annan aavesham · fahadh faasil · dashamoolam damu · adi pookkutti · cristiano ronaldo siuuu · lionel messi · malayalam coding companion · dancing sticker widget

Author & Credits

Developer: Jeswin John
Extension: Break Bestie (break-bestie)
Artwork: All celebrity caricature stickers in media/characters/ (mohanlal.png, mammootty.png, ranga.png, damu.png, adipookkutti.png, messi.png, and ronaldo.png) are custom-illustrated fan-art caricatures created for developer wellness reminders.

Licensed under the MIT License (LICENSE.txt).

Break Bestie — Water & Eye Break Companion

Jeswin John