STAR Tools Documentation
Everything you need to know about STAR Tracker and STAR Annotations. Built for SAFE-T, SSR, and PAT investigators on Paragon.
What is STAR Tools?
STAR Tools is a suite of Chrome extensions built for claim investigators on Paragon. It consists of two independent extensions:
STAR Tracker
Automatic AHT tracking per queue, per marketplace. Real-time dashboard, floating widget, agent status monitoring, and quality-of-life automations.
STAR Annotations
One-click annotation injection for Paragon cases. Category-based buttons, folder organization, email auto-fill, and tracking data capture.
Installation
Download the bundle
Get the latest STAR-Tools-Bundle.zip from the landing page or your team's shared drive.
Extract the folders
Unzip to get two folders: STAR-Tracker/ and STAR-Annotations/
Load in Chrome
Go to chrome://extensions, enable Developer Mode, click "Load unpacked" and select each folder.
Select your profile
Click the STAR Tracker icon and choose your profile: SAFE-T, SSR, or PAT. Open Paragon and start investigating.
Profiles
STAR Tracker supports three independent profiles. Each has its own queue map, dashboard, settings, and detector. Switching profiles is instant via the launcher.
| Profile | Program | Queues | Marketplaces |
|---|---|---|---|
| SAFE-T | Seller Assurance for E-commerce Transactions | ~50 | 6 (NA, UK, IN, BR, MX, ES) |
| SSR | Seller Support Requests | ~184 | 21 |
| PAT | Product Authenticity | ~898 | 23 |
Core Tracking
STAR Tracker automatically detects when a case starts and ends in Paragon, measuring the exact handle time per queue.
kat-card#taskItem elements in the lobby#queue_name hidden inputsDate.now() based, offset by Paragon's displayed timerDashboard
The popup dashboard shows live stats grouped by marketplace. Click any MP header to collapse/expand. Navigate between dates to view historical data.
- Queues grouped by marketplace with color-coded headers
- Live case count, total time, and average AHT per queue
- Recent Cases panel (last 5 cases with queue, time, case ID)
- Date navigation for historical stats
- Export: CSV with daily stats, aux time, and case log
- Import: accepts export format and backup format, merges with existing data
Floating Widget
A compact floating timer visible on every page when a profile is active. Shows the current case queue, label, flag, target time, and live aux status.
- Draggable — position cached in storage
- Open/closed state persisted across page loads
- Lite mode: simplified styling, 3s update interval
Settings
Four collapsible sections for full customization:
Paragon Dark Mode
One toggle inverts Paragon's entire UI into a dark theme using CSS filter: invert(1) hue-rotate(180deg). Images and videos are re-inverted to preserve their original colors.
Auto Features
| Feature | Description |
|---|---|
| Auto-Accept | Automatically clicks the Accept button when a case arrives |
| Auto-Clean | Clears missed contact notifications |
| Auto-Increment | Clicks the Increase Task button |
| Auto-Open Attachments | Opens seller attachment links in new tabs automatically |
Marketplace Badge
A colored badge with the marketplace code (US, UK, DE, IN, etc.) displayed next to the queue name in the case header. Provides instant visual awareness of which marketplace the current case belongs to.
Auto-Open Tools
Automatically opens investigation tools when a new case starts, based on which marketplace folder the queue belongs to. Currently available for SAFE-T only.
How it works
- Go to Settings > Additional Quality of Life > Auto-Open Tools
- Each tool starts empty (inactive). Click the + button to assign marketplace folders.
- When a new case loads and the queue's marketplace matches an assigned folder, the tool opens automatically.
- Remove a folder by clicking the X on its badge to stop auto-opening for that marketplace.
Tool locations
| Tool | Action | Location |
|---|---|---|
| Grass | Opens URL in new tab | Claim Details iframe |
| OBLT | Opens URL in new tab | Claim Details iframe |
| SPOT | Simulates click | Claim Details iframe |
| PeekNow | Clicks button via Shadow DOM | CTPS iframe header |
Keyword Alerts
Define keywords that trigger a visual alert when found anywhere in a case. Alerts fire automatically on case load.
- Add/remove keywords with enable/disable toggle per keyword
- Scans all frames including sibling iframes
- Glass modal alert with Acknowledge button
- Three visual modes: dark glass, light glass, lite flat
STAR Annotations
Injects annotation buttons below the claim action textarea in Paragon. Buttons insert pre-written text for SAFE-T claim resolutions. Supports category-based organization with folder filtering.
Button Editor
Click the extension icon to open the editor popup. Manage your annotation buttons with full CRUD operations.
- Add, edit, delete, and reorder buttons (drag and drop)
- Category color pickers (GRNT, NOGRNT, Miscellaneous)
- Folder management: create/delete folders
- Per-button folder assignment
- Import/Export as JSON
Tracking Auto-Fill
Automatically captures return and forward tracking data from the case and fills email blurb placeholders.
Return Tracking
Captures carrier, tracking number, status, delivered/shipped dates from the Return Details widget.
Forward Tracking
Reads tracking data from data-show-tracking-events JSON attributes and expanded tracking details.
Sidebar widget on the left panel shows all captured data with editable fields and retry buttons.
Changelog
Auto-Open Tools SAFE-T
Automatically open Grass, OBLT, SPOT, or PeekNow when a case starts based on marketplace folder assignments.
Marketplace Badge
Colored badge with MP code next to queue name. Custom colors in normal mode, fixed colors in lite mode.
Settings Reorganization
"Keyword Alerts" section renamed to "Additional Quality of Life" to house new QoL features.
v3.7 Release
Multi-profile system (SAFE-T, SSR, PAT), Liquid Glass theme, keyword alerts, lite mode, floating widget, Paragon dark mode.
Architecture
STAR-Tracker/
manifest.json MV3 config, content script rules
background.js Service worker: timers, routing, storage
content.js Main frame: case detection, aux, dark mode
attachments.js All frames: attachments, submit, auto-open tools
widget.js Floating timer on all pages
launcher.html/js/css Profile selector
profiles/
registry.js Profile definitions
_template/ Template for new profiles
safet/ SAFE-T (config, detector, popup, settings)
ssr/ SSR
pat/ PAT
STAR-Annotations/
manifest.json MV3 config
background.js Opens editor on icon click
inject.js All injection logic (~1069 lines)
editor.html/js/css Button editor popupStorage Keys
Profile-Scoped
| Key | Type | Description |
|---|---|---|
stats_[profile] | Object | Live AHT accumulator per queue |
statsHistory_[profile] | Object | Daily stats archive |
caseLog_[profile] | Object | Case-by-case log with timestamps |
mpColors_[profile] | Object | Custom marketplace colors |
autoOpenTools_safet | Object | Auto-open tool to folder config |
Global
| Key | Type | Description |
|---|---|---|
activeProfile | String | Current profile (safet/ssr/pat) |
liteMode | Boolean | Lite mode toggle |
mpBadge | Boolean | Marketplace badge toggle |
starKeywords | Array | Keyword alert list |
statusTime | Object | Aux time accumulator |
paragonDarkMode | Boolean | Dark mode toggle |