Browser Extension

Browser Extension

A Chrome/Edge browser extension that shows your Watchtower dashboard summary in a popup with a badge count for items needing attention.

The extension is checked into the main repo under browser-extension/ and is built as a Manifest V3 extension.

Setup

1. Generate an API key Go to Software → Settings → API Keys, enter a label (e.g. "Chrome extension"), and click Generate. Copy the key — it's only shown once.

2. Install the extension

   • Open chrome://extensions (or edge://extensions)
   • Enable Developer mode
   • Click Load unpacked
   • Select the browser-extension/ folder from your local clone of the repo

3. Configure Click the extension icon, then Settings. Enter:

   • Your FreeITSM server URL (e.g. https://itsm.example.com)
   • The API key from step 1

   Click Test to verify connectivity, then Save.

Features

• Badge count — number of items needing attention (urgent tickets, unapproved changes, active incidents, etc.) displayed on the extension icon
• Popup dashboard — compact 8-module summary matching the full Watchtower view
• Configurable polling — refresh every 1 to 30 minutes
• Rate-limited API — 60 requests per minute per key (configurable in System Settings)
• Works in Chrome and Edge (Manifest V3)

Files

browser-extension/
├── manifest.json
├── background.js     # Service worker — polling + badge updates
├── popup.html / .js / .css   # Extension popup UI
├── options.html / .js        # Settings page
└── icons/            # Extension icons (16, 32, 48, 128px)

API

The extension uses the public endpoints under api/watchtower/ with bearer-token auth via the generated API key. The single Watchtower aggregation endpoint returns counts and flags across all modules in one round trip.