Headspace Web Streak Reminder

WHAT IT DOES

Headspace Web Streak Reminder reads your meditation session completion and streak data directly from the Headspace web interface. It displays your current streak count in days, shows how many days remain until your next milestone (such as 10, 30, 50, or 100 days), and provides a visual status indicator that changes color based on your streak health. When your streak is at risk—meaning you haven't completed a session today and a milestone is approaching—the extension highlights this with a clear warning. A one-click button opens the Headspace streak page so you can view your full history and achievements. The extension also offers optional notifications to remind you when it's time to meditate to keep your streak alive.

WHERE IT RUNS

This extension works on all Headspace web pages at headspace.com and its subdomains. It monitors the page for streak indicators, session completion markers, and milestone progress elements. It does not require the mobile app and works entirely within your browser on the Headspace website. The extension runs only when you are on Headspace pages and does not track activity on other sites.

HOW TO USE

Install the extension, then navigate to headspace.com and log in to your account. The extension automatically detects your streak data from the page and displays it in a panel. Click the extension's icon in your browser toolbar to open the panel and view your current streak, next milestone, and days remaining. The panel updates in real time as you navigate through the site. Use the "View Full Streak" button to open your detailed Headspace streak page. Set your reminder preference to daily, weekly, or never using the dropdown menu. The "Check Now" button manually triggers a notification with your current streak status. Refresh the data at any time using the "Refresh Status" button.

DOM OBSERVER PATTERN WITH MUTATION OBSERVER

Unlike simple page load checks that miss dynamic updates, this extension uses a MutationObserver that watches the entire DOM for changes to Headspace's React-rendered components. When Headspace updates the streak counter, milestone progress, or session completion indicators, the observer captures these changes instantly. The extension combines this with a URL change detector using the History API, ensuring the data refreshes when you navigate between pages without a full page reload. The streak data extraction uses multiple fallback selectors that adapt to Headspace's various UI layouts, including the dashboard, profile page, and streak-specific views. This multi-layered observation strategy ensures the extension works reliably even as Headspace updates its interface, and the data is always current with the state displayed on the page.

THE PANEL

The panel supports drag-to-move anywhere on the page. It remembers its position per site, so it stays where you placed it on headspace.com. Click the panel header to collapse it down to just the minimized bubble, or click the expand handle to show the full panel. The panel can be resized by dragging the bottom-right corner. Press the Escape key to close the expanded panel and return to the minimized state. All panel settings, including position, size, and collapsed state, are saved per site and persist across browsing sessions.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and active, as it provides the underlying DOM injection and script execution environment that allows the observer patterns to work on React-based web applications. Headspace's website changes periodically, and element selectors, class names, and data attributes may be updated. When that happens, the extension may stop detecting streak data until an update is released. The extension stores your reminder preference and last check timestamp locally in your browser's storage using GM_setValue. No data is ever sent to any server, and no personal information is collected. The extension does not read or store your Headspace login credentials, email, or any identifying information. It only reads publicly visible streak and session data from the page. You can clear all stored settings at any time from the extension's settings page or by clearing your browser data for headspace.com.