The Spark: You Forgot to Stand Up Again

Three hours pass. Your back aches. Your eyes are dry. You glance at the clock and realize you skipped lunch — again.

Every knowledge worker knows this feeling. You sit down with good intentions, get absorbed in a problem, and surface hours later wondering where the time went. The irony is sharp: the better you focus, the worse you treat your body.

Break reminder apps exist, of course. Most of them are timers. They ring every 30 minutes whether you are mid-sentence in a critical email or walking back from the kitchen. They don't know if you just returned from a five-minute stretch. They don't care that your standup starts in two minutes. They interrupt without intelligence, and eventually, you disable them.

That is where Kairo comes in.

The Idea: Breaks at the Right Time

What if a break reminder actually understood when you were working — and when you were not?

What if it watched your keyboard and mouse activity, checked your calendar, noticed when you walked away naturally, and only intervened when you genuinely needed to stop?

• If you have been idle for five minutes, that counts as a break. The timer resets.
• If a meeting starts in ten minutes, the break waits until after.
• If you skip a break, the next one is mandatory and a little longer.
• If you have been working for 90 minutes straight without any real pause, the app steps in regardless.

No manual timers. No guesswork. The app does the thinking so you can focus on your work.

This is the core vision of Kairo:

A macOS menu bar app that intelligently forces you to take breaks — respecting your calendar, rewarding natural pauses, and stepping in when you have been at the screen too long.

What Problem Are We Solving?

• Forgetting to take breaks during deep focus sessions.
• Dumb timers that interrupt you at the worst possible moment.
• Break reminders that fire right before a meeting starts.
• No credit for natural breaks — walking to the kitchen, chatting with a colleague, stepping outside.
• Skipping a break with zero consequences, making it easy to never break at all.
• Apps that require constant manual interaction to stay useful.

How Kairo Solves It

Idle-Aware Focus Tracking: Kairo uses system idle time detection to know when you are actually at your desk. If your keyboard and mouse have been quiet for 20 seconds, the focus timer pauses. If you walk away for three minutes, you start earning break credit. Five minutes away? Your focus timer resets entirely. A genuine break is a genuine break — the app does not punish you for stepping away.

Calendar-Aware Scheduling: Connect your calendar and Kairo checks for upcoming meetings. If a break would land within ten minutes of a meeting, it delays automatically. When the meeting ends, the break triggers. You never get pulled away from your screen right before a call starts.

Progressive Enforcement: In flexible mode, breaks are suggestions. You can skip one. But skip it, and the next break becomes mandatory — slightly longer, and you cannot skip it. This recovery lock ensures that skipping once does not become skipping always. In strict mode, every break is mandatory from the start.

Continuous Work Safety Net: Regardless of settings, if you hit 90 minutes of continuous work without any meaningful pause, Kairo triggers a mandatory break. This is the hard ceiling — a safety net for the days when you are too deep in the zone to notice time passing.

Full-Screen Mandatory Breaks: When a break is mandatory, Kairo takes over the screen. Dock hidden, menu bar gone, process switching disabled. A calm countdown tells you how long to stay away. This is not a notification you can swipe away — it is a break you have to take.

Floating Panel for Soft Breaks: Non-mandatory breaks show a floating panel in the corner of your screen with a countdown timer and activity suggestions — "Hydrate with a glass of water," "Stretch your body," "Walk for a few minutes." Visible enough to act on, gentle enough not to break your train of thought if you genuinely need another minute.

How It Works

The Focus Cycle

When you start working, Kairo watches:

• Every second, it checks system idle time via IOKit.
• If you are active (idle < 20 seconds), the focus timer increments.
• When the focus timer hits your configured threshold (default: 30 minutes), a break triggers.
• The break lasts five minutes (configurable), then the cycle resets.

Natural Break Credit

Not every break needs to be forced:

• 3+ minutes idle — Partial credit. Your focus timer decreases proportionally.
• 5+ minutes idle — Full reset. You took a real break, and Kairo recognizes it.
• Continuous work counter also resets, so the 90-minute safety net adjusts too.

Meeting Awareness

If you connect your calendar:

• Kairo fetches your next event and checks whether it starts within ten minutes.
• If a break would collide with a meeting, it is delayed — not skipped.
• The dashboard shows "Break delayed — meeting starting soon."
• When the meeting ends, the break fires automatically.

The Skip-Recovery System

In flexible mode:

