cd /news/developer-tools/show-hn-cloud-drift-report-an-open-s… · home › topics › developer-tools › article
[ARTICLE · art-174084] src=github.com ↗ pub= topic=developer-tools verified=true sentiment=↑ positive

Show HN: Cloud-drift-report – an open-source driftctl alternative for AWS

OrchesTerra released cloud-drift-report, an open-source, read-only tool that detects AWS resources changed or deleted outside Terraform, OpenTofu or CloudFormation code and resources no state file or stack tracks, ranking each finding by severity. The tool ships as a command-line tool, a Claude skill for Claude Code, Claude desktop and claude.ai, a Cursor skill, and a GitHub Action (orchesterra/cloud-drift-report@v0), requires Python 3.10+ and boto3 for CloudFormation and not-in-IaC modes, and never writes to AWS or Terraform state, sends no telemetry and needs no account. The not-in-IaC scan covers about 170 resource types, mostly through the AWS Cloud Control API, and names types it could not list in its JSON output.

key takeaway

cloud-drift-report runs `plan -refresh-only -lock=false` and reads it with `show -json` to report Terraform drift, and lists about 170 AWS resource types via the Cloud Control API to flag resources no IaC tracks, ranking security-relevant changes as High.

read10 min views3 publishedNov 22, 2026
Show HN: Cloud-drift-report – an open-source driftctl alternative for AWS
Image: Michielbdejong (auto-discovered)

A read-only drift report for your cloud infrastructure. It finds resources that someone changed or deleted outside your Terraform, OpenTofu or CloudFormation code, and resources that exist in your account but no state file or stack knows about. It ranks them by severity and explains each one in plain English.

AWS Azure, GCP, OCI
Terraform / OpenTofu drift ✅ ✅ (any provider plan -refresh-only can refresh)
CloudFormation drift ✅ —
Resources not in any IaC ✅ planned

It ships four ways, from the same code:

  • a command-line tool (cloud-drift-report )
  • a Claude skill (Claude Code, Claude desktop and claude.ai)
  • a Cursor skill , plus a Cursor rule for older versions
  • a GitHub Action (orchesterra/cloud-drift-report@v0 )

It never writes to AWS or to Terraform state, sends no telemetry and needs no account.

Built by OrchesTerra. This free tool is a one-off check from your laptop or CI. OrchesTerra is the cloud platform that runs it continuously across all your AWS accounts and fixes what it finds, with approvals. Try the live demo (no sign-up) or see what it does.

Source How
Terraform / OpenTofu Runs plan -refresh-only -lock=false into a temporary plan file and reads it withshow -json , or reads a plan JSON you already have.
CloudFormation Runs drift detection on the stacks you name (or every stack in a region), waits for it, then reads the resource drifts.
Not in IaC Lists the account (about 170 resource types, mostly through the AWS Cloud Control API) and compares it with your Terraform state files and CloudFormation stacks. Anything neither lists is reported.

For each drifted resource you get the address, type, action (changed or deleted outside IaC), each changed attribute (before → after), a severity, and a short "what probably happened". For each resource not in IaC you get its name, region, type, ID or ARN and a severity.

The not-in-IaC scan skips what AWS creates itself: default VPCs and their subnets, route tables and security groups, service-linked roles, AWS-managed keys and policies, and resources another AWS service owns (an EKS cluster security group, an RDS-managed secret, instances launched by an Auto Scaling group). They are counted in the report's coverage line but not listed as findings. Types it could not list (access denied, or the type needs a parent resource) are named in the JSON output, so you know what was not checked.

Severity

  • High : security relevant. Security groups and rules, NACLs, IAM, bucket policies, public access, ACLs, encryption, KMS, resource policies, passwords.
  • Medium : any other change that alters behaviour, deleted resources, and most resources not in IaC.
  • Low : tags only, and log groups an AWS service created for one of your resources.

Formats: Markdown (default), CSV, JSON and a self-contained HTML page (no external assets, light and dark mode, severity filter).

You need Python 3.10+. The CloudFormation and not-in-IaC modes also need boto3; Terraform mode needs tofu or terraform on PATH.

pip install cloud-drift-report

Or the latest code from GitHub: pip install git+https://github.com/orchesterra/cloud-drift-report.

Or run the script directly with no install:

python3 skills/cloud-drift-report/scripts/drift_report.py --help

Copy the skill folder into your Claude skills directory:

cp -r skills/cloud-drift-report ~/.claude/skills/

Then ask Claude: "check drift in ./infra", "make a drift report for my CloudFormation stacks in us-east-1", "what changed outside Terraform?" or "what in this account isn't in Terraform?"

