Feature Flag Note Tracker

WHAT IT DOES

Feature Flag Note Tracker is a browser extension that automatically scans the current webpage for feature flag elements, toggle switches, experiment indicators, beta labels, and A/B test identifiers. It detects flag-related elements by examining class names, IDs, data attributes, and text patterns for keywords like "flag", "feature", "experiment", "toggle", "beta", "abtest", or "variant". The extension adds a floating "track flag" button (🏴) next to each detected feature flag element, allowing you to capture flag details, flag name, status (enabled/disabled), experiment ID, and custom notes with a single click. Clicking the button opens a panel where you can review the captured information, add notes about flag behavior, rollout status, testing observations, or any other relevant details, and save it to your local database. The extension maintains a complete feature flag database per page or URL with flag history, status changes, experiment IDs, and notes for each tracked flag. The main panel displays all tracked flags, showing the latest status, entry count, and any notes. Status changes are highlighted with color indicators showing whether a flag is enabled or disabled. All data is stored locally in your browser using GM_setValue, ensuring your flag tracking information persists across page reloads and browser sessions. This helps developers, QA engineers, and product managers track feature flag configurations, monitor experiment rollouts, and document testing observations across different environments.

WHERE IT RUNS

This extension runs on any webpage that displays feature flags, toggle switches, experiment indicators, or beta labels – including internal dashboards, staging environments, production applications, feature flag management tools, experiment platforms, and any page containing flag-related UI elements. The extension intelligently adapts to different page structures and supports a wide range of common flag display patterns. No manual configuration is required per site; the extension automatically detects flag elements using a flexible pattern matching system. This makes it ideal for developers working with feature flags, QA engineers validating flag behavior, and product teams monitoring experiment rollouts.

HOW TO USE

Simply install the extension and navigate to any webpage displaying feature flags. The extension automatically detects flag elements and places a small "track flag" button (🏴) next to each one. Click any of these buttons to open the tracking panel with flag name and status pre-filled. Add a note about the flag behavior, rollout status, testing observations, or any other relevant detail, then click "Log Flag Data" to save it. A floating button (⚑) appears in the bottom-right corner of the page – click this to open the main panel. The main panel shows all tracked flags, sorted by most recent entry, with flag name, latest status, entry count, and latest note displayed. Click any flag card to view detailed history, including all logged entries with timestamps, status changes, experiment IDs, and notes. The detail view also shows a status summary with counts of enabled, disabled, and unknown entries. Use the "Track Current Page Flags" button to quickly log all flags found on the current page, or "Add Manually" to enter flag details for a flag you're not currently viewing. The "Clear All Flag Data" button removes all tracking data when needed.

ONE TECHNICAL SECTION – WHY IT WORKS

The extension employs a multi-layered detection system that identifies feature flags with high accuracy. First, it scans the DOM using a comprehensive set of CSS selectors targeting common flag-related class patterns, IDs, and data attributes like "flag", "feature", "experiment", "toggle", "beta", and "abtest". Second, it uses a TreeWalker to examine text nodes for flag-related text patterns, capturing flag information that may not be wrapped in typical flag elements. The flag name extraction uses a pattern-matching engine with a weighted scoring system that identifies flag identifiers from text and attributes. The status detection analyzes multiple signals: text content containing "enabled/disabled", toggle switch input states, class name indicators like "active" or "inactive", and data attributes. The experiment ID extraction identifies A/B test identifiers using pattern matching on text and attributes like "data-experiment". Each tracked flag is assigned a unique ID based on the page URL and flag name, ensuring that history stays correctly associated even when pages use different query strings. A MutationObserver detects dynamic content updates and re-scans only when new flag elements appear, balancing real-time accuracy with system performance.

THE PANEL – DRAG / PER-SITE POSITION / SNAP / COLLAPSE / RESIZE / ESCAPE

The feature flag tracking panel includes a draggable title bar, allowing you to position it anywhere on screen for convenient access during development and testing. The extension remembers your preferred position per website, so the panel opens in the same location each time you return to that domain. The panel supports snap-to-edge behavior – when dragged near screen edges, it gently snaps into place for a tidy workspace layout. You can collapse the panel down to just its title bar by clicking the collapse button, keeping it accessible without taking up screen space. The flag list and history are contained within a scrollable body, ensuring all content remains accessible even on smaller screens. Pressing the Escape key closes the panel instantly, returning you to your development workflow.

PLEASE NOTE

This extension requires the free BotGentz extension to be installed and enabled, as it relies on BotGentz's userscript injection and GM_* API shims for cross-browser compatibility. Websites frequently update their HTML structures and class names, which may cause flag detection to break temporarily – we actively maintain the matching patterns and release updates regularly. The extension stores all flag data, status history, experiment IDs, timestamps, and notes exclusively in your local browser storage (GM_setValue); no data is ever transmitted to any external server or third party. You are responsible for backing up your flag tracking data if you switch browsers or clear your storage. The extension does not read, modify, or interfere with any flag functionality, experiment logic, or site behavior – it operates solely on the static page content and stores only metadata (flag names, statuses, experiment IDs, and notes) that you explicitly create. Use this tool responsibly for internal development and testing purposes.