Focus Sessions

A minimal local Chrome extension for lightweight focus accountability.

What It Does

• Opens an extension-owned interstitial before normal HTTP/HTTPS sites so prompt input is not tied to the page being loaded.
• Starts timing only after you choose a category and the destination site loads, then counts time only while that tab is active in a focused Chrome window.
• Logs tab sessions locally by domain, category, optional note, date, and duration.
• Tracks zero-duration Early Exit events when you choose to leave a site instead.
• Opens a dashboard tab from the extension toolbar button.
• Shows today's grouped stats, early exits, auth exemptions, export, and whitelist controls.
• Lets you whitelist domains that should not prompt or appear in analytics.
• Lets auth-exempt domains pass through login flows without prompting or tracking.

Privacy And Storage

Focus Sessions does not use accounts, remote APIs, analytics services, or network requests.

Completed records are stored in the local Chrome profile with chrome.storage.local under focusSessions. A record includes the domain, category, optional note, display purpose, status, date, timestamps, and active-tab duration. Raw records are retained for 90 days.

Long-term daily summaries are stored locally under focusDailyRollups. Active in-progress state is stored temporarily with chrome.storage.session under activeFocusSessions and pendingFocusPrompts.

Whitelisted domains are stored locally under whitelistedDomains. A whitelisted domain such as example.com also matches subdomains such as docs.example.com.

Auth exemptions are stored locally under authExemptions. These domains are skipped during login flows, but unlike whitelisted domains they do not exclude the final destination from tracking.

The extension does not encrypt local data itself. Anyone with access to your Chrome profile or device may be able to inspect extension storage.

Permissions

• storage: saves local session records, active state, and whitelisted domains.
• tabs: detects tab lifecycle, opens the dashboard tab, redirects to the interstitial, and closes a tab when you choose Exit instead.
• webNavigation: detects top-level navigation so the extension can show the interstitial before normal sites and carry selected intent through auth redirects.
• http://*/* and https://*/*: allows navigation detection for normal websites.

The extension does not use webRequest, remote scripts, or remote services.

Limitations

• Chrome does not allow the prompt on restricted pages such as chrome://newtab.
• This is an accountability aid, not a tamper-proof blocker.
• Whitelisted domains are skipped entirely and are not tracked in analytics.

Build

npm install
npm run build

Load In Chrome

1. Open chrome://extensions.
2. Enable Developer mode.
3. Click Load unpacked.
4. Select the generated dist folder.

License

MIT