Cursor versions with Agent Skills read the same folder:

mkdir -p ~/.cursor/skills && cp -r skills/cloud-drift-report ~/.cursor/skills/

For older Cursor versions, copy the rule into your project instead:

mkdir -p .cursor/rules && cp cursor/rules/cloud-drift-report.mdc .cursor/rules/

The tool never asks for, stores or sends credentials. It uses whatever is already set up on the machine, through the standard AWS credential chain (the same one the AWS CLI uses):

How you sign in How to run it
SSO (IAM Identity Center), recommended aws sso login --profile prod , then--profile prod
Assume-role profile ( role_arn +source_profile in~/.aws/config ) --profile <name>
Access keys in ~/.aws/credentials --profile <name> , or nothing fordefault
Environment variables ( AWS_ACCESS_KEY_ID ,AWS_PROFILE , ...) no flag needed
CI with OIDC (GitHub Actions, GitLab), or an EC2/ECS/Lambda role no flag needed

Terraform/OpenTofu mode runs tofu or terraform, so the provider reads its own credentials: --profile there sets AWS_PROFILE for the AWS provider; Azure, GCP and OCI providers use their usual environment variables or CLI login (az login, gcloud auth application-default login, ~/.oci/config).

Prefer SSO or a role over long-lived access keys. The AWS managed ReadOnlyAccess policy covers everything the tool reads; see Safety for the exact calls.

Use the action. It posts the report on the run's summary page, keeps the HTML, Markdown and JSON reports as an artifact, and fails the job when something drifted or is not in IaC. With GitHub's OIDC and a read-only role, no keys are stored:

name: drift-report
on:
  schedule: [{ cron: "0 6 * * 1-5" }]   # weekdays 06:00 UTC
  workflow_dispatch:
permissions:
  id-token: write   # for OIDC
  contents: read
jobs:
  drift:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: arn:aws:iam::123456789012:role/drift-report-readonly
          aws-region: us-east-1
      - uses: orchesterra/cloud-drift-report@v0
        with:
          mode: unmanaged
          args: --region us-east-1 --state s3://acme-tf-state/prod/

Terraform/OpenTofu drift: add hashicorp/setup-terraform or opentofu/setup-opentofu and run init, then use mode: terraform with args: --dir ./infra. CloudFormation: mode: cloudformation with args: --region us-east-1.

Input Default
mode (required) terraform ,cloudformation orunmanaged
args the mode's flags, as on the command line
fail-on-drift true fail the step when anything is found
upload-report true keep the reports as a workflow artifact
report-name cloud-drift-report the artifact's name

Outputs: findings (count), high (high-severity count) and report-dir (folder with report.html, report.md and report.json), for example to post to Slack only when high is not 0.

Without the action: pip install cloud-drift-report, then run the CLI with -o report.html -o report.md (each file takes the format of its extension) and --fail-on-drift.

AWS_PROFILE=prod cloud-drift-report terraform --dir ./infra

tofu plan -refresh-only -out=plan.out && tofu show -json plan.out > plan.json
cloud-drift-report terraform --plan-json plan.json --format html -o drift.html

cloud-drift-report cloudformation --profile prod --region us-east-1 --stack payments-api --stack network
cloud-drift-report cloudformation --profile prod --region us-east-1 --format csv -o drift.csv

cloud-drift-report unmanaged --profile prod --region us-east-1 --state s3://acme-tf-state/prod/

cloud-drift-report unmanaged --profile prod --all-regions \
  --state s3://acme-tf-state/ --state ./legacy/terraform.tfstate --format html -o not-in-iac.html

cloud-drift-report terraform --dir ./infra --fail-on-drift

Exit codes: 0 ok, 1 error, 2 drift or a resource not in IaC found with --fail-on-drift.

--state takes a local .tfstate file, s3://bucket/key.tfstate, s3://bucket/prefix/ (every .tfstate under it) or an initialised Terraform directory (read with state pull). It may repeat. Without --state, only CloudFormation stacks count as IaC.


**6 drifted resources** · high: 3 · medium: 2 · low: 1

