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
- Connect a cloud account — AWS, GCP, or Azure for drift detection
- Add a state source — point DriftWise at your Terraform state (S3, GCS, Azure Blob, TFC)
- Detect drift — compare live infrastructure against Terraform state
- Schedule recurring scans — continuous drift monitoring on a cron schedule
- Create an API key to authenticate with DriftWise
- Configure integrations for Atlantis, GitHub Actions, or GitLab CI
- Bring your own LLM — use your own Anthropic, OpenAI, Bedrock, Gemini, or Azure keys
- Understand risk levels and how scoring works