Eye Break

Eye Break 👀

Eye Break is a context-aware break assistant built for developers inside VS Code.

It helps you:

- Protect your eyes during long coding sessions

- Take meaningful stretch and meditation breaks

- Avoid interruptions while debugging or running tasks

- Build healthy focus–break cycles without breaking flow

No nagging alarms. No productivity gimmicks. Just smart recovery, when it actually makes sense.

✨ Features

🧠 Adaptive Focus Engine

Extends focus time if you’re actively coding near the end

👀 Guided Eye Exercises

Animated eye movements for strain relief

🧍 Stretch Break Mode

Simple timed breaks to move your body

🧘 Meditation Mode

Calm, distraction-free breathing sessions

🔕 Context-Aware Silence

Breaks auto-suppressed during:

Debug sessions

Running tasks

📊 Daily Micro-Insights

Focus time

Break completion ratio

Eye strain risk (low / moderate / high)

🚀 Getting Started

1️⃣ Install (Local Development)

git clone https://github.com/ypranay3232/eye-break
cd eye-break
npm install

2️⃣ Build the Extension

npm run compile

3️⃣ Run in VS Code

Open this folder in VS Code

Press F5

A new Extension Development Host window opens

Start coding — Eye Break runs automatically

⏱️ How It Works

Eye Break starts a focus timer

When focus ends, you choose how to recover:

👀 Eye Care

🧍 Stretch

🧘 Meditate

😴 Skip

After the break, a new focus session starts

This loop runs infinitely and cleanly

If you’re debugging or running tasks, Eye Break stays silent.

⚙️ Configuration

Open VS Code Settings (cntrl + ,) and search for Eye Break


{
  "eyeBreak.enabled": true,
  "eyeBreak.focusMinutes": 25,
  "eyeBreak.exerciseSeconds": 10,
  "eyeBreak.stretchSeconds": 60,
  "eyeBreak.meditateSeconds": 120
}

🖥 Status Bar

Eye Break always shows its state in the status bar:

👀 Focus: 14:32

📄 License

MIT

Pranay