| Severity | Resource                   | Action              | Changes (before → after)                                   | What probably happened |
|----------|----------------------------|---------------------|------------------------------------------------------------|------------------------|
| HIGH     | aws_security_group.web     | changed outside IaC | ingress[1]: (none) → {"cidr_blocks": ["0.0.0.0/0"], ... 22} | Security group rule edited outside IaC and now open to the internet. |
| HIGH     | aws_iam_role_policy.app    | changed outside IaC | policy: s3:GetObject → s3:*                                 | Policy or permissions edited outside IaC; review who gained or lost access. |
| MEDIUM   | aws_instance.worker        | changed outside IaC | instance_type: t3.small → t3.large                          | Edited outside IaC, likely a console or CLI change to instance_type. |
| MEDIUM   | aws_sqs_queue.jobs         | deleted outside IaC | resource no longer exists                                   | Deleted outside IaC; the code still expects it. |
| LOW      | aws_s3_bucket.logs         | changed outside IaC | tags.CostCenter: (none) → 1234                              | Tag added outside IaC. |

Full samples in every format are in examples/: Terraform (md, csv, json, html) and CloudFormation (md, csv, json, html) and not in IaC (md, csv, json, html). Regenerate them with python3 examples/generate.py.

  • Terraform: only plan -refresh-only -lock=false andshow -json . Noapply ,import ,state orrefresh . The plan file goes to a temporary folder and is deleted. Sensitive values are masked.
  • CloudFormation: DetectStackDrift ,DescribeStackDriftDetectionStatus ,DescribeStackResourceDrifts andListStacks . Drift detection records a check on the stack; nothing else changes.
  • Not in IaC: only List, Describe and Get calls (Cloud Control ListResources , plus a few service list calls such asec2:DescribeVpcs andiam:ListRoles ),cloudformation:ListStackResources , and reads of the state files you name. State files are read in memory and never printed or saved.
  • Uses your own credentials (see Credentials ). The AWS managedReadOnlyAccess policy is enough, pluscloudformation:DetectStackDrift for CloudFormation drift and whatever read permissions your Terraform provider needs to refresh.

--share will upload the HTML report to OrchesTerra as a private page your teammates can open. It is not live yet: the flag currently prints a note and uploads nothing. It will always be opt-in.

driftctl used to be the go-to free drift checker, but it is no longer actively maintained. Terraform and OpenTofu can now detect drift themselves with plan -refresh-only, and CloudFormation has drift detection built in, but both print raw output that is hard to triage, and neither tells you about resources your code never knew about. This tool turns the first into a short, ranked report, finds the second by listing the account, and lets Claude or Cursor explain both.

The account listing and the rules for what AWS owns come from OrchesTerra's own drift scanner, simplified to run as a single command.

This tool tells you what has drifted and what is not in code, once. OrchesTerra is a hosted platform for AWS that keeps doing it, fixes what it finds, and runs the rest of your infrastructure workflow in one place.

cloud-drift-report (free) OrchesTerra (paid, cloud)
Drift in Terraform/OpenTofu and CloudFormation ✅ one run ✅ scheduled scans, history and trends
Resources not in any IaC ✅ one run ✅ continuous, every AWS service
Accounts and regions one per run many accounts and regions in one view
Alerts — Slack and email
Fix drift — restore to code, or accept the change into code
Bring unmanaged resources into code — adopt into Terraform or a CloudFormation stack, with the import done for you
Approvals and safety — approvals for risky changes, critical resources protected
Team access — workspaces, roles and an audit log

What else OrchesTerra does

  • Drift and adoption : scans Terraform and CloudFormation on a schedule, and restores, accepts or adopts each finding with one click and an approval step.
  • Provisioning : AWS service forms and a visual designer that produce reviewed Terraform, with plan previews, cost estimates and quota checks before anything is applied.
  • Pull request checks : the plan and its cost impact posted on GitHub, GitLab and Bitbucket pull requests.
  • Policy and compliance : a policy catalog with guardrails mapped to common frameworks, custom rules, exceptions, and checks on existing infrastructure.
  • Cost control : budgets with alerts, cost estimates on every change, and auto-destroy for temporary environments.
  • Disaster recovery : a readiness score per application and scheduled DR drills.
  • Platform tools : a private Terraform module registry, shared variable sets, scheduled runs, and an MCP server so Claude and other AI tools can read your estate.

Start with a 14-day free trial; paid plans start at $99 a month. See pricing, or open the live demo to look around a sample workspace without signing up.

pip install -e '.[test]'
pytest

The tests use a fake refresh-only plan, a fake CloudFormation client and a fake AWS session, so they need no AWS access.

Apache-2.0. See LICENSE.

── more in #developer-tools 4 stories · sorted by recency
── more on @orchesterra 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
→ Live at https://your-agent.zahid.host ✓
Get free account → Pricing
from €0/mo · no card required
LIVE [news/show-hn-cloud-drift-…] indexed:0 read:10min 2026-11-22 · —