Skip to main content

Environment Selection

All Kadaikodi tools default to the production Burdenoff platform. You can switch to alpha or local using the BURDENOFF_ENV environment variable.

Rule​

BURDENOFF_ENV=local|alpha|prod
  • prod is the default when the variable is unset or empty
  • local targets localhost gateways
  • alpha targets the alpha/staging stack behind Cloudflare Access

No hardcoded URLs exist outside the central environment config files in each tool.

Gateway mapping​

EnvWorkspace GatewayGlobal Gateway
prodhttps://graphqlworkspaces.burdenoff.com/workspaces/graphqlhttps://graphql.burdenoff.com/global/graphql
alphahttps://alphagraphqlworkspaces.burdenoff.com/workspaces/graphqlhttps://alphagraphql.burdenoff.com/global/graphql
localhttp://localhost:4003/workspaces/graphqlhttp://localhost:4000/global/graphql

Per-tool usage​

CLI​

BURDENOFF_ENV=alpha kadaikodi auth login
BURDENOFF_ENV=local kadaikodi workspace list

Alternatively, set in your shell profile or use explicit endpoint variables:

export KADAIKODI_WORKSPACE_ENDPOINT=http://localhost:4003/workspaces/graphql
export KADAIKODI_GLOBAL_ENDPOINT=http://localhost:4000/global/graphql

Node SDK​

import { KadaikodiSDK } from '@kadaikodi/sdk';

// Defaults to prod
const sdk = new KadaikodiSDK();

// Or override explicitly
const localSdk = new KadaikodiSDK({
  workspaceEndpoint: 'http://localhost:4003/workspaces/graphql',
  globalEndpoint: 'http://localhost:4000/global/graphql',
});

Python SDK​

from kadaikodi_sdk import KadaikodiSDK

# Defaults to prod
sdk = KadaikodiSDK()

# Or override explicitly
local_sdk = KadaikodiSDK(
    workspace_endpoint="http://localhost:4003/workspaces/graphql",
    global_endpoint="http://localhost:4000/global/graphql",
)

Browser Extension​

Set at build time:

BURDENOFF_ENV=local bun run build
BURDENOFF_ENV=alpha bun run build

VS Code Extension​

Set before launching VS Code:

BURDENOFF_ENV=local code
BURDENOFF_ENV=alpha code

MCP Server​

Set in the MCP server environment config:

{
  "mcpServers": {
    "kadaikodi": {
      "command": "kadaikodi-mcp",
      "args": ["--stdio"],
      "env": {
        "BURDENOFF_ENV": "local",
        "LOG_LEVEL": "error"
      }
    }
  }
}

Doctor E2E​

export KADAIKODI_TARGET=local   # or alpha / prod
make test-all

Backend Service (wspace-kadaikodi-svc)​

The service reads BURDENOFF_ENV at startup to determine which gateway and database config to use. In local dev, the ACA provisioning scripts in ~/products/scripts/aca/ handle this automatically.

Alpha access (Cloudflare Access)​

Alpha hostnames are gated by Cloudflare Access. Automation passes via service-token headers:

  • CF-Access-Client-Id
  • CF-Access-Client-Secret

Fetch tokens from dev KV using ~/products/dev/platform/context/cfaccess/fetch-cfaccess-tokens.sh.

For the browser/VS Code extensions, alpha testing requires the user to be authenticated through the normal Cloudflare Access SSO flow.

Next steps​