MicroReps Support

MicroReps Support

Need help with MicroReps on Mac? This guide describes how the app works, where your data lives, and how to fix common issues.

Product page: patakolabs.com/projects/microreps

What MicroReps does

MicroReps is a free, native macOS app that schedules short exercise bursts (under about 60 seconds) during your configured working hours. Push-ups, squats, plank, jumping jacks, stretching, and more — one small session per hour, then back to work.

• No account, no cloud, no subscription
• All session history stays on your Mac (App Sandbox container)
• Native macOS notifications for hourly prompts (respects Focus modes when notifications are muted)

Getting started

First launch

1. Open MicroReps from Applications or the Mac App Store.
2. Allow notifications when macOS asks — they are how hourly session prompts appear.
3. Open Settings and set your working hours (start and end hour), daily rep targets, and which exercises to include.

Your first session

When a session is due, MicroReps shows a session popup with the exercise, variation, and rep target (or seconds for plank and stretching). Complete the movement, adjust the count if needed, and tap Complete. The app logs the session and schedules the rest of your day.

You can also start a pending session from the Dashboard timeline.

Working hours and session count

Sessions are spread evenly between your start hour and end hour (for example 9:00–18:00 → nine hourly slots). Each slot gets an exercise and a rep count derived from your daily targets.

Features explained

Smart scheduling and missed reps

MicroReps divides each exercise’s daily target across your working hours. If you skip a session, those reps are redistributed to remaining pending sessions that day (when possible within the per-session time cap).

Progressive overload

In Settings → Progression, set a daily growth rate. Over time, daily targets increase slightly. When a session would exceed the maximum session duration (default 60 seconds), MicroReps can introduce harder exercise variations instead of only adding reps.

Exercise rotation

You can enable a subset of exercises and optionally limit how many different exercises appear per day (rotation). Disabled exercises are excluded from the plan.

Streaks and history

The Dashboard shows today’s plan, completion rate, and streaks. History charts reps and completion over past days. Exercises lists how-to guidance for each movement.

Launch at Login

Settings → Launch at Login registers MicroReps with macOS so the app can schedule notifications across the workday without you opening it manually each morning.

Body metrics (optional)

Weight in Settings is used only for estimated calorie hints on the dashboard (MET-based estimates). It is stored locally and is not sent to any server.

Notifications and Focus

• MicroReps uses standard macOS User Notifications.
• If you use Focus modes that silence notifications, prompts may not appear until Focus allows them — same as any other Mac app.
• Use Snooze in the session popup (or notification flow) to defer a session by a few minutes.

Where your data is stored

With App Sandbox enabled, data lives in your Mac user library, inside the app container (bundle ID code.kikov.org.RepFlow):

text ~/Library/Containers/code.kikov.org.RepFlow/Data/Library/Application Support/RepFlow/Sessions/

One JSON file per calendar day (for example 2026-05-25.json). Nothing is uploaded to PatakoLabs or third-party analytics from the app.

To inspect or back up data, quit MicroReps and copy that folder. Replacing files while the app is running is not recommended.

Apple Health

MicroReps does not sync workouts to Apple Health on Mac. Apple does not allow native macOS apps to read or write HealthKit data. There is no Health privacy row for MicroReps in System Settings.

Motion & Fitness in Privacy & Security is unrelated (motion sensors). Turning it on does not connect MicroReps to the Health app on iPhone.

Troubleshooting

I do not get hourly notifications

1. System Settings → Notifications → MicroReps — ensure notifications are allowed.
2. Confirm working hours include the current hour and that the session is still pending.
3. Check Focus / Do Not Disturb — they may block alerts.
4. Keep MicroReps running or enable Launch at Login so scheduling stays active.

The session popup did not appear

Open MicroReps and check the Dashboard — you can start the current session from the timeline. The app also refreshes the day plan when brought to the foreground after midnight.

Rep targets look wrong after I changed settings

Changes apply to new day plans. If you edited targets mid-day, tomorrow’s plan reflects the new settings; today’s file may still reflect earlier distribution until the day rolls over or you reset (see below).

I want to reset today’s plan

Quit MicroReps, delete today’s JSON file in the Sessions folder (see path above), and relaunch — the app creates a fresh plan. This removes today’s logged sessions.

Demo / screenshot mode

Developers and reviewers may launch with --demo to use separate demo data under DemoSessions/. This is not used in normal App Store installs.

App crashes or will not open

Try restarting your Mac, then reinstall MicroReps from the Mac App Store. If it persists, contact us with your macOS version and MicroReps version (Settings or About).

Privacy

• No account, no cloud sync, no advertising trackers in the app.
• Session and settings data remain on your Mac.
• The marketing site may use optional analytics cookies; the app does not phone home for usage analytics.

Site privacy: PatakoLabs privacy policy

Contact us

If this page does not answer your question:

• Email: contact@patakolabs.com
• Product page: MicroReps on PatakoLabs

We typically respond within 24–48 hours.