Skip to main content

VS Code Extension

The Subscriberbot universal subscription manager, in your editor. Track every subscription, membership, license, and recurring relationship — with providers, invoices, a merged universal inbox, and automation agents — against the Burdenoff workspace + global GraphQL gateways, without leaving VS Code.

Publisher burdenoff · extension id burdenoff.subscriberbot-code-extension.

Features

  • Activity-bar views for the core Subscriberbot entities:
    • Subscriptions (relationships; expand to Entitlements, Assets, Renewal Events)
    • Providers (the registry; expand to Plans)
    • Invoices (issued / paid / overdue)
    • Universal Inbox (every merged subscription communication)
    • Agents (automation agents; expand to Policies)
    • Dashboard (live KPIs: active spend, upcoming renewals, unpaid invoices, unread inbox)
  • Create / update flows via guided input pickers.
  • Webview panels — rich Provider Detail and subscription Dashboard.
  • Status bar showing active subscriptions + unread inbox at a glance.

Install

From the VS Code Marketplace

Search "Subscriberbot" in the Extensions panel and install.

From a VSIX

  1. Build or download subscriberbot-code-extension-<version>.vsix from GitHub Releases.
  2. In VS Code, open the Extensions view → ...Install from VSIX....
  3. Select the VSIX file.

From source

git clone https://github.com/algoshred/subscriberbot-code-extension.git
cd subscriberbot-code-extension
bun install
bun run build
bun run package

Then install the generated .vsix as above.

Development

bun install
bun run lint # eslint, zero warnings
bun run typecheck # tsc --noEmit
bun run compile # tsc -> out/ (test harness)
bun run build # webpack (extension host + webview UI)
bun run test # @vscode/test-electron (needs a display / xvfb)
bun run test:smoke # force extension-host tests (CI-style)
bun run smoke # production build + artifact smoke check
bun run package # vsce package -> .vsix
bun run sanity # all of the above
Environment selection

The extension targets production by default. To use local or alpha Burdenoff infrastructure, set the environment variable before launching VS Code:

# Alpha
BURDENOFF_ENV=alpha code

# Local dev
BURDENOFF_ENV=local code
EnvironmentWorkspace gatewayGlobal gatewayWeb app
prod (default)https://graphqlworkspaces.burdenoff.com/workspaces/graphqlhttps://graphql.burdenoff.com/global/graphqlhttps://app.subscriberbot.com
alphahttps://alphagraphqlworkspaces.burdenoff.com/workspaces/graphqlhttps://alphagraphql.burdenoff.com/global/graphqlhttps://alphaapp.subscriberbot.com
localhttp://127.0.0.1:4003/workspaces/graphqlhttp://127.0.0.1:4000/global/graphqlhttps://app.local.subscriberbot.com

Endpoints are resolved in a single helper (src/env.ts). You can still override individual values through VS Code settings if needed.

Authentication

  1. Run Subscriber Bot: Login (or click Sign In in the Subscriptions view).
  2. Enter the displayed code at the verification URL.
  3. Pick a workspace. The extension issues a workspace-scoped token and scopes all data requests to it.

The VS Code OAuth client id is burdenoff_vscode_subscriberbot and the redirect is vscode://burdenoff.subscriberbot-code-extension/auth/callback.

Configuration

SettingDefaultPurpose
subscriberbot.workspaceEndpoint(env default)Workspace gateway GraphQL endpoint
subscriberbot.globalEndpoint(env default)Global gateway GraphQL endpoint
subscriberbot.oidcIssuer(env default)OIDC issuer override
subscriberbot.clientIdburdenoff_vscode_subscriberbotOAuth client id override
subscriberbot.workspaceId(auto)Set after login