ergocare-coach

Your personal desk health coach with automated break reminders. Generates platform-specific scripts (bash/PowerShell) for 20-20-20 eye care, lower back exercises, and RSI prevention. Comprehensive exercise routines, ergonomic guidance, and customizable notification systems for computer professionals.

# ErgoCare Coach 👁️🦴💪

## Description

Your intelligent desk health and wellness coach that actually reminds you automatically! ErgoCare Coach provides:

1. **Expert Exercise Guidance** - 20-20-20 eye care, lower back stretches, neck exercises, RSI prevention
2. **Platform-Specific Reminder Scripts** - Generates bash scripts (Linux/Mac) and PowerShell scripts (Windows) that run as background processes
3. **Automated Notifications** - Desktop notifications, terminal alerts, sound alerts, visual countdowns
4. **Customizable Schedules** - 20-20-20, hourly breaks, custom intervals, work hour limits
5. **Comprehensive Routines** - From 30-second micro-breaks to 10-minute full routines

**"The greatest wealth is Health."**

Perfect for:
- 💻 Computer professionals working long hours
- 👁️ Anyone experiencing eye strain or dry eyes  
- 🦴 People with lower back, neck, or shoulder pain
- 🎮 Gamers and content creators
- 📚 Students and researchers
- 🏢 Remote workers and desk workers
- 🩺 Anyone wanting to prevent RSI and chronic issues

---

## How This Skill Works

### Two Modes of Operation

**Mode 1: Interactive Exercise Coach**
- Ask for specific exercises anytime: "Show me eye exercises"
- Get instant guidance: "I have neck pain, what should I do?"
- Learn routines: "Give me a 5-minute full body desk stretch"

**Mode 2: Automated Reminder Scripts** ⭐ **NEW!**
- Request a custom script: "Generate a 20-20-20 reminder script for Mac"
- Get platform-specific code (bash/PowerShell) ready to run
- Scripts run in background, send notifications automatically
- Fully customizable intervals and exercise types

---

## 1. Quick Start: Get Your Reminder Script

### Request Your Custom Script

Just ask ErgoCare Coach:

```
"Generate a 20-20-20 reminder script for Linux"
"Create a Windows PowerShell script with hourly breaks"
"Give me a Mac script with eye and back exercises every 30 minutes"
"Make me a comprehensive break script for Ubuntu with all exercise types"
```

### Script Features

**All Scripts Include:**
- ✅ Desktop notifications with exercise instructions
- ✅ Countdown timers between breaks
- ✅ Sound alerts (optional, can be disabled)
- ✅ Customizable intervals
- ✅ Multiple exercise types embedded
- ✅ Easy start/stop/restart
- ✅ Run on system startup (optional)

**Platform Support:**
- 🐧 **Linux**: bash script with `notify-send`, `zenity`, or terminal alerts
- 🍎 **macOS**: bash script with `osascript` notifications and `say` voice alerts
- 🪟 **Windows**: PowerShell with `BurntToast` module or native notifications

---

## 2. The 20-20-20 Rule (Eye Care Foundation)

### What It Is

**Every 20 minutes, look at something 20 feet away for at least 20 seconds.**

### Why It Works

When you focus on a screen, your eye muscles maintain constant tension:
- **Ciliary muscles** stay contracted to focus at close range
- **Extraocular muscles** hold fixed position
- **Blinking rate drops** from 15-20/min to 5-7/min (causing dry eyes)
- **Blue light exposure** increases eye fatigue

Looking into the distance:
- ✅ Relaxes ciliary muscles
- ✅ Triggers natural blinking
- ✅ Resets focus mechanism
- ✅ Reduces strain accumulation

### 20-20-20 Implementation

**Your automated script will:**
1. Run silently in background
2. Track 20-minute intervals
3. Send desktop notification: "👁️ 20-20-20 Break: Look 20 feet away for 20 seconds"
4. (Optional) Play gentle sound alert
5. (Optional) Show countdown timer
6. Repeat every 20 minutes

**Manual 20-20-20:**
- Window view (buildings, trees, sky)
- Hallway or room far end  
- Distant wall clock or artwork
- Outside through open door
- Anything genuinely 20+ feet away

---

## 3. Eye Exercise Library

### Quick Blink Reset (30 seconds)
**When to use:** Every hour, or when eyes feel dry

```
1. Close eyes gently (don't squeeze) - 2 seconds
2. Open eyes wide - 2 seconds  
3. Repeat 10 times
4. Finish with 10 rapid blinks

Benefits: Refreshes tear film, prevents dry eyes
```