1. A break triggers. You see a floating panel.
2. You can skip it — once.
3. Skipping activates a recovery lock: the next break is mandatory, three minutes longer, and cannot be skipped.
4. Complete that mandatory break, and the lock releases. The cycle returns to normal.

This creates a natural rhythm: skip occasionally when you need to, but never indefinitely.

What Makes It Different

1. It Knows When You Are Working Most break reminders use a fixed timer. Kairo tracks actual activity. Walk away for five minutes and come back — your timer reflects that. No phantom breaks, no wasted interruptions.

2. It Respects Your Calendar A break two minutes before a standup is worse than no break at all. Kairo checks your calendar and waits. When the meeting ends, the break fires. Simple, but no other break app does this.

3. Skipping Has Consequences Skip a break, and the next one is longer and mandatory. This single rule transforms the experience: you skip when you genuinely need to, not out of habit.

4. It Actually Forces You to Stop Mandatory breaks take over the screen. No switching to another app, no dismissing a notification. You sit with the countdown and step away. This is the feature that makes Kairo work where others fail.

5. Natural Breaks Count The idle detection is not just for pausing the timer — it actively credits you. Three minutes away earns partial credit. Five minutes resets the cycle. The app rewards healthy behavior instead of ignoring it.

Key Features

Intelligent Break Timing

• Idle-Aware Tracking — Knows when you are working vs. away from the screen.
• Calendar Integration — Delays breaks to avoid interrupting meetings.
• Natural Break Credit — Idle time of 3-5 minutes partially or fully resets the focus timer.
• 90-Minute Safety Net — Mandatory break after sustained continuous work.

Progressive Enforcement

• Flexible Mode — Breaks are suggestions you can skip once.
• Strict Mode — Every break is mandatory from the start.
• Recovery Lock — Skip a break and the next one cannot be skipped.
• Full-Screen Overlay — Mandatory breaks take over the screen completely.

Menu Bar & Dashboard

• Live Countdown — See time until next break in the menu bar.
• Progress Ring — Visual indicator showing how close you are to the next break.
• Activity Suggestions — Rotating tips during breaks: hydrate, stretch, walk.
• Floating Break Panel — Non-mandatory breaks show a gentle countdown in the corner.

Set It and Forget It

• Launch at Login — Starts automatically so you never forget to turn it on.
• Persistent Settings — Mode, break period, and break duration survive restarts.
• Zero Configuration Needed — Works with sensible defaults out of the box.
• Notification Support — Break alerts even when the app is in the background.

The Experience

Menu Bar First — Kairo lives in your menu bar. A single icon shows the status. Click it for a quick view: countdown, state, current app, and controls. Open the dashboard only when you want details.

Dark, Calm Interface — The dashboard and break overlays use a dark gradient palette designed not to jar you when a break triggers. Warm amber countdown text, soft greens for activity suggestions, muted backgrounds. It is a break, not an alarm.

One-Click Controls — Start a break manually, pause tracking for 15 minutes, toggle between flexible and strict mode, skip a soft break. Everything is one click from the menu bar.

Perfect For

• Developers and designers who lose hours in deep focus.
• Remote workers without natural break triggers like commutes or lunch calls.
• Writers and researchers who sit for long stretches without noticing.
• Anyone who has said "I should take more breaks" and never followed through.

Kairo vs Simple Break Timers

Download

Kairo is free and open source. Download the latest release for macOS:

Download Kairo v1.0.0

1. Download Kairo-v1.0.0-macOS.zip from the release page.
2. Unzip and drag kairo.app to your Applications folder.
3. Launch Kairo — it appears in your menu bar.
4. Grant Accessibility permission when prompted — so Kairo can detect idle time.
5. Connect your calendar (optional) — so breaks respect your meetings.
6. Enable notifications — so you get alerted even when backgrounded.
7. Work normally — Kairo handles the rest.

Your Settings

• Break Period — How long you work before a break (default: 30 minutes).
• Break Duration — How long each break lasts (default: 5 minutes).
• Mode — Flexible (can skip once) or Strict (every break mandatory).
• Launch at Login — Toggle in the setup panel.

All settings persist across app restarts. Change them once and forget about it.

The Future: Work Hard, Break Smart

With Kairo, you do not have to remember to take breaks. You do not have to set timers, watch the clock, or feel guilty about skipping. The app watches your patterns, respects your schedule, credits your natural pauses, and steps in when you need it most.

It is not about working less. It is about working sustainably.

Kairo is where focus meets recovery — an intelligent break system that gets the timing right so you can keep doing your best work.