ConfigStack

configstack-cli

Run Stack Doctor in CI and download Stacks as .env or JSON. Package: configstack-cli. Uses an API token — no login flow.

Install

Node.js 18+ required. Get an API token from Settings → API tokens.

npx (recommended)
No install. Run directly.
npx configstack-cli --version
npx configstack-cli doctor --token <TOKEN> --source <SOURCE_ENV_ID> --target <TARGET_ENV_ID>
Global or local
npm install -g configstack-cli
npm install --save-dev configstack-cli

After install, the command is configstack.

Commands

doctor — CI gate.export — Download Stack.whoami — Verify token.

doctor

Run Stack Doctor between two environments or source vs baseline. Exit 0 = passed, 1 = failed (severity ≥ threshold), 2 = auth/error.

Usage
configstack doctor --token <TOKEN> --source <SOURCE_ENV_ID> --target <TARGET_ENV_ID> --fail-on MEDIUM

Omit --target to compare source vs its baseline.

export

Download a Stack as .env or JSON.

configstack export --stack <STACK_ID> --format env --token <TOKEN>
configstack export --stack <STACK_ID> --format env --out .env --token <TOKEN>
configstack export --stack <STACK_ID> --format json --out config.json --token <TOKEN>

whoami

Verify your API token. Prints your account email if valid.

configstack whoami --token <TOKEN>

Options

  • --token — API token (required for doctor, export, whoami)
  • --source — Source environment ID (doctor)
  • --target — Target environment ID (doctor; optional for baseline)
  • --fail-on — low, medium, high (doctor; default: medium)
  • --api-url — API base URL (default: CONFIGSTACK_URL or localhost:3000)

CI / GitHub Actions

Add CONFIGSTACK_TOKEN, CONFIGSTACK_SOURCE_ENV, CONFIGSTACK_TARGET_ENV as repo secrets.

- name: Stack Doctor check
  run: |
    npx -y configstack-cli doctor \
      --source ${{ secrets.CONFIGSTACK_SOURCE_ENV }} \
      --target ${{ secrets.CONFIGSTACK_TARGET_ENV }} \
      --fail-on medium \
      --api-url https://configstack.dev \
      --token ${{ secrets.CONFIGSTACK_TOKEN }}

Back to DocsHomePricing