### Palming (1-2 minutes)
**When to use:** Mid-morning, after lunch, mid-afternoon

```
1. Rub palms together until warm
2. Cup palms over closed eyes (don't press)
3. Block all light completely
4. Breathe deeply for 60-120 seconds
5. Slowly remove hands

Benefits: Deep relaxation, reduces eye fatigue
```

### Eye Rolls (45 seconds)
**When to use:** Every 2 hours

```
1. Look up, pause 2 seconds
2. Slowly roll eyes clockwise (full circle) - 3 seconds
3. Pause, center
4. Slowly roll eyes counterclockwise - 3 seconds
5. Repeat 5 times each direction

Benefits: Exercises all eye muscles, increases range of motion
```

### Focus Shifting (1 minute)
**When to use:** Every hour

```
1. Hold finger 10 inches from your face
2. Focus on finger - 5 seconds
3. Shift focus to object 20 feet away - 5 seconds
4. Repeat 10 times

Benefits: Strengthens focusing ability, prevents presbyopia progression
```

### Figure Eight (1 minute)
**When to use:** Mid-day, when feeling strain

```
1. Imagine a large figure 8 on the wall (10 feet away)
2. Trace it slowly with your eyes (don't move head) - 30 seconds clockwise
3. Trace it 30 seconds counterclockwise
4. Repeat 2 times

Benefits: Improves eye coordination and flexibility
```

### Near-Far Focus (1 minute)
**When to use:** Every 90 minutes

```
1. Hold thumb at arm's length
2. Focus on thumb - 10 seconds
3. Focus on something 20+ feet away - 10 seconds
4. Repeat 5 times

Benefits: Reduces accommodation stress
```

---

## 4. Lower Back Exercise Library

### Seated Spinal Twist (1 minute each side)
**When to use:** Every hour

```
1. Sit up straight, feet flat on floor
2. Place right hand on back of chair
3. Place left hand on right knee
4. Inhale: lengthen spine
5. Exhale: twist to the right
6. Hold 30 seconds, breathe normally
7. Repeat on left side

Benefits: Relieves lower back tension, improves spine mobility
```

### Seated Cat-Cow (1 minute)
**When to use:** Every 45-60 minutes

```
1. Sit on edge of chair, hands on knees
2. Inhale: arch back, look up (cow)
3. Exhale: round back, tuck chin (cat)
4. Flow between positions 10 times slowly
5. Hold each position 3 seconds

Benefits: Mobilizes entire spine, reduces stiffness
```

### Standing Hip Hinge (45 seconds)
**When to use:** Every 90 minutes

```
1. Stand with feet hip-width apart
2. Place hands on lower back
3. Hinge forward at hips (not waist)
4. Keep back straight, slight knee bend
5. Go until you feel stretch in hamstrings
6. Hold 15 seconds
7. Slowly return to standing
8. Repeat 3 times

Benefits: Stretches hamstrings, strengthens lower back
```

### Seated Forward Fold (1 minute)
**When to use:** Mid-morning, after lunch

```
1. Sit on edge of chair
2. Feet hip-width apart, flat on floor
3. Inhale: lengthen spine
4. Exhale: fold forward from hips
5. Let arms hang, relax neck and shoulders
6. Hold 30-60 seconds
7. Slowly roll up, vertebra by vertebra

Benefits: Decompresses spine, relieves lower back
```

### Pelvic Tilts (1 minute)
**When to use:** Every 2 hours

```
1. Sit with back against chair, feet flat
2. Tilt pelvis forward (arch lower back)
3. Hold 5 seconds
4. Tilt pelvis backward (flatten lower back against chair)
5. Hold 5 seconds
6. Repeat 10 times

Benefits: Strengthens core, mobilizes pelvis
```

### Standing Quad Stretch with Back Extension (1 minute each side)
**When to use:** Every 2 hours

```
1. Stand near chair for support
2. Bend right knee, grab right ankle behind you
3. Gently pull heel toward glutes
4. Simultaneously press hips forward
5. Hold 30 seconds
6. Repeat on left side

Benefits: Stretches hip flexors, counteracts sitting posture
```

---

## 5. Neck & Shoulder Exercise Library

### Neck Rolls (1 minute)
**When to use:** Every 45 minutes

```
1. Sit or stand with relaxed shoulders
2. Drop chin to chest - 5 seconds
3. Slowly roll head to right shoulder - 5 seconds
4. Roll head back (don't force) - 5 seconds
5. Roll to left shoulder - 5 seconds
6. Return to center
7. Repeat 3 times each direction

Benefits: Releases neck tension,