{"slug": "show-hn-cloud-drift-report-an-open-source-driftctl-alternative-for-aws", "title": "Show HN: Cloud-drift-report – an open-source driftctl alternative for AWS", "summary": "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.", "body_md": "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.\n\n|  | AWS | Azure, GCP, OCI | \n|---|---|---|\n| Terraform / OpenTofu drift | ✅ | ✅ (any provider `plan -refresh-only` can refresh) | \n| CloudFormation drift | ✅ | — | \n| Resources not in any IaC | ✅ | planned | \n\nIt ships four ways, from the same code:\n\n- a **command-line tool** (`cloud-drift-report` )\n- a **Claude skill** (Claude Code, Claude desktop and claude.ai)\n- a **Cursor skill** , plus a Cursor rule for older versions\n- a **GitHub Action** (`orchesterra/cloud-drift-report@v0` )\n\nIt never writes to AWS or to Terraform state, sends no telemetry and needs no account.\n\n**Built by [OrchesTerra](https://www.orchesterra.in/?utm_source=drift-skill&utm_medium=oss).** This free tool is a one-off check from your laptop or CI.\nOrchesTerra is the cloud platform that runs it continuously across all your AWS accounts and fixes what\nit finds, with approvals. [Try the live demo](https://app.orchesterra.in/auth/login?demo=1&utm_source=drift-skill&utm_medium=oss) (no sign-up) or [see what it does](#orchesterra-the-full-platform).\n\n| Source | How | \n|---|---|\n| Terraform / OpenTofu | Runs `plan -refresh-only -lock=false` into a temporary plan file and reads it with`show -json` , or reads a plan JSON you already have. | \n| CloudFormation | Runs drift detection on the stacks you name (or every stack in a region), waits for it, then reads the resource drifts. | \n| 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. | \n\nFor 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.\n\nThe 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.\n\n**Severity**\n\n- **High** : security relevant. Security groups and rules, NACLs, IAM, bucket policies, public access,\nACLs, encryption, KMS, resource policies, passwords.\n- **Medium** : any other change that alters behaviour, deleted resources, and most resources not in IaC.\n- **Low** : tags only, and log groups an AWS service created for one of your resources.\n\nFormats: Markdown (default), CSV, JSON and a self-contained HTML page (no external assets, light and dark mode, severity filter).\n\nYou need Python 3.10+. The CloudFormation and not-in-IaC modes also need `boto3`; Terraform mode needs `tofu`\nor `terraform` on PATH.\n\n```\npip install cloud-drift-report\n```\n\nOr the latest code from GitHub: `pip install git+https://github.com/orchesterra/cloud-drift-report`.\n\nOr run the script directly with no install:\n\n```\npython3 skills/cloud-drift-report/scripts/drift_report.py --help\n```\n\nCopy the skill folder into your Claude skills directory:\n\n```\ncp -r skills/cloud-drift-report ~/.claude/skills/\n```\n\nThen ask Claude: *\"check drift in ./infra\"*, *\"make a drift report for my CloudFormation stacks in us-east-1\"*,\n*\"what changed outside Terraform?\"* or *\"what in this account isn't in Terraform?\"*\n\nCursor versions with Agent Skills read the same folder:\n\n```\nmkdir -p ~/.cursor/skills && cp -r skills/cloud-drift-report ~/.cursor/skills/\n```\n\nFor older Cursor versions, copy the rule into your project instead:\n\n```\nmkdir -p .cursor/rules && cp cursor/rules/cloud-drift-report.mdc .cursor/rules/\n```\n\nThe 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):\n\n| How you sign in | How to run it | \n|---|---|\n| SSO (IAM Identity Center), recommended | `aws sso login --profile prod` , then`--profile prod` | \n| Assume-role profile ( `role_arn` +`source_profile` in`~/.aws/config` ) | `--profile <name>` | \n| Access keys in `~/.aws/credentials` | `--profile <name>` , or nothing for`default` | \n| Environment variables ( `AWS_ACCESS_KEY_ID` ,`AWS_PROFILE` , ...) | no flag needed | \n| CI with OIDC (GitHub Actions, GitLab), or an EC2/ECS/Lambda role | no flag needed | \n\nTerraform/OpenTofu mode runs `tofu` or `terraform`, so the provider reads its own credentials: `--profile`\nthere sets `AWS_PROFILE` for the AWS provider; Azure, GCP and OCI providers use their usual environment\nvariables or CLI login (`az login`, `gcloud auth application-default login`, `~/.oci/config`).\n\nPrefer SSO or a role over long-lived access keys. The AWS managed `ReadOnlyAccess` policy covers everything\nthe tool reads; see [Safety](#safety) for the exact calls.\n\nUse 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:\n\n```\nname: drift-report\non:\n  schedule: [{ cron: \"0 6 * * 1-5\" }]   # weekdays 06:00 UTC\n  workflow_dispatch:\npermissions:\n  id-token: write   # for OIDC\n  contents: read\njobs:\n  drift:\n    runs-on: ubuntu-latest\n    steps:\n      - uses: actions/checkout@v4\n      - uses: aws-actions/configure-aws-credentials@v4\n        with:\n          role-to-assume: arn:aws:iam::123456789012:role/drift-report-readonly\n          aws-region: us-east-1\n      - uses: orchesterra/cloud-drift-report@v0\n        with:\n          mode: unmanaged\n          args: --region us-east-1 --state s3://acme-tf-state/prod/\n```\n\nTerraform/OpenTofu drift: add `hashicorp/setup-terraform` or `opentofu/setup-opentofu` and run `init`, then use\n`mode: terraform` with `args: --dir ./infra`. CloudFormation: `mode: cloudformation` with\n`args: --region us-east-1`.\n\n| Input | Default |  | \n|---|---|---|\n| `mode` | (required) | `terraform` ,`cloudformation` or`unmanaged` | \n| `args` |  | the mode's flags, as on the command line | \n| `fail-on-drift` | `true` | fail the step when anything is found | \n| `upload-report` | `true` | keep the reports as a workflow artifact | \n| `report-name` | `cloud-drift-report` | the artifact's name | \n\nOutputs: `findings` (count), `high` (high-severity count) and `report-dir` (folder with `report.html`,\n`report.md` and `report.json`), for example to post to Slack only when `high` is not `0`.\n\nWithout the action: `pip install cloud-drift-report`, then run the CLI with `-o report.html -o report.md`\n(each file takes the format of its extension) and `--fail-on-drift`.\n\n```\n# Terraform/OpenTofu directory (must already be initialised), Markdown to the terminal\nAWS_PROFILE=prod cloud-drift-report terraform --dir ./infra\n\n# An existing plan file\ntofu plan -refresh-only -out=plan.out && tofu show -json plan.out > plan.json\ncloud-drift-report terraform --plan-json plan.json --format html -o drift.html\n\n# CloudFormation: two stacks, or every stack in a region\ncloud-drift-report cloudformation --profile prod --region us-east-1 --stack payments-api --stack network\ncloud-drift-report cloudformation --profile prod --region us-east-1 --format csv -o drift.csv\n\n# Not in IaC: compare us-east-1 with every state file under an S3 prefix and all CloudFormation stacks\ncloud-drift-report unmanaged --profile prod --region us-east-1 --state s3://acme-tf-state/prod/\n\n# Not in IaC across every enabled region, several state sources, HTML report\ncloud-drift-report unmanaged --profile prod --all-regions \\\n  --state s3://acme-tf-state/ --state ./legacy/terraform.tfstate --format html -o not-in-iac.html\n\n# CI: exit code 2 when drift (or a resource not in IaC) is found\ncloud-drift-report terraform --dir ./infra --fail-on-drift\n```\n\nExit codes: `0` ok, `1` error, `2` drift or a resource not in IaC found with `--fail-on-drift`.\n\n`--state` takes a local `.tfstate` file, `s3://bucket/key.tfstate`, `s3://bucket/prefix/` (every `.tfstate`\nunder it) or an initialised Terraform directory (read with `state pull`). It may repeat. Without `--state`,\nonly CloudFormation stacks count as IaC.\n\n```\n# Drift report: ./infra/prod\n\n**6 drifted resources** · high: 3 · medium: 2 · low: 1\n\n| Severity | Resource                   | Action              | Changes (before → after)                                   | What probably happened |\n|----------|----------------------------|---------------------|------------------------------------------------------------|------------------------|\n| 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. |\n| 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. |\n| 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. |\n| MEDIUM   | aws_sqs_queue.jobs         | deleted outside IaC | resource no longer exists                                   | Deleted outside IaC; the code still expects it. |\n| LOW      | aws_s3_bucket.logs         | changed outside IaC | tags.CostCenter: (none) → 1234                              | Tag added outside IaC. |\n```\n\nFull samples in every format are in [`examples/`](https://github.com/orchesterra/cloud-drift-report/tree/main/examples): Terraform\n([md](https://github.com/orchesterra/cloud-drift-report/blob/main/examples/terraform-drift.md), [csv](https://github.com/orchesterra/cloud-drift-report/blob/main/examples/terraform-drift.csv), [json](https://github.com/orchesterra/cloud-drift-report/blob/main/examples/terraform-drift.json),\n[html](https://github.com/orchesterra/cloud-drift-report/blob/main/examples/terraform-drift.html)) and CloudFormation\n([md](https://github.com/orchesterra/cloud-drift-report/blob/main/examples/cloudformation-drift.md), [csv](https://github.com/orchesterra/cloud-drift-report/blob/main/examples/cloudformation-drift.csv),\n[json](https://github.com/orchesterra/cloud-drift-report/blob/main/examples/cloudformation-drift.json), [html](https://github.com/orchesterra/cloud-drift-report/blob/main/examples/cloudformation-drift.html)) and not in IaC\n([md](https://github.com/orchesterra/cloud-drift-report/blob/main/examples/not-in-iac.md), [csv](https://github.com/orchesterra/cloud-drift-report/blob/main/examples/not-in-iac.csv), [json](https://github.com/orchesterra/cloud-drift-report/blob/main/examples/not-in-iac.json),\n[html](https://github.com/orchesterra/cloud-drift-report/blob/main/examples/not-in-iac.html)).\nRegenerate them with `python3 examples/generate.py`.\n\n- Terraform: only `plan -refresh-only -lock=false` and`show -json` . No`apply` ,`import` ,`state` or`refresh` . The plan file goes to a temporary folder and is deleted. Sensitive values are masked.\n- CloudFormation: `DetectStackDrift` ,`DescribeStackDriftDetectionStatus` ,`DescribeStackResourceDrifts` and`ListStacks` . Drift detection records a check on the stack; nothing else changes.\n- Not in IaC: only List, Describe and Get calls (Cloud Control `ListResources` , plus a few service list calls\nsuch as`ec2:DescribeVpcs` and`iam:ListRoles` ),`cloudformation:ListStackResources` , and reads of the state\nfiles you name. State files are read in memory and never printed or saved.\n- Uses your own credentials (see [Credentials](#credentials) ). The AWS managed`ReadOnlyAccess` policy is enough, plus`cloudformation:DetectStackDrift` for CloudFormation drift and whatever read permissions your Terraform\nprovider needs to refresh.\n\n`--share` will upload the HTML report to OrchesTerra as a private page your teammates can open. It is not\nlive yet: the flag currently prints a note and uploads nothing. It will always be opt-in.\n\n[driftctl](https://github.com/snyk/driftctl) used to be the go-to free drift checker, but it is no longer\nactively maintained. Terraform and OpenTofu can now detect drift themselves with `plan -refresh-only`, and\nCloudFormation has drift detection built in, but both print raw output that is hard to triage, and neither\ntells you about resources your code never knew about. This tool turns the first into a short, ranked report,\nfinds the second by listing the account, and lets Claude or Cursor explain both.\n\nThe account listing and the rules for what AWS owns come from\n[OrchesTerra](https://www.orchesterra.in/?utm_source=drift-skill&utm_medium=oss)'s own drift scanner, simplified\nto run as a single command.\n\nThis tool tells you what has drifted and what is not in code, once. [OrchesTerra](https://www.orchesterra.in/?utm_source=drift-skill&utm_medium=oss) is a hosted\nplatform for AWS that keeps doing it, fixes what it finds, and runs the rest of your infrastructure workflow\nin one place.\n\n|  | cloud-drift-report (free) | OrchesTerra (paid, cloud) | \n|---|---|---|\n| Drift in Terraform/OpenTofu and CloudFormation | ✅ one run | ✅ scheduled scans, history and trends | \n| Resources not in any IaC | ✅ one run | ✅ continuous, every AWS service | \n| Accounts and regions | one per run | many accounts and regions in one view | \n| Alerts | — | Slack and email | \n| Fix drift | — | restore to code, or accept the change into code | \n| Bring unmanaged resources into code | — | adopt into Terraform or a CloudFormation stack, with the import done for you | \n| Approvals and safety | — | approvals for risky changes, critical resources protected | \n| Team access | — | workspaces, roles and an audit log | \n\n**What else OrchesTerra does**\n\n- **Drift and adoption** : scans Terraform and CloudFormation on a schedule, and restores, accepts or adopts each finding with one click and an approval step.\n- **Provisioning** : AWS service forms and a visual designer that produce reviewed Terraform, with plan\npreviews, cost estimates and quota checks before anything is applied.\n- **Pull request checks** : the plan and its cost impact posted on GitHub, GitLab and Bitbucket pull requests.\n- **Policy and compliance** : a policy catalog with guardrails mapped to common frameworks, custom rules,\nexceptions, and checks on existing infrastructure.\n- **Cost control** : budgets with alerts, cost estimates on every change, and auto-destroy for temporary\nenvironments.\n- **Disaster recovery** : a readiness score per application and scheduled DR drills.\n- **Platform tools** : a private Terraform module registry, shared variable sets, scheduled runs, and an MCP\nserver so Claude and other AI tools can read your estate.\n\nStart with a 14-day free trial; paid plans start at $99 a month. See [pricing](https://www.orchesterra.in/pricing?utm_source=drift-skill&utm_medium=oss), or\n[open the live demo](https://app.orchesterra.in/auth/login?demo=1&utm_source=drift-skill&utm_medium=oss) to look around a sample workspace without signing up.\n\n```\npip install -e '.[test]'\npytest\n```\n\nThe tests use a fake refresh-only plan, a fake CloudFormation client and a fake AWS session, so they need no AWS access.\n\nApache-2.0. See [LICENSE](https://github.com/orchesterra/cloud-drift-report/blob/main/LICENSE).", "url": "https://wpnews.pro/news/show-hn-cloud-drift-report-an-open-source-driftctl-alternative-for-aws", "canonical_source": "https://github.com/orchesterra/cloud-drift-report", "published_at": "2026-11-22 07:32:32+00:00", "updated_at": "2026-11-22 07:41:51.716851+00:00", "lang": "en", "topics": ["developer-tools", "ai-agents", "ai-tools"], "entities": ["OrchesTerra", "cloud-drift-report", "Terraform", "OpenTofu", "CloudFormation", "AWS", "Claude", "Cursor"], "also_reported_by": [], "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.", "recommendation": null, "alternates": {"html": "https://wpnews.pro/news/show-hn-cloud-drift-report-an-open-source-driftctl-alternative-for-aws", "markdown": "https://wpnews.pro/news/show-hn-cloud-drift-report-an-open-source-driftctl-alternative-for-aws.md", "text": "https://wpnews.pro/news/show-hn-cloud-drift-report-an-open-source-driftctl-alternative-for-aws.txt", "jsonld": "https://wpnews.pro/news/show-hn-cloud-drift-report-an-open-source-driftctl-alternative-for-aws.jsonld"}}