Browser Extension Features - Documentation

Everything the Heyweek extension does — and nothing it doesn't.

Overview

The extension is focused on one thing: controlling your Heyweek timer from the browser. It adds a toolbar popup for starting and stopping time, keyboard shortcuts for doing it hands-free, a timer button on GitHub, and a tidy new-tab page. It is not a full clone of the web app — for managing projects, reports, and invoices you'll still use app.heyweek.com. What follows is the complete, real feature set.

The extension's main surface is the popup that opens when you click its toolbar icon:

Start and stop the timer — Begin tracking with one click, and stop it the same way.
See the running timer — The popup shows the timer that's currently running across your workspace.
Pause and resume — Pause a running timer from the popup and resume it later.
Toolbar badge & icon — The extension icon reflects whether a timer is running, so you get a glance-able status from the toolbar.

Anything you start here is the same timer as everywhere else in Heyweek, so it appears in your Time Tracking list immediately.

Keyboard shortcuts

You can drive the timer without opening the popup:

Open the popup — Ctrl+Shift+O (Cmd+Shift+O on macOS).
Start/stop the timer — Ctrl+Shift+S.

These are the defaults shipped with the extension, and you can change them on Chrome's extension-shortcuts page. See Keyboard Shortcuts for the full list and how to customize them.

GitHub integration

When you're on a GitHub issue or pull request, the extension injects a timer button into the page. Click it to start tracking time against the work you're looking at, without switching tabs back to Heyweek.

NOTE

GitHub is the website integration that ships in the extension today. Other site integrations are not yet enabled.

New-tab page

The extension replaces your browser's new-tab page with a minimal week-and-time display — a clean view of the current day and week. It respects light/dark theme and your accent color.

Idle detection & notifications

The extension keeps an eye on whether you're actually at your machine:

Idle detection — It can detect when you've gone idle while a timer is running.
Reminders & notifications — It can surface desktop notifications, such as reminders related to a running timer.

These help you avoid leaving the clock running after you've stepped away.

Maintenance

Clear extension storage — Right-click the extension icon for a menu option that clears the extension's locally stored data, handy if you ever need to reset its state.

Tips

Keep the timer button on GitHub in mind during code review — start tracking the moment you open a PR.
If a notification reminds you a timer is still running after you stepped away, you can stop it straight from the popup.
For everything beyond timing — projects, descriptions, reports, invoices — head to the web app or read Time Tracking.