Heroku Dyno Usage Badge

WHAT IT DOES This userscript adds real-time cost visibility to your Heroku dashboard. It reads dyno usage data from the page—including dyno type, current dyno count, and usage hours—then calculates estimated monthly costs and tracks free tier usage. A color-coded badge appears on each app row showing the dyno type, dyno count, and estimated monthly cost: green for free or $100/mo. Apps exceeding the free tier limit (1,000 hours per month) display a warning indicator. A summary panel shows total monthly cost across all apps, average cost per app, total dynos, and the number of apps exceeding free tier limits. This is invaluable for developers, DevOps engineers, and finance teams who need to monitor Heroku spending, identify cost anomalies, and ensure efficient dyno usage. WHERE IT RUNS The script runs on all Heroku web application pages at *.heroku.com/*, with automatic detection of the app dashboard, app list, and any page displaying app or dyno information. It works across all Heroku interfaces by using multiple selector strategies to find app rows, dyno types, dyno counts, and usage hours. The script detects dynamic content loading and re-applies usage badges when the app list updates. It runs across the entire Heroku domain, ensuring coverage whether you're viewing your main dashboard, a specific app's details, or the billing overview. HOW TO USE Install the script via the BotGentz extension and navigate to your Heroku dashboard. Dyno usage badges will appear automatically on every app row. Each badge shows the dyno type, dyno count, and estimated monthly cost, with a color-coded background indicating the cost category. Apps exceeding the free tier limit show a warning indicator (⚠️). The summary panel appears above your app list showing total monthly cost, average cost per app, total dynos, and apps exceeding free tier limits. A cost distribution breakdown shows counts by cost category with percentages. Use the panel controls to customize your experience: toggle usage badges on or off, show or hide the summary panel, enable or disable free tier usage tracking, or show or hide dyno type indicators. The "Refresh" button manually reapplies all badges if the page updates, and the "Copy summary" button exports the usage summary to your clipboard for reporting. THE MECHANISM - DATA EXTRACTION, COST CALCULATION, AND FREE TIER TRACKING This script identifies app data by scanning each app row using a cascading selector strategy. It extracts app names from name elements, dyno types from plan or dyno type elements, dyno counts from count or instances elements, and usage hours from hour or uptime elements. Hourly rates are determined by looking up the dyno type in a pricing map that covers all Heroku dyno types (Free, Hobby, Standard-1x, Standard-2x, Performance-M, Performance-L, Performance-XL, Private, and Shield variants). Monthly cost is calculated as hourly rate × usage hours × dyno count. Free tier usage tracks whether an app has exceeded the 1,000-hour monthly free limit. The badge is created as a DOM element with inline styles and inserted into the app name cell. The summary panel aggregates costs across all apps and calculates distribution percentages. THE PANEL The control panel appears as a floating, draggable element that you can position anywhere on the Heroku page. Drag by the header to reposition it, and the position is saved per site using GM_setValue so it stays where you left it across sessions. Release the panel near any edge and it snaps into place, keeping your workspace organized. Click the panel header to collapse it into a small bubble showing only the money emoji (💰), minimizing distraction while keeping controls accessible. Drag from the bubble to restore the full panel. The panel automatically resizes to fit its content and includes all setting toggles, action buttons, and a cost legend. Press the Escape key to quickly collapse the panel to its minimized state. The panel remains visible across page navigation within Heroku, with usage badges updating automatically as you move between views. PLEASE NOTE This script requires the free BotGentz extension to function. It is designed for Heroku users who need to monitor dyno usage and costs. The script reads only visible app data from the DOM—it does not access Heroku's API, your account credentials, or any sensitive information. All settings (badge visibility, summary toggle, free tier tracking toggle, dyno type toggle, and panel position) are stored locally using GM_setValue and never leave your browser. The script does not modify your Heroku data—it only reads and visualizes visible information. Cost estimates are based on standard Heroku pricing and usage calculations; actual billing may vary based on discounts, credits, or regional pricing. If Heroku updates its website structure or pricing, the script may need to be updated to match new selectors or rates. The free tier tracking assumes a 1,000-hour monthly limit per app; free tier eligibility may vary based on account type and region.