Documentation

Everything you need to get started with CC Break Monitor.

Overview

CC Break Monitor automatically tracks your active, break, and offline time on Command Center for AWS Support agents. It runs as a browser extension for Firefox and Chrome — no manual input required.

The extension monitors Command Center API calls in the background, categorises each status change, and shows a live panel with your daily totals and progress toward your active time target.

Features at a Glance

⏱️ Auto-Detection 📊 Time Tracking 🎯 Daily Target ↺ Reset View ◐ Theme Toggle 🔄 Cross-Device Sync 📥 Export Reports 📌 Dock or Float 🔒 Privacy First 🔁 Auto-Updates 🗂️ Multi-Tab Support

See the full features page for detailed descriptions.

Quick Start — Firefox

Download the latest signed .xpi: cc_break_monitor-latest.xpi
Firefox will prompt you to install — click Add.
Open Command Center. The panel appears automatically.

Updates are automatic. Firefox checks roughly every 24 hours. Force-check via about:addons → gear icon → "Check for Updates".

Quick Start — Chrome

Option A — Chrome Web Store (when approved)

Install from the Web Store listing. Auto-updates are handled by Chrome.

Option B — Developer Mode (available now)

Download the latest .zip: cc_break_monitor-chrome-latest.zip
Unzip the file.
Open chrome://extensions/ → enable Developer mode (top-right toggle).
Click Load unpacked → select the unzipped folder.
Open Command Center.

Project Structure

cc-break-monitor/ ├── FireFox-Extension/ │ └── CC-StatusChange/ # Firefox (Manifest V2) ├── Chrome-Extension/ │ └── CC-StatusChange/ # Chrome (Manifest V3) ├── Sync-Backend/ │ ├── cloudformation.yaml # One-click CloudFormation stack │ ├── sync.js # Lambda handler │ └── SETUP-SYNC.md ├── landing-page/ │ ├── index.html # Download page (this site) │ ├── readme.html / faq.html / features.html │ └── logo.png + screenshots ├── build-all.sh # Unified build script ├── README.md ├── FAQ.md └── FEATURES.md

Building & Publishing

./build-all.sh              # Patch bump  (1.4.0 → 1.4.1)
./build-all.sh minor        # Minor bump  (1.4.0 → 1.5.0)
./build-all.sh major        # Major bump  (1.4.0 → 2.0.0)
./build-all.sh --no-upload  # Build only, skip S3 upload
./build-all.sh --firefox-only
./build-all.sh --chrome-only

Prerequisites

npm install -g web-ext
AWS CLI configured (for S3 upload + CloudFront invalidation)
Required: Mozilla AMO credentials (AMO_JWT_ISSUER, AMO_JWT_SECRET)
Optional: Chrome Web Store credentials for auto-publish

Version Scheme

Versions follow MAJOR.MINOR.PATCH with rollover:

Patch increments normally: 1.4.0 → 1.4.1 → … → 1.4.9
Patch rolls over at 9: 1.4.9 → 1.5.0
Minor rolls over at 9: 1.9.9 → 2.0.0