Skip to content

About

A timer for the 20-20-20 habit: every twenty minutes, look twenty feet away for twenty seconds. Keeps count of whether you actually did it. A timer, not health advice.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Break Clock

A timer for the 20-20-20 habit: every twenty minutes, look twenty feet away for twenty seconds. Keeps count of whether you actually did it. A timer, not health advice.

A feature for Mavis AI — a desktop voice assistant.

You: "open break clock"

Mavis opens it and stands its own panels down so they are not in your way. Say "show the interface" to bring them back.

Install

From the Mavis Appstore — find Break Clock and click Install.

Or install it directly:

from utils.feature_install import install_from_github
install_from_github("https://github.com/keefng8/break-clock")

What you can say

  • "open break clock"
  • "start a screen break timer"
  • "remind me to look away"
  • "set up a pomodoro"

These are not matched word for word. Mavis gives them to its language model as examples of intent, so close variations work too.

How it works

Time is tracked as an absolute end timestamp, not a decrementing counter. Browsers throttle timers in background tabs, often to once a minute, so anything counting ticks silently turns a 20-minute timer into a 40-minute one - and a break reminder you are not looking at is exactly the case that has to keep working. It is a timer, and says plainly that it is not health advice.

Requirements

None. A single HTML file — it runs in your browser, offline, and nothing leaves your machine.

Building your own

See Building features for Mavis — a feature is just a GitHub repository with a mavis.json.

License

MIT — see LICENSE.

About

A timer for the 20-20-20 habit: every twenty minutes, look twenty feet away for twenty seconds. Keeps count of whether you actually did it. A timer, not health advice.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages