Eye Comfort
Blue-light reduction overlay for the Agent Zero Web UI. Seven warmth modes from Gentle Warm to Night Red, a circadian auto-schedule, and a Ctrl+Alt+R emergency reset. Tints the whole interface including popups and modals. No dependencies, no telemetry, settings persist locally.
README
Eye Comfort
Blue-light reduction overlay for the Agent Zero Web UI — 7 warmth modes, a circadian auto-schedule, and an emergency reset hotkey. No dependencies, no telemetry.
Eye Comfort warms the Agent Zero interface by drawing a lightweight multiply-blend overlay over the app, reducing the blue channel the same way warmth filters like f.lux or Redshift do — but scoped to the Agent Zero Web UI and implemented entirely client-side.
Inspired by the standalone screen-eyes Windows tray app. Because Agent Zero runs in the browser (often inside a container), this plugin cannot touch your host display's hardware gamma ramp; instead it tints the Agent Zero UI itself. For full-system blue-light filtering, use a host-level tool.
Features
- 7 filter modes from Gentle Warm to Night Red
- Circadian auto-schedule that shifts warmth across the day
- Manual override pauses the schedule so your pick sticks
- Ctrl+Alt+R emergency reset to normal colors
- Sidebar quick-action button with a live mode tooltip
- Settings UI for first-run defaults and a maximum-strength cap
- Local persistence via
localStorage— your mode survives reloads - No dependencies, no network calls, no telemetry
Filter Modes
| Mode | Use case |
|---|---|
| Off / Reset | Filter off, normal colors |
| Gentle Warm | Daytime comfort, slight warmth |
| Day Warm | Reduced blue during the day |
| Sunset Amber | Late afternoon transition |
| Deep Red | Night — still readable |
| Evening Red | Strict evening, almost no blue |
| Night Red | Blue channel fully removed |
Auto-Schedule
When enabled from the Eye Comfort panel, the UI warmth follows this schedule:
| Time | Mode |
|---|---|
| 06:00 – 07:59 | Gentle Warm |
| 08:00 – 16:59 | Day Warm |
| 17:00 – 19:59 | Sunset Amber |
| 20:00 – 21:59 | Evening Red |
| 22:00 – 05:59 | Night Red |
If you pick a mode manually while the schedule is on, the schedule pauses so your selection sticks. Re-enable it any time from the panel.
Usage
- Enable Eye Comfort in the Plugins dialog.
- Click the eye icon in the sidebar quick actions to open the panel.
- Pick a warmth mode, or toggle Auto-schedule.
- Press Ctrl+Alt+R at any time to reset to normal colors.
Settings
Open the plugin's settings (Settings → Agent → Eye Comfort) to set:
- Default mode applied on first run
- Auto-schedule by default
- Show sidebar button
- Emergency reset hotkey on/off
- Maximum strength cap (0.0–1.0) to soften the tint
How It Works
Eye Comfort appends a single fixed, full-viewport <div> overlay to the page with mix-blend-mode: multiply and pointer-events: none. Each mode maps to an rgb(255, g, b) tint where the green and blue components are scaled down to warm the image — leaving red at full strength. The overlay never intercepts clicks and transitions smoothly between modes. State is stored in localStorage under eyeComfort.state.v1.
Privacy
No network requests beyond reading the plugin's own default settings from Agent Zero. No analytics, no external resources, no tracking.
License
MIT — see LICENSE.