Skip to main content

Getting Started with DriftWise

DriftWise is an AI-powered Terraform plan analyzer that provides risk-scored, plain-English summaries of your infrastructure changes.

Quick Start

Add a step to your Atlantis workflow that converts the plan to JSON and sends it to DriftWise:

atlantis.yaml
workflows:
default:
plan:
steps:
- init
- plan
- run: |
terraform show -json $PLANFILE > /tmp/dw-plan.json
curl -sX POST https://app.driftwise.ai/api/v2/orgs/$ORG_ID/analyze \
-H "x-api-key: $DRIFTWISE_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"plan_json\": $(cat /tmp/dw-plan.json | jq -Rs .)}"

DriftWise returns a JSON response with the analysis — Atlantis echoes it as plan output.

What You Get

  • Risk scoring — Every change classified as None, Low, Medium, High, or Critical
  • Plain-English narratives — No more deciphering raw plan diffs
  • Callouts — Dangerous patterns (public ingress, IAM wildcards, stateful resource replacement) flagged automatically

Platform LLM quota & BYOK

Every plan gets platform-LLM analyses (see Plans & Billing):

  • Free: 5 per ISO-week. Configure BYOK for unlimited.
  • Team: unlimited with a 20/hour rate limit. Configure BYOK for unlimited.
  • Enterprise: unlimited with a contract-negotiated rate limit.

If you hit a platform limit you get a 402 plan_weekly_quota_exhausted or 429 plan_hourly_rate_limit with a pointer to the BYOK config endpoint — the fastest way to unblock is to configure BYOK, which bypasses both platform gates. See LLM Providers for the PUT flow.

Next Steps