Environment Selection

All HeadshotMarketing ecosystem tools target production by default. To switch to alpha or local, set the BURDENOFF_ENV environment variable before starting the tool.

Default behavior

When BURDENOFF_ENV is unset or set to prod, every ecosystem component talks to the production gateways and the production web app:

Endpoint	Production URL
Workspace gateway	`https://graphqlworkspaces.burdenoff.com/workspaces/graphql`
Global gateway	`https://graphql.burdenoff.com/global/graphql`
Web app	`https://app.headshotmarketing.com`

Environment matrix

`BURDENOFF_ENV`	Workspace gateway	Global gateway	Web app
`prod` (default)	`https://graphqlworkspaces.burdenoff.com/workspaces/graphql`	`https://graphql.burdenoff.com/global/graphql`	`https://app.headshotmarketing.com`
`alpha`	`https://alphagraphqlworkspaces.burdenoff.com/workspaces/graphql`	`https://alphagraphql.burdenoff.com/global/graphql`	`https://alphaapp.headshotmarketing.com`
`local`	`http://127.0.0.1:4003/workspaces/graphql`	`http://127.0.0.1:4000/global/graphql`	`http://app.headshotmarketing.local.burdenoff.com`

CLI

# Default (prod)
headshotmarketing auth login

# Alpha
BURDENOFF_ENV=alpha headshotmarketing auth login

# Local
BURDENOFF_ENV=local headshotmarketing auth login

VS Code extension

# Launch VS Code against local gateways
BURDENOFF_ENV=local code

# Launch VS Code against alpha
BURDENOFF_ENV=alpha code

Browser extension

The browser extension selects the environment at build time via BURDENOFF_ENV:

# Production build (default)
bun run build

# Alpha build
BURDENOFF_ENV=alpha bun run build

# Local development
BURDENOFF_ENV=local bun run dev

Node SDK

import { HeadshotmarketingSDK } from '@headshotmarketing/sdk';

// Prod (default)
const sdk = new HeadshotmarketingSDK();

// Or explicitly override endpoints
const sdkAlpha = new HeadshotmarketingSDK({
  workspaceEndpoint: 'https://alphagraphqlworkspaces.burdenoff.com/workspaces/graphql',
  globalEndpoint: 'https://alphagraphql.burdenoff.com/global/graphql',
});

Python SDK

from headshotmarketing_sdk import HeadshotmarketingSDK

# Prod (default)
sdk = HeadshotmarketingSDK()

# Override endpoints
sdk_alpha = HeadshotmarketingSDK(
    workspace_endpoint="https://alphagraphqlworkspaces.burdenoff.com/workspaces/graphql",
    global_endpoint="https://alphagraphql.burdenoff.com/global/graphql",
)

MCP server

{
  "mcpServers": {
    "headshotmarketing": {
      "type": "stdio",
      "command": "bun",
      "args": ["run", "~/products/headshotmarketing/headshotmarketing-mcp/src/index.ts"],
      "env": {
        "BURDENOFF_ENV": "prod"
      }
    }
  }
}

Per-tool overrides

Most tools also support per-tool environment variables for direct endpoint overrides (highest priority):

Tool	Override variables
CLI	`HEADSHOTMARKETING_WORKSPACE_ENDPOINT`, `HEADSHOTMARKETING_GLOBAL_ENDPOINT`, `HEADSHOTMARKETING_OIDC_ISSUER`
Node SDK	`HEADSHOTMARKETING_WORKSPACE_ENDPOINT`, `HEADSHOTMARKETING_GLOBAL_ENDPOINT`
Python SDK	`HEADSHOTMARKETING_WORKSPACE_ENDPOINT`, `HEADSHOTMARKETING_GLOBAL_ENDPOINT`
MCP server	`HEADSHOTMARKETING_WORKSPACE_ENDPOINT`, `HEADSHOTMARKETING_GLOBAL_ENDPOINT`

Production safety

All build scripts and CI pipelines default to prod. Never ship an extension or CLI build with local endpoints hardcoded. The BURDENOFF_ENV variable is the single, auditable switch.

Default behavior​

Environment matrix​

CLI​

VS Code extension​

Browser extension​

Node SDK​

Python SDK​

MCP server​

Per-tool overrides​