Sign in Start free
Documentation

Browser Extension Overview

Track time without leaving the tab you're working in — the Heyweek extension puts the timer in your browser toolbar.

Last updated:

Track time without leaving the tab you're working in — the Heyweek extension puts the timer in your browser toolbar.

Overview

The Heyweek browser extension is a lightweight companion to the web app. Its job is simple: let you start and stop the same timer you'd use on app.heyweek.com, straight from your browser, so you don't have to switch tabs to capture what you're working on. The timer it controls is the same one that lives across the rest of Heyweek, so anything you track in the browser shows up immediately in your Time Tracking list, reports, and invoices.

It's built as a Chrome extension (Manifest V3) and is published on the Chrome Web Store. It also replaces your new-tab page with a minimal week-and-time view, and adds a one-click timer button on GitHub issues and pull requests.

Key features

  • Toolbar timer — Start and stop tracking from the extension popup in your browser toolbar.
  • Keyboard shortcuts — Start/stop the timer or open the popup with a keystroke, without reaching for the mouse.
  • GitHub timer button — A "start timer" button is injected into GitHub issues and pull requests so you can track time against the work in front of you.
  • Minimal new-tab page — Each new tab shows a clean week-and-time display instead of the default page.
  • Idle detection & reminders — The extension can notice when you've gone idle and remind you about a running timer.
  • Stays in sync — Everything you track flows into the same workspace as the web app, mobile, and CLI.

How it works

  1. Install the extension from the Chrome Web Store and pin it to your toolbar.
  2. Sign in to connect it to your Heyweek workspace.
  3. Click the toolbar icon to open the popup, then start or stop your timer — or use a keyboard shortcut to do it without opening the popup.
  4. On GitHub, use the injected timer button to start tracking against an issue or pull request.

Tracked time appears in your Time Tracking list right away, where you can add descriptions, attach projects, and tidy up entries.

NOTE


The extension is currently available for Chrome (and Chromium-based browsers that support Chrome Web Store extensions). Builds for other browsers are not yet available.

Supported browser

  • Chrome — and other Chromium-based browsers that can install extensions from the Chrome Web Store.

Firefox, Safari, and other non-Chromium builds are not available yet.

Tips

  • Pin the extension to your toolbar so the timer is always one click away.
  • Learn the keyboard shortcuts — starting and stopping the timer without opening the popup is the fastest way to work.
  • The extension controls the same timer as the web app, so you can start it in the browser and stop it from your phone or the CLI.

Next steps