Harvest Time Entry Reminder Overlay

WHAT IT DOES

This userscript continuously monitors your Harvest time tracking page and alerts you when projects are missing time entries for the current day. It scans your project list and compares it against today's logged entries, then displays a persistent overlay listing every project that still needs time recorded. Each missing project appears with a "Start" button that, when clicked, automatically locates and activates the timer for that project. The script also tracks when you've been reminded about each project and uses a configurable cooldown interval to prevent nagging while still keeping you accountable. Additionally, the overlay shows you the total number of projects missing entries at a glance, helping you quickly assess your time logging status without navigating through multiple pages.

WHERE IT RUNS

The script runs on all Harvest web application pages at *.harvestapp.com/*, including the timesheet view, project dashboards, and the daily entry form. It works on both the legacy and newer Harvest interfaces by using multiple selector strategies to locate projects, time entries, and timer buttons. The script detects page changes in Harvest's single-page application architecture and re-evaluates your time entry status after each navigation, ensuring the reminder is always current whether you're viewing today's timesheet, switching between projects, or accessing the reporting views.

HOW TO USE

Install the script through the BotGentz extension and navigate to your Harvest account. The reminder overlay will appear automatically if you have projects that need time logged. Each missing project is listed with a "Start" button that begins the timer for that project with a single click. Use the "✕" button next to any project to dismiss it temporarily (the script will remember and not remind you again until the configured interval has passed). The overlay includes a "Refresh Status" button to manually rescan your entries, and an "Add Time Entry" button that scrolls to and focuses the time entry form for quick manual logging. You can customize the reminder interval (15, 30, 60, or 120 minutes) and enable or disable auto-show on page load. The panel can be dragged, collapsed, or closed at any time.

THE MECHANISM - DOM SCANNING AND DIFFERENTIAL COMPARISON

Unlike simple timer-based reminders, this script performs a differential analysis between your assigned projects and your logged time entries. It first builds a comprehensive list of all projects available on the page by scanning project selectors, task lists, and navigation elements. Simultaneously, it parses the current day's time entries by identifying entry rows and extracting project names and logged hours. The script then computes the set difference: projects that appear in the project list but have no corresponding entry in today's time entries. This approach catches projects with zero hours logged, even if they appear elsewhere on the page. The script uses a weighted selector strategy that prioritizes Harvest's data-test attributes for stability, falling back to class names and structural heuristics when necessary. When you click a "Start" button, the script traverses the DOM from the project name to locate the nearest timer activation element, ensuring precise targeting even in complex layouts. All reminder timestamps are stored locally to enforce the cooldown interval, preventing notification fatigue.

THE PANEL

The reminder appears as a floating, draggable overlay panel that you can position anywhere on the Harvest page. Drag by the header to reposition it, and the position is saved per website so it stays where you left it across sessions. Release the panel near any edge and it snaps into place for a tidy workspace. Click the header to collapse the panel into a small bubble showing only the alarm clock emoji (⏰), minimizing distraction while keeping the reminder accessible. Drag from the bubble to restore the full panel. The panel automatically resizes to fit its content and includes a scrollable list of missing projects. Press the Escape key to quickly collapse the panel to its minimized state. The panel remains visible across page navigations within Harvest, automatically updating as you move between views.

PLEASE NOTE

This script requires the free BotGentz extension to function. It is designed for Harvest users who need help remembering to log their time consistently. The script reads only the visible project list and time entry data from the DOM; it does not access Harvest's API, passwords, or any sensitive data. All settings and reminder timestamps are stored locally using GM_setValue and never leave your browser. If Harvest updates its website layout, the script may need to be updated to match new selectors. The script does not modify your time entries or project data - it only provides reminders and automates starting timers when you choose to do so. The "Start" button requires the Harvest timer button to be present and visible on the page; if the button structure changes, the script may need updates to maintain compatibility.