Pulse documentation

Getting started

Pulse runs on Android and iOS (a desktop client for macOS and Windows is in development). The first time you launch it, onboarding walks you through a short setup and builds a baseline energy profile.

Quick start

• Install — download from Google Play or the App Store and open the app.
• Profile — set your chronotype and usual routine so forecasts start sharper.
• Connect data — optionally grant access to Health Connect / Apple Health or a wearable.
• First check-in — log sleep, mood and energy to get your first Energy Score.
• Day plan — accept the suggested plan or adjust it to suit you.

Setup also covers

• A Free plan or a Pro / Premium subscription tied to your account.
• Permissions for notifications, location for weather and health-data access.
• Check-in reminders and your day start/end times.
• Accepting the Terms and Privacy Policy.

How Energy Score is calculated

Energy Score is a daily energy metric. It's assembled from several signals and recalculated throughout the day — and every number unfolds into the factors behind it.

Signal sources

• Sleep and recovery — duration and quality of sleep, heart rate and HRV from wearables or Health Connect / Apple Health.
• Activity — steps, workouts and overall movement during the day.
• Check-ins — subjective ratings of mood, energy and stress.
• Context — weather, pressure and your chronotype.

Energy day type

Transparency

• Any score can be expanded down to the factors behind it.
• You can see which signal raised or lowered your energy.
• The longer your history, the more accurate your personal baseline.

Energy-first planning

Pulse builds your day plan around your energy forecast, rather than just filling a calendar by the hour.

How the plan is built

• Energy forecast — from sleep, history and context, Pulse estimates the day's resource and its peaks.
• Task placement — important, demanding work goes on energy peaks; routine goes on dips.
• Recovery — pauses and rest are scheduled in advance, not "if there's time left".
• Adaptation — if the day goes sideways, the plan can be gently reshaped in one tap.

Tasks and habits

• Tasks — add to-dos with priority and a rough load estimate.
• Habits — mark recurring actions and track streaks.
• Calendar — count meetings as busy blocks and day context.
• Plan vs fact — compare your intent with how the day actually went.

Goals, tasks and productivity

Pulse ties your goals to real energy: important tasks land in your peak hours, and progress is measured not by the number of checkboxes but by whether you hit your state.

How goals work

• Goals and sub-goals — set what you're working toward and break it into concrete steps.
• Energy alignment — Pulse schedules a burning goal's tasks into your peak hours.
• Productivity index — one metric for focus depth, not just closed tasks.
• Golden hours — windows when you're most capable of deep work.

Focus and deep work

• Focus blocks — protected slots for deep work without context switching.
• Coverage — what share of important tasks actually landed on energy peaks.
• Anti-burnout — Pulse won't overload protect days just to fit the plan.

Wearables and integrations

Wearables make Energy Score more accurate, but they're optional — the baseline calculation works on check-ins, behavior and weather.

Data sources

How to connect

• Open "Settings → Data sources" and pick the service you need.
• Grant access — it's requested explicitly and used only to calculate your state.
• You can revoke access at any time in your system settings.
• Without integrations, Pulse relies on check-ins, chronotype and weather.

Stress and recovery

Pulse keeps an eye on load and stress and suggests recovery based on signals, not a blind timer.

• Short practices — breathing and micro-pauses at moments of peak stress.
• Recovery in the plan — pauses are scheduled after demanding blocks.
• Gentle days — in protect mode the plan's load goes down.

Smart behavior

• State-driven — nudges arrive when stress or fatigue is building.
• Non-intrusive — gentle reminders you can postpone.
• Scenarios — ready-made conversations with the Pulse assistant about recovery, focus and stress.
• Effect — see how recovery shapes the next day's energy.

Pulse — the AI coach

The Pulse assistant notices dips and helps you make energy decisions — in the morning, in the evening and at the end of the week, without pressure or nagging.

What Pulse does

• Warns ahead — spots an energy dip before it hits your day.
• Suggests an action — a concrete step: what to move, where to pause, what matters more.
• Reshapes the plan — helps you rework the day when something goes wrong.
• Explains — always tells you why it advises this.

How to talk to it

• Cards — short nudges at the right moment of the day.
• Chat — ask about your state or plan in your own words.
• Weekly reviews — weekly summaries and patterns (Pro / Premium).
• Tone control — choose how actively the coach steps in.

Analytics & insights

A deep look at your state patterns — energy trends, behavioral profiling and correlations.

Dashboard widgets

• Energy by hour — the day's curve with peaks, dips and "golden hours".
• Sleep, activity, mood — trends across your key signals.
• Plan vs fact — the intended plan against how the day actually went.
• Weekly digest — a 7-day summary with export.

Correlation insights

• "After 7+ hours of sleep, energy is ~20% higher on average."
• "On days with a workout, evening stress is lower."
• "Late screen time correlates with worse recovery."

Privacy & security

Health and behavior data stays on your device by default; privacy is a core design principle, not an add-on.

What data we work with

• Sleep, activity, HR/HRV — from wearables and Health Connect / Apple Health with your permission.
• Check-ins — mood, energy and stress that you log yourself.
• Context — weather and approximate coordinates for the forecast.
• Behavior — screen time and habits for calculating your state.

What we don't do

• We don't sell data or use ad tracking
• We don't read the contents of messages, photos or files
• We don't track precise location for surveillance
• We don't share health data with third parties

Storage

• On device — a local database on your phone.
• No cloud by default — only optional end-to-end encrypted sync.
• Access control — health-data permissions can be revoked anytime.
• Export anytime — export all your data to CSV/JSON.

Widgets and notifications

Notification timing and frequency can be tuned in "Settings → Reminders".

Troubleshooting

Health data isn't coming in

Check that access is granted in Health Connect (Android) or Apple Health (iOS), and that your wearable is synced with its own app.

Energy Score seems off

In the first days the system is still calibrating your personal baseline. Regular check-ins and a week of data noticeably improve accuracy.

Notifications aren't arriving

Make sure notifications are allowed in your system settings and the app isn't restricted from background activity.

Glossary of terms