Skip to main content

Browser Extension

The Chrome (MV3) browser extension for Subscriberbot — a subscription command center. Track every subscription, the provider registry, plans, invoices, renewals, the Universal Inbox, and the AI agents that act on them, directly from your browser.

Features​

  • Popup — quick KPIs (active subscriptions, upcoming renewals, estimated monthly spend), recent subscriptions, and top providers, plus a service-health dot.
  • Side panel (Ctrl+Shift+U) — a tabbed dashboard:
    • Subscriptions — filter by status; cancel a subscription inline.
    • Providers — browse the registry, filter by status, see health/churn.
    • Inbox — the Universal Inbox of merged communications; mark read.
    • Invoices — filter by status; mark an invoice paid.
    • Agents — cycle an AI agent's posture (Disabled → Suggest only → Autonomous).
  • Options — configure gateway endpoints + OAuth2 client id and theme.
  • Auth — Burdenoff SSO via the OAuth2 device-code flow.

Install​

From the Chrome Web Store​

Search "Subscriberbot" on the Chrome Web Store and install.

From source​

git clone https://github.com/algoshred/subscriberbot-browser-extension.git
cd subscriberbot-browser-extension
bun install
bun run build        # production build → dist/

Load dist/ as an unpacked extension at chrome://extensions (Developer mode).

Development​

bun run dev              # watch build
bun run build:dev        # single development build
bun run lint             # ESLint
bun run type-check       # TypeScript
bun run format           # Prettier
bun run test             # unit tests
bun run test:smoke       # production-build smoke check
bun run sanity           # format:check + lint + type-check + build + test + smoke
bun run zip              # build + create extension.zip
Environment selection

The extension targets production by default. Use the BURDENOFF_ENV environment variable at build time to switch gateways:

EnvCommandWorkspace gatewayGlobal gateway
prodbun run buildhttps://graphqlworkspaces.burdenoff.com/workspaces/graphqlhttps://graphql.burdenoff.com/global/graphql
alphaBURDENOFF_ENV=alpha bun run buildhttps://alphagraphqlworkspaces.burdenoff.com/workspaces/graphqlhttps://alphagraphql.burdenoff.com/global/graphql
localBURDENOFF_ENV=local bun run build:devhttp://localhost:4003/workspaces/graphqlhttp://localhost:4000/global/graphql

BURDENOFF_ENV is read at build time and injected by webpack's DefinePlugin. Only the endpoints for the selected environment are baked into the bundle. When BURDENOFF_ENV is omitted, the build defaults to prod and the production manifest strips all localhost host_permissions so the Chrome Web Store review sees only the required production URLs.

Authentication​

OAuth2 device-code flow against the global gateway with client id burdenoff_cli_subscriberbot. After sign-in the user selects a workspace; issueWorkspaceToken mints a workspace-scoped token. Workspace queries send both headers:

  • Authorization: Bearer <platform token>
  • X-Workspace-Authorization: Bearer <workspace token>