Licensing & Activation

Static analysis never needs a license. A license key unlocks AI analysis, the dashboard, and team features — activate it with a single environment variable.

Get a license key

Sign up (free) at cdkinsights.dev/start or subscribe on the pricing page. Your key appears in the dashboard under Licenses and looks like:

LIC-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Activate it

The CLI reads CDK_INSIGHTS_LICENSE_KEY from the environment. Locally, put it in your project's .env (and gitignore it):

# .env — never commit this file
CDK_INSIGHTS_LICENSE_KEY=LIC-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

In CI, store it as a secret and export it for the scan step:

# GitHub Actions
- name: CDK Insights scan
  run: npx cdk-insights scan -y
  env:
    CDK_INSIGHTS_LICENSE_KEY: ${{ secrets.CDK_INSIGHTS_LICENSE_KEY }}

On the next run the CLI authenticates, prints your tier (e.g. CDK Insights (pro tier)), and enables the features your plan includes. Auth tokens are cached locally for about an hour, so most runs skip the network round-trip.